AgentOps Context Map

Generated from SKILL.md frontmatter. See ADR-0001 and CDLC for the architectural rationale.

Skills by hexagonal role

domain

• behavior-first-planning — Behavior-first planning discipline — intent → Gherkin behaviors → EXECUTED-red acceptance tests → spec → acceptance-gated bead DAG. No runnable acceptance test, no bead. Triggers: "plan behavior-first", "acceptance-first planning", "give these beads runnable done-criteria".
• council — Run multi-judge consensus. Use when: an irreversible or high-stakes decision needs independent judges before committing — architecture forks, one-way doors, scoring options.
• crank — Execute epics through waves. Triggers: "crank an epic", "execute epics through waves", "drive the bead wave plan".
• discovery — Create dense execution packets. Fold target for brainstorm + design (goal clarification, product-fit pressure testing). Triggers: "run discovery", "shape intent as BDD", "scope a feature into an execution packet".
• domain — Canonical vocabulary for human-AI software work. Use when naming concepts, resolving terminology disputes, or establishing shared domain language across agents and docs. Triggers: "domain", "canonical vocabulary for human-ai software", "domain skill".
• evolve — Run autonomous improvement loops.
• goals — Maintain AgentOps goals. Triggers: "goals", "maintain agentops goals.", "goals skill".
• operationalize — Distill context (research, recon, learnings) into evidence-anchored rules routed to automation shapes. Use when a finished artifact should become skills, gates, or beads.
• plan — Decompose goals into issue plans. Triggers: "plan", "decompose goals into issue plans.", "plan skill".
• post-mortem — Review completed work and learn. Use when: a task, PR arc, or session is finished and you want to extract learnings, or after ≥5 PRs (the scope checkpoint).
• pre-mortem — Stress-test plans before work. Use when: a plan is drafted but not yet executed and you want to surface failure modes, risks, and what would prove it wrong before committing.
• product — Create or refine PRODUCT.md. Triggers: "product", "create or refine product.md.", "product skill".
• reality-check — Mid-epic drift audit: code is ground truth; README/PRODUCT/plan are the measuring stick. Use when a wave boundary lands and bead counts look healthy but value feels absent.
• rpi — Run discovery, crank, validation. Triggers: "run rpi", "research-plan-implement one turn", "drive a turn through the operating loop".
• shared — Shared AgentOps skill contracts. Triggers: "shared", "shared agentops skill contracts.", "shared skill".
• standards — Provide repo coding standards. Triggers: "standards", "provide repo coding standards.", "standards skill".

driving-adapter

• agy-native — Drive AgentOps in AGY: loop, plugins, memory, evidence, scoped worktrees. Triggers: agy, antigravity, agy plugin, AGY evidence.
• bootstrap — Initialize AgentOps project files. Triggers: "initialize AgentOps", "bootstrap project files", "set up .agents scaffolding".
• codex-exec — Use when running Codex workers or validators non-interactively through codex exec with evidence. Triggers:
• converge — Drive a fix→re-run-judge-panel loop to terminal agreement or a 3-consecutive-fail BLOCK via the Go ao converge command. Thin memo over the CLI — loop and gates live in Go. Triggers: "converge", "drive a fix re-run-judge-panel loop", "converge skill".
• implement — Implement one tracked issue. Triggers: "implement", "implement one tracked issue.", "implement skill".
• pr-prep — Prepare PR commits and body. Triggers: "pr-prep", "pr prep", "prepare pr commits and body.".
• pre-land-refuters — Dispatch fresh-context refuters (model-agnostic; multi-model opt-in) to attack a completion claim at the shared-trunk pawl before landing. Triggers: pre-land validation, refute.
• push — Validate, commit, and push.
• research — Explore and write findings. Triggers: "research", "explore and write findings.", "research skill".
• status — Show AgentOps work status. Triggers: "status", "show agentops work status.", "status skill".
• validate — Produce PASS/WARN/FAIL verdicts for artifacts, plans, code, PRs, or gates — including quick readiness/sanity checks before commit (absorbs vibe) and completion audits. Triggers: "validate an artifact", "PASS/WARN/FAIL verdict", "readiness / completion audit".

