goallisted

# Goal — persistent project objective A goal is a single objective the agent keeps pursuing across turns and sessions until it is marked done. Inspired by Prime Agent's thread goal: state lives outside any one conversation, so any tool with this skill installed (Claude Code, Cursor, Codex, ...) picks up where another left off. ## State file One file per project: `.goal.md` in the repository root. Human-readable and human-editable on purpose — pause, resume, edit, and clear are controlled by the user editing the file directly. ```markdown --- objective: Ship release notes for v2.3 status: active # active | paused | done created: 2026-08-22 --- ## Progress - 2026-08-22 14:02 — drafted changelog from git log ``` Optional sections the loop reads if present: `## Queue` (ordered work items), `## Standing constraints` (owner-set rules that bind every session), `## Decisions` (recorded owner calls — binding, never re-litigated), `## Done criteria`. ## API - **get** — read `.goal.md`. No file means no goal is set. Report the objective, status, and latest progress entries when asked about goal status. - **create(objective)** — write `.goal.md` with `status: active` and today's date. If an `active` goal already exists, do NOT silently replace it; show it and ask whether to complete, pause, or replace. Only create a goal when the user explicitly asks for a persistent goal; do not infer goals from ordinary tasks. - **update(note)** — append one dated line to `## P