Run any project like a top company, with an AI team in Claude Code
ai-organization turns Claude into the CEO of a right-sized team of subagents. It hires only the roles a job needs, vets their skills, applies Karpathy's methods, gates code on modern CI/CD, and ships only after independent QA proves it works.
/plugin marketplace add azharudh33n/ai-organization
/plugin install ai-organization@ai-organization
Why teams use it
Right-sized, not bloated
Solo, Squad or Company tier, chosen before anyone is hired. A README fix stays a one-person job.
Separation of duties
Whoever builds a deliverable never grades it. Benchmarks, acceptance tests, reviews and fact-checks go to someone else.
Karpathy's operating system
Think before acting, simplicity first, surgical changes, and checks that pass or fail. A locked-eval loop handles any metric goal.
CI/CD sized to the project
A lean baseline for every project. Merge queues, OIDC, provenance, staging and canary releases only when the stakes call for them.
Independent QA
A fresh agent that never saw the build checks every Definition of Done item and records evidence.
Token-efficient
About 2,000 tokens on trigger. Playbooks load only for the departments you staff.
How it works
- Size the job: Solo, Squad or Company.
- Brief and Definition of Done: 5–10 criteria, each a test, metric or inspection.
- Org chart: the smallest team that covers the DoD without letting builders grade their own work.
- Talent sourcing: skills come from your repo's roster or skills.sh, pass an independent-audit vetting gate, and are installed pinned to a commit so cloud sessions start with them.
- Hiring: one tight job brief per subagent, with handoffs of 200 words or less.
- Plan and execute: rolling-wave plan, parallel lanes, CI/CD before features.
- Independent QA: evidence for every DoD item.
- Review, delivery and retro: you approve anything irreversible before it happens.
Install
Claude Code plugin:
/plugin marketplace add azharudh33n/ai-organization
/plugin install ai-organization@ai-organization
Manual:
git clone https://github.com/azharudh33n/ai-organization
cp -r ai-organization/skills/ai-organization ~/.claude/skills/
Claude app: download ai-organization-skill.zip from the latest release and upload it as a custom skill.
FAQ
What is a Claude Code skill?
A folder with a SKILL.md file that Claude loads when a task matches its description, following the open Agent Skills specification. ai-organization is a skill packaged as a Claude Code plugin.
How is it different from just using subagents?
Subagents are the workers. ai-organization is the management layer: how many to hire, what each may touch, which skills they load, and what evidence counts as done.
Does it work without subagents?
Yes. Claude plays each role in sequence and keeps the same briefs and quality gates.
Will it use a lot of tokens?
No. Small jobs skip the ceremony, playbooks load on demand, and plans are detailed one milestone at a time.