What is CortexBuild?¶
In plain English
AI coding agents are great at writing plausible code — but they don't know the unwritten conventions your team already follows, so they quietly break them. CortexBuild reads your repo, captures those conventions as rules, and feeds them to every AI tool you use, plus runs every change through a fixed review pipeline.
The problem it solves¶
Every existing codebase has implicit conventions: how errors are handled, how auth is wired, how tests are structured, which patterns are banned. A generic AI agent can't see those conventions, so it produces pull requests that look right but violate your team's tribal knowledge.
CortexBuild turns that tribal knowledge into machine-enforced rules so future agent work obeys it — instead of relearning (and re-breaking) it every time.
Who it's for¶
- Any team adopting AI coding tools — Copilot, Claude Code, Codex, Cursor — that wants those tools to respect their codebase, not a generic average.
- IT and non-IT teams alike. You don't need to be a compiler engineer. The onboarding command does the analysis; you review plain-English rules and keep or drop them.
- Built for existing repos. CortexBuild works on the systems you already have — the messy, real, already-shipped codebase. It relies on the conventions your code already encodes, so it leans on existing convention signal rather than scaffolding from an empty repo.
The mental model¶
Two ideas carry the whole product:
-
Rules as a single source of truth (SSoT). You author governance rules once. CortexBuild renders them into the native format of every AI tool —
.github/copilot-instructions.md,CLAUDE.md,AGENTS.md,.cursor/rules/— so the same policy applies no matter which tool or model runs. -
A fixed agent review pipeline. Changes flow through a fixed, auditable sequence of specialised agents:
Planner → Critic → Builder → Tester → Security → Optimizer → PR Reviewer
Every change is planned, reviewed, built, and verified before it lands.
A third loop closes over time: a recurrence ledger records defects and their fixes so the same class of failure is caught earlier next time.
What you actually get¶
When you onboard a repo, CortexBuild writes a .cortexbuild/ folder containing a
human-readable onboarding report, a structural + dependency-graph analysis, a
technical-debt heatmap, and a starter rule pack — all committed to your repo,
under your control.
Beyond onboarding, the platform gives you:
- An always-current code graph —
cortexbuild graphkeeps the per-repo module-dependency graph fresh incrementally, andcortexbuild workspace graphrolls repos up into a cross-repo dependency map so a control plane can see how features connect across frontend, backend, and mobile. - Portable memory —
cortexbuild memory session save|restorecarries a tag-only working-context snapshot across devices and teammates ("continue where Alice left off"), scoped to a stable repo identity and consent-gated when synced. - Feature observability —
cortexbuild featuresshows every capability's tier, entitlement, and real utilization (including unused entitled features), with admin enable/disable that is subtract-only, signed, and audit-logged.
What CortexBuild does — and does NOT — do today (pre-alpha)
It does: analyse your repo, render rules to the AI coding tools you
already use (Copilot, Claude Code, Codex, Cursor), score conformance, run an
offline eval, and record a recurrence ledger. The deterministic checks
(eval, render --check, ledger guards) run with no LLM; optional rule
synthesis (--with-rule-synthesis) is propose-only.
It does NOT (yet): run the agents itself or open pull requests on its own. Your existing AI coding tools execute the rendered harness; CortexBuild makes them consistent, governed, and auditable. In-process agent execution and an autonomous PR engine are deferred, not shipped.
Next¶
→ Install the pre-alpha CLI, then Onboard Your Repo.