a-team
CLAUDE.md24 starsChanged 24 days agoMITView on GitHub
Not a marketplace of agents you configure — a pre-configured, pre-enforced team of 26 specialists with a lead orchestrator, hard quality gates, and a Pipeline Auditor that verifies work was done, not just reported. Drop this folder into any project and it's operational from the first keystroke. Works on Claude Code, Codex CLI, Cursor, OpenCode, and GitHub Copilot CLI. 1. Install the shared directories, scripts and platform integration files using install.sh / install.ps1, or follow the complete manual options in…
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .claude/rules/agents.mdAGENTS.md
- api-contract-firstSkill
- architecture-auditSkill
- brainstormingSkill
- data-migrationSkill
- dispatching-parallel-agentsSkill
- executing-plansSkill
- finishing-a-development-branchSkill
- five-whysSkill
- incident-responseSkill
- performance-auditSkill
- skill-duplication-auditSkill
- smart-initSkill
- subagent-driven-developmentSkill
- systematic-debuggingSkill
- test-driven-developmentSkill
- using-a-teamSkill
- using-git-worktreesSkill
- verification-before-completionSkill
- writing-plansSkill
- writing-skillsSkill
The file
We split this CLAUDE.md into the rules it gives an agent
7 rules. About 0 are common, 1 is distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 3
Not a marketplace of agents you configure — a pre-configured, pre-enforced team of 26 specialists with a lead orchestrator, hard quality …
- Very specific: line 11
Write a project INIT.md (use INIT_TEMPLATE.md as a guide).
- Very specific: line 12
Run /orchestrate init — the Lead Orchestrator reads INIT.md, evaluates which agents and skills are irrelevant to the scope, and prunes them …
- Very specific: line 14
Every session starts with the using-a-team meta-skill injected via the SessionStart hook.
- Very specific: line 95
When you run /orchestrate init:
- Very specific: line 107
Every session start triggers the hooks/session-start.md content via the SessionStart hook.
- Very specific: line 116
All agents enforce the rules in .claude/rules/:
≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
A Team — A Complete Engineering Team in One Folder v1.4.1
Not a marketplace of agents you configure — a pre-configured, pre-enforced team of 26 specialists with a lead orchestrator, hard quality gates, and a Pipeline Auditor that verifies work was done, not just reported. Drop this folder into any project and it's operational from the first keystroke. Works on Claude Code, Codex CLI, Cursor, OpenCode, and GitHub Copilot CLI.
Quick Start
- Install the shared directories, scripts and platform integration files using
install.sh/install.ps1, or follow the complete manual options inREADME.md. Do not overwrite an existingAGENTS.md,CLAUDE.mdor.claude/settings.json. - Write a project
INIT.md(useINIT_TEMPLATE.mdas a guide). - Run
/orchestrate init— the Lead Orchestrator readsINIT.md, evaluates which agents and skills are irrelevant to the scope, and prunes them automatically. - Every session starts with the
using-a-teammeta-skill injected via the SessionStart hook.
Folder Layout
A Team/
├── CLAUDE.md ← This file
├── AGENTS.md ← Agent roster & quick reference
├── INIT_TEMPLATE.md ← Template for project-specific init doc
├── .claude/
│ ├── settings.json ← Universal permissions, hooks, MCP stubs
│ ├── agents/ ← 26 agent profiles
│ ├── commands/ ← Slash commands
│ └── rules/ ← Enforced coding & workflow standards
├── skills/ ← 20 workflow skill modules
├── hooks/
│ └── session-start.md ← Injected at every session start
├── .cursor-plugin/ ← Cursor IDE integration
├── .codex-plugin/ ← Codex CLI integration
├── .copilot-plugin/ ← GitHub Copilot CLI integration
└── .opencode/ ← OpenCode integrationAgent Roster (26)
| Agent | Role | Trigger |
| orchestrator | Lead — reads INIT.md, prunes team, dispatches | /orchestrate |
| architect | System design & ADRs | Architectural decisions |
| planner | Implementation plans | Feature requests |
| code-reviewer | Code quality & security | After every code change |
| security-reviewer | OWASP Top 10, secrets | Auth/API/input code |
| tdd-guide | TDD enforcement | New features & bug fixes |
| refactor-cleaner | Dead code & duplication | Code maintenance |
| doc-updater | Codemaps & README | Post-feature |
| build-error-resolver | Build/type failures | Build broken |
| e2e-runner | End-to-end test flows | Critical user journeys |
| database-reviewer | PostgreSQL & schema | DB queries & migrations |
| go-reviewer | Idiomatic Go | Go code changes |
| python-reviewer | Pythonic & PEP 8 | Python code changes |
| rust-reviewer | Rust idioms & safety | Rust code changes |
| typescript-reviewer | TypeScript/React/frontend | All .ts/.tsx changes |
| debugger | Root-cause investigation | Any bug |
| chief-of-staff | Communication triage | Email/Slack workflows |
| loop-operator | Autonomous loop safety | Agent loops |
| harness-optimizer | Pipeline auditor — detects rule evasion, blocks merge | Post-task, pre-merge |
| kotlin-reviewer | Kotlin/Android — Coroutines, Compose, MVVM | All .kt changes |
| swift-reviewer | Swift/iOS — ARC, concurrency, SwiftUI | All .swift changes |
| flutter-reviewer | Flutter/Dart — null safety, state management | All .dart changes |
| infra-reviewer | Terraform, Docker, K8s, CI/CD | All IaC changes |
| compliance-reviewer | GDPR, COPPA, PCI-DSS, SOC2, HIPAA | Privacy/data/payment code |
| ai-reviewer | LLM code — prompt injection, token cost, tool safety | Any LLM API calls |
| performance-profiler | Systematic profiling — measure before optimising | Performance regressions |
Skill Library (20)
| Skill | Use Case | Gate Type |
| using-a-team | Meta — enforced at every session start | Hard gate |
| verification-before-completion | Prove it works before claiming done | Hard gate |
| brainstorming | Before any new feature/component | Hard gate |
| subagent-driven-development | Execute plans with per-task subagents | Workflow |
| systematic-debugging | Any bug — root-cause first | Hard gate |
| test-driven-development | RED before GREEN before REFACTOR | Hard gate |
| using-git-worktrees | Isolated workspace before development | Workflow |
| executing-plans | Run a written plan in current session | Workflow |
| dispatching-parallel-agents | 2+ independent problems simultaneously | Workflow |
| writing-plans | Create structured implementation plans | Workflow |
| finishing-a-development-branch | Wrap up a branch before merge | Workflow |
| writing-skills | Create new A Team skills via TDD | Meta |
| skill-duplication-audit | Detect overlapping skills across packs — classify pairs as duplicate / partial overlap / complementary / false positive | Workflow |
| api-contract-first | Design API contract before writing any endpoint | Hard gate |
| incident-response | Production incident playbook (detect → contain → resolve → post-mortem) | Workflow |
| data-migration | Safe schema changes with rollback strategy | Hard gate |
| performance-audit | Baseline → profile → optimise → validate with numbers | Workflow |
| architecture-audit | Map system as-built → parallel specialist reviews → severity verdicts | Workflow |
| five-whys | Root-cause investigation through 5-Why analysis | Workflow |
| smart-init | ROADMAP-aware session initialization | Workflow |
Orchestrator Init & Pruning Protocol
When you run /orchestrate init:
- The Lead Orchestrator reads
INIT.md(your project scope document). - It evaluates each agent and skill against the declared scope.
- It deletes files that are irrelevant (e.g., removes
go-reviewer.mdfrom a Python-only project). - It generates
.agent-sync/TEAM.md— permanent record of active agents. - It generates
.agent-sync/ROUTING.md— task routing table for this project.
The pruned workspace is leaner and agents no longer have access to context that doesn't apply.
Session Enforcement
Every session start triggers the hooks/session-start.md content via the SessionStart hook.
This injects the using-a-team meta-skill into session context, which enforces:
- Skills must be consulted before action
verification-before-completionbefore any "done" claimcode-reviewerafter every code change- Language-specific reviewers for Go/Python/Rust changes
Standards
All agents enforce the rules in .claude/rules/:
- orchestration.md — Orchestrator state machine, init/prune, veto buffer protocol
- coding-style.md — Immutability, KISS, DRY, YAGNI, naming conventions
- security.md — Secrets, injection, auth, OWASP mandatory checks
- testing.md — TDD, 80% coverage, unit + integration + E2E
- git-workflow.md — Conventional commits, PR process
- performance.md — Model selection, context window management
- agents.md — Parallel execution, agent selection rules
- patterns.md — Repository pattern, API envelopes, error handling
Cross-Platform Support
| Platform | Config |
| Claude Code | .claude/ (native) |
| Cursor | .cursor-plugin/plugin.json |
| Codex CLI | .codex-plugin/plugin.json |
| GitHub Copilot CLI | .copilot-plugin/plugin.json |
| OpenCode | .opencode/commands/ |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

