Skip to content

feat(brief,builder): cite the peer callsite for composition slices#253

Merged
eduralph merged 1 commit into
mainfrom
feat/248-peer-callsite
Jul 5, 2026
Merged

feat(brief,builder): cite the peer callsite for composition slices#253
eduralph merged 1 commit into
mainfrom
feat/248-peer-callsite

Conversation

@eduralph

@eduralph eduralph commented Jul 5, 2026

Copy link
Copy Markdown
Owner

Closes #248.

Problem

The builder made locally-reasonable, globally-wrong calls where the correct pattern was in the same file:

  • cmd_custodian hardcoded open_local_meta_redb with no resolve_backend/TiKV arm, while cmd_put/cmd_get two functions away already resolve the backend (cli.rs:865) — so on a real TiKV cluster the custodian opens an empty local redb (wyrd #366 Iter-3).
  • positional DServerId instead of the registered failure-domain (#366 Iter-3).
  • inverted "stream, don't buffer" invariant (#364 Iter-1).

"Read brief.md only" gives Do no cue to consult the peer callsite that already solves the composition, even though the builder can read the target repo.

Change

Confirmed design: relax the narrow-input wall for brief-cited callsites (rather than require Plan to inline peer code).

  • templates/brief.md.tplCitations expected MAY name a peer callsite Do should mirror (path:line + how).
  • agents/builder.md.jinja — a narrow, explicit exception: Do MAY open the one callsite the brief cites in Citations expected, solely to mirror the pattern; the wall is otherwise absolute.
  • agents/planner.md.jinja — for composition slices, Plan names the peer callsite in Citations expected.

Single-source: .claude/agents/* {% include %} the bodies.

Verification

  • cd template && make check — 478 driver unit tests pass.
  • builder.md.jinja / planner.md.jinja parse cleanly (jinja2).
  • Render+run test skips locally without copier; runs in CI.

🤖 Generated with Claude Code

)

The builder made locally-reasonable, globally-wrong calls where the correct pattern was
in the same file: cmd_custodian hardcoded open_local_meta_redb with no resolve_backend
arm while cmd_put/cmd_get two functions away already resolved the backend (wyrd #366
Iter-3); a positional DServerId instead of the registered failure-domain; an inverted
stream-don't-buffer invariant (#364). "Read brief.md only" gave Do no cue to consult the
peer callsite. For composition slices, Plan now names the peer callsite in Citations
expected, and Do MAY open that one cited callsite — a narrow, deliberate exception to the
narrow-input wall.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@eduralph eduralph added this to the Milestone 0.52.0 milestone Jul 5, 2026
@eduralph eduralph merged commit 00f2fe9 into main Jul 5, 2026
2 checks passed
@eduralph eduralph deleted the feat/248-peer-callsite branch July 5, 2026 13:17
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.

Brief + builder: cite the peer callsite for composition slices

1 participant