Give docs-only tickets an os-sdlc map with no red round #812

Open
opened 2026-09-28 20:08:42 +00:00 by jared · 5 comments
Owner

Problem

The implement skill says to use maps/poodr-implementation.yaml for a ticket with no test-shaped increment: docs, config, an ADR-only change, or a spike. That map sends the run through seam-designer and test-writer. For a docs-only ticket, the test-writer has nothing to test, stops without a gate result, and the Runner ends the run with verdict:error. A docs-only ticket cannot pass the map that the skill names for it.

Observed

Implementation 66, ticket #807 (one-line edit to skills/implement/SKILL.md): change-auditor 670 pass, seam-designer 671 pass, test-writer 672 error with gate step gate_skip, then implementation_failed with reason: verdict:error.

Reproduce

os-sdlc-implementation-open SESSION 807 plugins/os-sdlc/maps/poodr-implementation.yaml --target os-sdlc

Then dispatch the named nodes for a docs-only ticket.

Approach

Give docs-only tickets a map with no red round: an editor node that runs a check command from the ticket's Required work, then a reviewer node. Point the implement skill at that map for docs, config and ADR-only tickets.

Required work:

  1. Add a map for tickets with no test-shaped increment, with no test-writer node.
  2. Change the implement skill to name that map for docs, config and ADR-only tickets — check: present poodr-implementation.yaml in plugins/os-sdlc/skills/implement/SKILL.md

Acceptance criteria

  1. Given a docs-only ticket, when it runs through the map that the skill names, then no node requires a red test.
  2. Given a docs-only ticket whose Required work check passes, when the run ends, then the Runner returns implementation_complete.

Owner sketch

plugins/os-sdlc/maps/<docs map>.yaml
plugins/os-sdlc/skills/implement/SKILL.md  ## Start

Origin

  • Trigger: /os-sdlc:implement 807, implementation 66
  • Improvised this session: made the one-line skill edit by hand, commit 75cbe519
  • Chain: implementation_failed ← test-writer gate_skip on a docs ticket ← skill routes docs tickets to a map that has a test-writer ← DESIGN (skills/implement/SKILL.md Start section, maps/poodr-implementation.yaml)
  • Root candidate: this ticket
  • Where: plugins/os-sdlc/maps/poodr-implementation.yaml, plugins/os-sdlc/skills/implement/SKILL.md
  • Session: b505a812-db25-4f85-8d52-ae7cda49eaab
  • Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/b505a812-db25-4f85-8d52-ae7cda49eaab.jsonl

VERDICT: CREATE — Real run (implementation 66) shows the docs-only map path ending in implementation_failed due to a design gap (no no-test map exists); this ticket names the design root, not a downstream symptom, and is distinct from #811.

## Problem The implement skill says to use `maps/poodr-implementation.yaml` for a ticket with no test-shaped increment: docs, config, an ADR-only change, or a spike. That map sends the run through seam-designer and test-writer. For a docs-only ticket, the test-writer has nothing to test, stops without a gate result, and the Runner ends the run with `verdict:error`. A docs-only ticket cannot pass the map that the skill names for it. ## Observed Implementation 66, ticket #807 (one-line edit to `skills/implement/SKILL.md`): change-auditor 670 pass, seam-designer 671 pass, test-writer 672 `error` with gate step `gate_skip`, then `implementation_failed` with `reason: verdict:error`. ## Reproduce ``` os-sdlc-implementation-open SESSION 807 plugins/os-sdlc/maps/poodr-implementation.yaml --target os-sdlc ``` Then dispatch the named nodes for a docs-only ticket. ## Approach Give docs-only tickets a map with no red round: an editor node that runs a check command from the ticket's Required work, then a reviewer node. Point the implement skill at that map for docs, config and ADR-only tickets. Required work: 1. Add a map for tickets with no test-shaped increment, with no test-writer node. 2. Change the implement skill to name that map for docs, config and ADR-only tickets — check: present `poodr-implementation.yaml` in `plugins/os-sdlc/skills/implement/SKILL.md` ## Acceptance criteria 1. Given a docs-only ticket, when it runs through the map that the skill names, then no node requires a red test. 2. Given a docs-only ticket whose Required work check passes, when the run ends, then the Runner returns `implementation_complete`. ## Owner sketch ``` plugins/os-sdlc/maps/<docs map>.yaml plugins/os-sdlc/skills/implement/SKILL.md ## Start ``` ## Origin - Trigger: `/os-sdlc:implement 807`, implementation 66 - Improvised this session: made the one-line skill edit by hand, commit 75cbe519 - Chain: implementation_failed ← test-writer `gate_skip` on a docs ticket ← skill routes docs tickets to a map that has a test-writer ← DESIGN (`skills/implement/SKILL.md` Start section, `maps/poodr-implementation.yaml`) - Root candidate: this ticket - Where: `plugins/os-sdlc/maps/poodr-implementation.yaml`, `plugins/os-sdlc/skills/implement/SKILL.md` - Session: b505a812-db25-4f85-8d52-ae7cda49eaab - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/b505a812-db25-4f85-8d52-ae7cda49eaab.jsonl VERDICT: CREATE — Real run (implementation 66) shows the docs-only map path ending in implementation_failed due to a design gap (no no-test map exists); this ticket names the design root, not a downstream symptom, and is distinct from #811.
Author
Owner

