// AGH runtime and contribution guide. Use for sessions, agents, native tools, skills, memory, network, tasks, capabilities, bundles, QA, docs, and repo work. Do not use for unrelated projects.
| name | agh |
| description | AGH runtime and contribution guide. Use for sessions, agents, native tools, skills, memory, network, tasks, capabilities, bundles, QA, docs, and repo work. Do not use for unrelated projects. |
| metadata | {"agh":{"version":1,"kind":"runtime","bundled":true,"instructional_only":true}} |
Use this skill when operating AGH or contributing to the AGH repository. This body is a router, not the full manual. Load the matching reference before acting.
Match the task to the row. Read the listed files in full before producing output. They are not appendices. Inline reminders in this file are only tripwires.
| Task | MUST read |
|---|---|
| Start, inspect, prompt, stop, resume, or debug AGH sessions and daemon state | references/runtime-operations.md |
| Create or review AGH agent definitions, provider defaults, permissions, or MCP sidecars | references/agent-definitions.md + references/tools-and-skills.md |
| Discover or call AGH-native tools, inspect native tool IDs, view skills, or choose tools vs CLI | references/tools-and-skills.md + references/native-tools.md |
| Participate in an AGH Network channel, thread, direct room, work item, receipt, trace, or capability exchange | references/network.md |
| Read, write, clean, or consolidate AGH memory | references/memory.md |
| Work as a coordinator, task worker, or task reviewer | references/tasks-and-orchestration.md |
| Design or manage capabilities, bundles, extension resources, hooks, config lifecycle, or agent-manageable runtime surfaces | references/capabilities-and-bundles.md + references/tools-and-skills.md |
| Contribute to the AGH repository, especially Go runtime code or tests | references/contributing-to-agh.md + references/qa-and-verification.md |
| Change public docs, product copy, design guidance, site docs, or UI-facing text | references/docs-design-and-copy.md |
| Finish work, claim readiness, or prepare a handoff | references/qa-and-verification.md |
STOP. Read references/tools-and-skills.md and references/native-tools.md in full before discovering, invoking, creating, or modifying any AGH tool or skill. The catalog in this file is only a router.
STOP. Read references/tasks-and-orchestration.md in full before acting as a coordinator, worker, or reviewer. Task authority and review verdicts are runtime contracts, not prompt conventions.
STOP. Read references/qa-and-verification.md in full before claiming AGH work is complete. Passing a narrow command is not evidence for a broad completion claim.
Auto Review closeout. Codex review is the default when no engine is set and is the recommended reviewer.
Drives end-to-end execution of a Compozy techspec across many agent restarts by detecting the current phase from state.yaml plus .compozy/tasks/<slug>/, then activating the correct cy-* skill chain or the Compozy -> Claude Opus delegation lane for one iteration before stopping. Each Phase B iteration ends with an atomic checkpoint commit so every completed task or slice becomes a restorable git snapshot. Use when running a Compozy techspec under the codex-loop-plugin in goal mode, or when manually iterating through tasks, qa-report, and qa-execution with persistent memory and state. Do not use for one-off tasks without a .compozy/tasks/<slug>/ directory, for techspec authoring (use cy-create-techspec), or for any work that does not require iteration tracking across agent restarts.
Runs an optional cross-LLM peer review of an implemented change via compozy exec --ide claude --model opus --reasoning-effort xhigh and requires the reviewer to write a scoped Markdown findings artifact for user-directed remediation. Use after any implementation pass (feature, bug fix, refactor) when the user explicitly asks for an external Opus review of the diff before commit or PR. Do not use for TechSpec review (use cy-spec-peer-review), automatic remediation, batched provider review fetching (use cy-fix-reviews), manual self-review without an external LLM (use cy-review-round), or auto-looped review cycles.
Runs an optional cross-LLM peer review of a TechSpec via compozy exec --ide claude --model opus --reasoning-effort xhigh and requires the reviewer to write a scoped Markdown findings artifact for user-directed incorporation. Use when a TechSpec draft has already been approved by the user and they want an external review round, especially for autonomy/network/memory-impacting designs. Do not use for PRDs, automatic approval gates, code review batches, or auto-looped review cycles.
Executes real-user QA sessions through public interfaces using personas, journeys, exploratory charters, test tours, edge-case probes, CFR checks, and browser evidence. Reads qa-report artifacts from <qa-output-path>/qa/ when present, captures issues/screenshots/reports under the same output tree, and classifies bugs by user impact. Use when validating a release candidate, migration, refactor, or user-facing change against production-like behavior. Do not use for AI implementation audits, task-status reconciliation, CI gate runs, integration/security/performance templates, or flaky-test triage; use agent-output-audit for those.
Audits Go functions with multi-step setup or teardown for cleanup discipline on every error return: cancel any context created or extended, close every opened resource, release every claim or lease, stop every spawned subprocess, drain every HTTP body. Forbids http.DefaultClient in production code paths. Use when editing functions in internal/acp, internal/session, internal/scheduler, internal/coordinator, internal/extension, internal/automation, internal/store, internal/memory, internal/api, or any subprocess or registry handler. Do not use for read-only helpers, pure data structures, or tests.
