Skip to content

refactor(doctrine): thin kernel S2-6 to a pointer (full protocol in docs/orchestration.md)#15

Merged
mbanderas merged 2 commits into
mainfrom
doctrine/kernel-s2-6-thin
Jun 18, 2026
Merged

refactor(doctrine): thin kernel S2-6 to a pointer (full protocol in docs/orchestration.md)#15
mbanderas merged 2 commits into
mainfrom
doctrine/kernel-s2-6-thin

Conversation

@mbanderas

Copy link
Copy Markdown
Owner

What

Thin the always-on Maestro kernel: replace the S2-6 "Multi-Agent Protocol"
body in AGENTS.md and the self-contained .cursorrules with a compact
stub plus a pointer to docs/orchestration.md, where the full protocol
already lives unchanged.

Why

The full S2-6 protocol is loaded on demand from docs/orchestration.md;
keeping a ~20-line copy in the always-on kernel was redundant token cost. The
stub keeps the irreducible chain so any subagent/runtime that has NOT loaded
docs/orchestration.md can still act on a multi-agent verdict.

Changes

  • AGENTS.md + .cursorrules: S2-6 body -> Option-B stub (Planner first as a
    real subagent -> scoped manifests -> cross-talk check -> Staff Engineer
    PASS/FAIL, max 2 cycles -> orchestrator never plans/codes/reviews) + pointer.
    The new S2-6 region is byte-identical across both files (one source of truth).
  • README.md: always-on kernel-size claim ~11 KB -> ~10 KB (AGENTS.md now
    9.67 KB).
  • CHANGELOG.md: [Unreleased] entry.

S0/S1 and S7-S10 are untouched. docs/orchestration.md is unchanged.

Size

AGENTS.md 10296 -> 9899 B (-397); .cursorrules 10205 -> 9769 B (-436);
~0.8 KB always-on saved across both kernel copies.

Verification

  • npm test: all suites passed. npm run lint: 0 errors.
  • docs/orchestration.md completeness confirmed: every S2-6 item (Planner real
    subagent; manifest fields ROLE/TASK/FILES/OUTPUT/ACCEPT/TOOLS; cross-talk
    check; Staff PASS/FAIL max 2 cycles; orchestrator never plans/codes/reviews)
    is still present there.
  • Three fresh-context gates PASS: Staff-Engineer diff review (PASS), SUCCESS
    verifier (conditions a-e PASS), and a behavior falsifying check (the
    post-change stub alone is enough to reach a multi-agent verdict and spawn a
    Planner).

Harness surface (always-on kernel) -> PENDING_REVIEW per Maestro S10.

Replace the Multi-Agent Protocol body in AGENTS.md and .cursorrules with
a compact Option-B stub: the irreducible chain (Planner first as a real
subagent -> scoped manifests -> cross-talk check -> Staff Engineer
PASS/FAIL, max 2 cycles) plus a pointer to docs/orchestration.md, where
the full S2-6 protocol already lives unchanged. Both kernel copies get
the byte-identical region. Saves ~0.8 KB always-on. S0/S1, S7-S10
untouched.
README always-on kernel claim ~11 KB -> ~10 KB (AGENTS.md now 9.67 KB);
add CHANGELOG [Unreleased] entry for the S2-6 pointer thinning.
@mbanderas mbanderas merged commit 63ff045 into main Jun 18, 2026
2 checks passed
@mbanderas mbanderas deleted the doctrine/kernel-s2-6-thin branch June 18, 2026 10:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant