Generate AGENTS.md

Regenerate the AGENTS.md file with a compressed documentation index.

When to run

Run this command when:

• Documentation files have been added, removed, or reorganized
• You want to update the docs index for AI agents

Steps

1. Check for changes (only regenerate if docs changed):

   git diff --name-only HEAD -- docs/
   git diff --name-only master...HEAD -- docs/
   

2. If docs changed or $ARGUMENTS includes force: Run the generator script:

   node scripts/generate-agents-md.js
   

3. Report the result:

   • Show the docs index size
   • Show total file size
   • List any new directories or significant changes

Arguments

• No arguments: Only regenerate if docs/ files have changed
• force: Regenerate regardless of changes
• status: Show current AGENTS.md stats without regenerating:
  • File size and last modified date
  • Number of indexed paths (count lines starting with |)
  • Check if AGENTS.md is stale (docs changed since last generation)

Output format

For regeneration:

## AGENTS.md Generation

### Changes detected
- 3 files modified in docs/

### Generated
- Docs index: 10.5 KB
- Total size: 14.2 KB
- Directories indexed: 120

### Next steps
- Review AGENTS.md if needed
- Commit with your other changes

For status:

## AGENTS.md Status

### Current file
- Size: 14.2 KB
- Last modified: 2024-02-09 20:44
- Indexed paths: 122

### Freshness
- [OK] Up to date (no docs changes since generation)
  OR
- [STALE] 5 docs files changed since last generation
  Run `/agents` to regenerate