Code Rooms
# Toolchain Boundary
KOGNIT1V is a cognitive skills pack, not a full machine image.
Installing it gives an agent Max's operating posture: the skills, contracts,
examples, proof discipline, and bootstrap checks needed to work agent-first.
It does not silently install every runtime Max uses locally.
## What Comes Bundled
| Layer | Included |
| --- | --- |
| Codex skills | `skills/*` copied into a Codex skills directory |
| Agent contracts | `AGENTS.md`, `docs/AGENT_OPERATING_MANUAL.md`, contracts, examples |
| Proof checks | `npm run validate`, `npm run smoke:install`, `npm run proof` |
| Bootstrap | `scripts/bootstrap-kognit1v.mjs` for install and doctor reports |
| Helper scripts | Portable scripts inside bundled skills, such as m1nd probing, Git reputation linting, local bridge helpers, and Brotherizer runtime guidance |
| GitHub validation | `.github/workflows/validate.yml` |
## What The Host Must Provide
| Tool | Needed for | Install behavior |
| --- | --- | --- |
| Codex or compatible runtime | Loading and invoking skills | External; not bundled |
| Node.js `>=20` | Validation, bootstrap, smoke install | External; required |
| Git | Repo hygiene, commits, optional dependency clone | External; checked |
| Python 3 | Some bundled skill helper scripts | External; checked |
## Optional Tools Max Often Uses
| Tool | Why it matters | KOGNIT1V behavior |
| m1nd | Graph-first repository investigation and structural context | Optional; checked by bootstrap; installed only with explicit m1nd flags |
| Cargo/Rust | Native m1nd runtime builds | Optional; checked |
| tmux | Multi-lane terminal coordination | Optional; checked |
| DEXT3R local companion | Session memory, project scope, m1nd flash, and Council-style perspectives | Optional; the public skill ships the operator contract, not the local service |
| Brotherizer source/runtime | Higher-fidelity voice preservation workflows | Optional; env-gated with `BROTHERIZER_ROOT`; no private checkout is bundled |
| Local Codex bridge runtime | Integrating with an existing local bridge workflow | Optional; the public skill ships the safe bridge contract only |
## What Is Not Included
- Private products, unreleased systems, or local project doctrine.
- Live API keys, provider credentials, tokens, or secrets.
- Codex itself.
- Hosted provider access.
- A full m1nd vendored checkout by default.
- The DEXT3R local service itself.
- Private voice packs, private donor repositories, or local-only archives.
- Any external mutation authority.
## Install Semantics
The default install is intentionally narrow:
```bash
npm run bootstrap -- --install-skills --codex-home "$CODEX_HOME"
```
That copies the cognitive skills into Codex.
m1nd is explicit:
npm run bootstrap -- --with-m1nd
npm run bootstrap -- --with-m1nd --install-m1nd
The first command checks. The second may clone/install. Neither happens during a
plain skill install.
## Tool Doctor
Run this when you want to know whether the current machine looks ready for the
full KOGNIT1V posture:
npm run doctor:tools
The report avoids printing secret values and treats optional tools as optional.
Missing optional tools should become a clear capability gap, not a fake claim.
