Design the refine step: upgrading a capture to workable

jared commented

2026-08-03 14:42:48 +00:00

Owner

Blocked by #240
Blocked by #241

Question

Who or what upgrades a raw capture (e.g. #118) into a workable ticket — a skill, a human triage pass, an agent — and at what moment in the lifecycle? What does the refine step add (structure, acceptance criteria, links), and how does it interact with the ready-for-agent / ready-for-human labels?

Map: #239 Blocked by #240 Blocked by #241 ## Question Who or what upgrades a raw capture (e.g. #118) into a workable ticket — a skill, a human triage pass, an agent — and at what moment in the lifecycle? What does the refine step add (structure, acceptance criteria, links), and how does it interact with the ready-for-agent / ready-for-human labels?

jared added the

wayfinder:grilling

label

2026-08-03 14:42:51 +00:00

jared referenced this issue

2026-08-03 14:43:45 +00:00

Assemble the os-backlog lifecycle design #247

jared referenced this issue

2026-08-03 22:07:31 +00:00

Define issue tiers: capture vs ticket vs map #240

jared commented

2026-08-03 22:07:39 +00:00

Author

Owner

Constraints inherited from #240's resolution: enhance the installed Matt Pocock triage skill rather than replacing it; recommender must be blind to the automation threshold (separate sweep gate applies it); undecided parts of a ticket become decision children with weighted recommendations, swept at ≥85% confidence + cheap reversal; no partial execution before all decision children close.

jared self-assigned this

2026-08-04 10:24:49 +00:00

jared commented

2026-08-04 10:28:04 +00:00

Author

Owner

Resolution

Decided (grilling session 2026-08-04):

Agent end-to-end. The refine agent (an enhancement of the installed triage skill, per #240) drafts the full ticket template, spawns decision children for anything undecided, and self-applies ready-for-agent once the template is complete and all decision children are closed. No human gate in the hot path; honesty is enforced by #240's falsifiability test — a working agent forced to ask a clarifying question strips the label with a comment.
Refine may close with evidence. Duplicate / already-done / invalid captures that are objectively verifiable (duplicate #NN link, shipped commit) are closed directly with a resolution comment; judgment-shaded cases fall back to recommend-only. Reopen is the cheap reversal; recurring issues remain never-closed-by-AI.
Standing checklist: (a) fill the full ticket template (slice, 3–7 given/when/then acceptance criteria, non-goals) from the capture's ## Context + repo reading; (b) run /os-adr:find on paths the work will touch, link governing ADRs in Notes-for-implementer; (c) link related issues; (d) spawn decision children with machine-parseable weighted blocks (format: #248), gated by the blind sweep; (e) apply ready-for-agent/ready-for-human, route needs-a-map to the human.
Trigger: pick-up + standalone. Refine auto-runs as the first stage whenever an item is picked for work and lacks ticket-tier structure, and is also standalone-invocable for ahead-of-time grooming.

## Resolution Decided (grilling session 2026-08-04): 1. **Agent end-to-end.** The refine agent (an enhancement of the installed triage skill, per #240) drafts the full ticket template, spawns decision children for anything undecided, and self-applies `ready-for-agent` once the template is complete and all decision children are closed. No human gate in the hot path; honesty is enforced by #240's falsifiability test — a working agent forced to ask a clarifying question strips the label with a comment. 2. **Refine may close with evidence.** Duplicate / already-done / invalid captures that are objectively verifiable (duplicate #NN link, shipped commit) are closed directly with a resolution comment; judgment-shaded cases fall back to recommend-only. Reopen is the cheap reversal; recurring issues remain never-closed-by-AI. 3. **Standing checklist:** (a) fill the full ticket template (slice, 3–7 given/when/then acceptance criteria, non-goals) from the capture's `## Context` + repo reading; (b) run `/os-adr:find` on paths the work will touch, link governing ADRs in Notes-for-implementer; (c) link related issues; (d) spawn decision children with machine-parseable weighted blocks (format: #248), gated by the blind sweep; (e) apply `ready-for-agent`/`ready-for-human`, route needs-a-map to the human. 4. **Trigger: pick-up + standalone.** Refine auto-runs as the first stage whenever an item is picked for work and lacks ticket-tier structure, and is also standalone-invocable for ahead-of-time grooming.

jared closed this issue

2026-08-04 10:28:07 +00:00

jared referenced this issue

2026-08-04 10:30:06 +00:00

Wayfinder map: os-backlog issue lifecycle & templates #239

jared referenced this issue

2026-08-04 10:35:02 +00:00

Design the close process and resolution comments #244

jared referenced this issue

2026-08-04 10:48:56 +00:00

Should template/section compliance be linted? #249