docs: revise and ratify the no-approvals speedrun specHEADmain

Recast the speedrun eligibility criteria as checkable gates, not adjectives: dropped the task-size gate so large tasks decompose into per-commit chunks, replaced the act-vs-file rule with a four-item defer checklist keyed on whether the failing test is writable from the task text, and added a pre-flight step that front-loads a run's decisions so it proceeds unattended after. Define :solo: and :quick: precisely enough to enforce in task-review and task-audit.

Also record the spec storage and lifecycle-status decision (org-keyword authoritative, drop the filename suffix) and the requirement to retrofit existing docs across projects.

2 files changed, 108 insertions, 1 deletions

diff --git a/.ai/notes.org b/.ai/notes.org
index 03347d2..0d1e20e 100644
--- a/.ai/notes.org
+++ b/.ai/notes.org
@@ -79,6 +79,6 @@ Format:
 Markers maintained by workflows to record when they last ran. Read by other workflows that gate their behavior on freshness.
 
 :LAST_AUDIT: 2026-06-28
-:LAST_INBOX_PROCESS: 2026-06-28 (11 handoffs → simplification mode in /refactor, locating-craig.md rule, suspend.org workflow, commit-gate hardening + bundled-test deny hook, readability-audit template workflow, dot-stripped project names; bug-priority matrix made binding in todo-format.md + home/work handoffs)
+:LAST_INBOX_PROCESS: 2026-06-29 (1 FYI handoff from home — confirmed it adopted the bug-priority matrix into its scheme header; no action needed, matrix already canonical here; acked)
 
 Format: one =:MARKER: YYYY-MM-DD= line per workflow. Workflows overwrite their own marker on completion.
