DeepChat SDD Cleanup

Rule

Run this skill only when the developer explicitly asks for SDD cleanup, documentation tidying, pruning,
or removal of completed/stale SDD files. Do not run it as an automatic final step of ordinary
feature, bug, architecture, or release work.

Workflow

1. Inspect docs/spec-driven-dev.md, docs/README.md, and git status.
2. Inventory docs/features, docs/issues, and docs/architecture with find or rg.
3. Prefer parallel sub-agent review when available:
   • one pass for docs/features
   • one pass for docs/issues
   • one pass for docs/architecture
   • optional verifier pass over proposed deletes
4. Apply only changes with clear evidence. Keep a concise keep/delete/update list for handoff.
5. Validate references after edits.

Cleanup Rules

• Completed feature or architecture goal: delete plan.md and any legacy tasks.md; keep spec.md
  only when it still defines a maintained contract, regression guard, platform policy, or
  architecture decision.
• Completed issue goal: delete the issue folder when a linked GitHub issue is closed or the
  implementation and validation evidence prove the bug no longer exists.
• Removed feature: delete its folder when the product/code path is gone and the spec has no reusable
  decision record.
• Obsolete architecture: delete its folder when the module was fully replaced and the doc no longer
  describes a maintained boundary; otherwise update the spec.
• Historical feature spec affected by an architecture refactor: update the retained spec instead of
  leaving contradictory docs.

GitHub Checks

Use gh only when it is installed and authenticated. For linked issue docs, verify closure with
gh issue view <number> --json state,url,title when possible. If gh is unavailable, do not delete
solely because a GitHub link looks old.

Never Delete

• Active work with unchecked plan.md steps or legacy tasks.
• Any document containing unresolved [NEEDS CLARIFICATION].
• A document referenced by docs/README.md, docs/ARCHITECTURE.md, docs/FLOWS.md, or AGENTS
  instructions unless the reference is updated in the same change.
• Runtime baselines or machine-read files unless the cleanup request explicitly covers them.

Validation

• Run rg -n "plan.md|tasks.md|docs/archives|NEEDS CLARIFICATION" docs AGENTS.md .agents/skills
  and inspect any stale policy references.
• Run git status --short.
• For Markdown-only cleanup, formatting/lint commands are optional unless repository instructions or
  touched generated files require them.