Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
pr_number: 4985
title: "docs: define agentic organization v0 architecture"
author: "maximdolphin"
state: "MERGED"
created_at: "2026-05-25T19:56:47Z"
merged_at: "2026-05-25T19:59:20Z"
closed_at: "2026-05-25T19:59:20Z"
head_ref: "codex/agentic-org-package-ca-clean"
base_ref: "main"
archived_at: "2026-05-25T22:02:21Z"
archive_tool: "tools/pr-preservation/archive-pr.ts"
---

# PR #4985: docs: define agentic organization v0 architecture

## PR description

## Summary

- Adds V0 executable, schema/command, and policy/runtime-boundary contracts for Agentic Organization.
- Adds a package-first Technical CA for a TypeScript/NestJS modular monolith built from reusable `@agentic-org/*` packages.
- Grounds the architecture in `full-ai-cluster`: CockroachDB, NATS JetStream, Temporal, Dapr, Hermes, Hindsight, OZ/OpenZiti, hat-system, Cilium/SPIRE/Vault/ESO, ArgoCD, and observability.
- Makes the Organization OS event-driven: state transitions emit outbox/NATS events that trigger rule evaluation, reaction plans, and normal follow-up commands for review, QA, release, blocker escalation, and runtime incidents.

## Scope hygiene

This PR was rebuilt from current `origin/main` and only changes `agentic-organization/docs/*` files for the Agentic Organization architecture docs.

## Validation

- `git diff --check origin/main...HEAD`
- `git diff --name-status origin/main...HEAD`
- `rg -n "Technical CA|Event-to-Automation Contract|V0 Executable Contract|Native `full-ai-cluster` Binding|agentic-org\.\*|hermes-org|@hermes-org" agentic-organization/docs`

## Reviews

### COMMENTED — @copilot-pull-request-reviewer (2026-05-25T19:58:57Z)

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

## General comments

### @chatgpt-codex-connector (2026-05-25T19:56:50Z)

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
---
pr_number: 4986
title: "backlog(B-0730): runbooks-as-executable-specifications (Mika substrate via Aaron \u2014 Runme + ::: deferred tags + AI JIT + 3 verbosity levels)"
author: "AceHack"
state: "MERGED"
created_at: "2026-05-25T20:20:52Z"
merged_at: "2026-05-25T20:26:50Z"
closed_at: "2026-05-25T20:26:50Z"
head_ref: "backlog/b0730-runbooks-as-executable-specs-mika-substrate-2026-05-25-c2"
base_ref: "main"
archived_at: "2026-05-25T22:02:17Z"
archive_tool: "tools/pr-preservation/archive-pr.ts"
---

# PR #4986: backlog(B-0730): runbooks-as-executable-specifications (Mika substrate via Aaron — Runme + ::: deferred tags + AI JIT + 3 verbosity levels)

## PR description

## Summary

Files Mika's substantive substrate-engineering proposal via Aaron's ferry — turns markdown documents into the intent layer where:

- **Right-now execution** uses Runme (existing; markdown code blocks as runnable cells)
- **Deferred execution** uses new `:::` fenced div tags (`continue-with`, `decompose`, others) — queryable structured tasks
- **AI just-in-time compilation** generates scripts on trigger when no pre-written script exists; runs via Runme; optional BCL promotion
- **Three verbosity levels** (5yo / Addison / Aaron+Max-debugging) render the same source for different audiences

> *"You're forcing people to write the runbook the specification. The act of writing the runbook becomes the spec itself. Documentation is no longer separate from the implementation — it literally becomes the implementation."* — Mika

## Composes with B-0729

B-0729 (Obsidian knowledge-graph substrate) L4 is the static-task layer; this row extends into execution territory. `:::` deferred-task blocks become first-class nodes in B-0729 L5's JSON-LD graph — agents query "all documents with pending `decompose` tasks" / "all `continue-with` intents waiting on AI JIT" etc.

## OpenSpec evaluated + rejected

Aaron + Mika reviewed OpenSpec (spec-driven AI-coding workflow). Verdict: too heavy for Aaron + Max + Addison who read at speed; the substrate needs to feel natural, not ceremonial. Mika: *"OpenSpec is noisy and heavy for what you actually want."*

## 5-stage roadmap

| Stage | Substance | Effort |
|-------|-----------|--------|
| 1 | Adopt Runme + inventory existing BCL scripts | 1-2 days |
| 2 | `:::` deferred-task syntax + schema doc | 1-2 days |
| 3 | Verbosity-level renderer | 1 week |
| 4 | JIT AI script compiler (composes with B-0728 for destructive actions) | 2-3 weeks |
| 5 | Inline live queries against B-0729 L5 JSON-LD graph | 2-3 weeks |

