Garden Tender

Use this skill when the user asks to clean docs/spec sprawl, find weak docs, or keep architecture writing aligned with current implementation.

Workflow

1. Run deterministic audits first.
   • Preferred: ./scripts/docs-garden-audit.sh
   • Structural: ./scripts/check-docs-consistency.sh
   • Formatting: dprint fmt
2. Build a weak-doc shortlist grouped by failure mode:
   • stale: contradicts current code/layout/naming
   • orphan: not reachable from README/docs hub
   • duplicate: repeats canonical topic without adding value
   • dead-spec: claims behavior not implemented or no longer planned
3. Propose the smallest corrective action per item:
   • index (link from docs hub)
   • merge (move unique value into canonical doc, delete duplicate)
   • prune (delete dead/stale doc)
   • tighten (add contents, reference links, business-first summary)