Skip to content

Commit 3803dbd

Browse files
committed
docs(scaffolding): CLOSED banners on 5 historical .dev docs; retire phase-era wording
- sweep_plan / convergence_campaign / cw_v0_parity_and_gap_plan / v0_v1_feature_parity / core_coverage_gaps: CLOSED banners (sweep_plan's "/continue reads this" + "commit LOCALLY" claims were false vs the debt-drain model + atomic push; banners preserve inbound references). - continue/SKILL.md: retired §9.<N>-placeholder resume steps + the phase-close trigger rewritten to the ADR-0142 gap-area model. - check_tier_d_error_msg / check_compat_tiers_sync / check_no_op_stub headers: "Active phase: 6" / "Phase 5+" -> on-demand-audit label (the D-547 relabel's script-side remainder). - gate_continue_remind matcher: --list / reap are not gate launches. - D-553 filed: check_vm_parity repurpose (a follow-up that lived only in D-196's discharged tail — invisible to the drain). Smell-audited: 1: truth-sync only; banners over moves to keep inbound refs intact
1 parent 4ef6c7f commit 3803dbd

11 files changed

Lines changed: 59 additions & 23 deletions

‎.claude/skills/continue/SKILL.md‎

Lines changed: 16 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -40,16 +40,13 @@ spec is not duplicated here — CLAUDE.md is the single source.
4040
(anticipated directory tree Phase 5-20). When a task touches
4141
any topic these files cover, treat them as fact above
4242
ROADMAP / ADR text.
43-
3. Read `.dev/ROADMAP.md`:
44-
- Find the IN-PROGRESS phase in §9. If none, take the first
45-
PENDING.
46-
- In that phase's expanded §9.<N> task list, find the first
47-
`[ ]` task. If §9.<N> is missing/empty, the phase has not
48-
been opened yet — load the §9.<N> placeholder including
49-
its **Entry ADRs / Entry debts / Reference / Skeletons /
50-
Deliverables / Final activation step** lines. The Entry
51-
debts list points at `.dev/debt.yaml` rows the Phase owner
52-
must resolve.
43+
3. Read `.dev/ROADMAP.md` **§9.0** (the gap-area model — the
44+
phase-queue/§9.<N>-placeholder model is RETIRED per ADR-0142):
45+
the three gap areas' BUILT status + named gaps + draining
46+
`D-NNN` rows. Next-unit selection is `handover.md`'s "First
47+
task on resume" if concrete, else the `.dev/debt.yaml`
48+
`active:` list EASIEST-FIRST (CLAUDE.md § When the active
49+
work unit completes).
5350
4. (Dormant cadence per ADR-0025: skip the
5451
`docs/ja/learn_clojurewasm/` chapter check. `private/notes/`
5552
per-task notes continue.)
@@ -75,12 +72,13 @@ spec is not duplicated here — CLAUDE.md is the single source.
7572
§ Autonomous Workflow.** Do not wait for "go" — `/continue`
7673
itself is the go signal.
7774

78-
## Phase boundary review chain (auto-runs at phase close)
75+
## Boundary review chain (auto-runs when a gap-area unit arc closes)
7976

80-
A Phase closes when the chapter commit's `commits:` list includes
81-
the SHA that flipped the last `[ ]` to `[x]` in §9.<N>. Run this
82-
chain in parallel where possible, **continue into §9.<N+1>
83-
without asking**:
77+
The phase-queue is RETIRED (ADR-0142); the boundary is now a
78+
major work-arc close (a gap-area unit family drained, a release
79+
cut, or ~a full gate-ceiling cycle of related units). Run this
80+
chain in parallel where possible, **continue into the next
81+
self-selected unit without asking**:
8482

8583
1. Run `audit_scaffolding`. Findings of any severity feed the
8684
loop's next interrupt (block-severity ones become an immediate
@@ -101,10 +99,9 @@ without asking**:
10199
`bench/quick_baseline.txt` auto-baseline was removed from the gate,
102100
so no dangling samples accumulate. Perf is measured on demand via
103101
`bench/compare_langs.sh` / `bench/run_bench.sh`.)
104-
5. Open §9.<N+1>: flip the §9 phase tracker; expand §9.<N+1>
105-
inline (mirror §9.<N>'s structure); update `handover.md` to
106-
point at §9.<N+1>'s first task.
107-
6. Proceed to Step 0 of §9.<N+1>.1. Auto-compaction handles context
102+
5. Update `handover.md` to point at the next self-selected unit
103+
(debt.yaml easiest-first).
104+
6. Proceed to that unit's Step 0. Auto-compaction handles context
108105
size transparently — no agent action needed.
109106

110107
## Subagent delegation cheatsheet

‎.dev/convergence_campaign.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Convergence Campaign — drive cw v1 to feature-convergence (autonomous)
22

3+
> **CLOSED (2026-07-02).** Historical campaign record (2026-06-06); stages
4+
> complete. Kept for inbound references; do not drive work from it.
5+
36
> **Status**: opened 2026-06-06; **Stage 0 DONE 2026-06-06** (5 SSOTs rebuilt:
47
> `core_coverage_gaps.md` re-run, NEW `v0_v1_feature_parity.md` + D-273 umbrella,
58
> `compat_tiers.yaml` Java scope +31A/+3C reservations, debt de-staled −5,

‎.dev/core_coverage_gaps.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# clojure.core coverage gap map (corpus-driven, D-158 tier 1)
22

3+
> **CLOSED (2026-07-02).** Historical work queue (D-158 era). Any residual
4+
> coverage gap lives as a `.dev/debt.yaml` row, not here. Kept for inbound
5+
> references; do not drive work from it.
6+
37
Unbiased functional-completeness work queue: the real `clojure.core`
48
public var list (babashka `ns-publics`, ~647) diffed against cljw's var
59
set. Replaces AI-probed guessing. Companion to D-158 (the later

‎.dev/cw_v0_parity_and_gap_plan.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# cw v0 parity snapshot + gap-incorporation plan
22

3+
> **CLOSED (2026-07-02).** Historical snapshot (2026-05-29) from the
4+
> phase-queue era. Kept for inbound references; do not drive work from it.
5+
36
> **Purpose** (user directive, 2026-05-29): persist the cw-v0-vs-cw-v1
47
> coverage/parity analysis as a reference, and prepare — with **ROADMAP
58
> amendment in scope** — how the loop will incorporate the missing

‎.dev/debt.yaml‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1404,6 +1404,19 @@ active:
14041404
barrier: |-
14051405
tractable now; M-sized survey-first. Value rises with D-528 (real deps.edn corpus).
14061406
last_reviewed: "2026-07-02"
1407+
- id: "D-553"
1408+
status: |-
1409+
open (2026-07-02, lifted from D-196's discharged tail — a follow-up living only
1410+
inside a discharged row is invisible to the active drain). Repurpose
1411+
scripts/check_vm_parity.sh to run the e2e suite on the NON-default backend
1412+
(tree_walk, the F-012 differential oracle) so an oracle-only e2e/rendering
1413+
regression cannot hide behind the vm-default gate. On-demand / Phase-boundary
1414+
cadence per ADR-0049 (never per-commit). The script's BLOCKERS list stays the
1415+
re-add point for future VM-only regressions.
1416+
category: "tooling"
1417+
barrier: |-
1418+
tractable now; S-M (swap -Dbackend + drive run_all's e2e list through it).
1419+
last_reviewed: "2026-07-02"
14071420
standing:
14081421
- id: "D-549"
14091422
status: |-

‎.dev/sweep_plan.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
# Sweep plan — confirmed order (2026-06-14, user-directed)
22

3+
> **CLOSED (2026-07-02).** Historical planning document — the sweep phase it
4+
> ordered is complete and the "/continue reads this after handover.md" claim is
5+
> RETIRED (next-unit selection = `.dev/debt.yaml` easiest-first per CLAUDE.md;
6+
> the "commit LOCALLY" instruction predates atomic commit+push). Kept for
7+
> inbound references; do not drive work from it.
8+
39
> The SSOT for the current **sweep + wasm-north-star phase**. `/continue` reads
410
> this after `handover.md` to pick the next unit autonomously. Order is
511
> top-to-bottom; finish a unit, commit LOCALLY, move to the next.

‎.dev/v0_v1_feature_parity.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# v0 → v1 feature parity
22

3+
> **CLOSED (2026-07-02).** Historical generated snapshot (2026-06-06). Kept
4+
> for inbound references; do not drive work from it.
5+
36
Convergence Campaign Stage 0.2 deliverable. Enumerates every v0 (ClojureWasm
47
v0.5.0, the read-only reference clone) bundled namespace + app feature and maps
58
each to its v1 (`main`) status, with the owning debt row (or

‎scripts/check_compat_tiers_sync.sh‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@
33
# Verifies compat_tiers.yaml entries match actual implementation in
44
# src/lang/primitive/ and src/runtime/{java,cljw}/.
55
#
6-
# Active phase: 6. Directory layout shipped at Phase 5 entry (ADR-0029,
6+
# On-demand audit (D-547 relabel; the phase model is retired, ADR-0142).
7+
# Directory layout shipped at Phase 5 entry (ADR-0029,
78
# supersedes ADR-0011); host_classes entries are landing through Phase
89
# 6+. Sync check remains informational pending a real-cycle promotion;
910
# refresh when the first cycle actually treats this gate as block-grade

‎scripts/check_no_op_stub.sh‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@
33
# Heuristic lint for forbidden no-op stub patterns in src/.
44
# Per Shota's directive: "if implemented, must be real; no-op redirect forbidden".
55
#
6-
# Active phase: 6. Activation as hard gate deferred — the heuristic
6+
# On-demand audit (D-547 relabel; the phase model is retired, ADR-0142).
7+
# Activation as hard gate deferred — the heuristic
78
# at L113 of `.claude/rules/no_op_stub_forbidden.md` needs concrete
89
# bash/grep recipes before the gate becomes block-grade. Informational
910
# is the current correct shape (no new debt row needed).
@@ -12,7 +13,7 @@ set -euo pipefail
1213

1314
REPO_ROOT="${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
1415

15-
# Patterns considered no-op stubs (Phase 5+ activation):
16+
# Patterns considered no-op stubs:
1617
# 1. fn body that immediately returns the only argument unchanged
1718
# 2. fn body that wraps the body argument in a no-op block
1819
# 3. comment "no-op" or "stub" near impl without explicit ADR reference

‎scripts/check_tier_d_error_msg.sh‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@
33
# Verifies Tier D forms / fns produce structured error messages
44
# referencing the rationale ADR.
55
#
6-
# Active phase: 6. Tier D error messages are landed inline at each
6+
# On-demand audit (D-547 relabel; the phase model is retired, ADR-0142).
7+
# Tier D error messages are landed inline at each
78
# `tier_d_*` Code in src/runtime/error/catalog.zig per ADR-0018
89
# amendment 2. Promotion to gate deferred until a real drift surfaces;
910
# script stays informational meanwhile.

0 commit comments

Comments
 (0)