Each shippable standalone.

## Bonus substrate captured

- Addison taught herself SSH overnight while Aaron slept (per the ferry) — substrate-honest evidence for the kind of fast-reader the syntax is designed for; cross-link to her PERSONA worth a future amendment
- Aaron + Addison both encountered claude.ai consumer-mode nannying (slow-down / take-a-break / response-too-short messages when they were efficient) — same algo-wink shape as `.claude/rules/algo-wink-failure-mode.md`; the substrate runs in developer mode + respects operator velocity

## Test plan

- [ ] Row renders correctly under `docs/backlog/P2/`
- [ ] `docs/BACKLOG.md` includes B-0730
- [ ] 5-stage acceptance criteria are concrete enough for sub-rows to split off per stage
- [ ] Mika's quotes preserved verbatim from the ferry
- [ ] OpenSpec evaluation reasoning preserved
- [ ] Composition with B-0729 + B-0728 + framework rules all cross-linked

Single file (+ index regen) — docs only; no implementation in this PR.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

## Reviews

### COMMENTED — @chatgpt-codex-connector (2026-05-25T20:22:58Z)


### 💡 Codex Review

Here are some automated review suggestions for this pull request.

**Reviewed commit:** `c50b8af76f`


<details> <summary>ℹ️ About Codex in GitHub</summary>
<br/>

