docs/plans/2026-05-24-cut-legacy-planning-skill.md
Objective:
Hard-cut the obsolete legacy planning skill from this repo, complete only
when its .agents/skills directory is removed, active source/generated guidance
no longer routes work through it, remaining repo references are rewritten or
removed so the literal old skill name no longer appears under .agents, docs,
or AGENTS.md, goal-owned docs/plans workflow remains intact, pnpm install
syncs generated output, pnpm lint:fix passes, and this plan passes
check-complete.
Goal plan: docs/plans/2026-05-24-cut-legacy-planning-skill.md
Completion threshold:
.agents/skills directory is absent; no literal old skill-name
matches remain under .agents, docs, or AGENTS.md; generated output is
synced; lint and the active goal-plan checker pass.Verification surface:
.agents/skills path, literal
old-skill-name rg search over .agents, docs, and AGENTS.md,
pnpm install, pnpm lint:fix, and
node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-cut-legacy-planning-skill.md.Constraints:
docs/plans workflow and negative root planning-file
guidance; do not restore root task_plan.md, findings.md, or progress.md
semantics; preserve historical plan meaning as much as possible while removing
the obsolete skill name.Boundaries:
docs/plans/** mentions, and this goal plan.Blocked condition:
Completion rule:
update_goal(status: complete) while any required checklist item
remains unchecked. If an item does not apply, check it and add N/A: <reason>.update_goal(status: complete) until the named verification
evidence is recorded below and
node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-cut-legacy-planning-skill.md passes.active goal state for this goal. This
file plus the active goal are the durable state.Required checklist:
get_goal checked; create_goal called only when no active goal existed,
or the active matching goal was recorded.learnings-researcher / docs/solutions checked, or marked N/A with
reason. N/A: workflow skill removal, not a product bug/feature.docs/plans goal plan created before substantive edits.check run before PR create/update, or marked N/A with reason. N/A:
no PR requested.node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-cut-legacy-planning-skill.md
passes after final evidence is recorded.ce-compound evaluated after non-trivial verified work. N/A: the durable
artifact is the workflow cut itself.Phase / pass table:
| Phase | Status | Evidence | Next |
|---|---|---|---|
| Intake and source read | complete | inspected memory, generated skill dir, source rules, generated guidance, and repo references | hard cut |
| Implementation | complete | removed obsolete skill directory, rewrote stale references, renamed this plan to avoid the old literal skill name | sync generated output |
| Verification | complete | directory absence, literal-name search, generated sync, goal guidance check, and lint passed | done |
| Closeout | complete | final response reports hard cut and evidence | done |
Findings:
.agents/skills directory.goal guidance already owns durable single-file plans under
docs/plans, so keeping a second planning skill creates conflict and drift.docs/plans workflow.Decisions and tradeoffs:
Error attempts:
| Error / failed attempt | Count | Next different move | Resolution |
|---|---|---|---|
Shell interpreted backticks inside an rg pattern while checking goal guidance | 1 | Rerun with safely quoted pattern | Fixed; clean rerun passed |
External/browser findings:
Timeline:
.agents/skills directory.pnpm install synced generated output and did not
recreate the removed skill.pnpm lint:fix passed with no fixes applied.Verification evidence:
.agents, docs, and AGENTS.md -> no
matches..agents/skills -> no matches..agents/rules/goal.mdc, .agents/AGENTS.md,
generated AGENTS.md, and generated goal skill -> passed.pnpm install -> passed; skiller apply completed successfully and did not
recreate the removed skill.pnpm lint:fix -> passed; Checked 3423 files in 5s. No fixes applied.node .agents/rules/goal/scripts/check-complete.mjs docs/plans/2026-05-24-cut-legacy-planning-skill.md -> passed with [goal] complete: docs/plans/2026-05-24-cut-legacy-planning-skill.md.Reboot status:
| Question | Answer |
|---|---|
| Where am I? | Closeout |
| Where am I going? | Report hard cut and verification |
| What is the goal? | Hard-cut the obsolete legacy planning skill from this repo |
| What have I learned? | See Findings |
| What have I done? | See Timeline |
Open risks: