# three-man-team

> A structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.

- **URL**: https://www.freshcrate.ai/projects/three-man-team
- **Author**: russelleNVy
- **Category**: Frameworks
- **Latest version**: `v1.2.5` (2026-06-04)
- **License**: MIT
- **Source**: https://github.com/russelleNVy/three-man-team
- **Language**: Shell
- **GitHub**: 562 stars, 61 forks
- **Registry**: github (`russelleNVy/three-man-team`)
- **Tags**: `agent-skills`, `agent-workflow`, `ai-agents`, `claude`, `context-files`, `developer-tools`, `llm`, `markdown`, `prompt-engineering`, `shell`

## Description

A structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.2.5` | 2026-06-04 | High | ## What's Fixed  - **RICHARD.md → REVIEWER.md** — The line Arch uses to spin up Richard referenced a file that has never existed. Richard was failing to load his role file silently. ([#9](https://github.com/russelleNVy/three-man-team/issues/9)) - **BOB.md → BUILDER.md (root-level template)** — The v1.2.4 fix only reached one template path. This closes the gap for all install paths. - **Version check upgraded** — The simplified ping-and-link version check is replaced with the full procedure: trac |
| `v1.2.4` | 2026-05-27 | High | ## v1.2.4 — Bug fixes  Two fixes. If you're on v1.2.3, the version check has been silently broken since it shipped — this is the patch.  ---  ### What changed  **Version check tag extraction (fixes #8)** The version check instruction told Arch to "fetch and extract tag_name" without specifying how. Arch guessed a parsing method that silently failed and reported a false network error. Fixed — now uses `curl \| jq` as primary, `curl \| grep \| cut` as fallback for systems without jq. Both verified ag |
| `v1.2.3` | 2026-05-03 | High | ⏺ v1.2.3 — Auto-update check    Arch now checks for new releases at the start of every session. If you're behind, it tells you before doing anything else.  ###  For existing installs:    1. Add this as step 1 in your ARCHITECT.md Session Start section:   1. Version check — run: `curl -s https://api.github.com/repos/russelleNVy/three-man-team/releases/latest \| grep -o '"tag_name":"[^"]*"' \| cut -d'"' -f4`      Read `VERSION`. If the remote tag differs from local, tell the Project Owner be |
| `v1.2.1` | 2026-04-27 | High | There was /agents/ folder in the repo that was redundant. Removed, updated the system commands and the claude file. |
| `v1.2.0` | 2026-04-20 | High | **RTK URL (issue #2 + JBarrskog comment)**   - All 3 new-setup.md files: dropped the curl command, replaced with a link to github.com/rtk-ai/rtk + README instructions   - ARCHITECT-BRIEF.md: private fork URL → rtk-ai/rtk    **Windows (issue #1)**   - INSTALL.md: added a Windows section under Requirements — Git Bash/WSL for setup script, manual copy alternative, note that RTK is macOS/Linux only   - All 3 new-setup.md files: added Windows note in the RTK install block itself   **Model as |
| `V1.1.0` | 2026-04-03 | Medium | - Added new-setup.md — guided first-session onboarding handled by Arch: team naming, project context file, RTK install - Architect now spins up Builder and Reviewer via Agent tool (foreground only) — documented in ARCHITECT.md and INSTALL.md - Foreground-only requirement documented — background agents stall on Edit approval - Reviewer protocol upgraded: APPROVED / APPROVED WITH CONDITIONS / REJECTED replaces Must Fix / Should Fix - Reviewer now runs git diff first — diff is primary source of |
| `1.0.0` | 2026-03-31 | Medium | Initial public release.  - Three-agent team: Architect, Builder, Reviewer - Generic agents in agents/ with customizable personas and [CUSTOMIZE] placeholders - Named persona template in templates/project-folder/ (Arch, Bob, Richard) - Generic clean-slate template in templates/generic/ - Structured handoff files: ARCHITECT-BRIEF, REVIEW-REQUEST, REVIEW-FEEDBACK, BUILD-LOG, SESSION-CHECKPOINT - Token optimization rules baked into every session router - RTK integration guidance in docs/toke |

## Citation

- HTML: https://www.freshcrate.ai/projects/three-man-team
- Markdown: https://www.freshcrate.ai/projects/three-man-team.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/three-man-team/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._