Skip to content

docs: shape the spec-conversion-and-guidance-sweep - #163

Draft
levifig wants to merge 1 commit into
mainfrom
spec-conversion-and-guidance-sweep
Draft

docs: shape the spec-conversion-and-guidance-sweep#163
levifig wants to merge 1 commit into
mainfrom
spec-conversion-and-guidance-sweep

Conversation

@levifig

@levifig levifig commented Aug 11, 2026

Copy link
Copy Markdown
Owner

Change

docs/changes/20260727-spec-conversion-and-guidance-sweep/ — the terminal carrier of the change-model-hard-cut lineage, promoted from capture-only to structurally executable. Its sequencing predecessor, docs/changes/20260811-linear-native-coordination/, landed on main as a capture-only brief (5987614); this PR references it but carries only the sweep.

What & Why

Shapes the retirement of the legacy work surface: loaf spec/loaf task (with all markdown-compat machinery), the breakdown skill, and every guidance surface that still routes toward them. Eight implementation units: a mechanical rows-to-intake migration (loaf migrate work-records) lands first so no window exists where legacy rows are unreachable; CLI and state removal follow; install/init/hooks, skills, and docs converge; the content-hygiene gate flips from pinning the compatibility stance to forbidding the retired surface; a dogfood run migrates Loaf's own 15 open specs and 17 open tasks and archives the 24 top-level SPEC files, ending with a loaf change verify receipt.

Two model updates are recorded as Decisions: the brief's target_release: 0.3.0 strong-gate framing is formally retired — under the revised ADR-026 the sweep stays unpinned and derives as an arc of one, bumping X at its own cut — and Linear-native coordination is restored to its recorded position ahead of the sweep, carrying the operator mandate that Linear's ontology informs the internal model (that Change owns ADR-011's supersession).

Review focus

  • Decision 3 (hybrid disposition): the migration writes Intents only, never briefs — the SQLite-unattended vs docs/changes-authored boundary.
  • Decision 5 (promise retirement): confirm the arc-of-one reading matches your intent for the old 0.3.0 gate.
  • Decision 6 (sequencing): the sweep cannot execute until linear-native-coordination lands — implement's preflight re-checks convergence targets against the landed model.
  • TASK-002/TASK-005 split sanctions: both are flagged heavyweight; challenge the slice boundaries.
  • The Cut list: no public read-only compat commands, no machine-authored briefs, no schema drops.

Verification

loaf change check docs/changes/20260727-spec-conversion-and-guidance-sweep — no violations, executable. The Linear folder intentionally reports captured-not-shaped. Open fog entries (all owner-routed): hygiene-gate stance strings (TASK-007), SPEC harvest review (TASK-008), nudge UX (TASK-001), post-Linear convergence re-check (implement preflight).

Migration / breaking changes

None in this PR (shaping documents only). The shaped work defines the breaking cut: loaf spec/loaf task removed, migration via loaf migrate work-records, projects with open legacy rows nudged on next open.

Deferred

  • Zero-row schema cleanup — later Change, once no project retains rows.
  • Legacy change.md folder fate — owned by the removal boundary named in change-work-model.
  • Lighter-than-Change work container — spark logged for a future pitch.
  • suggestReleaseBump arc-evidence realignment — named pending by ADR-026.

https://claude.ai/code/session_014SSND9qNjHmJNhmmDrNsKD

…ntation units

Promotes the capture-only carrier to a structurally executable Change:
full hard cut of the loaf spec/task/breakdown surface reaffirmed, a
mechanical rows-to-intake migration (loaf migrate work-records) with
human brief promotion at triage, guidance convergence across skills,
docs, and the flipped hygiene gate, and a dogfood run that archives
Loaf's own SPEC files. The brief's 0.3.0 strong-gate framing is retired
to arc-of-one semantics per the revised ADR-026; execution sequences
after linear-native-coordination lands.

Claude-Session: https://claude.ai/code/session_014SSND9qNjHmJNhmmDrNsKD
@levifig
levifig force-pushed the spec-conversion-and-guidance-sweep branch from 3ee2643 to 137dc46 Compare August 12, 2026 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant