# core-ai-native

> The AI-Native Code Discipline v0.2 (BETA) - language-independent principles, pattern cards, executable-scaffold catalog, and raid playbook for code optimized for comprehension and safe modification by AI agents

A community documentation of nothing it declares, published by org.vibevm.ai-native, in en.
Read it at /doc/org.vibevm.ai-native/core-ai-native/1.0.0/. Rendered 2026-09-12.

The AI-Native Code Discipline v0.2 (BETA) - language-independent principles, pattern cards, executable-scaffold catalog, and raid playbook for code optimized for comprehension and safe modification by AI agents

## For agents

- [Boot snippet](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/boot-snippet/): `org.vibevm.ai-native/core-ai-native@1.0.0` contributes a boot snippet: text that a session reads before it starts work, placed into the project's generated boot lane by `vibe install`. It is not read on this page — it is read by the agent. (1 min · user, agent)

## Pages

- [The AI-Native Code Discipline — Manifesto](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/00-MANIFESTO/): **Discipline v0.2 · status: BETA · supersedes DISCIPLINE-CHARTER-v0.1** (10 min)
- [The AI-Native Pattern Card Format](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/01-PATTERN-CARD-FORMAT/): **Discipline v0.2 · status: BETA · T1 · supersedes part of GUIDE-SPEC-AUTHORING-v0.1** (7 min)
- [Executable Scaffolds — The Runnable-Capital Catalog](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/02-EXECUTABLE-SCAFFOLDS/): **Discipline v0.2 · status: BETA · T1** (3 min)
- [The Raid Playbook — Layered Refactoring Sweeps](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/03-RAID-PLAYBOOK/): **Discipline v0.2 · status: BETA · T1** (3 min)
- [The Sweep Playbook — the standing guardian](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/04-SWEEP-PLAYBOOK/): **Discipline v0.2 · status: BETA · T1 · language-neutral** (6 min)
- [The Campaign Form — plans, baselines, and the paper trail](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/05-CAMPAIGN-FORM/): **Discipline v0.2 · status: BETA · T1 · language-neutral** (4 min)
- [The WAL Convention — session-durable project state](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/06-WAL-CONVENTION/): **Discipline v0.2 · status: BETA · T1 · language-neutral · OPTIONAL but preferred** (3 min)
- [Atlas — Findings Ledger (human view)](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/appendix/ATLAS/): **Discipline v0.2 · BETA · appendix · GENERATED from findings.jsonl (A2: derived, do not hand-edit)** (24 min)
- [Contradiction Map — Synthesis Provenance](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/appendix/CONTRADICTION-MAP/): **Discipline v0.2 · BETA · appendix** (4 min)
- [Discipline v0.2 (BETA) — boot snippet](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/boot/10-flow-core-ai-native/): This project follows the AI-Native Code Discipline. (1 min)
- [GUIDE — C++ (MISRA C++:2008 profile) under the Discipline, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-CPP-MISRA2008-v0.1/): **Status.** Beta; one of three sibling C++ profiles (`cpp-traditional`, `cpp-modern`, `cpp-misra2008`). Sections isomorphic vertically and horizontally. **Precedence rule of this profile:** where a Discipline binding and a MISRA guideline conflict, MISRA wins; the Discipline may only *add* strictness, never relax — the same only-stricter direction the GRP matrix itself enforces. (8 min)
- [GUIDE — C++ (Modern profile) under the Discipline, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-CPP-MODERN-v0.1/): **Status.** Beta; one of three sibling C++ profiles (`cpp-traditional`, `cpp-modern`, `cpp-misra2008`). Sections isomorphic vertically (Rust/TS/Python guides) and horizontally (sibling profiles). Profile granularity is per build target; cross-profile boundaries follow the adopted-code semantics referenced in the Traditional guide's header. (6 min)
- [GUIDE — C++ (Traditional profile) under the Discipline, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-CPP-TRADITIONAL-v0.1/): **Status.** Beta; one of three sibling C++ profiles (`cpp-traditional`, `cpp-modern`, `cpp-misra2008`). Section structure is isomorphic vertically (to the Rust/TS/Python guides) and horizontally (across the three profiles — diff them; the profiles rewire *bindings*, never principles). Profile granularity is **per build target**: one repository may host targets under different profiles; a cross-profile boundary is treated as an adopted-code relationship (see `GUIDE-CPP-MISRA2008-v0.1.xml` §0, which imports that semantics from MISRA Compliance:2020 §6). (7 min)
- [GUIDE — Go under the Discipline, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-GO-v0.1/): **Status.** Beta; fifth language guide. Sections isomorphic to the Rust/TS/Python/C++ guides — diff them across languages; that is the genre's contract. (8 min)
- [GUIDE — Java + GraalVM Native Image under the Discipline, v0.1 (overlay)](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-JAVA-GRAALVM-v0.1/): **Status.** Beta; overlay on `GUIDE-JAVA-v0.1.xml`. Composes with the Spring overlay (Boot AOT) and with Jakarta-family runtimes built for ahead-of-time CDI; only named sections are rewired. (4 min)
- [GUIDE — Java + Jakarta EE / MicroProfile under the Discipline, v0.1 (overlay)](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-JAVA-JAKARTA-v0.1/): **Status.** Beta; overlay on `GUIDE-JAVA-v0.1.xml`. Composes with the GraalVM overlay via build-time-CDI runtimes; never with the Spring overlay (one container per target). Only named sections rewired. (3 min)
- [GUIDE — Java + Spring under the Discipline, v0.1 (overlay)](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-JAVA-SPRING-v0.1/): **Status.** Beta; overlay on `GUIDE-JAVA-v0.1.xml` (the trunk). Only the sections named here are rewired; everything else — carrier, naming, errors-as-sealed-results, suppression policy, risk rows — is inherited. Composition: combines with the GraalVM overlay (Spring Boot AOT); never with the Jakarta overlay (one container per target). (4 min)
- [GUIDE — Java under the Discipline, v0.1 (trunk)](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-JAVA-v0.1/): **Status.** Beta; sixth language. Java ships as a **trunk plus three overlays**, in the owner's priority order: this trunk, then `GUIDE-JAVA-SPRING`, `GUIDE-JAVA-GRAALVM`, `GUIDE-JAVA-JAKARTA`. An overlay presupposes the trunk and rewires only the sections it names; everything unstated is inherited. **Composition matrix:** SPRING+GRAALVM legal (Boot AOT); JAKARTA+GRAALVM legal (build-time CDI implementations); SPRING+JAKARTA illegal (one container per target). Sections remain isomorphic to the other language guides — diff them. (8 min)
- [GUIDE — Kotlin under the Discipline, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-KOTLIN-v0.1/): **Status.** Beta; seventh language. One document by the owner's structure: **Part I is the trunk** (core Kotlin), **Parts II–IV are inline area overlays** that inherit it and rewire only named sections. The trunk is sovereign — Kotlin Multiplatform makes the JVM just one target, so this is *not* an overlay on the Java trunk; instead, Part II **composes** with the Java ecosystem overlays (Spring) at the JVM, and Part IV defines the Discipline's first **inter-trunk boundary** (Kotlin/JS ↔ `GUIDE-TYPESCRIPT`). Sections stay isomorphic to the other guides. (10 min)
- [GUIDE — Python under the Discipline, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-PYTHON-v0.1/): **Status.** Beta; third T2 guide. Section structure is isomorphic to `GUIDE-RUST-v0.1.md` and `GUIDE-TYPESCRIPT-v0.1.xml` — the guides are meant to be diffed across languages. Scope: only what the axioms require. (8 min)
- [GUIDE — TypeScript/JavaScript under the Discipline, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/legacy-projections/GUIDE-TYPESCRIPT-v0.1/): **Status.** Beta; second T2 guide. Section structure is deliberately isomorphic to `GUIDE-RUST-v0.1.md` — cross-language diffing of the guides is a feature of the discipline, not a coincidence. Scope: only what the axioms require; formatting and generic style live in tooling. (7 min)
- [Package manifest](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/manifest/): What `org.vibevm.ai-native/core-ai-native@1.0.0` declares about itself. Everything on this page is the package's own manifest, read and shown — nothing here is an opinion about the package. (1 min · user, dev)
- [BROWNFIELD — Terraforming unfinished projects, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/mechanisms/BROWNFIELD-PROTOCOL-v0.1/): **Status.** Beta. (6 min)
- [ENGINE — conform: the cross-language conformance engine, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/mechanisms/ENGINE-CONFORM-v0.1/): **Status.** Design, beta. (10 min)
- [LEDGER — the intent ledger, v0.1](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/mechanisms/LEDGER-INTENT-v0.1/): **Status.** Design, beta. (7 min)
- [MCP-CORE v0.1 — the neutral MCP server transport](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/mechanisms/MCP-CORE-v0.1/): **Status:** SHIPPED with discipline-core 0.6.0 (MCP-SOVEREIGNTY-PLAN Wave 2); the flow foundation is named core-ai-native since the package-family rename (PROP-028), and the crate ships as core-ai-native-mcp. (3 min)
- [PROP-014 — specmap: bidirectional spec↔code traceability and the source metamodel](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/mechanisms/PROP-014-specmap-bidirectional-traceability/): **Status.** Design proposal v0.1 — not implementation-locked. (24 min)
- [core-ai-native — README](/doc/org.vibevm.ai-native/core-ai-native/1.0.0/readme/): The README of `org.vibevm.ai-native/core-ai-native@1.0.0`, as the package ships it. (2 min · user, dev)