/readmes

Comprehensive review and update of all README.md files in the meta-repo.

Usage

/readmes    # Review all READMEs in ideas/ directory

Scope

Includes:

• ideas/[project]/README.md

  - All project overviews

• ideas/[project]/apps/*/README.md

  - Multi-app project READMEs
• Root-level documentation files

Excludes:

• spaces/

  directory (code repos have their own maintenance)
• Build artifacts, node_modules, etc.

Execution Flow

1. Discover All READMEs

Glob: ideas/**/README.md

2. Review Each README

For each README, technical-writer agent checks:

• Status accuracy: Matches CLAUDE.md Current Projects?
• Date accuracy: Is "Last Updated" current?
• Link validity: Are all links working?
• Content completeness: Required sections present?
• Consistency: Formatting matches standards?

3. Update READMEs

• Fix outdated status indicators
• Update dates to current date
• Fix broken links
• Add missing sections
• Standardize formatting

4. Report Results

Summary includes:

• READMEs reviewed (count)
• Updates made (list of files)
• Issues requiring manual attention

What Gets Checked

Aspect	Validation
Status	Matches CLAUDE.md
Dates	"Last Updated" is accurate
Links	Internal refs work
Structure	Has required sections
Consistency	Follows template

When to Use

• After major project updates
• Before project reviews/demos
• Monthly documentation maintenance
• After status changes in CLAUDE.md

Notes

• Read then write: Agent reads each file before making changes
• Preserves content: Only updates metadata and known sections
• Non-destructive: Doesn't remove custom content
• Idempotent: Safe to run multiple times

Integration

Update CLAUDE.md status → /readmes → Verify changes