18 areas · 10 Software specs · 8 DevOps specs · 7 SDLC agents · 105+ skills · 73+ workflows
A unified catalog of agentic specializations and the agentic CLI. Install orchestrator-ready rules, skills, workflows,
and prompts into any project — and run a full SDLC agent team out of the box.
Coverage report for the current catalog across areas, specs, skills, and workflows.
Most agent prompt libraries give you a smarter single agent. agent-guides gives you a coordinated team:
@product-owner → @team-lead → @developer → @qa → @devops-engineer
Each role has hard boundaries, explicit handoff criteria, and measurable success metrics. The Product Owner orchestrates the full SDLC; no other agent library ships this out of the box.
Works with Claude Code, opencode, Cursor, Codex, kilocode, antigravity and Gemini.
agent-guides is a structured knowledge base for AI coding agents. Instead of writing long system prompts, you install focused, composable guidance files that agents load on demand based on the task at hand.
Each area (e.g., devops/kubernetes) provides:
| File type | Purpose | When loaded |
|---|---|---|
AGENTS.md |
Navigation index, load order, constraints | First — always |
rules/*.md |
Hard constraints the agent must follow | Always, for the active spec |
skills/*/SKILL.md |
Technical capabilities and patterns | On demand, matching "When to load" |
workflows/*.md |
Orchestrated step-by-step processes | On /command trigger |
prompts/*.md |
Human copy-paste templates (EN + RU) | Reference / paste |
agent-guides/
├── areas/
│ ├── software/ # Application development
│ │ ├── general/ # Shared baseline — all software specs inherit from here
│ │ ├── backend/ # REST/GraphQL APIs, services, database access
│ │ ├── frontend/ # Components, accessibility, performance, CSS
│ │ ├── full-stack/ # End-to-end product features
│ │ ├── data-engineering/ # dbt, warehouses, pipelines, streaming
│ │ ├── mlops/ # Training, evaluation, serving, monitoring
│ │ ├── mobile/ # iOS, Android, React Native, Flutter
│ │ ├── platform/ # K8s manifests, IaC, CI/CD, secrets
│ │ ├── qa/ # Test strategy, coverage, flakiness, performance
│ │ └── security/ # Threat modeling, SAST/DAST, auth, compliance
│ └── devops/ # Platform and operations
│ ├── kubernetes/ # Cluster bootstrap, workload ops, RBAC, upgrades
│ ├── ci-cd/ # GitHub Actions, GitLab CI, quality gates, supply chain
│ ├── infrastructure/ # Terraform, Ansible, IaC standards, drift detection
│ ├── observability/ # Prometheus, Loki, Tempo, Grafana, SLOs
│ ├── sre/ # SLOs, error budgets, incidents, chaos engineering
│ ├── networking/ # Ingress, TLS, service mesh, DNS, VPC
│ ├── devsecops/ # Shift-left, SBOM, OPA/Kyverno, container hardening
│ └── database-ops/ # PostgreSQL, Redis, migrations, backup/restore
├── extensions/
│ ├── opencode/ # OpenCode agent definitions, commands, skills
│ │ └── agents/ # 7 SDLC agents for .opencode/agents/
│ ├── claude/ # Claude Code configs
│ │ └── agents/ # 7 SDLC agents for .claude/agents/
│ ├── antigravity/ # Antigravity platform configs
│ ├── codex/ # Codex custom agents and override configs
│ │ └── agents/ # 7 SDLC agents for .codex/agents/
│ └── gemini/ # Gemini-specific configs
│ │ └── agents/ # 7 SDLC agents for .gemini/agents/
├── areas/template/ # Authoring templates — start here for new content
├── docs/ # Setup and usage guides
├── AGENTS.md # Root agent guidance (loaded into every project)
└── agentic # CLI installer
npx @jetrabbits/agentic@latestAlternative bootstrap (installs local binary):
curl -fsSL https://raw.githubusercontent.com/sawrus/agent-guides/main/install | bashagenticagentic upgrade
Interactive walkthrough of the agentic CLI flow: choose a target project, pick agent platforms, and install the
guidance bundle.
The same 7-agent team works across Claude Code, OpenCode, Codex, and any tool that supports agent or subagent files.
| Agent | Role | Invoke when |
|---|---|---|
product-owner |
Scope, acceptance criteria, SDLC orchestration | Start of any feature; final acceptance |
pm |
Planning, milestones, risk register | Scope is defined, execution needs tracking |
team-lead |
Architecture, code review, quality gates | Planning and pre-release sign-off |
developer |
Implementation, tests, delivery | Implementation plan is approved |
qa |
Verification, defect classification, go/no-go | Developer hands off an increment |
designer |
UX flows, accessibility, design-system review | Planning and implementation review |
devops-engineer |
CI/CD, IaC, platform reliability | Anything touching infra, pipelines, or deploy |
Each agent has a vibe (one-line personality), Identity, Communication Style, Success Metrics, and explicit
Boundaries — so roles never overlap and handoffs are always documented.
| Platform | Agent path | Format | Guide |
|---|---|---|---|
| Claude Code | project/.claude/agents/*.md |
Markdown with YAML frontmatter | Claude Code subagents |
| OpenCode | project/.opencode/agents/*.md |
Markdown with frontmatter | OpenCode agents · repo setup note |
| Codex | project/.codex/agents/*.toml |
TOML custom agents | Codex subagents |
| Gemini | project/.gemini/agents/*.toml |
Markdown with YAML frontmatter | Gemini subagents |
Running agentic in a target project installs shared guidance into the project's .agent/ directory and copies any
selected platform extensions into tool-specific directories such as .claude/, .opencode/, and .codex/.
Generated operating guidance is written to AGENTS.md at the project root for most agents. OpenCode receives the same
generated guidance at .opencode/AGENTS.md; multi-target installs that include OpenCode and another agent write both
files.
project/.agent/
├── rules/ ← constraints active for every task in this project
├── skills/ ← capabilities loaded on demand
├── workflows/ ← processes triggered by slash commands
└── prompts/ ← human-paste templates
| Option block | Choices | Applies to | Result |
|---|---|---|---|
| MCP selection | context7, mempalace (multi-select) |
Supported Agent IDE targets | Writes optional MCP configuration for selected integrations. |
| OpenCode plugins | telegram-opencode-notifier, llm-quota-checker (multi-select) |
opencode target only |
telegram: prompts for bot token/chat id; model-checker: enables plugin; no selection keeps both disabled. |
See CONTRIBUTING.md for authoring standards, templates, and the pull request process.
Quick checklist before opening a PR:
- Used the appropriate template from
areas/template/. - No
{{PLACEHOLDER}}values remain. - Spec map in
AGENTS.mdupdated. - Constraints in rules use imperative language.
- Prompt examples include both EN and RU blocks.
See LICENSE if present, or contact the maintainers.