Skip to content

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 May 00:13
· 6 commits to main since this release

Changed (bootstrap behavior — major UX revision)

  • 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.
    • RE-INSTALL — destructive override. Requires explicit confirmation.
  • /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.