Write superseding ADR for ADR-0121 (SubagentStop-driven advancement) #426

New issue

Closed

opened 2026-08-18 18:31:23 +00:00 by jared · 1 comment

jared commented

2026-08-18 18:31:23 +00:00

Owner

#426 Write superseding ADR for ADR-0121 (SubagentStop-driven advancement)

(open)

@jared created 2026-08-18 14:31

#426 Write superseding ADR for ADR-0121 (SubagentStop-driven advancement)

(open)

@jared created 2026-08-18 14:31

Parent

#425
Map: #425

What to build

An Accepted ADR in docs/adr/ that supersedes ADR-0121, recording why launch-
time synchronous-only Agent dispatch advancement is abandoned in favor of
SubagentStop-driven completion intake: async-forcing harnesses stall
permanently on the async_launched guard, and SubagentStop is verified (2026-
08-18) to fire at real completion for background agents. The ADR covers:
hooks become webhook-thin data couriers, runner owns all state/post-agent
steps/routing, state derived purely from lifecycle timestamps, orchestrator
reads only runner instructions. Created via /os-adr:create; regenerate the
ADR index.

Acceptance criteria

[ ] ADR exists and marks ADR-0121 superseded
[ ] index regenerated
[ ] ADR-0097 (gates/sequencing in tested Ruby) and ADR-0108 (loud stall)
explicitly carried forward

Blocked by

None — can start immediately

Origin

• Trigger: /to-tickets skill on #425 spec
• Improvised this session: none
• Chain: #425 (DESIGN — spec of #425) ← decomposed via /to-tickets user
approval 2026-08-18
• Root candidate: none (this is a decomposition task)

# #426 Write superseding ADR for ADR-0121 (SubagentStop-driven advancement) (open) @jared created 2026-08-18 14:31 # #426 Write superseding ADR for ADR-0121 (SubagentStop-driven advancement) (open) @jared created 2026-08-18 14:31 ## Parent #425 Map: #425 ## What to build An Accepted ADR in docs/adr/ that supersedes ADR-0121, recording why launch- time synchronous-only Agent dispatch advancement is abandoned in favor of SubagentStop-driven completion intake: async-forcing harnesses stall permanently on the async_launched guard, and SubagentStop is verified (2026- 08-18) to fire at real completion for background agents. The ADR covers: hooks become webhook-thin data couriers, runner owns all state/post-agent steps/routing, state derived purely from lifecycle timestamps, orchestrator reads only runner instructions. Created via /os-adr:create; regenerate the ADR index. ## Acceptance criteria [ ] ADR exists and marks ADR-0121 superseded [ ] index regenerated [ ] ADR-0097 (gates/sequencing in tested Ruby) and ADR-0108 (loud stall) explicitly carried forward ## Blocked by None — can start immediately ## Origin • Trigger: /to-tickets skill on #425 spec • Improvised this session: none • Chain: #425 (DESIGN — spec of #425) ← decomposed via /to-tickets user approval 2026-08-18 • Root candidate: none (this is a decomposition task)

jared added the

plugin/os-sdlc

labels

2026-08-18 18:31:23 +00:00

jared referenced this issue

2026-08-18 18:31:31 +00:00

Schema migration + round-start/instruction-query runner endpoint #427

jared added the

ready-for-agent

label

2026-08-18 18:32:09 +00:00

jared referenced this issue

2026-08-18 18:44:58 +00:00

Assemble and close map #425: final cleanup sweep and verification #433

jared commented

2026-08-18 18:57:39 +00:00

Author

Owner

Resolution

Done: ADR-0128 created via adr-new CLI, superseding ADR-0121: SubagentStop-driven completion intake, webhook-thin hooks, runner owns state/routing, state from lifecycle timestamps; ADR-0097 (gates/sequencing in tested Ruby) and ADR-0108 (loud stall) explicitly carried forward in the decision text.

Evidence: docs/adr/0128-os-sdlc-advancement-is-subagentstop-driven-hooks-are-webhook-thin-couriers-and-the-runner-owns-all-state.md; ADR-0121 status now Superseded with superseded-by 0128; index regenerated; commit f8ba73e

Follow-ups: none — obsolete guard/advisory removal is already covered by later chain tickets under map #425

## Resolution **Done:** ADR-0128 created via adr-new CLI, superseding ADR-0121: SubagentStop-driven completion intake, webhook-thin hooks, runner owns state/routing, state from lifecycle timestamps; ADR-0097 (gates/sequencing in tested Ruby) and ADR-0108 (loud stall) explicitly carried forward in the decision text. **Evidence:** docs/adr/0128-os-sdlc-advancement-is-subagentstop-driven-hooks-are-webhook-thin-couriers-and-the-runner-owns-all-state.md; ADR-0121 status now Superseded with superseded-by 0128; index regenerated; commit f8ba73e **Follow-ups:** none — obsolete guard/advisory removal is already covered by later chain tickets under map #425

jared closed this issue

2026-08-18 18:57:40 +00:00

jared referenced this issue

2026-08-18 21:50:59 +00:00

Redesign os-sdlc pipeline advancement around SubagentStart/SubagentStop hooks #425

jared referenced this issue from a commit

2026-08-19 15:10:23 +00:00

docs(os-sdlc): ADR-0128 SubagentStop-driven advancement supersedes ADR-0121 (#426)