ago is a lightweight set of agent workflows for retrospective audit, structured research, documentation review, ADR capture, and audit-driven remediation.
It is designed as one product with platform-specific adapters:
- Claude installs
agoas a marketplace plugin withago:*commands - Codex installs
agoas a native skill set withago-*scenarios
All workflows operate directly on the project you are in. There is no required .workflow/ directory and no extra runtime service to install.
Run a multi-angle retrospective review of recent project work. The workflow inspects git history, recent changes, and documentation context, then produces a consolidated audit report with actionable findings.
Artifact: docs/audit/YYYY-MM-DD-audit.md
Run a structured research session on a technical topic. The workflow combines project context, codebase analysis, and external research, then saves a reusable research artifact.
Artifact: docs/research/YYYY-MM-DD-{topic}.md
Check project documentation against ADRs and current code. The workflow identifies stale docs, missing docs, outdated statements, and ADR consistency issues.
Artifact: docs/audit/YYYY-MM-DD-docs.md
Capture a decision from the current conversation as an ADR with explicit user approval before writing it.
Artifact: docs/adr/NNN-{title}.md
Run a multi-role review of an implementation plan before execution. The workflow evaluates the plan through architecture, security, quality, and product lenses, then writes review artifacts next to the plan.
Artifacts: docs/superpowers/plans/*.{arch,sec,qal,pm}-review.md, docs/superpowers/plans/*.review-index.md
Take an existing audit report, group findings by dependency, plan fixes, and execute them through agents with review gates.
Artifacts: draft PRs, ADRs when needed, and an updated audit report
/plugin marketplace add eyev0/ago
/plugin install ago@ago
Detailed guide: docs/install/claude.md
Fetch and follow instructions from https://raw.githubusercontent.com/eyev0/ago/main/.codex/INSTALL.md
Canonical instructions: .codex/INSTALL.md
After installation, start a fresh session and invoke one of the platform-native entry points:
- Claude:
ago:audit,ago:research,ago:audit-docs,ago:write-adr,ago:review-plan - Codex:
ago-audit,ago-research,ago-audit-docs,ago-write-adr,ago-review-plan
- Claude updates through the plugin marketplace flow
- Codex refreshes through the documented skill install/update flow
Codex currently uses native skill installation rather than a plugin marketplace, so the update path is a managed reinstall of the ago-* skills, not a marketplace auto-update.
MIT