/acreadiness-generate-instructions — write AI agent instructions

Use this skill whenever the user wants to create, regenerate, or refresh their custom instructions for AI coding agents (Copilot, Claude, etc.). This is the Generate step in AgentRC's Measure → Generate → Maintain loop and the single highest-leverage action for the AI Tooling pillar.

Output options

VS Code recognises several instruction file types — AgentRC generates the most common ones:

File	Scope	When to use
`.github/copilot-instructions.md`	Always-on, whole workspace	Default — VS Code Copilot's native instruction file
`AGENTS.md`	Always-on, whole workspace	Multi-agent repos (Copilot + Claude + others)
`.github/instructions/*.instructions.md`	Scoped by `applyTo` glob	Per-area / per-language rules in monorepos
`CLAUDE.md`	Claude-specific	Add via `--claude-md` (nested only)

Strategies

flat (default) — single .github/copilot-instructions.md at the chosen path. Simple, easy to review.
nested — hub at .github/copilot-instructions.md + per-topic detail files at .github/instructions/<topic>.instructions.md, each with an applyTo glob so VS Code only loads the topic when it's relevant. Better for large or multi-stack repos.