Skip to content

docs: correct drift the v0.13.4 crosscheck found in the internals and delivery chapters - #892

Merged
REPPL merged 1 commit into
mainfrom
docs/brief-drift-internals
Oct 10, 2026
Merged

REPPL merged 1 commit into
mainfrom
docs/brief-drift-internals

Conversation

@REPPL

@REPPL REPPL commented Oct 10, 2026

Copy link
Copy Markdown
Collaborator

The v0.13.4 release gate's brief/surface crosscheck reported 22 places where the design brief's internals and delivery chapters no longer match the code. This change corrects 20 of them, each checked against the code at file:line before the prose changed. Every edit is to the smallest false span.

What changes

  • 05-internals/01-agents.md: what agents/ holds (prompts and fixtures only); the two direct-model routes that ship, the provider API and model CLIs as runners.
  • 05-internals/03-configuration.md: the configuration surface the binary reads (pace.*, roles/runner and the provider keys were missing); which records carry schema_version; the layout tree's adapter and surface packages; memory ingest inputs.
  • 05-internals/05-prompt-quality.md: which agents have fixtures beyond the canary.
  • 06-delivery/01-build-sequence.md: the adapter seams, ahoy's writing forms, superseded intent ids, and the one CLI door.
  • 06-delivery/02-verification-matrix.md: five rows whose status or evidence was wrong (the provider fallback ships, the doc-audit half runs, capture runs no interview, no flat-list reader, inbox show in the surface-discipline row).

One finding, in a list of command pages in 01-product/04-scope.md, is left to the verb-split work that rewrites those lists. No finding was refuted, and none was already fixed upstream.

make preflight is clean on e8e132afb. The issue stays open: its remedy needs two stable crosscheck runs against an unchanged tree.

Refs: iss-2609091956001547
Assisted-by: Claude:claude-opus-5-5

… delivery chapters

The v0.13.4 release-gate brief/surface crosscheck reported 22 findings in
01-product, 05-internals and 06-delivery. Each was re-located at HEAD and
checked against the code before any prose changed.

- fixed: 21 (20 distinct claims; two findings name the same agents/ passage)
- refuted: 0
- already-true: 0
- skipped: 1 (01-product/04-scope.md, the /abcd:reflect row sits in a
  command list another session is restructuring)

The corrections cover the agents/ layout and iss-110, the oracle backends
that ship (provider adapter, runners) against oracle.backend, the
configuration surface's count and the schema_version tally, the
internal/adapter and internal/surface layout, the memory ingest operand,
the agent fixtures, the ahoy writing forms, the superseded itd-27 and
itd-29, and six verification-matrix rows whose status or evidence was
wrong.

Refs: iss-2609091956001547
Refs: iss-110
Assisted-by: Claude:claude-opus-5-5
@REPPL
REPPL added this pull request to the merge queue Oct 10, 2026
Merged via the queue into main with commit 501c1e3 Oct 10, 2026
13 checks passed
@REPPL
REPPL deleted the docs/brief-drift-internals branch October 10, 2026 17:33
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