Dotfiles

Appearance

ADR 0006: Personal Vibe Core ​

Status: superseded Last reviewed: 2026-06-20 Superseded by: DECISIONS.md#retired-vibe-workflow Accepted: 2026-05-22

This ADR is a historical record. The current repo no longer owns Vibe Core, just vibe, .vibe/ workflow state, or a repo-local autonomous workflow runner.

Context ​

The initial just vibe workflow made GitHub Issues preferred when available and kept local queue fallback language. That made the system more accommodating, but it also encouraged degraded autonomous behavior. The desired workflow is a trusted personal-project maintainer loop that moves quickly, stops when required infrastructure is broken, and records its work.

Decision ​

Adopt Personal Vibe Core as the target doctrine for just vibe.

  • just vibe is the portable workflow entrypoint.
  • GitHub Issues are mandatory durable queue state.
  • .vibe/runs/ and .vibe/state/current.json are standard local run state.
  • Normal GitHub issue writes are autonomous queue/process work.
  • Direct commit/push is the default delivery mode.
  • Branch/PR delivery may be added later as an explicit lane.
  • The workflow stops hard when required dependencies are broken instead of falling back to weaker local substitutes.
  • Human gates remain for real durable decisions and high-risk external actions, while operational blockers use Status: blocked.

Consequences ​

  • .vibe/queue/ is not a normal fallback path for Vibe work.
  • Missing gh, broken auth, missing GitHub remote, failed issue reads, or missing labels block the run.
  • Agents may create/update/close GitHub Issues when policy and validation allow.
  • Future Vibe work should target Claude as the read-only planner/reviewer and Codex as the implementation worker, with the orchestrator owning Git/GitHub mutations.
  • Exporting Vibe to other repos should carry this low-gate personal-project doctrine by default.

Alternatives considered ​

  • Keep GitHub optional with local queue fallback. Rejected because it creates a worse autonomous mode and hides setup failures.
  • Adopt the external Claude/Codex orchestration target as-is. Rejected because its conservative GitHub write gates and generic command surface do not match the desired personal workflow.
  • Make branch/PR delivery the default. Deferred because direct commit/push is better for this repo and keeps the first Vibe Core implementation smaller.

Follow-up work ​

  • Add Claude planner/reviewer backend.
  • Add structured worker results and orchestrator-owned mutation execution.
  • Add worktree worker execution.
  • Add deep-review, policy-review, and council modes.
  • Define an explicit branch/PR delivery lane for larger personal repos.