driven-adapter

• converter — Convert AgentOps skill formats. Triggers: "converter", "convert agentops skill formats.", "converter skill".
• scope — Hard-block edits outside declared frozen directories and protect paths during risky changes. Triggers: "scope", "hard-block edits outside declared frozen", "scope skill".
• security — Run repository security scans for vulnerabilities, dependency risk, secrets, and release gates. Triggers: "security", "run repository security scans for", "security skill".

supporting

• account-rotation — Switch coding-agent accounts on a usage/rate limit or to spread swarm lanes. Routes by host+agent: macOS+Claude via claude-acct; Codex/Gemini and Linux/WSL via caam. Triggers: "account-rotation", "account rotation", "switch coding-agent accounts on a".
• agent-mail — Use when coordinating agents with Agent Mail locks, inboxes, threads, and conflict-prevention handoffs. Triggers: "agent-mail", "agent mail", "use when coordinating agents with".
• agent-native — Make an out-of-session agent AgentOps-native with skills, the ao CLI, local cockpit proof, and CI backstop telemetry instead of runtime hooks. Triggers: "agent-native", "agent native", "make an out-of-session agent agentops-native".
• automation-shape-routing — Front door for agent automation — decide the SHAPE (Workflow vs ATM vs skill), then hand off. Triggers: "build automation", "convert skills to workflows", "which shape".
• beads-br — Local-first issue tracker (beads_rust) for AI agents. Use when tracking tasks, managing dependencies, finding ready work, or syncing issues to git via JSONL. Triggers: "beads-br", "beads br", "local-first issue tracker beads rust".
• beads-bv — Graph-aware task triage with bv and br. Use when prioritizing work, finding bottlenecks, tracking dependencies, or managing local issues across projects. Triggers: "beads-bv", "beads bv", "graph-aware task triage with bv".
• cass — Mine past agent sessions for working prompts, decisions, and patterns. Use when "what did I ask?", "find that prompt", session archaeology, or agent history. Triggers: "cass", "mine past agent sessions for", "cass skill".
• cc-hooks — Configure Claude Code hooks (PreToolUse, PostToolUse, Stop, Notification). Fold target for the cc-* loop, subagent, and worktree-isolation skills. Triggers: "cc-hooks", "cc hooks", "configure claude code hooks pretooluse".
• dcg — Handle blocked destructive commands. Use when dcg blocks rm -rf, git reset --hard, DROP DATABASE, kubectl delete, or when configuring agent safety guardrails. Triggers: "dcg", "handle blocked destructive commands. use", "dcg skill".
• doc — Generate and validate repo docs, READMEs, and OSS doc packs. Triggers: "doc", "generate and validate repo docs", "doc skill".
• gc-membrane — Reference for the agentops-membrane Gas City pack: the fail-closed, cross-family, verdict-bound close door composed onto stock gc — close-gate mechanics, finalize semantics (nonce, ≥2 families, DEGRADED), pawl-verdict.v1 anatomy, trinity RBAC, quest intake, doctor checks. Loaded JIT by using-gc. Triggers: "gc-membrane", "membrane pack", "pawl-verdict.v1", "gc close door".
• handoff — Write compact session handoffs. Triggers: "handoff", "write compact session handoffs.", "handoff skill".
• heal-skill — Repair skill hygiene, and deep-audit SKILL.md quality (absorbed from /skill-auditor). Triggers: "heal-skill", "heal skill", "repair skill hygiene", "skill-auditor", "audit skill", "skill audit".
• ms — meta_skill (ms) — skill-search/load engine over both corpora (agentops + jsm). Use to find a skill, search skills, or load guidance. Consume via MCP, write via CLI. Triggers: "ms", "meta_skill", "skill search", "find a skill for", "load skill guidance".
• ntm — Orchestrates NTM tmux agent swarms and robot APIs. Use when spawning/sending panes, reading robot state, triaging work, locks/mail, safety, pipelines, serve, or NTM errors. Triggers: "ntm", "orchestrates ntm tmux agent swarms", "ntm skill".
• rch — Use when offloading slow builds to remote workers or recovering RCH worker, hook, SSH, sync, or disk issues. Triggers: "rch", "use when offloading slow builds", "rch skill".
• refactor — Execute safe refactors. Triggers: "refactor", "execute safe refactors.", "refactor skill".
• release — Run release validation. Triggers: "run release validation", "cut a release", "check release readiness".
• reverse-engineer — Reverse-engineer an authorized repo, binary, or product into a verifiable feature inventory and adoption map. Triggers: "reverse-engineer X", "tear down Y", "what should we steal from Z", "evaluate competitor/upstream", "should we fork/adopt/build-native".
• sbh — Disk-pressure defense for AI coding workloads. Use when: disk full, low space, ballast, cleanup, scan artifacts, emergency, sbh daemon, sbh status.
• scaffold — Create project, component, or boilerplate scaffolds. Use when starting a new project, module, or component, generating boilerplate, or stamping a repeatable file structure. Triggers: "scaffold", "create project component or boilerplate".
• skill-builder — Scaffold or absorb new SKILL.md files against the unified AgentOps template. Triggers: "create a skill", "scaffold skill", "absorb external skill", "new skill".
• swarm — Dispatch parallel agents. Triggers: "swarm", "dispatch parallel agents.", "swarm skill".
• test — Generate tests and coverage plans. Triggers: "test", "generate tests and coverage plans.", "test skill".
• toil-mining — Mine usage history (cass, rtk, shell) for repeated toil, score frequency x pain, emit ranked candidates for automation-shape-routing. Use when rituals repeat by hand.
• using-atm — Use ATM as the out-of-session substrate: spawn Claude/Codex panes running /rpi and /evolve over a bead queue, then tend the swarm to convergence under the continuity contract. Triggers: "use ATM as the out-of-session substrate", "spawn atm panes over a bead queue", "tend an unattended swarm", "renewal ticks", "two-tick stall rule".
• using-gc — Drive a Gas City (gc) factory day-to-day: stand up a correct native city, sling quests, watch the membrane close gate, resolve the known stalls, read pawl-verdict.v1, converge. The vibing-with-ntm analog for gc. Use when standing up, running, administering, or troubleshooting a gas city. Triggers: "using-gc", "gas city", "drive a gc city", "sling a quest", "gc stall", "stand up a membrane city".
• workflow-builder — Scaffold a new Claude Workflow script — deterministic multi-agent orchestration. Triggers: "build a workflow", "create a workflow", "scaffold workflow", "author a workflow".

