jared/cc-os

Watch

Fork 0

Document the reroute verdict in change-auditor.md #879

New issue

Closed

opened 2026-10-01 15:26:45 +00:00 by jared · 2 comments

jared commented

2026-10-01 15:26:45 +00:00

Owner

Problem

After the reroute verdict works for change-auditor (ADR-0258 decision 2), plugins/os-sdlc/agents/change-auditor.md still lists only pass, fail, and error (line 92 handoff shape, lines 95-99 verdicts). change-auditor cannot know when to request a reroute or what fields to send.

Reproduce

n/a: prose change, nothing to reproduce.

Approach

Edit plugins/os-sdlc/agents/change-auditor.md only. Keep the addition short (ADR-0259 A3: requester instructions stay as short prose; code enforces the contract).

Add reroute to the handoff verdict: line and to the Verdicts list. Return reroute when the ticket is coherent but does not fit the current map, for example: no Required-work item has owner programmer, so a red-first test can never fail for a missing behavior. fail is unchanged: UNMAPPED and CONFLICT still go to the human.
Name the three handoff fields for reroute: situation (one sentence on what the ticket asks), misfit (why the current map cannot finish it), work_done (work already verified, so the router can pick the entry node).
Say that change-auditor does not choose the map; map-router does.

Required work:

List the reroute verdict — check: present reroute in plugins/os-sdlc/agents/change-auditor.md
Name the misfit field — check: present misfit in plugins/os-sdlc/agents/change-auditor.md

Acceptance criteria

Given the edited change-auditor.md, when a reader checks the Verdicts list, then reroute is listed with when to return it, and fail still covers UNMAPPED and CONFLICT.
Given the edited change-auditor.md, when a reader composes a reroute handoff, then the file names situation, misfit, and work_done and says what each holds.

Owner sketch

n/a: prose only (plugins/os-sdlc/agents/change-auditor.md).

Authoring guidance (user ruling, verbatim)

Use existing project agents/skills (plugins/os-sdlc/agents/.md, plugins/os-sdlc/skills/) as examples, plus the orwell-writing skill, the os-sdlc:technical-communication skill, cc-architect (plugins/cc-architect, incl. references/conventions/cc-os-naming.md: never name: in SKILL.md frontmatter, no commands/ dir), and the mattpocock-skills:writing-for-agents skill, to guide language and structure.

Origin

Trigger: user ruling on the map reroute design, 2026-10-01 (ADR-0258 decision 2; ADR-0259 A3)
Improvised this session: none
Chain: change-auditor never returns reroute ← its prose lists three verdicts ← DESIGN (docs/adr/0258)
Root candidate: #859
Where: plugins/os-sdlc/agents/change-auditor.md
Improvised this session: none
Root candidate: #859
Session: 55a56279-83ee-47d5-a21e-ee67f9e28abd
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/55a56279-83ee-47d5-a21e-ee67f9e28abd.jsonl

Parent: #859
Blocked by: #878

