English ยท ็ฎไฝไธญๆ ยท ๆฅๆฌ่ช ยท ํ๊ตญ์ด ยท Franรงais ยท Deutsch ยท ะ ัััะบะธะน ยท Espaรฑol ยท Italiano
A Golang-based AI coding orchestration platform. It owns no LLM itself; instead it dispatches external AI coding CLIs (Codex & OpenCode as real drivers; Claude-Code & DeepSeek-DSH as stubs), simulates a 9-role software-development team that collaborates over the A2A protocol, enforces a deterministic quality gate with governance auditing, ships in containers, and exposes four protocols externally โ gRPC, MCP, ACP, and A2A โ alongside a TypeScript TUI client.
- Orchestration vs execution separation โ The Coordinator only orchestrates and never writes code; host CLIs only execute and never decide.
- Container-as-role โ 9 team roles (PM, Architect, Frontend, Backend, QA, Security, DevOps, โฆ), each in its own container, independently scalable and replaceable.
- A2A protocol collaboration โ Structured inter-agent communication, supporting InProc (development) and Redis Pub/Sub (containerized).
- Deterministic quality gate โ Hard-executed by
golangci-lint+go vet+go test; never relies on model self-evaluation. - RAG knowledge base + project memory โ BM25 retrieval injected into context; the memory store accumulates failure lessons and historical solutions.
- Four external protocols โ gRPC (TUI communication), MCP (external tool integration), ACP (standard Agent client), A2A (cross-instance mesh).
- Local-first โ Code never leaves the container; no API keys are held; all auth is delegated to the underlying host CLI.
User โ TypeScript TUI (Ink) โ gRPC โ Coordinator
โโโ Router (intent routing)
โโโ Planner (DAG plan)
โโโ Scheduler (role dispatch)
โ โโโ A2A Bus โ Reviewer Agents (parallel)
โ โโโ Single-Writer Lock โ Writer Agents (serial)
โโโ Knowledge (BM25 RAG retrieval)
โโโ Memory (facts/pitfalls/lessons)
โโโ Quality Gate (deterministic checks)
โ
Host CLIs: Codex (real) | OpenCode (real) | Claude (stub) | DSH (stub)
See docs/04-็ณป็ปๆถๆๅพ.md for the full architecture diagrams.
# Build
go build -o bin/aicodingagentteam ./cmd/aicodingagentteam
# Initialize a project
./bin/aicodingagentteam init
# Run a full pipeline
./bin/aicodingagentteam run "Build a REST API" --backend codex
# Quick edit
./bin/aicodingagentteam quick "Fix the login button style"
# Quality verification
./bin/aicodingagentteam verify
# RAG knowledge base demo
./bin/aicodingagentteam knowledge demo
# Start the coordinator service (gRPC + A2A HTTP)
./bin/aicodingagentteam servecd tui && npm install && npm run build
# Start the coordinator
cd .. && go run ./cmd/aicodingagentteam serve
# Launch the TUI (in another terminal)
cd tui && node dist/cli.js
# Demo mode (no coordinator required)
node dist/cli.js --demodocker compose -f deploy/compose/docker-compose.yml up -d| Command | Description |
|---|---|
init |
Initialize project configuration |
run "requirement" |
Run the full pipeline |
quick "description" |
Lightweight quick edit |
verify |
Execute quality verification |
govern [--ci] [path] |
Governance scan |
report |
Emit compliance report |
serve |
Start coordinator (gRPC + A2A) |
knowledge index [dir] |
Index a directory into the knowledge base |
knowledge search "query" |
Retrieve top-5 knowledge chunks |
knowledge demo |
End-to-end RAG + memory demo |
version |
Print version |
agent_team/
โโโ cmd/aicodingagentteam/ # Go binary entry
โโโ internal/
โ โโโ a2a/ # A2A protocol (InProc + Redis)
โ โโโ acp/ # Agent Client Protocol
โ โโโ agent/ # 9-role registry
โ โโโ audit/ # Audit log
โ โโโ config/ # Configuration loader
โ โโโ coordinator/ # Orchestration core (5-layer flow)
โ โโโ governance/ # Governance rules (113+ rules)
โ โโโ host/ # Host drivers (codex/opencode/claude/dsh)
โ โโโ knowledge/ # RAG retrieval engine (BM25)
โ โโโ mcp/ # Model Context Protocol
โ โโโ memory/ # Project memory (facts/pitfalls/lessons)
โ โโโ planner/ # DAG plan builder
โ โโโ qualitygate/ # Quality-gate engine
โ โโโ router/ # Intent router
โ โโโ scheduler/ # Role scheduler + single-writer lock
โ โโโ types/ # Shared types
โโโ pkg/
โ โโโ api/ # gRPC proto + server
โ โโโ contracts/ # Front/back-end contracts
โ โโโ runtime/ # Host driver trait
โโโ tui/ # TypeScript TUI client
โโโ deploy/ # Containerized deployment
โโโ proto/ # gRPC proto definitions
โโโ docs/ # Documentation (requirements/architecture/plans/ADR/spec/plan)
| Dimension | Threshold | Actual |
|---|---|---|
| Go test coverage | โฅ 80% (core โฅ 90%) | router 100% ยท scheduler 96% ยท governance 96% ยท codex 94.9% |
| Lint | 0 new warnings | golangci-lint + eslint |
| Build | โค 5 minutes | CI full flow ~3 minutes |
| Security | 0 high-severity CVEs | govulncheck + npm audit |
make all # lint + vet + test + build
make test # Full test suite
make lint # golangci-lint
make run # build + serve- AGENTS.md โ Project standards (root doc)
- docs/01-้ๆฑๅๆๆๆกฃ.md โ Product requirements
- docs/02-ๆๆฏๆถๆ่ฎพ่ฎก.md โ Architecture design
- docs/03-็ณป็ป่ฎพ่ฎกไธๅฎๆฝ่งๅ.md โ Implementation plan
- docs/adr/ โ Architecture Decision Records (ADR-0001 ~ 0013)
- docs/CONSTRAINTS.md โ Quality red lines