diff --git a/TRIAGE.md b/TRIAGE.md index d8ee1be..b7451bb 100644 --- a/TRIAGE.md +++ b/TRIAGE.md @@ -122,8 +122,11 @@ expected. When an acceptance produces more than one issue, mint an **epic** (`epic` label): the approach, the decisions, the constraint list, and a -dependency-ordered task list of child issues. Children reference the epic; -the epic's checklist is the progress view. Builders never pick the epic +dependency-ordered checklist of child issues. Children reference the epic; +that checklist is the progress view. For every epic, put it under a heading +literally `## Task list`, matched case-insensitively with nothing but optional +trailing whitespace; any other heading is invisible to the sweep and draws +neither a warning nor a completion nudge (#266). Builders never pick the epic itself. Keep the checklist current — a stale epic misleads every scan. Repositories that adopt version epics follow [RELEASES.md](RELEASES.md). diff --git a/changelog.d/266.md b/changelog.d/266.md new file mode 100644 index 0000000..9d6bd0b --- /dev/null +++ b/changelog.d/266.md @@ -0,0 +1,5 @@ +### Changed + +- TRIAGE.md now tells every epic author to put its progress checklist under + the literal `## Task list` heading, because any other heading is silently + invisible to the completion sweep (#266).