diff --git a/.ai/sessions/2026-06-29-03-56-spec-lifecycle-decision-and-speedrun-ratified.org b/.ai/sessions/2026-06-29-03-56-spec-lifecycle-decision-and-speedrun-ratified.org
new file mode 100644
index 0000000..2a61f75
--- /dev/null
+++ b/.ai/sessions/2026-06-29-03-56-spec-lifecycle-decision-and-speedrun-ratified.org
@@ -0,0 +1,107 @@
+#+TITLE: Session Context
+#+DATE: 2026-06-28
+
+* Summary
+
+** Active Goal
+Handle todo.org items 4 (spec storage location + lifecycle convention) and 5
+(speedrun / autonomous-batch) — both decision-gated — then wrap.
+
+** Decisions
+- Item 4 status mechanism: org-keyword authoritative + Status field in Metadata,
+  drop the filename suffix (Craig chose option 1 over his earlier filename-suffix
+  lean, 2026-06-28).
+- Item 4 scope addition: retrofit existing docs across ALL projects, not just
+  document the convention going forward (Craig, 2026-06-28).
+- Speedrun naming: the workflow is "speedrun" / "no approvals speedrun" (not
+  "fix speedrun"); threaded through task heading, body, and the spec prose.
+- Item 5 criteria recast (Craig found them too soft): removed the task-size gate
+  entirely (large tasks decompose into per-commit chunks; size gating defeated the
+  away-from-desk use case); replaced act-vs-file adjectives with a crisp 4-item
+  defer checklist keyed on test-writability; eligibility simplified to status TODO
+  AND :solo:.
+- :solo: / :quick: get hard definitions in todo-format.md, applied at creation and
+  enforced as a mandatory step in task-review + task-audit.
+- Added the speedrun pre-flight decision-gathering step: batch all quick decisions
+  up front, "skip this" drops a task, then run hands-off. Unattended loop has no
+  kickoff human, so it still defers decision-needing tasks.
+- Craig ratified all 8 revised decisions; spec Status → ready.
+
+** Data Collected / Findings
+- No abandoned work from any shutdown: clean wrap last session (no crash anchor,
+  clean tree, last commit was the wrap archive at 15:59). Craig's "machine shut
+  down" recollection didn't match the record; deferred work (wrap-teardown
+  validation) was the closest match.
+- The autonomous-batch spec already existed and reconciled the old fix-speedrun +
+  inbox-zero Phase E proposals; it had 6 drafted decisions awaiting ratification.
+  The revision grew it to 8 (added tag-definitions/enforcement + pre-flight Q&A).
+
+** Files Modified
+- docs/design/2026-06-16-autonomous-batch-execution-spec.org — major revision
+  (size gate removed, defer checklist, tag definitions, pre-flight Q&A, naming),
+  then ratified: Status ready, cookie [8/8], all 8 decisions DONE, history entries.
+- todo.org — item 4 (:373) decision + retrofit requirement recorded; item 5 (:394)
+  heading/body renamed to "No-approvals speedrun"; the spec-review VERIFY rewritten
+  to a dated event-log entry.
+
+** Next Steps
+- Item 5 build (when prioritized): Phase 0 (todo-format.md :solo:/:quick: definitions
+  + task-review/task-audit enforcement) through Phase 6 (synthesis). Parent task
+  stays DOING.
+- Item 4 build (when prioritized): spec-create via the recorded decisions; ship the
+  retrofit helper + startup nudge; pilot on rulesets' own docs/design first.
+- Naming cleanup: the proposal-doc filenames still carry "fix-speedrun"; a rename
+  pass with link updates is deferred.
+- Other open carryover from startup: wrap-teardown manual validation (task 42),
+  memories-sync VERIFY (needs ratio), plus the remaining what's-next candidates.
+
+KB: promoted 0 / consulted no
+
+* Session Log
+
+** 2026-06-28 — Startup + what's-next triage
+Ran full startup: clean wrap last session (no crash anchor), repos current,
+inbox empty, no reminders/pending decisions. Roam inbox had 4 items, all for
+other projects (.emacs.d, emacs-wttrin) — none for rulesets. Surfaced 5
+what's-next candidates; Craig picked items 4 and 5 to handle, then wrap.
+
+** 2026-06-28 — Item 4 decision recorded
+Craig chose option 1 for the spec lifecycle status mechanism (org-keyword
+authoritative + Status field, drop filename suffix; adopt location split +
+org-id links). He added a requirement: existing spec/design files in ALL
+projects must be sorted into docs/specs/ vs docs/design/ — a one-time per-project
+migration template sync can't do, so the spec must design the reach mechanism
+(proposed: synced classify-and-move helper under .ai/scripts/ + startup nudge
+gated on a :LAST_SPEC_SORT: marker). Recorded both into todo.org:373.
+
+** 2026-06-28 — Item 5 (speedrun) spec revised per Craig's direction
+Craig found the eligibility criteria too soft. Revised the autonomous-batch spec
+(docs/design/2026-06-16-autonomous-batch-execution-spec.org) substantially:
+- Removed the task-size gate entirely (Craig: size shouldn't matter; large tasks
+  decompose into per-commit chunks; speedrun is the away-from-desk mode and size
+  gating forced him to stay at the desk). I agreed; only caveat is the unattended
+  loop's cost ceiling, handled by the vNext token budget.
+- Recast act-vs-file as a crisp 4-item defer checklist keyed on test-writability
+  ("can I write the failing test from the task text without inventing a
+  requirement"), an enumerated data-loss operation list, already-satisfied, and
+  design-deliberation. Replaces the old adjectives.
+- Eligibility simplified to status TODO AND :solo: (size gone, so :quick: drops to
+  an effort hint, not a gate). :solo:/:quick: get hard definitions in
+  todo-format.md, applied at creation + enforced as a mandatory step in
+  task-review and task-audit (Craig's ask).
+- Added the speedrun pre-flight decision-gathering step: gather → classify → order
+  → intro → batch-ask the quick decisions → "skip this" drops a task → run
+  hands-off. Makes "no approvals" = all approvals front-loaded. The unattended
+  loop has no kickoff human, so it still defers decision-needing tasks.
+- Naming: "fix speedrun" → "no-approvals speedrun" in spec prose + todo.org:394
+  heading/body. Proposal-doc filenames keep their on-disk names (rename pass is
+  separate). Spec Status stays draft pending ratification of the revised decisions.
+Spec opened in emacs for Craig's review. Companion build edits still pending:
+todo-format.md definitions + task-review/task-audit enforcement (Phase 0).
+
+** 2026-06-29 — Item 5 ratified
+Craig ratified all 8 decisions. Spec Status → ready, cookie → [8/8], all 8
+decision headings DONE, ratification entry added to iteration history. The
+*** VERIFY "Review the autonomous-batch execution spec" (todo.org) rewritten to a
+dated event-log entry. Parent task stays DOING (build pending: Phase 0–6).
+Items 4 and 5 both handled. Ready to wrap.