docs(framework): describe the board we actually run#424
Merged
Conversation
MAINTAINERS.md described fields that no longer exist (`Area`, `Work type`, `Phases`), a `Priority` scale of P0/P1/P2, a `Ready` status, and a label-driven Type. The board has four orthogonal axes instead: the type is an issue type stamped by the form, the milestone says when, the priority orders what has no when, and only the status lives on the board. Also drops `--label back-merge-failed` from the back-merge workflow. The label never existed, so `gh issue create` failed, the trailing `|| echo` swallowed the error, and the step stayed green: the back-merge failed silently, which is what the comment above it forbids. Nothing read the label. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
blafourcade
added a commit
that referenced
this pull request
Jul 10, 2026
MAINTAINERS.md described fields that no longer exist (`Area`, `Work type`, `Phases`), a `Priority` scale of P0/P1/P2, a `Ready` status, and a label-driven Type. The board has four orthogonal axes instead: the type is an issue type stamped by the form, the milestone says when, the priority orders what has no when, and only the status lives on the board. Also drops `--label back-merge-failed` from the back-merge workflow. The label never existed, so `gh issue create` failed, the trailing `|| echo` swallowed the error, and the step stayed green: the back-merge failed silently, which is what the comment above it forbids. Nothing read the label. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🎯 What & why
The maintainer docs describe a board that no longer exists. Every row below was checked against the live project #8 and the repo today.
Status/Area/PriorityAreais deleted; the scope lives in the issue titlePriority(P0 · P1 · P2)Urgent·High·Medium·Low, and it is an org issue field, not a board fieldStatus:Todo · In progress · In review · Ready · DoneIdeation · Todo · In Progress · In review · Done. NoReadyWork typeandPhasesROADMAP.md: Now / Next / Later, framework and CLIaidd-cliwas removed from the board🛠️ How it works
docs/MAINTAINERS.md — the board section becomes four orthogonal axes, one table, plus the two rules that keep them orthogonal: a milestone or a priority, never both, and the scope lives in the title. The labels section states what a label is for now that types categorize.
aidd_docs/memory/vcs.md — the routing table's
Label (auto)column becomesIssue type. The board-advance line drops theReadystep that does not exist.ROADMAP.md — one sentence, describing the board as it is.
.github/workflows/back-merge.yml — drops
--label "back-merge-failed". This is a live bug, not a doc fix. The label never existed, sogh issue createfailed; the trailing|| echo "issue creation failed"swallowed the error and the step stayed green. A failed back-merge therefore opened no issue and raised no alarm — exactly what the comment two lines above forbids:Nothing read the label:
git grep back-merge-failedmatched the workflow and the doc sentence describing it, nothing else.🧪 How to verify
The live board:
gh project field-list 8 --owner ai-driven-devreturns exactly one single-select,Status.✅ I certify