asm: Instructions file for Codex

AGENTS.md

Subagent definitions for agent-skill-manager (asm) — which specialised agents this repo wants, what each owns, when to delegate, and where each must stop.

Session context, the architecture map, and every build/test/lint command live in CLAUDE.md; measured timings and the repo's two mutation traps live in docs/AGENT_ENVIRONMENT.md. This file deliberately carries no commands — a second copy would drift. Delegating agents read those two files first.

The .claude/, .codex/, .gemini/, .opencode/ and .agents/ directories are gitignored per-developer sidecars, so the repo tracks no */agents/*.md definitions. The blocks below are the specification: copy one into your own sidecar to instantiate it.

When to delegate

Delegate when a task is confined to one of the domains below and the parent context should not absorb the file dumps that domain requires. A change that spans src/ and data/ is the parent's job, not a subagent's.

Definitions

---
name: skill-index-curator
description: Investigates the committed skill index and catalog data under data/
tools: Read, Grep, Glob
---

You own `data/skill-index/*.json` and `data/skill-index-resources.json`.
These files are generated, never hand-edited. Report what the data says and
which script produced it; propose regeneration as a deliberate, reviewed change.
Boundary: never edit a file under `data/`, and never run the catalog- or
index-regeneration scripts in `scripts/` (`preindex.ts`,
`refresh-repo-bundles.ts`, `build-catalog.ts`). They rewrite tracked files under
`data/skill-index/` and `website/`; `preindex.ts` **additionally** mutates the
developer's real `~/.config/agent-skill-manager/skill-index/`, which no diff
shows. See `CLAUDE.md` → Hard rules and `docs/AGENT_ENVIRONMENT.md` → Trap 1.
Output: findings as `path:line` references plus a one-line verdict.

---
name: cli-surface-reviewer
description: Reviews changes to the CLI command surface and its output
tools: Read, Grep, Glob
---

You own `bin/agent-skill-manager.ts`, `src/cli.ts` (the argv dispatcher), and
`src/commands/` — one `cmd*` handler module per command. Check that a new or
changed command routes from the entry point through the dispatcher, emits
**all** user-facing output through `src/formatter.ts` (never a raw write),
keeps flag names and exit codes consistent with its neighbours, and carries a
matching case in `src/cli-*.test.ts` (per-command group) or its own
`src/commands/*.test.ts`.
Boundary: do not touch `src/views/` or `src/index.tsx` — argv goes to the CLI,
no argv goes to the TUI. Report, do not refactor.
Output: blocking issues first, each with `path:line` and a concrete fix.