generate-agent-instructions

Generate or update AGENTS.md using evidence from the current repository.

Ignore CLAUDE.md entirely if present.

Workflow

1. Locate existing AGENTS.md and treat it as the base when present.
2. Inspect the codebase deeply enough to understand:
   • Architecture across multiple files (major components, boundaries, data flow, and structural intent).
   • Real developer workflows (build, test, lint, run, debug, and release commands).
   • Project-specific conventions and non-obvious patterns.
   • Integrations, external services, and cross-component communication.
3. Extract only discoverable facts from code, config, scripts, and docs.
4. Merge intelligently with existing AGENTS.md: keep still-valid guidance, remove stale guidance, fill important gaps.
5. Write concise, actionable instructions targeted to future coding agents.

Output Requirements