whatisgithub

What is ainous-team?

xalbert1d/ainous-team — explained in plain English

Analysis updated 2026-05-18

1ShellAudience · developerComplexity · 4/5Setup · moderate

In one sentence

A Claude Code plugin that adds a 12-role team of specialized coding agents with shared memory that improves over time.

Mindmap

mindmap
  root((Ainous Team))
    What it does
      Multi-agent Claude Code plugin
      12 roles with memory
      Learns over sessions
    Tech stack
      Shell scripts
      Python hooks
      Claude Code CLI
    Use cases
      Delegate feature work
      Security scans
      Bug fixes
      Team retrospectives
    Audience
      Developers
      Claude Code users
    Setup
      Install marketplace
      Run team-init
      Choose mode

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Delegate a feature request to a coordinator that spawns researcher, architect, developer, and tester roles automatically.

USE CASE 2

Run a security-focused review of your codebase using the dedicated security role.

USE CASE 3

Track which coding strategies work over time so the team avoids repeating past mistakes.

USE CASE 4

Review team retrospectives to see how different agent roles collaborated on a task.

What is it built with?

ShellPythonBashClaude Code

How does it compare?

xalbert1d/ainous-teamanthonyhann/knowledge-wikibaiyuetribe/test-heroku
Stars111
LanguageShellShellShell
Last pushed2021-06-30
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity4/53/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the Claude Code CLI, Python 3.6+, bash 3.2+, and git already installed.

So what is it?

Ainous Team is a plugin for Claude Code, the command-line coding assistant, that turns it into a persistent team of specialized agents instead of one general assistant. It sets up 12 named roles, such as coordinator, developer, architect, tester, researcher, writer, security, and authority, each with its own playbook and 57 shared skills split between orchestration and domain expertise. The idea is that these roles remember what worked and what did not across sessions, so strategies that succeed get reinforced and ones that fail get retired over time. After installing the plugin through Claude Code's plugin marketplace system, you run a setup command that walks you through picking an operating mode and creates starter files for all 12 roles on your machine. There are two modes: a coordinator-as-default mode, where Claude automatically plans a task, hands pieces of it to the right role, and combines the results, so you can just describe what you want in plain language, and an agent mode, where you manually call on specific roles yourself, like asking the developer role to fix a bug or the security role to scan code. When the coordinator handles a task, it chooses an approach based on what kind of work it is (a quick bugfix versus a full feature, for example), spawns the needed teammates with context and instructions, and checks their work against verification gates between steps, such as requiring tests to pass before moving on. It also holds a review after each task to look at how the roles worked together and to pick up on any corrections you made by hand. The project is built on top of several published ideas about multi-agent coordination, including shared team memory, feedback from user corrections, and periodic team retrospectives. It requires the Claude Code CLI, Python 3.6 or newer, a recent version of bash, and git for tracking what the team has learned. This is aimed at developers already using Claude Code who want a more structured, memory-aware way to delegate coding tasks. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Install the Ainous Team plugin marketplace and set it up in coordinator-as-default mode.
Prompt 2
Use @coordinator to implement user authentication for my API.
Prompt 3
Run /team-status to show the current state of the agent team.
Prompt 4
Explain what happens when @developer and @tester loop on a failing test.
Prompt 5
Show me how to switch from agent mode to coordinator-as-default mode.

Frequently asked questions

What is ainous-team?

A Claude Code plugin that adds a 12-role team of specialized coding agents with shared memory that improves over time.

What language is ainous-team written in?

Mainly Shell. The stack also includes Shell, Python, Bash.

How hard is ainous-team to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ainous-team for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.