Start here for repository documentation.
- Implementation State — current execution snapshot and fresh-session read order
- Implementation Workflow — workflow/process authority boundaries
- Conductor Routing Contract — canonical outer-loop routing contract
- PR Lifecycle Contract — canonical family-local PR lifecycle contract
- Pre-push Review Contract — developer-briefed fresh-context general-purpose review before the first push; ephemeral, bounded, config-resolved model, pre-filter to the fan-out gate (issue #2305); plus bounded delta mode before a gate act-list or Copilot-thread fix push (issues #2423, #2575)
- Artifact Authority Contract — canonical artifact-selection model (tracker-first, local-planning, and PR-body-as-spec) and the local-first plan-file flow
- Tracker Seam Contract — the
Trackerprovider interface/registry (issue #1408); GitHub is the built-in default, external providers are a post-1.0 drop-in - Local Planning — plan-file contract, operator sequence for the local-first plan-file flow, and a worked example of one plan file through every stage
- Spike-mode Contract — operator sequence for time-boxed exploratory runs: start from a question, reach findings, then discard or graduate into a plan file
- Tracker Story PR Contract — canonical tracker-first story/PR contract
- Sub-Issue Tree Contract — deterministic pattern for epic decomposition with GitHub sub-issue trees
- Copilot Loop State Graph
- Reviewer Loop State Graph
- Gate Review Comment Contract
- Worktree Usage Guidance — canonical local checkout isolation and cleanup rules
- Steering Contract
- UI Validation Contract
- UI Smoke Harness
- UI Artifact Contract
- UI Designer + Vision Review Loop
- UI-Review Run/Auth Recipe Contract — per-project run/login/flow recipe for
/loop-review-ui - Slides Content & Storytelling Review Loop
- A/B Contrast Deslop Step
- Docs-Grill Step — autonomous in-loop check of a change against its contracts/docs
- Bun 1.4.1 benchmark verdict — accepted contributor-toolchain migration evidence
- Phase 8 Plan — active phase plan
- Phase 7 Plan — deferred second-repo pilot plan
- Introducing dev-loops — start here: what dev-loops is, the proof from its own history, and how to adopt it
- dev-loops: A Deep Dive — deep dive in two parts: why every handoff is an explicit decision on a state graph, then measuring the waiting between actions
- The State Graph Is the Surface — reframes dev-loops as a graph/loop control surface: modeled state is authoritative, loops traverse it, and GitHub supplies the durable tracker/review evidence plane
- How dev-loops Decided Itself Into Shape — the history: forty dated architecture decisions, the two reversals, and the outcomes, read straight from the decision log
- Applied Dev Loops Presentation
- Process Observability Presentation
- The State Graph Is the Surface (deck) — the graph/loop reframe in a self-contained presentation
- The State Graph Is the Surface (Slidev companion) — headline-level source companion to the publishable HTML deck
- How dev-loops Decided Itself Into Shape (deck) — the evolution/history narrated through the decision log
docs/presentations/style.css
- Library vs Packages Core Boundary — ownership boundary between
lib/,packages/core/, andscripts/_core-helpers.mjs - Copilot CI Status Contract → Copilot CI Status Contract (canonical)
- README Audit Rubric — single owner of README.md's intended semantic properties (on-demand LLM-judge audit)
- README — repo overview and workflow posture
- Extension README — command surface, package install, and configuration
- Dev Loop Contract — canonical routing contract
- AGENTS.md — repo working agreement
- Projects Queue Contract — board contract, one-time board setup, and day-to-day usage for GitHub Projects V2 queue tooling
- Queue Mode SPEC — queue mode specification