generic

• (no skills in this role yet)

unclassified

• (no unclassified skills)

Context relationships

graph LR
  automation-shape-routing -- "supplier-to" --> operationalize
  automation-shape-routing -- "supplier-to" --> skill-builder
  automation-shape-routing -- "supplier-to" --> workflow-builder
  behavior-first-planning -- "shared-kernel" --> standards
  codex-exec -- "supplier-to" --> codex-sandbox-evidence
  council -- "shared-kernel" --> standards
  crank -- "shared-kernel" --> standards
  discovery -- "shared-kernel" --> standards
  evolve -- "customer-of" --> rpi
  goals -- "shared-kernel" --> standards
  heal-skill -- "customer-of" --> skill-builder
  implement -- "customer-of" --> domain
  operationalize -- "customer-of" --> automation-shape-routing
  operationalize -- "supplier-to" --> beads-br
  operationalize -- "supplier-to" --> cc-hooks
  operationalize -- "customer-of" --> research
  operationalize -- "supplier-to" --> skill-builder
  operationalize -- "customer-of" --> validate
  operationalize -- "supplier-to" --> workflow-builder
  plan -- "shared-kernel" --> standards
  post-mortem -- "shared-kernel" --> standards
  pr-prep -- "customer-of" --> domain
  pre-land-refuters -- "customer-of" --> codex-exec
  pre-land-refuters -- "customer-of" --> validate
  pre-mortem -- "shared-kernel" --> standards
  product -- "shared-kernel" --> standards
  reality-check -- "supplier-to" --> discovery
  release -- "supplier-to" --> crank
  rpi -- "customer-of" --> crank
  rpi -- "customer-of" --> discovery
  rpi -- "customer-of" --> validate
  scope -- "supplier-to" --> domain
  security -- "supplier-to" --> validate
  skill-builder -- "customer-of" --> automation-shape-routing
  skill-builder -- "supplier-to" --> heal-skill
  swarm -- "customer-of" --> crank
  toil-mining -- "supplier-to" --> automation-shape-routing
  using-atm -- "customer-of" --> swarm
  workflow-builder -- "customer-of" --> automation-shape-routing
  workflow-builder -- "shared-kernel" --> operating-loop-workflow

