Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt

Use this file to discover all available pages before exploring further.

​
ADR-008: Direct-to-main workflow — no long-lived branches, no worktrees by default

Status: CURRENT Date: 2026-05-16

​
Context

The 2026-05-16 audit surfaced 77 orphan branches carrying ~15K LOC that never landed because sub-agents and worktrees forgot to merge. PR #71 surfaced the scale of the problem.

​
Decision

Work directly on main. Commit → push → Cloud Build submit → verify, same session. Worktrees are used only for genuine parallel agent work and must be merged and deleted in the same session.

​
Reason

Pre-launch reality with a sole developer means there is no PR-review bottleneck to justify long-lived branches. “I’ll land this later” does not happen.

​
Consequences

  • No PR review process.
  • Orphan-branch audits are no longer needed quarterly.
  • The cleanup-worktrees skill flags any worktree alive longer than one session.
  • The dispatch-fix-wave skill enforces “push-after-each-commit” discipline for parallel agents.

​
Source memos

  • [[workflow_direct_to_main_only_2026_05_16]]
  • [[orphan_branches_audit_2026_05_16]]
  • [[feedback_direct_to_master_not_worktrees]]