Design the first official os-sdlc map and agent configuration (grill-with-docs session)

jared commented

2026-08-21 13:25:53 +00:00

Owner

Context

The shipped maps/coding.yaml is a draft example, not built around the real workflow: it has only programmer and reviewer nodes, leaving code-probe, seam-designer, test-writer, lint-fixer, and wiring orphaned from the map runner (audit 2026-08-21). The user wants a dedicated /grill-with-docs session to design the first official map and agent configuration: map the real workflow (code-probe → seam-designer → test-writer → programmer → wiring → reviewer), give each in-map agent the YAML stop-message handoff contract, and realign or retire the orphaned agent files.

Tasks

Run /grill-with-docs against the map-runner design docs and the seven agent files
Produce the official map YAML for the real workflow
Realign or retire each orphaned agent file; record the decision
Test-drive the map end-to-end on a real ticket

Origin

Trigger: agent-alignment audit during #438 close-out (2026-08-21) showed 5 of 7 agents orphaned from coding.yaml
Improvised this session: rewrote programmer/reviewer to the handoff contract so the draft map can run; orphans left standalone
Chain: orphaned agents ← coding.yaml drafted as an example map ← DESIGN (docs/os-sdlc-rebuild/map-runner-design.md shipped one draft map at slice 4)
Root candidate: this ticket

## Context The shipped maps/coding.yaml is a draft example, not built around the real workflow: it has only programmer and reviewer nodes, leaving code-probe, seam-designer, test-writer, lint-fixer, and wiring orphaned from the map runner (audit 2026-08-21). The user wants a dedicated /grill-with-docs session to design the first official map and agent configuration: map the real workflow (code-probe → seam-designer → test-writer → programmer → wiring → reviewer), give each in-map agent the YAML stop-message handoff contract, and realign or retire the orphaned agent files. ## Tasks - [ ] Run /grill-with-docs against the map-runner design docs and the seven agent files - [ ] Produce the official map YAML for the real workflow - [ ] Realign or retire each orphaned agent file; record the decision - [ ] Test-drive the map end-to-end on a real ticket ## Origin - Trigger: agent-alignment audit during #438 close-out (2026-08-21) showed 5 of 7 agents orphaned from coding.yaml - Improvised this session: rewrote programmer/reviewer to the handoff contract so the draft map can run; orphans left standalone - Chain: orphaned agents ← coding.yaml drafted as an example map ← DESIGN (docs/os-sdlc-rebuild/map-runner-design.md shipped one draft map at slice 4) - Root candidate: this ticket

jared added the

plugin/os-sdlc

label

2026-08-21 13:25:53 +00:00

jared referenced this issue

2026-08-21 13:29:56 +00:00

Verify, review, and close #438 (map runner build close-out) #447

jared referenced this issue

2026-08-21 13:30:03 +00:00

Build the map-driven os-sdlc runner (ADR-0133/0134/0135) #438

jared commented

2026-08-21 19:14:22 +00:00

Author

Owner

Requirement from the #467 first drive (skeptic MERGE-INTO ruling): the official map design must route lint-gate offenses in TEST files. Today the lint gate lints all changed files including tests, but programmer/programmer-repair may not edit tests and no lint-fail edge reaches test-writer — a test-file offense loops programmer-repair to bound exhaustion (O7, docs/os-sdlc-rebuild/poodr-map-first-drive.md). The drive fixed the offenses via a disclosed out-of-map deviation. Options to weigh in the design session: test-scoped lint exclusion, a lint-fail edge to test-writer, or a dedicated lint-repair role.

jared referenced this issue

2026-08-21 19:14:23 +00:00

POODR map T9: supervised end-to-end drive of the POODR map #467

jared referenced this issue

2026-08-21 19:18:46 +00:00

POODR implementation map — build wayfinder #458

jared referenced this issue

2026-08-21 20:15:16 +00:00

POODR implementation map — build wayfinder #458

jared commented

2026-08-23 12:27:20 +00:00

Author

Owner

Resolution

Done: Superseded by an existing map; coding.yaml was always the draft/toy map, not the target for these agents

Evidence: code-probe agent abe0f36f530327170 (claude-sonnet-5): of the 5 agents the ticket names as orphaned, only lint-fixer and wiring actually have no map (grep for agent: lint-fixer|agent: wiring under plugins/os-sdlc/ returns no matches). code-probe, seam-designer, and test-writer are already wired into plugins/os-sdlc/maps/poodr-implementation.yaml, the production-focused map -- coding.yaml is the 2-node draft/toy map (per docs/os-sdlc-rebuild/map-runner-design.md:410-424, coding.yaml itself lands at slice 6, not slice 4 as the ticket cited).

Follow-ups: none

## Resolution **Done:** Superseded by an existing map; coding.yaml was always the draft/toy map, not the target for these agents **Evidence:** code-probe agent abe0f36f530327170 (claude-sonnet-5): of the 5 agents the ticket names as orphaned, only lint-fixer and wiring actually have no map (grep for agent: lint-fixer|agent: wiring under plugins/os-sdlc/ returns no matches). code-probe, seam-designer, and test-writer are already wired into plugins/os-sdlc/maps/poodr-implementation.yaml, the production-focused map -- coding.yaml is the 2-node draft/toy map (per docs/os-sdlc-rebuild/map-runner-design.md:410-424, coding.yaml itself lands at slice 6, not slice 4 as the ticket cited). **Follow-ups:** none

jared closed this issue

2026-08-23 12:27:20 +00:00

Rows
Columns

Design the first official os-sdlc map and agent configuration (grill-with-docs session) #453

Context

Tasks

Origin

Resolution