OpenSkillIndex← back to search
claude-codeproductivity

Claude-skill-registry doc-update

Updates documentation after code changes to keep docs in sync with code reality. Use AFTER implementation is complete. Covers feature docs, workflow docs, and index files.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/doc-update" ~/.claude/skills/majiayu000-claude-skill-registry-doc-update && rm -rf "$T"
manifest: skills/data/doc-update/SKILL.md
tags
#documentation#code-sync#markdown#automation#git#content-management
source content

Doc Update

Keep documentation evergreen by updating immediately after code changes.

When to Use

  • After completing any code change
  • After fixing a bug or adding a feature
  • Before running 
    /handoff
  • When 
    /drift-check
    identifies stale docs

Hierarchy

Updates flow from specific to general:

  1. Feature Docs → 
    docs/features/{feature}.md
  2. Workflow Docs → 
    docs/workflows/{role}-workflows.md
  3. Index Files → FEATURE_INDEX.md, WORKFLOW_INDEX.md
  4. Architecture Docs → 
    docs/engine/*.md
    (if patterns changed)

Quick Reference

Files ChangedUpdate
app/actions/*.ts
Feature doc → Server Actions
app/(routes)/**
Feature doc → User Surfaces
components/**
Feature doc + Component Index
supabase/migrations/*
Feature doc → Data Model + prod SQL
lib/ai/**
AI context docs + feature docs

Feature Doc Sections to Update

  • User Surfaces: Routes, UI elements
  • Data Model: Tables, columns, relationships
  • Server Actions: Action name, purpose, tables, auth
  • Permissions: RLS policies, admin client usage
  • Invariants: Add newly discovered rules
  • Testing Checklist: Update verification steps

Output

## Doc Update Complete

### Updated
| Doc | Sections |
|-----|----------|
| [feature].md | User Surfaces, Data Model |

### Production SQL
- Provided: [Yes/No]

### Verification
Run `/drift-check` to confirm no remaining drift.

Related