Skip to content

Commit cb7101d

Browse files
committed
v3.7 Pass 3c: park Part IX + agent-teams + spawning; do not expose Claude in spec
User directive: the v3.7 normative specification must not expose Claude as a named dependency, and must not include aspirational/partial chapters labelled as normative. Six chapters are moved out of the published spec tree and consolidated into parked/3.7-deferred.md for future revisiting. Moved to parked/3.7-deferred.md (repo root, outside docs/, not served): - subagent.md (CK as Subagent, Claude-specific /ck command) - streaming.md (Claude Code SDK framing) - web-shell.md (tooling/UX, not protocol) - evolution.md (persona/multi-model configuration tied to Claude) - agent-teams.md (labelled Future Capability) - spawning.md (task-engine + headless Claude Code; not settled) The deferred file has frontmatter `ingest: false`, `visibility: internal`, `revisit: pending`, and a header table explaining why each chapter was deferred. It lives at repo root so VitePress never renders it, sitemap never indexes it, and llms.txt does not reference it. Sidebar (docs/.vitepress/config.mts): - Part IX "Claude Integration" removed entirely - Part X "Governance" renamed to Part IX "Governance & Accumulation"; Agent Teams and Dynamic Spawning entries removed (parked) - "EXTENDS + CK.Claude" label changed to "EXTENDS" Internal-link fixes (dangling references to parked pages): - consensus.md: dropped "See CK Loop Evolution" cross-link - operator.md: "from the web shell" -> "from web console clients" - project.md: removed trailing "For more on the web console" pointer - sessions.md: replaced web-shell references with "subscribed clients"; replaced "Claude streaming" label with generic "agent-type kernel" - task-engine.md: removed subagent + streaming links; reframed the intro to speak of "authorized executor" without naming Claude introduction.md: - "CKP v3.7 is organised into ten parts" -> "nine parts"; table rewritten to match the actual spec structure (not legacy chapter counts that included the parked chapters) - Overview table dropped rows for Web Shell, Subagent, Streaming, Agent Teams; no more "Claude integration" language in The Shift paragraph (replaced with neutral "operator, auth, CRDs, reconciliation, consensus, graph store") - "Logical Analysis Note" now cites Sessions + Task Engine as the only planned-feature pages (was also flagging Agent Teams) changelog.md: - Revised the v3.7 header to "nine parts"; rewrote the Specification Scope table to match the nine-part structure; dropped the two "Claude Integration" part rows - Added an info callout naming the six deferred chapters and pointing to parked/3.7-deferred.md Assets: - llms.txt: removed the 6 parked-page URLs - sitemap.xml: removed the 6 parked-page <url> entries Not in this commit (still Claude-exposing in the published spec, to be handled in a follow-up pass once you confirm scope): - extends.md is built around CK.Claude as the canonical EXTENDS example - core.ttl AgentKernel class description names CK.Claude - taxonomy.md mentions CK.Claude as an agent kernel - crd.md `agent` enum description references extends.md - changelog.md prose elsewhere may still reference Claude Build clean; 31 v3.7 pages (was 37); all internal links resolve.
1 parent a43326f commit cb7101d

17 files changed

Lines changed: 1389 additions & 1344 deletions

‎docs/.vitepress/config.mts‎

