Generate and update project documentation

gsd:docs-updateskillsetup L23,035
davepoon/buildwithclaude
What it does

Generate or update project documentation verified against codebase

Best for

Keeping documentation in sync with code when you want codebase facts verified instead of hallucinated, or auditing existing docs for staleness.

Inputs
  • · --force (optional)
  • · --verify-only (optional)
Outputs
  • · up to 9 documentation files
  • · VERIFY marker count
  • · VERIFY-only report
Requires
  • · Read
  • · Write
  • · Edit
  • · Bash
  • · Glob
  • · Grep
  • · Task
  • · AskUserQuestion
Preconditions

Project structure exists; codebase is readable; gsd-doc-writer subagent configured

Failure modes

--force and --verify-only both specified (--force takes precedence); doc generation timeout; codebase has phantom paths (files deleted but still referenced)

Trust signals
  • · Subagent explores codebase directly (no phantom paths)
  • · Preserves hand-written content unless --force
  • · VERIFY markers enable accuracy audits
  • · Phase 4 verifier provides full cross-codebase fact-checking