Data flow (consumes / produces)

Skill	Direction	Artifact
agent-native	consumes	converter
agent-native	consumes	standards
agent-native	consumes	validate
agent-native	produces	docs/contracts/agent-runtime-profile.md
agy-native	produces	agy-run-evidence
behavior-first-planning	consumes	standards
behavior-first-planning	produces	.agents/plans/*.md
behavior-first-planning	produces	br-issue
bootstrap	consumes	doc
bootstrap	consumes	goals
bootstrap	consumes	product
bootstrap	consumes	shared
codex-exec	produces	codex-run-output
converge	consumes	command-help
converge	produces	stdout
converter	produces	converted-skill
council	consumes	standards
council	produces	result.json
council	produces	verdict.json
crank	consumes	beads-br
crank	consumes	implement
crank	consumes	post-mortem
crank	consumes	swarm
crank	consumes	validate
crank	produces	.agents/swarm/results/*.json
crank	produces	git-changes
discovery	consumes	plan
discovery	consumes	pre-mortem
discovery	consumes	research
discovery	consumes	shared
discovery	produces	.agents/plans/*.md
discovery	produces	br-issue
discovery	produces	execution-packet.json
doc	consumes	repo-context
doc	produces	documentation
domain	produces	stdout
evolve	consumes	goals
evolve	consumes	post-mortem
evolve	consumes	rpi
evolve	produces	git-changes
evolve	produces	goals-fitness-delta
goals	produces	result.json
handoff	produces	.agents/research/*.md
heal-skill	produces	audit-report.json
implement	consumes	domain
implement	produces	git-changes
operationalize	consumes	.agents/research/*.md
operationalize	produces	.agents/operationalize/*.md
operationalize	produces	routed-handoffs
plan	consumes	standards
plan	produces	.agents/plans/*.md
plan	produces	execution-packet.json
post-mortem	consumes	council
post-mortem	consumes	implement
post-mortem	consumes	validate
post-mortem	produces	result.json
pr-prep	consumes	domain
pr-prep	produces	git-changes
pre-land-refuters	consumes	codex-exec
pre-land-refuters	consumes	validate
pre-land-refuters	produces	.agents/council/*.md
pre-mortem	consumes	standards
pre-mortem	produces	result.json
pre-mortem	produces	verdict.json
product	produces	result.json
push	consumes	git-changes
push	produces	git-changes
reality-check	consumes	implement
reality-check	produces	result.json
refactor	consumes	repo-context
refactor	produces	git-changes
release	produces	result.json
research	consumes	repo-context
research	produces	.agents/research/*.md
research	produces	result.json
reverse-engineer	produces	.agents/research/*.md
rpi	consumes	crank
rpi	consumes	discovery
rpi	consumes	domain
rpi	consumes	validate
rpi	produces	.agents/rpi/*.md
scaffold	produces	converted-skill
scope	produces	filesystem-gate
security	consumes	repo-context
security	produces	security-report.json
shared	produces	stdout
skill-builder	produces	converted-skill
standards	produces	stdout
status	consumes	br
status	produces	stdout
swarm	consumes	implement
swarm	consumes	validate
swarm	produces	.agents/swarm/results/*.json
test	consumes	repo-context
test	consumes	standards
test	produces	result.json
toil-mining	produces	result.json
using-atm	produces	documentation
validate	produces	result.json
workflow-builder	produces	workflow-script