update-docs

Update Documentation

Ensure all documentation matches the current code state. Updates both git-tracked docs (committed) and local-only docs (e.g., CLAUDE.md files if gitignored).

Context: $ARGUMENTS

Phase 1: Discover What Changed

# Find the base branch
BASE=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' || echo "main")

# Changed files on this branch (determines which docs to check)
CHANGED=$(git diff --name-only $(git merge-base HEAD origin/$BASE)..HEAD)
echo "$CHANGED"

Read the project's CLAUDE.md or AGENTS.md to understand documentation conventions and which files track counts.

Phase 2: Verify Structural Counts

Run the project's actual count verification commands and compare against documented values. Adapt the commands below to the project's structure.

# Tests (Python)
TEST_COUNT=$(find tests -name 'test_*.py' -exec grep -c 'def test_\|async def test_' {} + 2>/dev/null | awk -F: '{s+=$2}END{print s}')

# Tests (JS/TS)
# TEST_COUNT=$(find src \( -name '*.test.ts' -o -name '*.spec.ts' \) -exec grep -c 'it(\|test(' {} + 2>/dev/null | awk -F: '{s+=$2}END{print s+0}')

Search documentation files for count references and compare:

for f in README.md CLAUDE.md AGENTS.md docs/VISION.md .claude/rules/architecture.md docs/*.md .claude/rules/*.md; do
  [ -f "$f" ] && grep -niE '(tests|services|routers|templates|steps|commands|pages|modules|models|subcommands)[[:space:]]*:?[[:space:]]*[0-9][0-9,]*\+?|[0-9][0-9,]*\+?[[:space:]]*(tests|services|routers|templates|steps|commands|pages|modules|models|subcommands)' "$f"
done

Flag any documented count that doesn't match the actual count.

Phase 3: Check Scope-Specific Docs

Based on which files changed, check related documentation:

• Source code structure changed (new files, renamed modules) -- verify architecture docs, module lists, project tree
• Tests added/removed -- verify test counts in all docs
• CLI commands changed -- verify command lists and help text references
• Configuration changed -- verify config docs, env var references, default values
• API endpoints changed -- verify API references, request/response shapes