506f532f88
Session 4 step 15 — GOALS.md hierarchy (objectives > initiatives > tasks) and goal-tracker.sh for status/context/complete operations. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
# Goal Hierarchy
|
|
|
|
File-based goal hierarchy inspired by Paperclip's goal system.
|
|
|
|
## Design decisions
|
|
|
|
- **Simple parent_id, not recursive**: Each goal references its parent by ID.
|
|
No recursive traversal at runtime — matching Paperclip's actual implementation
|
|
(not their aspirational docs which describe "full ancestry").
|
|
- **Dot notation for hierarchy**: G1 → G1.1 → G1.1.1 makes the hierarchy visible
|
|
in the ID itself.
|
|
- **File-based, not database**: Human-editable, version-controlled, no dependencies.
|
|
|
|
## Goal levels
|
|
|
|
| Level | ID pattern | Example | Description |
|
|
|-------|-----------|---------|-------------|
|
|
| Company | G1, G2 | G1 | Top-level organizational goals |
|
|
| Project | G1.1, G1.2 | G1.1 | Goals that support a company goal |
|
|
| Task | G1.1.1 | G1.1.1 | Specific tasks assigned to agents |
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# View goal summary
|
|
./goal-tracker.sh
|
|
|
|
# Mark a task as complete
|
|
./goal-tracker.sh complete G1.1.1
|
|
|
|
# Generate context for heartbeat injection
|
|
./goal-tracker.sh context
|
|
```
|
|
|
|
## Integration with heartbeat
|
|
|
|
The `context` command produces a summary suitable for injection into
|
|
the heartbeat context packet (see `scripts/templates/heartbeat/context-packet.md`).
|
|
The heartbeat runner can call `./goal-tracker.sh context` and inject
|
|
the output as `{{ACTIVE_GOALS}}`.
|