deepchat-sdd-cleanup

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

1. Apply only changes with clear evidence. Keep a concise keep/delete/update list for handoff.
2. 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.