SuperAPI AI Directory

revise-claude-md

Coding & development

View repository

Updated 11-10 17:24

About this skill

Review this session for learnings about working with Google Antigravity in this codebase. Update AGENTS.md with context that would help future Antigravity sessions be more effective.

Step 1: Reflect

What context was missing that would have helped Antigravity work more effectively?

  • run_command commands that were used or discovered
  • Code style patterns followed
  • Testing approaches that worked
  • Environment/configuration quirks
  • Warnings or gotchas encountered

Step 2: Find AGENTS.md Files

find . -name "AGENTS.md" -o -name ".claude.local.md" 2>/dev/null | head -20

Decide where each addition belongs:

  • AGENTS.md - Team-shared (checked into git)
  • .claude.local.md - Personal/local only (gitignored)

Step 3: Draft Additions

Keep it concise - one line per concept. AGENTS.md is part of the prompt, so brevity matters.

Format: <command or pattern> - <brief description>

Avoid:

  • Verbose explanations
  • Obvious information
  • One-off fixes unlikely to recur

Step 4: Show Proposed Changes

For each addition:

### Update: ./AGENTS.md

**Why:** [one-line reason]

\`\`\`diff
+ [the addition - keep it brief]
\`\`\`

Step 5: Apply with Approval

Ask if the user wants to apply the changes. Only edit files they approve.