docs: shape the spec-conversion-and-guidance-sweep - #163
Draft
levifig wants to merge 1 commit into
Draft
Conversation
…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
force-pushed
the
spec-conversion-and-guidance-sweep
branch
from
August 12, 2026 00:38
3ee2643 to
137dc46
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 aloaf change verifyreceipt.Two model updates are recorded as Decisions: the brief's
target_release: 0.3.0strong-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
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 taskremoved, migration vialoaf migrate work-records, projects with open legacy rows nudged on next open.Deferred
change.mdfolder fate — owned by the removal boundary named in change-work-model.suggestReleaseBumparc-evidence realignment — named pending by ADR-026.https://claude.ai/code/session_014SSND9qNjHmJNhmmDrNsKD