Engineering Docs

Procedural Cognitive Runtime Architecture — public engineering docs for ai-native-sdlc.org.

Start here

1. Architecture — runtime harness thesis (read first)
2. How It Works — condensed entry + doc map

The framing

Concept	Definition
Runtime harness	.sdlc/ + materialization + gates — the architecture
Runtime adapter	{specialization_layer}/ — reference implementation binding (cursor, claude, …)
Procedural DSL	sdlc.yaml — operational source of truth
Materialization	init, doctor, gate scripts — DSL → verifiable state
Playbook	Atomic procedural specification — not documentation
Workflow layer	Delivery methodology (AIDLC-style) — sits on top
Runtime substrate	AI Native SDLC — sits underneath

The agent coordinates. The harness governs. The LLM infers.

Guide

Document	Subject
Materialization	Init learns repo, generates integration manifests
Workflow vs Runtime	Workflow layer (AIDLC) vs runtime substrate
Workflows	DSL stage contracts
Lifecycle	End-to-end execution
Gates	Deterministic transitions

Architecture

Document	Subject
Composition Stack	Expertise externalization layers
Operational Layer	Harness directory and DSL
Runtime Layer	Adapter binding contract
Observability	Dual trace layers
Context Economics	Hydration and token budget

Plug-ins

Document	Subject
Integrations	Close SDLC cycles — generated at init
Playbooks	Domain procedures — lazy provision
Distribution	Install commands

Install

npx @jambu/ai-native-sdlc@latest install
ai-native-sdlc install --runtime cursor   # reference implementation

System map

         Workflow Layer (AIDLC-style methodology)
                         │
         ┌───────────────▼───────────────┐
         │  Runtime Harness (.sdlc/)     │
         │  DSL · gates · materialization│
         └───────────────┬───────────────┘
                         │
         ┌───────────────▼───────────────┐
         │  Runtime Adapter (.cursor/…)  │
         │  hooks · commands · agents    │
         └───────────────┬───────────────┘
                         │
         ┌───────────────▼───────────────┐
         │  Application (target_root/)   │
         │  any language · any structure │
         └───────────────────────────────┘

ADR index

ID	Decision
ADR-009	E2E orchestration composes workflows
ADR-010	Playbooks as domain procedural units
ADR-011	Distributable SDLC two-phase init
ADR-012	Deterministic gate matrix