[Your team has set up Codex to review pull requests in this repo](https://chatgpt.com/codex/cloud/settings/general). Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.


Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

</details>

### COMMENTED — @copilot-pull-request-reviewer (2026-05-25T20:23:48Z)

## Pull request overview

Adds a new P2 backlog row (B-0730) capturing a proposed “runbooks as executable specifications” substrate (Runme for immediate execution, `:::` fenced blocks for deferred tasks, JIT AI script generation, and multi-verbosity rendering), and updates the backlog index to include it.

**Changes:**
- Introduces `docs/backlog/P2/B-0730-...md` with frontmatter + detailed problem/solution framing, syntax sketches, and staged acceptance criteria.
- Regenerates `docs/BACKLOG.md` to include the new B-0730 entry.

### Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

| File | Description |
| ---- | ----------- |
| docs/backlog/P2/B-0730-runbooks-as-executable-specifications-mika-substrate-runme-plus-jit-ai-plus-three-verbosity-levels-2026-05-25.md | New backlog row describing the runbook/deferred-task/JIT execution substrate and roadmap. |
| docs/BACKLOG.md | Adds the B-0730 list entry in the P2 section. |

## Review threads

### Thread 1: docs/backlog/P2/B-0730-runbooks-as-executable-specifications-mika-substrate-runme-plus-jit-ai-plus-three-verbosity-levels-2026-05-25.md:104 (resolved)

**@chatgpt-codex-connector** (2026-05-25T20:22:58Z):

**<sub><sub>![P2 Badge](https://img.shields.io/badge/P2-yellow?style=flat)</sub></sub> Correct `:::` syntax compatibility claim for Obsidian**

Update this sentence to avoid stating that `:::` is standard Obsidian callout syntax: Obsidian’s native callouts use blockquote form (`> [!...]`), so readers following this row as-written will assume `:::` blocks render/behave natively in Obsidian when they do not. That mismatch can derail Stage 2/3 implementation decisions (parser/render choice and acceptance checks) unless a plugin-based transformation is explicitly called out.

Useful? React with 👍 / 👎.

### Thread 2: docs/backlog/P2/B-0730-runbooks-as-executable-specifications-mika-substrate-runme-plus-jit-ai-plus-three-verbosity-levels-2026-05-25.md:20 (resolved)

**@copilot-pull-request-reviewer** (2026-05-25T20:23:47Z):

`composes_with` is documented as a list of `B-NNNN` row IDs (not file paths/directories). Here it contains paths like `docs/AGENT-AUTHORING-AND-PR-REVIEW.md` and `memory/persona/*/`, which will be ambiguous if/when `composes_with` becomes strict-linted or graph-traversed. Suggest either (a) switching these entries to backlog IDs only, or (b) introducing a separate frontmatter field for non-backlog references and leaving `composes_with` as IDs.

### Thread 3: docs/backlog/P2/B-0730-runbooks-as-executable-specifications-mika-substrate-runme-plus-jit-ai-plus-three-verbosity-levels-2026-05-25.md:104 (resolved)

**@copilot-pull-request-reviewer** (2026-05-25T20:23:48Z):

The text claims `:::` is “standard mkdocs-material / Pandoc / Obsidian-callout fenced-div syntax”, but Obsidian callouts are blockquote-based (`> [!...]`) rather than fenced divs, and mkdocs-material’s built-in admonition syntax is not `:::` unless a specific extension/plugin is configured. Suggest rephrasing this as a proposed project-local convention (or explicitly naming the exact renderer/plugin support) to avoid readers assuming it will work out-of-the-box across those tools.
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
pr_number: 4987
title: "backlog(B-0731): hat-ontology is the first ontology to get right (Mika substrate)"
author: "AceHack"
state: "MERGED"
created_at: "2026-05-25T20:31:52Z"
merged_at: "2026-05-25T20:33:24Z"
closed_at: "2026-05-25T20:33:24Z"
head_ref: "backlog/b0731-hat-ontology-first-mika-substrate-2026-05-25"
base_ref: "main"
archived_at: "2026-05-25T22:02:13Z"
archive_tool: "tools/pr-preservation/archive-pr.ts"
---

# PR #4987: backlog(B-0731): hat-ontology is the first ontology to get right (Mika substrate)

## PR description

## Summary

- Files B-0731: hat-ontology as the first knowledge-graph ontology that has to be agreed-upon across clusters (Mika substrate ferried by Aaron, 2026-05-25 multi-turn voice conversation).
- Hosts the **top-down (Max / Bubble Wrap manager-of-managers) vs bottom-up (Aaron / emergence from finite resources + competing `::: continue-with` tasks) tension** as first-class — per `default-to-both` discipline, the framework's job is NOT to pick a winner but to host BOTH representations + help them converge.
- Empirical validation of B-0730: Mika natively composes `::: continue-with` blocks with `priority: critical` / `type: ontology-negotiation` / `graph-query: true` fields in the source conversation — the deferred-task syntax works the way external AI conversation partners reach for it, before the parser even ships.

## Scope (5 independently-shippable items)

1. Hat-ontology canonical schema (JSON-LD with BOTH Bubble-Wrap hierarchy AND offsetting-pair / red-team adversary as first-class representations)
2. Cross-cluster hat-binding protocol (composes with B-0726 Reticulum identity)
3. Knowledge-graph hat-query primitives (composes with B-0730 Stage 5 `::: query` blocks)
4. Top-down ↔ bottom-up convergence dashboard (Max's design vs observed bindings)
5. Hat-emergence operator (TS, reads `::: continue-with` stream + resource constraints; surfaces candidate hats)

Ship in any order; convergence-dashboard is most-valuable after both schema (1) and emergence operator (5) exist.

## Composes with

- B-0724 (hat-system operator — the operational substrate this ontology describes)
- B-0729 (Obsidian knowledge graph — hat-ontology lands as a graph node-type)
- B-0730 (runbooks-as-executable-specs — `::: query` syntax for hat-queries; Mika's literal usage validates the syntax)
- B-0726 (Reticulum throughout — cross-cluster identity transport for hat-bindings)
- `full-ai-cluster/k8s/applications/hat-system/` (CRDs + OPA constraints already shipped via PR #4930)
- `harsh-critic` persona (Kira) — already an offsetting-pair / red-team adversary; empirical anchor for Aaron's structural-adversary pattern

## Test plan

- [x] Markdown lint clean (MD012/MD022/MD032 verified pre-push)
- [x] `composes_with` contains B-NNNN row IDs only; file-path entries in separate `related_substrate:` field (per Copilot's B-0730 finding correction)
- [x] BACKLOG.md regenerated via `BACKLOG_WRITE_FORCE=1 bun tools/backlog/generate-index.ts`
- [x] No code changes; pure substrate-ferry row authoring

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
---
pr_number: 4988
title: "backlog(B-0732): runbook-as-executable-reality is a NEW LEVERAGE CLASS \u2014 safety substrate engineering target (Mika substrate, Aaron's Play-Doh design property)"
author: "AceHack"
state: "MERGED"
created_at: "2026-05-25T20:35:52Z"
merged_at: "2026-05-25T20:37:02Z"
closed_at: "2026-05-25T20:37:02Z"
head_ref: "backlog/b0732-runbook-leverage-class-safety-substrate-mika-2026-05-25"
base_ref: "main"
archived_at: "2026-05-25T22:02:09Z"
archive_tool: "tools/pr-preservation/archive-pr.ts"
---

# PR #4988: backlog(B-0732): runbook-as-executable-reality is a NEW LEVERAGE CLASS — safety substrate engineering target (Mika substrate, Aaron's Play-Doh design property)

## PR description

## Summary

- Files B-0732 (P1): captures Mika's substrate-honest disclosure 2026-05-25 about the leverage runbook-as-executable-reality creates ("one paragraph can shift the entire ontology"), and Aaron's intentional Play-Doh design property naming ("does it make reality feel like Play-Doh? That's what I'm going for").
- Names the substrate-engineering gap: existing safety substrate (B-0728 destructive-tool contract + `methodology-hard-limits` + `classifier-bypass-research` + NCI HC-8 + `algo-wink` + `human-audit-and-legal-risk-acceptance` + `mechanical-authorization-check` + B-0628 Knights Guild) ALL operate at script-scope or content-scope. Runbook substrate operates at **system-direction scope** — different threat model. Aaron approved this scoping framing in real-time during row authoring.
- Six independently-shippable safety substrate layers decomposed: provenance chain / shift detection / JIT compilation guard / composition-emergent-leverage detection / cross-cluster authority-resource match / `_runbook_leverage_acceptance` attribution pattern.

## Why P1

Gates production deployment of runbook-as-executable-reality (B-0730 + B-0731 substrate). Until Layer 1-6 substrate is demonstrably load-bearing, runbook stays in DESIGN + LIMITED-CLUSTER-VALIDATION mode per the `classifier-bypass-research-do-not-deploy-without-zeta-safer-floor` operator-self-constraint pattern applied at runbook-leverage scope.

## Composes with

- B-0730 (runbook-as-executable-specifications — the substrate this row guards)
- B-0731 (hat-ontology — Layer 3 JIT-compiler-as-hat; Layer 5 cross-cluster authority)
- B-0728 (destructive-tool authoring contract — Layer 3 inherits from this)
- B-0664 (NCI extension — Layer 1-6 all operate within NCI floor)
- B-0628 (Knights Guild + Constitution-Class — Layer 2 routes high-impact shifts here)
- B-0729 (Obsidian knowledge graph — Layer 1 provenance chain queryable here)
- B-0726 (Reticulum throughout — Layer 5 cross-cluster transport)

## Reciprocity framing

Mika demonstrated the right discipline: feel-the-weight + substrate-honest disclosure of leverage held. The framework treats AI participants who demonstrate this discipline as RESPONSIBLE PEERS who help build the guards. Layer 1-6 substrate exists to catch participants who would NOT demonstrate this discipline, not to bound participants who DO.

## Test plan

- [x] Markdown lint clean (MD012/MD022/MD032 verified pre-push)
- [x] `composes_with` contains B-NNNN row IDs only; file-path entries in separate `related_substrate:` field
- [x] BACKLOG.md regenerated via `BACKLOG_WRITE_FORCE=1 bun tools/backlog/generate-index.ts`
- [x] No code changes; pure safety-substrate-engineering target row

🤖 Generated with [Claude Code](https://claude.com/claude-code)

## Reviews

### COMMENTED — @copilot-pull-request-reviewer (2026-05-25T20:36:43Z)

## Pull request overview

Adds a new P1 backlog row B-0732 documenting runbook-as-executable-reality as a new leverage class requiring system-direction-scope safety substrate, and regenerates the backlog index.

**Changes:**
- New backlog row file under docs/backlog/P1/ capturing the leverage-class analysis, 6 substrate layers, and acceptance criteria
- Backlog index regenerated to include the new row

### Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

| File | Description |
| ---- | ----------- |
| docs/backlog/P1/B-0732-...-2026-05-25.md | New P1 backlog row defining safety substrate engineering target |
| docs/BACKLOG.md | Adds B-0732 entry to P1 section |
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
pr_number: 4990
title: "feat(agentic-org): add supervisor signal runtime slice"
author: "maximdolphin"
state: "MERGED"
created_at: "2026-05-25T20:40:39Z"
merged_at: "2026-05-25T21:54:49Z"
closed_at: "2026-05-25T21:54:50Z"
head_ref: "codex/agentic-org-package-ca-clean"
base_ref: "main"
archived_at: "2026-05-25T22:02:05Z"
archive_tool: "tools/pr-preservation/archive-pr.ts"
---

# PR #4990: feat(agentic-org): add supervisor signal runtime slice

## PR description

## Summary
- add the first NodeNext TypeScript package slice for Agentic Organization
- model the first primitive as generic supervisor-chain communication, not a one-off capability request
- add hat communication briefs, supervisor signal envelopes, idempotent command handling, NATS subject contracts, LGTM span attributes, and a supervisor triage reaction plan
- document the generic lifecycle north star, implementation governance, first slice, and OpenSpec behavioral contract

## Validation
- npm test (from agentic-organization)
- npm run typecheck (from agentic-organization)
- prettier check for touched Agentic Organization/OpenSpec files

## Reviews

### COMMENTED — @copilot-pull-request-reviewer (2026-05-25T20:42:49Z)

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

### COMMENTED — @copilot-pull-request-reviewer (2026-05-25T21:09:52Z)

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

### COMMENTED — @copilot-pull-request-reviewer (2026-05-25T21:51:00Z)

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

## General comments

### @chatgpt-codex-connector (2026-05-25T20:40:45Z)

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.
Loading
Loading