acreadiness-generate-instructions

1# /acreadiness-generate-instructions — write AI agent instructions
2 
3Use 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.
4 
5## Output options
6 
7VS Code recognises several instruction file types — AgentRC generates the most common ones:
8 
9| File | Scope | When to use |
10|---|---|---|
11| `.github/copilot-instructions.md` | Always-on, whole workspace | **Default** — VS Code Copilot's native instruction file |
12| `AGENTS.md` | Always-on, whole workspace | Multi-agent repos (Copilot + Claude + others) |
13| `.github/instructions/*.instructions.md` | Scoped by `applyTo` glob | Per-area / per-language rules in monorepos |
14| `CLAUDE.md` | Claude-specific | Add via `--claude-md` (nested only) |
15 
16## Strategies
17 
18- **`flat`** *(default)* — single `.github/copilot-instructions.md` at the chosen path. Simple, easy to review.
19- **`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.
20…