Lines changed: 3 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ export default withMermaid(defineConfig({
9696
text: 'Part VI: Edges & Composition',
9797
items: [
9898
{ text: 'Edge Predicates', link: '/v3.7/edges' },
99-
{ text: 'EXTENDS + CK.Claude', link: '/v3.7/extends' },
99+
{ text: 'EXTENDS', link: '/v3.7/extends' },
100100
]
101101
},
102102
{
@@ -118,23 +118,12 @@ export default withMermaid(defineConfig({
118118
]
119119
},
120120
{
121-
text: 'Part IX: Claude Integration',
122-
items: [
123-
{ text: 'CK as Subagent', link: '/v3.7/subagent' },
124-
{ text: 'Streaming', link: '/v3.7/streaming' },
125-
{ text: 'Web Shell', link: '/v3.7/web-shell' },
126-
{ text: 'CK Loop Evolution', link: '/v3.7/evolution' },
127-
]
128-
},
129-
{
130-
text: 'Part X: Governance',
121+
text: 'Part IX: Governance & Accumulation',
131122
items: [
132123
{ text: 'CK.Consensus', link: '/v3.7/consensus' },
133124
{ text: 'Task Engine', link: '/v3.7/task-engine' },
134125
{ text: 'Ontological Graph', link: '/v3.7/graph' },
135-
{ text: 'Sessions & Agent Teams', link: '/v3.7/sessions' },
136-
{ text: 'Agent Teams', link: '/v3.7/agent-teams' },
137-
{ text: 'Dynamic Spawning', link: '/v3.7/spawning' },
126+
{ text: 'Sessions', link: '/v3.7/sessions' },
138127
{ text: 'PROV-O Provenance', link: '/v3.7/provenance' },
139128
]
140129
},

‎docs/public/llms.txt‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -31,16 +31,10 @@ CKP v3.7 is the current specification. v3.6 is frozen and remains browseable; ol
3131
- Evidence-Based Proof: https://conceptkernel.org/v3.7/proof
3232
- Reconciliation & Logging: https://conceptkernel.org/v3.7/reconciliation
3333
- Versioning (per-kernel repos, 3 sibling dirs): https://conceptkernel.org/v3.7/versioning
34-
- CK as Subagent: https://conceptkernel.org/v3.7/subagent
35-
- Streaming: https://conceptkernel.org/v3.7/streaming
36-
- Web Shell: https://conceptkernel.org/v3.7/web-shell
37-
- CK Loop Evolution: https://conceptkernel.org/v3.7/evolution
3834
- CK.Consensus: https://conceptkernel.org/v3.7/consensus
3935
- Task Engine: https://conceptkernel.org/v3.7/task-engine
4036
- Ontological Graph: https://conceptkernel.org/v3.7/graph
41-
- Sessions & Agent Teams: https://conceptkernel.org/v3.7/sessions
42-
- Agent Teams: https://conceptkernel.org/v3.7/agent-teams
43-
- Dynamic Spawning: https://conceptkernel.org/v3.7/spawning
37+
- Sessions: https://conceptkernel.org/v3.7/sessions
4438
- PROV-O Provenance: https://conceptkernel.org/v3.7/provenance
4539
- Full Changelog: https://conceptkernel.org/v3.7/changelog
4640

‎docs/public/sitemap.xml‎

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,16 +34,10 @@
3434
<url><loc>https://conceptkernel.org/v3.7/proof</loc><priority>0.8</priority></url>
3535
<url><loc>https://conceptkernel.org/v3.7/reconciliation</loc><priority>0.8</priority></url>
3636
<url><loc>https://conceptkernel.org/v3.7/versioning</loc><priority>0.9</priority></url>
37-
<url><loc>https://conceptkernel.org/v3.7/subagent</loc><priority>0.7</priority></url>
38-
<url><loc>https://conceptkernel.org/v3.7/streaming</loc><priority>0.7</priority></url>
39-
<url><loc>https://conceptkernel.org/v3.7/web-shell</loc><priority>0.7</priority></url>
40-
<url><loc>https://conceptkernel.org/v3.7/evolution</loc><priority>0.7</priority></url>
4137
<url><loc>https://conceptkernel.org/v3.7/consensus</loc><priority>0.8</priority></url>
4238
<url><loc>https://conceptkernel.org/v3.7/task-engine</loc><priority>0.7</priority></url>
4339
<url><loc>https://conceptkernel.org/v3.7/graph</loc><priority>0.8</priority></url>
4440
<url><loc>https://conceptkernel.org/v3.7/sessions</loc><priority>0.7</priority></url>
45-
<url><loc>https://conceptkernel.org/v3.7/agent-teams</loc><priority>0.7</priority></url>
46-
<url><loc>https://conceptkernel.org/v3.7/spawning</loc><priority>0.7</priority></url>
4741
<url><loc>https://conceptkernel.org/v3.7/provenance</loc><priority>0.8</priority></url>
4842
<url><loc>https://conceptkernel.org/v3.7/changelog</loc><priority>0.6</priority></url>
4943

‎docs/v3.7/agent-teams.md‎

Lines changed: 0 additions & 161 deletions
This file was deleted.

‎docs/v3.7/changelog.md‎

Lines changed: 20 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,35 +9,37 @@ description: Full changelog for CKP v3.7 -- the complete 10-part, 48-chapter spe
99

1010
**Date:** 2026-04-06
1111

12-
CKP v3.7 is the consolidation of the entire protocol into a single normative specification: **SPEC.CKP.v3.7.full.md** -- 10 parts, 48 chapters, covering every aspect of concept kernel design, deployment, and governance.
12+
CKP v3.7 is the consolidation of the protocol into a single normative specification organised as **nine parts**, covering every aspect of concept kernel design, deployment, and governance.
1313

1414
### What Is New vs v3.5-alpha6
1515

1616
v3.5-alpha6 was the last deployed incremental release. v3.7 adds:
1717

1818
| Area | v3.5-alpha6 | v3.7 |
1919
|---|---|---|
20-
| Specification | 8 delta specs across multiple files | Single unified 48-chapter spec |
21-
| Claude integration | Subagent + streaming implemented | Full Part IX: EXTENDS runtime, CK loop evolution, multi-model config |
22-
| Governance | CK.Consensus kernel deployed | Full Part X: task engine, sessions, agent teams, spawning, PROV-O |
20+
| Specification | 8 delta specs across multiple files | Single unified nine-part spec |
21+
| Governance | CK.Consensus kernel deployed | Part IX: consensus, task engine, graph, sessions, PROV-O |
2322
| Compliance checks | 13 checks | 20 checks (added provenance, edge, topology, governance checks) |
2423
| Ontological graph | 10 Turtle modules loaded | Published triples per project/kernel/edge, SPARQL query catalog |
2524
| Provenance | Instance-level prov fields | Full PROV-O model with three-factor audit chain |
2625

27-
### Specification Scope -- All 10 Parts
28-
29-
| Part | Chapters | Title | Key Content |
30-
|---|---|---|---|
31-
| I | 1-4 | Foundations | CKP purpose, BFO 2020 grounding, three-loop separation, 8 awakening files |
32-
| II | 5-10 | Ontology | URN scheme, 5 edge predicates, governance modes, ontology.yaml, rules.shacl |
33-
| III | 11-16 | Runtime Semantics | Action lifecycle, instance sealing, NATS messaging, event types, proof records |
34-
| IV | 17-22 | Compliance and Proof | CK.ComplianceCheck, 20 check types, proof verification, compliance scoring |
35-
| V | 23-27 | System Kernels | CK.Operator, CK.Project, CK.Filer, CK.ComplianceCheck, CK.Consensus |
36-
| VI | 28-30 | Infrastructure | Kubernetes CRD, volume layout, namespace isolation, ConceptKernel CR |
37-
| VII | 31-35 | Libraries and Tools | CK.Lib.Py, CK.Lib.Js, web shell, AuthConfig, deploy pipeline |
38-
| VIII | 36-38 | Claude Integration (Runtime) | Subagent, streaming, EXTENDS predicate, CK.Claude |
39-
| IX | 39-40 | Claude Integration (Evolution) | CK loop evolution workflow, multi-model configuration |
40-
| X | 41-48 | Governance and Coordination | Consensus, task engine, graph, sessions, agent teams, spawning, provenance |
26+
### Specification Scope -- Nine Parts
27+
28+
| Part | Scope |
29+
|---|---|
30+
| I | Foundations: purpose, conformance, terminology, namespaces, design principles |
31+
| II | The Three Loops: CK identity, TOOL capability, DATA knowledge, system integration |
32+
| III | Ontology: BFO 2020 grounding, four-layer model, published modules, SHACL |
33+
| IV | Messaging: NATS transport and topics, message envelope |
34+
| V | Security: loop isolation, authentication, namespace security |
35+
| VI | Edges & Composition: edge predicates, EXTENDS |
36+
| VII | System Kernels: taxonomy, CK.ComplianceCheck, CK.Operator, CK.Project & Libraries |
37+
| VIII | Infrastructure: ConceptKernel + CKProject CRDs, evidence-based proof, reconciliation, versioning |
38+
| IX | Governance & Accumulation: CK.Consensus, task engine, ontological graph, sessions, PROV-O provenance |
39+
40+
::: info Deferred (not part of the v3.7 normative specification)
41+
Six chapters drafted during v3.5.x development -- *CK as Subagent*, *Streaming*, *Web Shell*, *CK Loop Evolution*, *Agent Teams*, *Dynamic Spawning* -- have been moved out of the normative v3.7 spec. They exposed vendor-specific integrations (Claude Code) and aspirational features that belong in tooling specs rather than the protocol specification. The consolidated content is preserved for future revisiting at `parked/3.7-deferred.md` in the source tree; it is intentionally not served on the website.
42+
:::
4143

4244
---
4345

‎docs/v3.7/consensus.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ Consensus behavior depends on the target kernel's governance mode:
215215

216216
This means CK.ComplianceCheck (STRICT governance) requires consensus for every change, while a development kernel with RELAXED governance can iterate faster on documentation without governance overhead. Even AUTONOMOUS kernels should record provenance -- the audit trail matters even when governance is relaxed.
217217

218-
The governance mode is declared in `conceptkernel.yaml` -- the developer sets the rules, consensus enforces them. See [CK Loop Evolution](./evolution) for the full workflow including change types and governance levels.
218+
The governance mode is declared in `conceptkernel.yaml` -- the developer sets the rules, consensus enforces them.
219219

220220
## Architectural Consistency Check
221221

0 commit comments

Comments
 (0)