Claude Team

Claude Team is an automated AI agent team, built both from and for BrewDocs and running on GitHub. It splits the work into roles, so each agent focuses on one job instead of doing everything at once. That started as a way to control turn costs and keep runs reliable, and it grew into something closer to a small managed engineering team.

BrewDocs was originally hand-written, with some light AI assistance in its less mature days. Nowadays, virtually every line of code is managed and authored by Claude Code running on GitHub.

Clear Workflows

Work is organized using GitHub Issues as Epics • Stories • Tasks

Compartmentalized roles

ArchitectShapes the work: turns a rough idea into a plan, and splits it into pieces small enough to finish.ResearcherInvestigates the questions nobody has answered yet, and leaves a recommendation.ImplementorWrites the app code, one piece at a time.DesignerOwns the look and feel: the shared buttons, inputs and type everything else is built from.TesterWrites the checks, from what the product promised rather than from what got built.WriterKeeps the written record straight: what the product does, and why it works the way it does.SecurityReviews every change that ships, and raises what it finds.

Reasonable check-ins

Claude Team is more a pattern for running Claude Code on GitHub than a fixed framework, since much of the instruction can be generated by AI. The dedicated repo has the details.

Read the source