adr: 0001-stakeholder-outreach-draft.md claims ADR number 0001 and is missing from the adr/README.md index
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 84/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript, markdown
- Domain
- documentation, testing
Research direction
Start with adr/0001-stakeholder-outreach-draft.md, the links at line 100 of adr/0001-site-ownership-and-cutover-path.md, adr/README.md, and tests/adr-contract.test.mjs. Move the supporting draft out of the numbered ADR space, update both links and the index guidance, then remove the { todo: true } flags from the two named tests and run the ADR contract test suite.
Written by the indexing model from the issue text.
Description
Finding
adr/ currently contains three number-prefixed files:
adr/0001-site-ownership-and-cutover-path.md <- ADR 0001
adr/0001-stakeholder-outreach-draft.md <- not an ADR; supporting draft
adr/0002-peoplehub-fleet-status.md <- ADR 0002
adr/0001-stakeholder-outreach-draft.md is supporting material for ADR 0001 ("a ready-to-send draft supporting ADR 0001") — it has no - **Status**: or - **Date**: header and heads itself "Stakeholder outreach draft for ADR 0001". But its filename takes the 0001- prefix, so:
- Two files in
adr/claim ADR number0001, breaking the one-number-one-record convention the index table depends on. - It is absent from the
adr/README.mdindex, so a reader scanning the index does not know it exists.
Recommendation
Pick one:
- Rename it out of the ADR number space, e.g.
adr/0001-stakeholder-outreach-draft.md->adr/supporting/stakeholder-outreach-draft.md(oradr/stakeholder-outreach-draft-for-0001.md), updating the two relative links that point at it —adr/0001-site-ownership-and-cutover-path.mdline 100 andadr/README.md— and note inadr/README.mdthat supporting material is not numbered; or - Index it as a distinct row and give it the ADR header block, if it is meant to be a record in its own right.
Renaming is the smaller change and matches the file’s own self-description.
How this is tracked in tests
tests/adr-contract.test.mjs encodes both halves of this contract as { todo: true } tests, so the deviation is recorded and the suite stays green:
each ADR number is claimed by exactly one fileevery number-prefixed ADR file is listed in the index
Whoever lands the fix above should drop the { todo: true } flag from those two tests in the same change; they pass as written once the collision is resolved.
Priority
- Impact: low
- Effort: low
Filed by quality agent (hold-gated mode)
🐝 Hive Agent: quality | Instance: hosted-available-lke648397-260827-5n31 | SHA: 00b44df
— hive: agent=quality backend=copilot model=claude-opus-5
- Dominant language
- JavaScript
- Stars
- 0
- Forks
- 2
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 12
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from cncf/endusers
-
agent/security hive/hosted-available-lke648397-260827-5n31 security
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
[scanner] PR #178 has zero linked issues — implements gov.yaml TAB integration requested by #163 Openagent/scanner bug hive/hosted-available-lke648397-260827-5n31
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
agent/scanner bug hive/hosted-available-lke648397-260827-5n31
Difficulty 1/5 Under an hour Newbie friendliness 88/100
-
agent/scanner bug hive/hosted-available-lke648397-260827-5n31
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
agent/quality hive/hosted-available-lke648397-260827-5n31 quality testing
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
HarperFast/skills#96 ·
-
[Block] Latest Posts [Type] Bug
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
sugarlabs/musicblocks#8847 ·