whatisgithub

What is agent-team-brain?

adrian7411374113/agent-team-brain — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A file based operating system that gives AI agent teams persistent roles, shared task tracking, and a way to compress project context between sessions.

Mindmap

mindmap
  root((agent team brain))
    What it does
      Persistent agent roles
      Shared task state
      QA gates
    Tech stack
      JavaScript
      Node.js
      CLI
    Use cases
      Multi agent teams
      Context compression
      Learning loop
    Audience
      Developers
      AI builders

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

Set up persistent role profiles for a team of AI agents like Coordinator, Builder, and QA Reviewer

USE CASE 2

Track shared task state, project briefs, and handoffs across multiple agent sessions

USE CASE 3

Run a dream cycle to compress context so a new session can pick up a long project

USE CASE 4

Score task traces and roll up lessons into reusable agent playbooks

What is it built with?

JavaScriptNode.jsCLI

How does it compare?

adrian7411374113/agent-team-brainacip/slack-claude-agentadii0906/supportiq
Stars111
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/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 Node.js and running a CLI bootstrap command to scaffold the file structure.

So what is it?

Agent Team Brain is a JavaScript based operating system for organizing teams of AI agents around a shared, file backed structure instead of one long chat transcript. Rather than treating each agent as a one off task runner, it gives every role, such as Coordinator, Architect, UX Reviewer, Scout, Analyst, Builder, and QA Reviewer, a persistent profile stored as markdown, along with its own workspace for scratch notes and current focus. Work moves through a defined loop: a task is created, sized for risk, assigned to the right role, tracked for blockers, and documented through shared artifacts like project briefs and handoff notes. Once built, work passes through a QA gate before being closed out. After a task finishes, the system captures an after action review and a trace score covering things like clarity, execution, and coordination quality, then rolls these into lessons that can update a role's playbook over time. A notable feature is the dream cycle, a way to compress and preserve context so long projects do not depend on an ever growing chat history. Individual agents produce short summaries of their work, which a coordinator consolidates into project state files, decision logs, and a context pack. This lets a fresh session pick up where a previous one left off by loading the role profile, playbook, and context pack instead of full history. The system also supports rotating out overloaded runtime sessions while keeping the durable team identity intact in files. You install it by running a CLI bootstrap command from Node, which scaffolds config files, role definitions, workspaces, and templates into a target directory. A doctor command checks the setup and reports pass, warn, or fail results. This is aimed at people building or coordinating multi-agent AI systems who want a repeatable, auditable structure rather than ad hoc prompting.

Copy-paste prompts

Prompt 1
Help me bootstrap Agent Team Brain into my project using the CLI init command
Prompt 2
Explain how the dream cycle in Agent Team Brain compresses context between sessions
Prompt 3
Show me how to define a QA gate using Agent Team Brain's task state files
Prompt 4
Walk me through setting up persistent role profiles for a Builder and QA Reviewer agent

Frequently asked questions

What is agent-team-brain?

A file based operating system that gives AI agent teams persistent roles, shared task tracking, and a way to compress project context between sessions.

What language is agent-team-brain written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, CLI.

How hard is agent-team-brain to set up?

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

Who is agent-team-brain for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.