Enhance triage into the refine agent (standing checklist, self-applied readiness) #255

New issue

Closed

opened 2026-08-04 11:44:35 +00:00 by jared · 2 comments

jared commented

2026-08-04 11:44:35 +00:00

Owner

Spec: #250
Blocked by #253
Blocked by #254

Slice

Enhance the installed triage skill into the refine agent per the standing checklist (design doc §Refine): fill the full ticket template from ## Context + repo reading; run /os-adr:find and link governing ADRs; link related issues; spawn decision children (weighted YAML blocks, Blocked by #NNN appended to the parent per child); run the template validator and self-apply ready-for-agent only when it passes and all decision children are closed; flag needs-a-map and bounce to the human; may close objectively-verifiable duplicate/done/invalid captures with evidence.

Acceptance criteria

Given a capture picked for work without ticket-tier structure, when refine runs, then the checklist executes end-to-end and readiness labels are self-applied only behind a passing validator run.
Given an unresolved-decisions situation, when refine hits the map trigger, then it leaves a needs-map comment and bounces — never charts.
Given a judgment-shaded duplicate, when refine evaluates it, then it recommends rather than closes; recurring issues are never closed.
Skill artifact passes os-aidd-lint.

Non-goals

No auto-charting, no sweep execution (invoked, not implemented, here), no changes to capture.

Spec: #250 Blocked by #253 Blocked by #254 ## Slice Enhance the installed triage skill into the refine agent per the standing checklist (design doc §Refine): fill the full ticket template from `## Context` + repo reading; run `/os-adr:find` and link governing ADRs; link related issues; spawn decision children (weighted YAML blocks, `Blocked by #NNN` appended to the parent per child); run the template validator and self-apply `ready-for-agent` only when it passes and all decision children are closed; flag needs-a-map and bounce to the human; may close objectively-verifiable duplicate/done/invalid captures with evidence. ## Acceptance criteria - Given a capture picked for work without ticket-tier structure, when refine runs, then the checklist executes end-to-end and readiness labels are self-applied only behind a passing validator run. - Given an unresolved-decisions situation, when refine hits the map trigger, then it leaves a needs-map comment and bounces — never charts. - Given a judgment-shaded duplicate, when refine evaluates it, then it recommends rather than closes; recurring issues are never closed. - Skill artifact passes os-aidd-lint. ## Non-goals No auto-charting, no sweep execution (invoked, not implemented, here), no changes to capture.

jared added the

ready-for-agent

label

2026-08-04 11:44:35 +00:00

jared commented

2026-08-04 16:31:39 +00:00

Author

Owner

Work started on branch worktree-refine-255 (plain session in a worktree; will merge to main).

jared commented

2026-08-04 16:42:30 +00:00

Author

Owner

Resolution

Done: Installed triage skill (~/.agents/skills/triage/SKILL.md) enhanced with a Refine section per design doc §Refine: standing checklist (template fill, /os-adr:find, related issues, decision children), weighted-decision YAML blocks + decision-sweep invocation (recommender-blind — no threshold stated in the skill), validate-template exit gate for self-applied ready-for-agent, needs-map comment + bounce (never charts), evidence-backed closes for objectively-verifiable captures only, recurring never closed, comment-first mutation ordering.

Evidence: Skill artifact: ~/.agents/skills/triage/SKILL.md (outside repo, not version-controlled). Status leaf row: commit 489d123 on main. os-aidd-lint: Tier 1 exit 0 (zero non-advisory findings), Tier 2 charter-judge NONE.

Follow-ups: Dropped as non-blocking: advisory lint findings on the triage skill (skill-file-length over 50-line budget, step-owner-unassigned) — advisory tier only, artifact passes lint.

## Resolution **Done:** Installed triage skill (~/.agents/skills/triage/SKILL.md) enhanced with a Refine section per design doc §Refine: standing checklist (template fill, /os-adr:find, related issues, decision children), weighted-decision YAML blocks + decision-sweep invocation (recommender-blind — no threshold stated in the skill), validate-template exit gate for self-applied ready-for-agent, needs-map comment + bounce (never charts), evidence-backed closes for objectively-verifiable captures only, recurring never closed, comment-first mutation ordering. **Evidence:** Skill artifact: ~/.agents/skills/triage/SKILL.md (outside repo, not version-controlled). Status leaf row: commit 489d123 on main. os-aidd-lint: Tier 1 exit 0 (zero non-advisory findings), Tier 2 charter-judge NONE. **Follow-ups:** Dropped as non-blocking: advisory lint findings on the triage skill (skill-file-length over 50-line budget, step-owner-unassigned) — advisory tier only, artifact passes lint.

jared closed this issue

2026-08-04 16:42:30 +00:00

jared referenced this issue from a commit

2026-08-04 17:51:20 +00:00

Record #255 refine agent in os-backlog status leaf

jared referenced this issue

2026-08-07 13:15:18 +00:00

Spec: os-backlog issue lifecycle implementation (from map #239) #250