Skip to content

feat(backlog-triage): add spec-aware Decision Review#174

Merged
sungjunlee merged 1 commit into
mainfrom
codex/backlog-triage-decision-review
May 31, 2026
Merged

feat(backlog-triage): add spec-aware Decision Review#174
sungjunlee merged 1 commit into
mainfrom
codex/backlog-triage-decision-review

Conversation

@sungjunlee
Copy link
Copy Markdown
Owner

@sungjunlee sungjunlee commented May 31, 2026

Summary

  • Add a prompt-driven, report-only Decision Review contract for backlog-triage.
  • Document evidence order across spec/charter.md, optional spec/capabilities.md, optional spec/system-map.md, active sprint context, snapshot, relationships, and stale signals.
  • Add a dev-backlog dogfood triage report plus its source snapshot for milestone Extract shared Node library (lib.js) #8 evidence.

Backlog artifact policy

This repo already tracks backlog/triage-config.yml, so backlog/ is not treated as entirely local-only here. This PR commits the final dogfood report and the matching snapshot it references. Regenerable relate/stale intermediate JSON files were intentionally excluded.

Verification

  • node --test skills//scripts/.test.js
  • bash skills/dev-backlog/scripts/smoke-test.sh

Related: #167, #168, #169, #170, #171, #172, #173

Summary by CodeRabbit

릴리스 노트

  • 새로운 기능

    • 백로그 트리아지 워크플로우에 의사결정 검토(Decision Review) 기능 추가 - Do Now, Shape First, Defer, Drop/Close 카테고리로 이슈 분류 지원
    • 단일 마크다운 리포트 생성 및 명시적 --apply 적용 흐름 구현
  • 문서

    • 백로그 트리아지 역할 설명 확장 및 의사결정 검토 참고 가이드 추가
    • 스펙 기반 의사결정 리뷰 프로세스 및 증거 기반 권장사항 문서화

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 31, 2026

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b13eba8d-9408-4a20-ba9f-50442e35d7e5

📥 Commits

Reviewing files that changed from the base of the PR and between 4c1683d and fe455ea.

⛔ Files ignored due to path filters (1)
  • backlog/triage/.cache/2026-05-31T07-05-39Z.json is excluded by !**/.cache/**
📒 Files selected for processing (4)
  • README.md
  • backlog/triage/2026-05-31-decision-review-dogfood.md
  • skills/backlog-triage/SKILL.md
  • skills/backlog-triage/references/decision-review.md

Walkthrough

백로그 트리아지 기술에 스펙 기반 Decision Review 계층을 추가하여 이슈를 Do Now/Shape First/Defer/Drop 네 가지 버킷으로 분류한다. 증거 우선순위, 루브릭, 앵커-체크박스 계약, 그리고 graceful no-op 처리를 정의하고 예시 리포트로 검증한다.

Changes

Decision Review 기반 우선순위 분류

Layer / File(s) Summary
Decision Review 편집 지침 및 증거 우선순위
skills/backlog-triage/references/decision-review.md
Decision Review의 네 버킷(Do Now/Shape First/Defer/Drop·Close)과 증거 우선순위(문서 → 스프린트 컨텍스트 → 수집·관계·노후 신호), 루브릭(목표 적합성/타이밍/레버리지/준비도), 스펙 파일 조건부 사용 규칙, 그리고 리포트 내 섹션 배치 및 앵커-체크박스 계약을 정의한다.
Phase 1 리포트 스키마 및 Analyze 프로세스 통합
skills/backlog-triage/SKILL.md
Phase 1(Report)의 Analyze 단계를 Alignment Check와 Decision Review로 확장하고, 리포트 템플릿에 ## Decision Review 섹션(Evidence used/absent, 네 버킷 하위 구조)을 추가한다. dev-backlog의 책임 구분 표에 "Spec-aware Decision Review"를 backlog-triage의 고유 책임으로 추가한다.
공개 문서 업데이트 및 예시 리포트
README.md, backlog/triage/2026-05-31-decision-review-dogfood.md
README에서 backlog-triage의 처리 범위(분류·관계·우선순위·정렬·Decision Review), 리포트 산출물 경로, --apply 명시적 적용을 명시한다. 실제 백로그 스냅샷 기반 예시 리포트에서 테마/라벨/연령별 분류, 관계 엣지, 우선순위 제안, 정렬 검사, Decision Review(근거 항목 포함), Apply Checklist(동일 앵커 기반 체크박스 반복)를 통합적으로 제시한다.

Sequence Diagram

sequenceDiagram
  participant Sprint as Active Sprint
  participant Charter as Charter
  participant Specs as Spec Files
  participant Snapshot as Issue Snapshot
  participant Phase1 as Phase 1: Analyze
  participant Report as backlog/triage/YYYY-MM-DD-report.md
  
  Sprint->>Phase1: Context / burndown / active goals
  Charter->>Phase1: Resolved charter constraints
  Specs->>Phase1: Optional capabilities / system-map
  Snapshot->>Phase1: Issues / relationships / stale signals
  
  Phase1->>Phase1: Alignment Check<br/>(Coverage + Orphans + Contradictions)
  Phase1->>Phase1: Decision Review<br/>(Evidence-driven classification)
  
  Phase1->>Report: § Alignment<br/>§ Decision Review<br/>  ├─ Do Now (evidence)
  Phase1->>Report: § Decision Review<br/>  ├─ Shape First (evidence)
  Phase1->>Report:   ├─ Defer (evidence)<br/>    ├─ Drop / Close (explicit evidence)
  Phase1->>Report: § Apply Checklist<br/>(Anchor-based checkboxes)
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • sungjunlee/dev-backlog#92: PR #92에서는 Phase 1 리포트에 CHARTER 기반 ## Alignment 섹션을 추가했고, 본 PR에서는 동일한 Phase 1 구조에 스펙/charter 기반 ## Decision Review 흐름을 추가하여 같은 backlog-triage 계약을 확장한다.

🐰 숨겨진 차터의 손길로
이제 우선 일들을 구분하고 📋
증거 밝은 길에서 판단하리
미룬 것과 버린 것의 경계, 명확하게 🎯

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed PR 제목 'feat(backlog-triage): add spec-aware Decision Review'는 변경사항의 핵심을 명확하게 반영하며, 명확하고 구체적입니다.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/backlog-triage-decision-review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fe455ead53

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +137 to +138
- #76 - Current tree already contains `triage-apply.integration.test.js` plus SKILL/README run instructions; verify against the issue AC and close if no gap remains.
- #118 - Belongs to dev-relay documentation rather than dev-backlog's accepted capability set; close here after confirming the dev-relay-side follow-up exists.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Anchor close recommendations in the checklist

When a maintainer uses this dogfood report as the acceptance surface, these Drop / Close recommendations cannot be accepted or applied because they are plain bullets, even though the new Decision Review reference says close proposals must keep the anchor-comment apply contract and that prose alone must not imply mutation. Since triage-apply.js only parses <!-- triage:... --> anchors followed by checkboxes, either add supported close/revisit anchors for these recommendations or reword them as non-mutating follow-up notes.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant