Repository navigation
source-control: dossier branches per owning item #7579
Copy link
Copy link
Open
Labels
needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.Human-in-the-loop required; autonomous sessions must not resolve items carrying this.needs-specNeeds a Brief or plan before anyone can build it.Needs a Brief or plan before anyone can build it.
Description
Parent
Refs #7555. Source: PLAN Phase 12, topic poteto-review. Thread: Dossier branches.
Depends on
- config-cascade: settings resolution and convention home #7571 Settings resolution and convention home (prefix setting)
- work-items: bug path, triage clusters, claim protocol, trackers and morning brief #7578 work-items (tracker binding)
Outcome
Each owning work item can keep its docs, exploration notes and draft plan on a dossier/<key>-<slug>
branch, pushed only after a pre-push secrets and machine-data check, and deleted when the item
closes.
Decisions
- Per-item
dossier/<key>-<slug>branch with the tracker's own key; prefix a setting, default
dossier/(repo); one dossier per owning item (a parent or spec container gets its own, children
add their own only when needed); holds docs, exploration notes and the draft plan until finalized;
deleted on close; pre-push secrets and machine-data check (Q533, Q573, Q168). Origin: owner's
(the name) and ours. - The pre-push secrets check is this thread's first item: CI runs gitleaks on PRs only, and a dossier
branch is pushed with no PR. - Rejected: one ephemeral
contextbranch per issue ("context" is overloaded, D70);workfilesand
other work-compounds (Q573); findings in the resolution comment instead of a branch (Q533). - No ruleset applies to the prefix today (Q533).
Key interfaces
From the design's contracts, "Settings": "Dossier branch prefix dossier/, repo; branch shape
dossier/<key>-<slug> with the tracker's own key; one per owning item; deleted on close."
Variation verdicts: "Dossier prefix: contain now; setting default dossier/; abstract-now not chosen
(Q573)."
Done when
- The source-control convention and
/work-items:workboth name thedossier/prefix (0
mentions on main), and the branch-name test exits 0. - The pre-push step's test exits non-zero on a planted-token fixture and 0 after its revert, both
runs recorded in the PR. - Every slice sub-issue is closed by a merged PR.
Out of scope
- Prototype evidence branches (Other plugins thread), beyond sharing the secrets check.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
needs-humanHuman-in-the-loop required; autonomous sessions must not resolve items carrying this.Human-in-the-loop required; autonomous sessions must not resolve items carrying this.needs-specNeeds a Brief or plan before anyone can build it.Needs a Brief or plan before anyone can build it.
Type
Fields
Work status
needs-spec
Activity
github-actions commentedon Oct 16, 2026
Thanks for the report. Automated triage handed this issue to a maintainer.
Proposed work class: work-class: structural
Basis: automated intake triage; a maintainer confirms or changes it.
Automated triage. A maintainer reviews it.