Decisions

Status: current Last reviewed: 2026-06-22 Superseded by: none

Durable decisions remain summarized in DECISIONS.md while this docs site becomes the browsable interface for workflow knowledge.

Current Direction

• Chezmoi owns rendering and host-specific templates.
• Supported profiles are desktop and headless; supported lanes are Windows, Ubuntu WSL, CachyOS, and the headless Ubuntu/Linux droplet Codex host lane.
• Local secrets stay out of the repo and are loaded only by scoped wrappers.
• GitHub Git transport is SSH-first through the shared Git config.
• just is the quality entrypoint.
• Source-only render tests are the safety net for WSL, CachyOS, droplet, and Windows fixtures.
• GitHub Issues are the durable autonomous-work queue; TODO.md is legacy and manual queue context.
• Vibe Core is retired from this repo. There is no active just vibe, .vibe/, repo-local Vibe plugin, or Bun runtime requirement here.
• ShellKit is parked. The old Rust implementation is removed; restart from current shell pain points before reviving any shell runtime coordinator.

Current ADRs

• ADR 0003: Managed Shell Contract
• ADR 0005: Profiles, Lanes, And Bootstrap Scope

Historical And Superseded ADRs

These records are retained as context. They do not describe current repo direction unless a later current decision explicitly revives them.

• ADR 0001: Agentic Vibe Workflow
• ADR 0002: ShellKit Runtime Coordinator First
• ADR 0004: Two-Binary ShellKit Architecture
• ADR 0006: Personal Vibe Core
• ADR 0007: Bun-First Vibe Core

When a decision affects daily use, add or update a docs page as well as the short DECISIONS.md summary.