These pages document master, which is unreleased and in development. The Quick Start installs the latest stable release; anything newer than that tag is marked in the text.
Documentation — all of it, grouped
Everything written down about Code Copilot Team, grouped the way the Studio’s Learn tab groups it — this page and that tab read the same registry, so they cannot disagree about what exists.
These pages are also published as a searchable site at
https://gosha70.github.io/code-copilot-team/, built from master by
.github/workflows/pages.yml.
New here? The Quick Start installs the harness in about five minutes, and the five-minute paths prove each major piece works.
Two of these pages are generated and carry a banner saying so: the Feature Index and the Configuration Reference. Fix a generated page by editing its source, never the page.
Start here
Section titled “Start here”- Documentation — all of it, grouped — Everything written down about Code Copilot Team, grouped the way the Studio’s Learn tab groups it — this page and that tab read the same registry, so they cannot disagree about what exists
- Code Copilot Team — README — An enforceable harness for AI-assisted coding: your rules, your workflow and your safety rails, applied the same way by every coding agent you use
- Developer Cookbook — the SDLC of this project — How a change moves from idea to merged PR in code-copilot-team, in two modes:
- Auto code review — setup cookbook — How to have a second model review your work automatically: which reviewer, what goes in the provider profile, how to prove it works before it gates a run, how to turn it on per session and per unattended build, and where to read the result
- Feature Index — generated from its sources; edit the source, not the page
- Feature maturity, release state and adapter support — The feature catalog (
shared/features/catalog.yaml) records four separate things about every user-facing feature - Shape-Up Workflow — Shape-Up is Basecamp’s product development methodology
- Spec-Driven Development vs Code Copilot Team — A side-by-side comparison of two complementary approaches to AI-assisted software development
Feature guides
Section titled “Feature guides”- Spec-Driven Development (SDD) — The specification, plan and task artifacts a feature needs before code is written, the gates that enforce them, and what each adapter can do about it
- Peer Review (Multi-Copilot) — How a second model reviews your work: the round, the verdict contract, the findings file, the fallback chain, and every switch that turns it on
- Unattended auto-build — The driver that builds an approved feature phase by phase outside a session, and the four gates that decide whether a phase lands: the caps that stop a run, the coverage contract, the runtime conformance evaluator, and the visual verification gate
- LLM Routing — Routing an auto-build task to a backend by route class and role, under an execution profile
- Project Templates — The eleven stack templates, what each one’s agent team looks like, and the CI workflow each ships
- Configuration Reference — generated from its sources; edit the source, not the page
- Repo Structure — Where everything lives in this repository, for contributors
- Configuration Layers — Where each rule, skill, agent and hook is installed, and which layer wins when two of them say different things. More specific always wins: a project’s
CLAUDE.mdoverrides the global manifest, andCLAUDE.local.mdoverrides both - Install Options — Every install path, for every tool
Analytics & benchmarks
Section titled “Analytics & benchmarks”- Session Analytics — user cookbook — Session Analytics reads the transcripts your AI coding assistant leaves on disk (Claude Code, Aider, Pi), stores them in a local database, and opens a Studio where you can see what happened in your sessions, find what to fix in your harness, and measure whether the numbers can be trusted
- Session Analytics — Copilot session analytics & process-mining pipeline (issue #63) — the Claude Code analyzer, mirroring the architecture of the upstream kiro-analyzer (which already covers Kiro)
- Benchmark Harness — Benchmark-agnostic runner for evaluating AI copilots and LLMs on coding tasks under reproducible isolation, with deterministic scoring and SDD-aware run records
- Knowledge Layer — A durable, structured knowledge layer for
code-copilot-team, designed to be read and maintained by both humans and AI agents, and to outlive any single session - CCT Capability Compatibility Matrix — generated from its sources; edit the source, not the page
Judge on a DGX Spark
Section titled “Judge on a DGX Spark”- DGX Spark — setup & cookbook (Ollama, vLLM, Open WebUI) — Revision 2 — 2026-09-07. Changes from revision 1 are listed in What changed and why at the end
- DGX Spark + vLLM — Qwen3.8-27B operator manual — Revised 2026-08-28. Two different things are being tracked here, and conflating them is the main way to misread this document. The model is verified on this hardware class. A published run on a single GB10 with 121.63 GiB usable brought up
unsloth/Qwen3.8-27B-NVFP4on vLLM0.26.1rc1at the native 262,144-token window, with no vLLM modifications, and exercised reasoning, tool calling, MTP speculative decoding, long context and memory. vLLM has since published an official Qwen3.8-27B recipe (updated 2026-08-26) covering the NVFP4 checkpoint, FP8 KV cache, the Qwen reasoning parser, structured tool calling and MTP - DGX Spark — Qwen3.8-27B runbook (exact sequence) — Two machines
- Wiki Overview —
knowledge/wiki/is the project’s curated knowledge layer - Glossary — Short canonical definitions of terms used across this project
Background
Section titled “Background”- Evidence & Influences — External reviews, scorecards, and the sources that shaped this harness
- Case study: an A/B autonomous build of MAP-ATLAS (Claude Code vs pi.dev) — A hands-off experiment: two AI coding harnesses built the same open-source product — MAP-ATLAS (repository not yet public), a domain-agnostic TypeScript mapping engine — from an identical, harness-neutral specification, phase by phase, and were scored on a fixed rubric with every claim independently verified
- GitHub Hardening Playbook — This playbook sets repository-level guardrails that complement in-repo checks
What is not listed here
Section titled “What is not listed here”Skills (shared/skills/), agents (adapters/claude-code/.claude/agents/) and
the adapter guides under adapters/*/docs/ are served in Learn by directory,
so they have no fixed list. Browse them there, or run scripts/cct list for
every command, skill and capability the harness offers.