You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Bootstrap is now inspection-first and consent-based. No more invasive tracker writes during setup. The bootstrap inspects the workspace + tracker read-only, makes educated guesses, and asks the user before any write.
Workflow installation-state detection. Before doing anything, the bootstrap checks for signatures that another collaborator already ran it (AGENTS.md "Tracker destinations" section, canonical labels in tracker, bootstrap ADR). Classifies as FRESH / PARTIAL / INSTALLED.
Four scope modes for PARTIAL/INSTALLED workspaces:
LOCAL SYNC (default for new team members) — only writes per-machine memory files. Zero shared writes.
COMPLETE-PARTIAL — finish a half-done install. Only writes what's missing.
TEAM UPDATE — intentional team config changes. AGENTS.md changes go through a branch + PR; per-change confirmation for tracker writes.
/defect destination is now inspected before creation. The bootstrap detects existing options (Linear built-in Triage, dedicated "Bugs" project, label-based bug tracking) and proposes mapping /defect to those instead of forcing a new "Bug Triage" project. User picks.
/idea destination same treatment. Common existing destinations ("Backlog", "Icebox", "Ideas", "Parking Lot", "Future Enhancements") are detected and proposed first.
Planning cadence is now opt-in. Bootstrap no longer auto-creates an "M0 / Current Sprint" document. Instead, it detects existing cadence (active sprints/cycles/milestones) and asks whether to continue, adopt 10-day phases, or skip planning artifacts entirely.
Docs storage location is asked, not assumed. Detects existing docs/, dedicated docs repos, GitHub Wikis, and tracker documents in use. Proposes options including in-repo, dedicated docs repo, tracker-attached, or skip-ADRs. Recommends in-repo for ADRs (version-controlled, PR-reviewable).
Label taxonomy writes are opt-in. Bootstrap shows the diff (which labels would be added) before writing.
/defect and /idea skills now read destinations from AGENTS.md at runtime instead of having hardcoded project IDs. New "Tracker destinations" section in the AGENTS.md template is the canonical config + workflow-installed signature.
Added
AGENTS.md template now includes "Tracker destinations" + "Docs location" sections — the canonical config + workflow-installed signature that future bootstrap runs detect.
Spec §A introspection now also reads tracker state, docs storage signals, and workflow installation state.
Spec §B questions extended with bug destination (Q9), idea destination (Q10), planning cadence (Q11), label taxonomy diff (Q12), and docs storage (Q15).
Notes
This is a meaningful behavior change to the bootstrap. Existing workspaces that ran the v0.1.x bootstrap aren't broken — but the new bootstrap will detect them as PARTIAL or INSTALLED and offer non-destructive sync. To get the new AGENTS.md sections, re-run the bootstrap in TEAM UPDATE mode.