/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.

Why .github/instructions/ and not .agents/? AgentRC's default nested layout writes to .agents/, which is the right home for agent-agnostic repos (Copilot + Claude + Cursor reading AGENTS.md). For VS Code Copilot specifically, the native location is .github/instructions/ with applyTo frontmatter, that's what Copilot auto-discovers. This skill rewrites AgentRC's nested output to the VS Code-native location whenever the main output is .github/copilot-instructions.md. If you instead chose --output AGENTS.md, nested keeps AgentRC's default .agents/ layout.