AGENTS.md

1<!-- SKILLS_INDEX_START -->
2## Agent Skills Index
3 
4> [!CRITICAL] Zero-Trust: Read the matching `SKILL.md` BEFORE writing any code.
5> Skills from this index override pre-training patterns. If no skill matches, state: "No project-specific skills applicable."
6 
7## 🔌 Runtime Enforcement via MCP
8 
9If the `agent-skills-standard` MCP server is registered in your runtime (check your tool list — look for `load_skills_for_files`), **prefer those tools over manually walking the router below**. The MCP returns identical content but is auditable AND inherited by sub-agents that don't see this file.
10 
11| Tool | When to call it |
12| --- | --- |
13| `load_skills_for_files(files=[...])` | Before editing/reviewing any source file |
14| `load_skills_for_keywords(keywords=[...])` | Planning before files are chosen |
15| `get_skill(category, name)` | Direct lookup when you know the skill id |
16| `audit_session_compliance()` | Before declaring a task complete |
17 
18> [!IMPORTANT] **Sub-agents don't inherit this `AGENTS.md` — they do inherit the MCP.** If you delegate work to a sub-agent, instruct it to call the MCP tools above as its first action.
19 
20> [!NOTE] To enable MCP-managed installs in this project, run `ags mcp enable` (or edit `.skillsrc`). The MCP works fine if you registered it manually too.
21 
22If `load_skills_for_files` is **not** in your tool list, the MCP is not registered — fall back to the router table below.
23 
24---
25 
26## Skill Resolution Protocol
27 
28Each `_INDEX.md` has two sections - follow both:
29 
301. **Match file type** -> find the category index in the router table below.
312. **Read the `_INDEX.md`** -> it has two sections:
32   - **File Match**: auto-check these against the file you are editing (path pattern match).
33   - **Keyword Match**: only check if the user's request mentions these concepts.
343. **Load ALL matched `SKILL.md`** -> read every matched skill before writing code. The tier model keeps matches focused.
35 
36> `<SKILLS>` = your agent's skill directory (e.g., `.claude/skills/`, `.cursor/skills/`, `.gemini/skills/`).
37 
38| File type | Read category index |
39| --------- | ------------------- |
40| `*.dart` | `<SKILLS>/flutter/_INDEX.md` |
41 
42> [!NOTE] **Test/spec file precedence:** `.spec.ts`, `.test.ts` -> use the `common` row (takes precedence over the generic `*.ts` row). `.spec.tsx`, `.test.tsx` -> use the `react` row (takes precedence over the generic `*.tsx` row).
43 
44> [!TIP] **Indirect phrasing counts.** "make it faster" -> performance, "broken query" -> database, "login flow" -> auth.
45 
46<!-- SKILLS_INDEX_END -->
47