Start here
- Quickstart gives the shortest install path.
- Install guide covers update, uninstall, and troubleshooting.
- Architecture explains the state machine, hooks, adapters, and completion gate.
- Runtime E2E review is the live verification checklist.
Install
What it adds
| Area | What it does |
|---|---|
| Goal tools | goal_system_open, goal_system_status, goal_system_update, and goal_system_close create, reload, update, and close persisted goals. Completion is refused without proof. |
| Lifecycle hooks | Restore goal context, write compact snapshots, block premature stop, deny stale non-goal tools, and keep subagents outside goal ownership. |
| VS Code Chat adapter | Adds the Goal System custom agent, VS Code hook config, and local goalSystem MCP server. |
| Goal contract | Installs the goal skill and instruction snippet so Copilot knows the work is execution, not a loose reminder. |
Default behavior
- Goal mode is manual. Normal prompts do not become goals.
/goalactivation creates a persisted draft goal before work begins.- Goal state is main-session only. Subagents cannot open, update, read, or close goals.
- Same-directory sessions are isolated.
- Completion requires inspection evidence, validation proof, verification results, requirement coverage, no remaining work, no blockers, resolved or evidence-covered discovered issues, and a completion audit.