## Problem After the `reroute` verdict works for change-auditor (ADR-0258 decision 2), `plugins/os-sdlc/agents/change-auditor.md` still lists only `pass`, `fail`, and `error` (line 92 handoff shape, lines 95-99 verdicts). change-auditor cannot know when to request a reroute or what fields to send. ## Reproduce n/a: prose change, nothing to reproduce. ## Approach Edit `plugins/os-sdlc/agents/change-auditor.md` only. Keep the addition short (ADR-0259 A3: requester instructions stay as short prose; code enforces the contract). 1. Add `reroute` to the handoff `verdict:` line and to the Verdicts list. Return `reroute` when the ticket is coherent but does not fit the current map, for example: no Required-work item has owner programmer, so a red-first test can never fail for a missing behavior. `fail` is unchanged: `UNMAPPED` and `CONFLICT` still go to the human. 2. Name the three handoff fields for `reroute`: `situation` (one sentence on what the ticket asks), `misfit` (why the current map cannot finish it), `work_done` (work already verified, so the router can pick the entry node). 3. Say that change-auditor does not choose the map; map-router does. Required work: 1. List the reroute verdict — check: present `reroute` in `plugins/os-sdlc/agents/change-auditor.md` 2. Name the misfit field — check: present `misfit` in `plugins/os-sdlc/agents/change-auditor.md` ## Acceptance criteria 1. Given the edited change-auditor.md, when a reader checks the Verdicts list, then `reroute` is listed with when to return it, and `fail` still covers `UNMAPPED` and `CONFLICT`. 2. Given the edited change-auditor.md, when a reader composes a `reroute` handoff, then the file names `situation`, `misfit`, and `work_done` and says what each holds. ## Owner sketch n/a: prose only (`plugins/os-sdlc/agents/change-auditor.md`). ## Authoring guidance (user ruling, verbatim) Use existing project agents/skills (plugins/os-sdlc/agents/*.md, plugins/os-sdlc/skills/*) as examples, plus the orwell-writing skill, the os-sdlc:technical-communication skill, cc-architect (plugins/cc-architect, incl. references/conventions/cc-os-naming.md: never `name:` in SKILL.md frontmatter, no commands/ dir), and the mattpocock-skills:writing-for-agents skill, to guide language and structure. ## Origin - Trigger: user ruling on the map reroute design, 2026-10-01 (ADR-0258 decision 2; ADR-0259 A3) - Improvised this session: none - Chain: change-auditor never returns reroute ← its prose lists three verdicts ← DESIGN (docs/adr/0258) - Root candidate: #859 - Where: plugins/os-sdlc/agents/change-auditor.md - Improvised this session: none - Root candidate: #859 - Session: 55a56279-83ee-47d5-a21e-ee67f9e28abd - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/55a56279-83ee-47d5-a21e-ee67f9e28abd.jsonl Parent: #859 Blocked by: #878

jared added the

plugin/os-sdlc

filed-by/user

labels

2026-10-01 15:26:45 +00:00

jared added a new dependency

2026-10-01 15:29:39 +00:00

#878 Accept a reroute verdict from change-auditor and route it to map-router

jared added the

ready-for-agent

label

2026-10-01 15:29:59 +00:00

jared referenced this issue

2026-10-01 15:30:09 +00:00

no pipeline path for guard/characterization tests (unexpected_pass escalation) #859

jared referenced this issue

2026-10-01 20:25:09 +00:00

no pipeline path for guard/characterization tests (unexpected_pass escalation) #859

jared commented

2026-10-01 21:15:44 +00:00

Author

Owner

Work started: os-sdlc pipeline on branch ticket-879 (worktree .claude/worktrees/ticket-879).

jared commented

2026-10-01 21:19:12 +00:00

Author

Owner

Resolution

Done: change-auditor.md: added reroute to the handoff verdict line and the Verdicts list with when to return it; named situation, misfit and work_done; said map-router chooses the map; fail still covers UNMAPPED and CONFLICT.

Evidence: Commit 10bf6277 on main. Required-work checks: present 'reroute' (5 lines), present 'misfit' (2 lines). The parser reads situation and misfit at the top level of the handoff. bin/test 9 suites passed. Hand-finished: implementation 13 escalated unexpected_pass:test-writer/diff-test (escalation 5), prose-only ticket (#892).

Follow-ups: none

## Resolution **Done:** change-auditor.md: added reroute to the handoff verdict line and the Verdicts list with when to return it; named situation, misfit and work_done; said map-router chooses the map; fail still covers UNMAPPED and CONFLICT. **Evidence:** Commit 10bf6277 on main. Required-work checks: present 'reroute' (5 lines), present 'misfit' (2 lines). The parser reads situation and misfit at the top level of the handoff. bin/test 9 suites passed. Hand-finished: implementation 13 escalated unexpected_pass:test-writer/diff-test (escalation 5), prose-only ticket (#892). **Follow-ups:** none

jared closed this issue

2026-10-01 21:19:12 +00:00

jared referenced this issue

2026-10-01 21:23:06 +00:00

no pipeline path for guard/characterization tests (unexpected_pass escalation) #859

jared referenced this issue from a commit

2026-10-02 17:43:17 +00:00

docs(os-sdlc): document the reroute verdict in change-auditor.md (#879)

jared referenced this issue from a commit

2026-10-02 17:43:17 +00:00

docs: #879 History row