History

Kjell Tore Guttormsen 506f532f88 feat(templates): add goal hierarchy tracker (Paperclip pattern) 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>		2026-04-12 06:51:38 +02:00
..
goal-tracker.sh	feat(templates): add goal hierarchy tracker (Paperclip pattern)	2026-04-12 06:51:38 +02:00
GOALS.md	feat(templates): add goal hierarchy tracker (Paperclip pattern)	2026-04-12 06:51:38 +02:00
README.md	feat(templates): add goal hierarchy tracker (Paperclip pattern)	2026-04-12 06:51:38 +02:00

README.md

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

# 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}}.