track-ai-plans
Installation
SKILL.md
Track AI Plans
Use qing-plans/ as durable project memory: what the user wants, why the plan is shaped this way, what each stage changes, which modules are affected, what was observed and verified, and exactly what should happen next.
Preflight
- Treat the Git top-level as
ROOT. SetPLANCTLto this skill's ownscripts/planctl.pyand run every command aspython3 "$PLANCTL" --root ROOT .... A repository holds plan data anddashboard.htmlonly — never the runtime — so the same command works before the first plan exists and on every later machine. - If
qing-plans/index.jsonexists, runvalidate, thenresume. With no current plan,resumediscovers one unfinished draft or lists draft candidates instead of silently ignoring them. - If only
plans/index.jsonexists, it is V1 and read-only. Read references/migration.md before mutation. - If both directories exist, continue only when
qing-plans/migration.jsonis verified; thenqing-plans/is authoritative andplans/is legacy evidence. - A paused plan is current but never auto-resumed. Report it and ask the user before changing its lifecycle.