1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# INTERFACES.md - Interface Contracts Registry
**Authority:** interface (machine-readable contracts and invariants)
**Layer:** Interfaces
**Binding:** Yes
**Scope:** canonical index of binding interfaces
**Non-goals:** methodology guidance or subsystem tutorials
This registry defines the canonical binding interface surfaces.
---
## 1. Interface Contracts
| Document | Purpose | Binding |
|----------|---------|---------|
| `interfaces/CLAIMS.md` | Promises ledger with proof surfaces | Yes |
| `interfaces/CONTROL_PLANE.md` | Agent sequencing and interoperability | Yes |
| `interfaces/DOC_RULES.md` | Doc compilation and graph semantics | Yes |
| `interfaces/GLOSSARY.md` | Normative term definitions | Yes |
| `interfaces/STORE_MODEL.md` | Store semantics and purity model | Yes |
| `interfaces/TESTING.md` | Verification and proof claim contract | Yes |
| `interfaces/ARCHITECTURE_FOUNDATIONS.md` | Architecture quality primitives and governed artifact contract | Yes |
| `interfaces/KNOWLEDGE_SCHEMA.md` | Knowledge schema + invariants | Yes |
| `interfaces/KNOWLEDGE_STORE.md` | Knowledge store semantics + promotion firewall contract | Yes |
| `interfaces/MEMORY_SCHEMA.md` | Memory schema + retrieval-event contract | Yes |
| `interfaces/DEMANDS_SCHEMA.md` | User-demand schema + precedence rules | Yes |
| `interfaces/RISK_POLICY_GATE.md` | Deterministic PR risk-policy gate semantics | Yes |
| `interfaces/INTERNALIZATION_SCHEMA.md` | Internalized context artifact schema + lifecycle contract | Yes |
| `interfaces/jsonschema/internalization/*.json` | Stable JSON Schemas for internalization manifests and CLI results | Yes |
| `interfaces/AGENT_CONTEXT_PACK.md` | Agent context-pack layout and mutation contract | Yes |
| `interfaces/PROJECT_SPECS.md` | Canonical local `specs/*.md` contract and constitution mapping | Yes |
---
## 2. Decision Rights (Routing)
- Proof claims and testing obligations: `interfaces/TESTING.md`
- Architecture delivery primitives and artifact contract: `interfaces/ARCHITECTURE_FOUNDATIONS.md`
- Knowledge structure and validation: `interfaces/KNOWLEDGE_SCHEMA.md`
- Memory structure and retrieval-event semantics: `interfaces/MEMORY_SCHEMA.md`
- User demand typing and precedence: `interfaces/DEMANDS_SCHEMA.md`
- Deterministic PR risk policy and evidence discipline: `interfaces/RISK_POLICY_GATE.md`
- Agent memory/context pack semantics: `interfaces/AGENT_CONTEXT_PACK.md`
- Canonical local project specs contract: `interfaces/PROJECT_SPECS.md`
- Internalized context artifact lifecycle: `interfaces/INTERNALIZATION_SCHEMA.md`
- Internalization JSON schemas:
- `interfaces/jsonschema/internalization/InternalizationManifest.schema.json`
- `interfaces/jsonschema/internalization/InternalizationCreateResult.schema.json`
- `interfaces/jsonschema/internalization/InternalizationAttachResult.schema.json`
- `interfaces/jsonschema/internalization/InternalizationDetachResult.schema.json`
- `interfaces/jsonschema/internalization/InternalizationInspectResult.schema.json`
---
## Links
### Core Router
- [core/DECAPOD.md](core/DECAPOD.md) - **Router and navigation charter (START HERE)**
### Authority (Constitution Layer)
- [specs/INTENT.md](specs/INTENT.md) - **Methodology contract (READ FIRST)**
- [specs/SYSTEM.md](specs/SYSTEM.md) - System definition and authority doctrine
- [specs/SECURITY.md](specs/SECURITY.md) - Security contract
- [specs/GIT.md](specs/GIT.md) - Git etiquette contract
- [specs/evaluations/VARIANCE_EVALS.md](specs/evaluations/VARIANCE_EVALS.md) - Variance-aware evaluation contract
- [specs/evaluations/JUDGE_CONTRACT.md](specs/evaluations/JUDGE_CONTRACT.md) - Judge JSON/timeout contract
- [specs/engineering/FRONTEND_BACKEND_E2E.md](specs/engineering/FRONTEND_BACKEND_E2E.md) - Frontend/backend E2E governance contract
- [specs/skills/SKILL_GOVERNANCE.md](specs/skills/SKILL_GOVERNANCE.md) - Skills-to-kernel artifact and governance contract
- [specs/AMENDMENTS.md](specs/AMENDMENTS.md) - Change control
### Registry (Core Indices)
- [core/PLUGINS.md](core/PLUGINS.md) - Subsystem registry
- [core/METHODOLOGY.md](core/METHODOLOGY.md) - Methodology guides index
- [core/DEPRECATION.md](core/DEPRECATION.md) - Deprecation contract
### Contracts (Interfaces Layer - This Registry)
- [interfaces/CLAIMS.md](interfaces/CLAIMS.md) - Promises ledger
- [interfaces/CONTROL_PLANE.md](interfaces/CONTROL_PLANE.md) - Sequencing patterns
- [interfaces/DOC_RULES.md](interfaces/DOC_RULES.md) - Doc compilation rules
- [interfaces/STORE_MODEL.md](interfaces/STORE_MODEL.md) - Store semantics
- [interfaces/GLOSSARY.md](interfaces/GLOSSARY.md) - Term definitions
- [interfaces/TESTING.md](interfaces/TESTING.md) - Testing contract
- [interfaces/ARCHITECTURE_FOUNDATIONS.md](interfaces/ARCHITECTURE_FOUNDATIONS.md) - Architecture quality primitives
- [interfaces/RISK_POLICY_GATE.md](interfaces/RISK_POLICY_GATE.md) - Deterministic PR risk-policy gate
- [interfaces/AGENT_CONTEXT_PACK.md](interfaces/AGENT_CONTEXT_PACK.md) - Agent context-pack contract
- [interfaces/PROJECT_SPECS.md](interfaces/PROJECT_SPECS.md) - Canonical local project specs contract
- [interfaces/KNOWLEDGE_STORE.md](interfaces/KNOWLEDGE_STORE.md) - Knowledge store and promotion firewall contract
### Operations (Plugins Layer)
- [plugins/TODO.md](plugins/TODO.md) - Work tracking
- [plugins/VERIFY.md](plugins/VERIFY.md) - Validation subsystem