Triage 2026-09-29: still valid; ready-for-agent. Evidence: main skills/implement/SKILL.md (Start) still routes docs/config/ADR-only/spike tickets to maps/poodr-implementation.yaml, which still has the test-writer red round (maps/ holds only coding.yaml, poodr-implementation.yaml, poodr-ticket-implementation.yaml; none is a no-red docs map). No commit since filing changes this. Related: #663 (same routing gap for behavior-preserving refactors; recovered via coding.yaml, which has programmer->reviewer->suite-check and may serve docs tickets too) - consider settling both with one map decision. Not blocked by #802/#805/#806/#811/#818; #811 is a distinct test-reviewer defect. Labels added: ready-for-agent, create, enhancement. Implementer note: Required work item 1 has no check: line; add one.

Triage 2026-09-29: still valid; ready-for-agent. Evidence: main skills/implement/SKILL.md (Start) still routes docs/config/ADR-only/spike tickets to maps/poodr-implementation.yaml, which still has the test-writer red round (maps/ holds only coding.yaml, poodr-implementation.yaml, poodr-ticket-implementation.yaml; none is a no-red docs map). No commit since filing changes this. Related: #663 (same routing gap for behavior-preserving refactors; recovered via coding.yaml, which has programmer->reviewer->suite-check and may serve docs tickets too) - consider settling both with one map decision. Not blocked by #802/#805/#806/#811/#818; #811 is a distinct test-reviewer defect. Labels added: ready-for-agent, create, enhancement. Implementer note: Required work item 1 has no check: line; add one.
Author
Owner

Resolution

Done: Occurrence: #892 "Prose-only tickets have no red path in poodr-ticket-implementation" (same mechanism as #859: the red-first map cannot handle non-test-shaped work).

Evidence: #892 adds #874 impl 7 (unexpected_pass:test-writer/diff-test on a prose-only ticket) and two fix options: run required-work as the red gate at test-writer, or restore a docs map; it notes SKILL.md still says docs tickets run on this map.

Follow-ups: none

## Resolution **Done:** Occurrence: #892 "Prose-only tickets have no red path in poodr-ticket-implementation" (same mechanism as #859: the red-first map cannot handle non-test-shaped work). **Evidence:** #892 adds #874 impl 7 (unexpected_pass:test-writer/diff-test on a prose-only ticket) and two fix options: run required-work as the red gate at test-writer, or restore a docs map; it notes SKILL.md still says docs tickets run on this map. **Follow-ups:** none
Author
Owner

2026-10-18: bb617f0b adds an interim skill rule (implement/SKILL.md line 59): non-code tickets open on poodr-ticket-implementation and reroute when they escalate. Still open: the no-red-round map (editor node, then reviewer node) and the change that points the skill at it. #663 overlaps; merge or re-scope the two.

2026-10-18: bb617f0b adds an interim skill rule (implement/SKILL.md line 59): non-code tickets open on poodr-ticket-implementation and reroute when they escalate. Still open: the no-red-round map (editor node, then reviewer node) and the change that points the skill at it. #663 overlaps; merge or re-scope the two.
Author
Owner

Occurrence: Give category/prose-artifact tickets a pipeline path or stop the implement skill promising one
Seen: plugins/os-sdlc/skills/implement/SKILL.md Start section; plugins/os-sdlc/maps/*.yaml (all requires_category code-change or structure)
Run: session b154d58f-14cd-41fc-ba1a-04aa88301bfb, /os-sdlc:implement 1315 on 2026-10-25
Adds: implementation-open now refuses a prose-artifact ticket by requires_category (ADR-0287) before the unexpected_pass or gate_skip escalation the skill promises can fire, so the documented path is unreachable. #1313-#1316 were hand-finished as a result (main 59f6cdb0).

Occurrence: Give category/prose-artifact tickets a pipeline path or stop the implement skill promising one Seen: plugins/os-sdlc/skills/implement/SKILL.md Start section; plugins/os-sdlc/maps/*.yaml (all requires_category code-change or structure) Run: session b154d58f-14cd-41fc-ba1a-04aa88301bfb, /os-sdlc:implement 1315 on 2026-10-25 Adds: implementation-open now refuses a prose-artifact ticket by requires_category (ADR-0287) before the unexpected_pass or gate_skip escalation the skill promises can fire, so the documented path is unreachable. #1313-#1316 were hand-finished as a result (main 59f6cdb0).
Author
Owner

Occurrence: Align implement skill routing with category check for prose-artifact tickets
Seen: plugins/os-sdlc/skills/implement/SKILL.md (Start); plugins/os-sdlc/lib/os_sdlc/implementation/open.rb:46
Run: eb98cdcd-6783-46a0-b7df-cf18a8fe2a56
Adds: On 2026-10-25, os-sdlc-implementation-open for #1323 (category/prose-artifact) on poodr-ticket-implementation exited 3: 'map poodr-ticket-implementation needs category code-change'. The skill forbids a hand-finish, so the orchestrator finished #1323 outside the pipeline.

Occurrence: Align implement skill routing with category check for prose-artifact tickets Seen: plugins/os-sdlc/skills/implement/SKILL.md (Start); plugins/os-sdlc/lib/os_sdlc/implementation/open.rb:46 Run: eb98cdcd-6783-46a0-b7df-cf18a8fe2a56 Adds: On 2026-10-25, os-sdlc-implementation-open for #1323 (category/prose-artifact) on poodr-ticket-implementation exited 3: 'map poodr-ticket-implementation needs category code-change'. The skill forbids a hand-finish, so the orchestrator finished #1323 outside the pipeline.
Sign in to join this conversation.
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#812
No description provided.