When to use
Use this when you start a new task or need to re-orient inside a project.
Steps
- •If AOC files are missing or stale, run
aoc-initfrom the project root. - •Read memory:
aoc-mem readandaoc-mem search "<topic>"as needed. - •Review tasks:
tm list,aoc-task list, or the Taskmaster TUI. - •For the active task, check PRD linkage with
aoc-task prd show <id>; if missing, create/link viaaoc-task prd init <id>oraoc-task prd set <id> <path>. - •Plan: add or refine tasks with
aoc-task add "<task>"and set status. - •Execute changes and run tests.
- •If context gets tight, capture state (
aoc-stm add/edit; in OpenCode you can run/stm), review current draft withaoc-stm, archive it withaoc-stm archive, and useaoc-stm readto load archived diary context when needed. - •Update tasks and record decisions:
aoc-task status <id> done,aoc-mem add "<decision>".
Guardrails
- •Do not edit
.aoc/memory.mddirectly. - •Do not keep long-term decisions in
.aoc/stm/current.md; promote durable decisions toaoc-mem. - •Do not edit
.taskmaster/tasks/tasks.jsondirectly. - •Do not add PRD links to subtasks; PRDs are task-level only (
aocPrd).