update-docs

update-docs

Audit every documentation surface in ai-platform-engineering and fix what is out of date.

---

What this skill checks

#	Surface	Stale when…
1	Release blog posts	A git tag exists with no matching docs/releases/ file
2	Homepage version string	Helm --version in docs/src/pages/index.tsx doesn't match latest git tag
3	Docusaurus version config	lastVersion in docusaurus.config.ts doesn't match latest git tag
4	Docusaurus version snapshot	A tag exists but no versioned_docs/version-X.Y.Z/ snapshot
5	Features page	docs/src/pages/features.tsx tiles don't reflect new feature docs in docs/docs/features/
6	Agent docs	A directory under ai_platform_engineering/agents/ has no matching docs/docs/agents/<name>.md
7	Sidebar completeness	A directory under docs/docs/ is not referenced in docs/sidebars.ts
8	Navbar version label	The 0.4.X (Latest) label in the navbar version dropdown is behind the latest tag

---

Execution context

Runs in two modes:

• Coding agent (Claude Code) — runs git, find, grep directly and writes fixes to disk.
• Chat-only — renders a checklist of findings; states which files to edit and what to change.

---

Step 1 — Collect ground truth

Run all of the following in parallel.

# Latest stable git tag
LATEST=$(git tag --sort=-version:refname | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | head -1)
echo "Latest tag: $LATEST"

# All release tags
git tag --sort=-version:refname | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$'

# Existing release blog posts (extract version from filename)
ls docs/releases/*.md 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | tr '-' '.'

# Current lastVersion in docusaurus config
grep 'lastVersion' docs/docusaurus.config.ts

# Current Helm version string on homepage
grep -o "'--version [0-9.]*'" docs/src/pages/index.tsx ||
  grep -o '"--version [0-9.]*"' docs/src/pages/index.tsx ||
  grep 'version' docs/src/pages/index.tsx | grep helm | head -3

# Versioned snapshots
ls docs/versioned_docs/

# Agent implementation directories
ls ai_platform_engineering/agents/

# Agent doc files
ls docs/docs/agents/*.md 2>/dev/null | xargs -I{} basename {} .md

# Feature doc files
ls docs/docs/features/*.md 2>/dev/null | xargs -I{} basename {} .md

# Top-level docs directories
ls -d docs/docs/*/

# Sidebar entries
grep -E "^\s+'[a-z]" docs/sidebars.ts | head -40