Single-source the settlement block duplicated across os-sdlc agent prompts #504

New issue

Open

opened 2026-08-25 12:18:44 +00:00 by jared · 2 comments

jared commented

2026-08-25 12:18:44 +00:00

Owner

Context

The 2026-08-25 fossil-hunt over plugins//agents/.md found the settlement block (temp-file payload, subagent-stop, rm, three-separate-commands rule) duplicated verbatim in ~10 os-sdlc agent prompts. Any protocol change requires N synchronized edits. User approved capturing this as a ticket.

Tasks

Decide the mechanism: a generation/composition step, a shared ${CLAUDE_PLUGIN_ROOT}/references/settlement.md the agent reads at runtime, or accept duplication with a sync check
Apply the chosen mechanism to all agent prompts carrying the block
Record the decision (ADR if it changes prompt-composition conventions)

Acceptance criteria

The settlement protocol is defined in one place, or a recorded decision accepts duplication with an enforcement mechanism

Origin

Trigger: 2026-08-25 fossil-hunt pass over plugins//agents/.md (session cleanup of programmer/test-writer prompts, ADR-0148)
Improvised this session: none
Chain: duplicated settlement block ← each agent prompt hand-authored independently ← DESIGN (agent .md files have no include mechanism; plugins/os-sdlc/agents/)
Root candidate: this ticket

## Context The 2026-08-25 fossil-hunt over plugins/*/agents/*.md found the settlement block (temp-file payload, subagent-stop, rm, three-separate-commands rule) duplicated verbatim in ~10 os-sdlc agent prompts. Any protocol change requires N synchronized edits. User approved capturing this as a ticket. ## Tasks - [ ] Decide the mechanism: a generation/composition step, a shared `${CLAUDE_PLUGIN_ROOT}/references/settlement.md` the agent reads at runtime, or accept duplication with a sync check - [ ] Apply the chosen mechanism to all agent prompts carrying the block - [ ] Record the decision (ADR if it changes prompt-composition conventions) ## Acceptance criteria - [ ] The settlement protocol is defined in one place, or a recorded decision accepts duplication with an enforcement mechanism ## Origin - Trigger: 2026-08-25 fossil-hunt pass over plugins/*/agents/*.md (session cleanup of programmer/test-writer prompts, ADR-0148) - Improvised this session: none - Chain: duplicated settlement block ← each agent prompt hand-authored independently ← DESIGN (agent .md files have no include mechanism; plugins/os-sdlc/agents/) - Root candidate: this ticket

jared added the

plugin/os-sdlc

label

2026-08-25 12:18:44 +00:00

jared commented

2026-08-25 13:26:29 +00:00

Author

Owner

Design direction (2026-08-25 session): extract the shared handoff-submission + final-output instructions into a preloaded skill (os-sdlc:submit-handoff) listed in each agent's frontmatter skills:, like os-sdlc:code-write — deterministic preload, no runtime Read. Reword the extracted instructions in intent language with the clock-out framing: the agent is clocking out; the runner's reply carries next_step, the message it must pass to the orchestrator so it knows whom to call next. Set disable-model-invocation in the skill frontmatter. Verify with one live dispatch that skills: preloads the body (fallback: a references/ file read at runtime). Related: #505 renames the runner-side settlement vocabulary.

Design direction (2026-08-25 session): extract the shared handoff-submission + final-output instructions into a preloaded skill (os-sdlc:submit-handoff) listed in each agent's frontmatter `skills:`, like os-sdlc:code-write — deterministic preload, no runtime Read. Reword the extracted instructions in intent language with the clock-out framing: the agent is clocking out; the runner's reply carries next_step, the message it must pass to the orchestrator so it knows whom to call next. Set disable-model-invocation in the skill frontmatter. Verify with one live dispatch that `skills:` preloads the body (fallback: a references/ file read at runtime). Related: #505 renames the runner-side settlement vocabulary.

jared commented

2026-08-25 14:00:56 +00:00

Author

Owner

User approved option B (preloaded os-sdlc:submit-handoff skill, clock-out framing, disable-model-invocation, one-dispatch preload verification) on 2026-08-25. Implementation deferred to its own session — this ticket is ready to work.

jared added the

label

2026-08-26 15:25:23 +00:00

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

jared/cc-os#504

No description provided.

Rows
Columns