From 8f2a7ac124653bdf5c2e0e84ed52e06e49f9e821 Mon Sep 17 00:00:00 2001 From: Gianluca Carucci Date: Thu, 16 Jul 2026 16:21:43 +0200 Subject: [PATCH 1/3] =?UTF-8?q?[#313]=20refactor:=20close=20T6=20=E2=80=94?= =?UTF-8?q?=20sharpen=20bootstrap=20Verify=20beat=20(soft=20criterion)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Step 4.1's Verify was vague ("internally and cross-referentially consistent" — trivially true). Reworded to name the three concrete checks already enumerated in step 2 (tech-stack/architecture, way-of-working/tech-stack, infrastructure/architecture), with an explicit loop-back if any still fails after step 3's fixes. review/SKILL.md's Level table + degradation-levels.md co-location (T6's other remaining item) reassessed: T5 already resolved it via correct progressive disclosure (compact decision table stays in SKILL.md, per-level procedure disclosed to degradation-levels.md) — not scattered fragments. No change made there; reasoning in PR body. Co-Authored-By: Claude Sonnet 5 --- .claude/skills/pair-process-bootstrap/SKILL.md | 2 +- .../knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.claude/skills/pair-process-bootstrap/SKILL.md b/.claude/skills/pair-process-bootstrap/SKILL.md index ef0de344..d0d08897 100644 --- a/.claude/skills/pair-process-bootstrap/SKILL.md +++ b/.claude/skills/pair-process-bootstrap/SKILL.md @@ -205,7 +205,7 @@ Runs after architecture and tech-stack are adopted (Step 3.1) — both are prere - Way-of-working references correct tools from tech-stack - Infrastructure aligns with architecture patterns 3. **Act**: Fix any inconsistencies found. -4. **Verify**: All documents are internally and cross-referentially consistent. +4. **Verify**: The three checks from step 2 hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after step 3's fixes → return to step 3. ### Step 4.2: PM Tool Configuration diff --git a/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md b/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md index 63eb8cf1..639c5a3d 100644 --- a/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md +++ b/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md @@ -205,7 +205,7 @@ Runs after architecture and tech-stack are adopted (Step 3.1) — both are prere - Way-of-working references correct tools from tech-stack - Infrastructure aligns with architecture patterns 3. **Act**: Fix any inconsistencies found. -4. **Verify**: All documents are internally and cross-referentially consistent. +4. **Verify**: The three checks from step 2 hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after step 3's fixes → return to step 3. ### Step 4.2: PM Tool Configuration From 12d83cb3d9420a549263e09baf07d5cc15243a7d Mon Sep 17 00:00:00 2001 From: Gianluca Carucci Date: Thu, 16 Jul 2026 16:39:45 +0200 Subject: [PATCH 2/3] [#313] refactor: fix bootstrap loop-back cross-ref + add HALT escape (review finding) Step 4.1's Verify used bare lowercase "step 2"/"step 3" instead of corpus convention (capitalized Step X.Y, 0 other bare-lowercase hits corpus-wide) and had no escape if the loop-back never resolves. Now points to Step 4.1.2/4.1.3, retries once, then HALTs per this skill's own HALT-message phrasing convention. Co-Authored-By: Claude Sonnet 5 --- .claude/skills/pair-process-bootstrap/SKILL.md | 2 +- .../knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.claude/skills/pair-process-bootstrap/SKILL.md b/.claude/skills/pair-process-bootstrap/SKILL.md index d0d08897..d3e6d756 100644 --- a/.claude/skills/pair-process-bootstrap/SKILL.md +++ b/.claude/skills/pair-process-bootstrap/SKILL.md @@ -205,7 +205,7 @@ Runs after architecture and tech-stack are adopted (Step 3.1) — both are prere - Way-of-working references correct tools from tech-stack - Infrastructure aligns with architecture patterns 3. **Act**: Fix any inconsistencies found. -4. **Verify**: The three checks from step 2 hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after step 3's fixes → return to step 3. +4. **Verify**: The three checks from **Step 4.1.2** hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after **Step 4.1.3**'s fixes → retry **Step 4.1.3** once; if still unresolved, **HALT**: "Consistency check unresolved — report the specific mismatch to the developer." ### Step 4.2: PM Tool Configuration diff --git a/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md b/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md index 639c5a3d..5b5ac135 100644 --- a/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md +++ b/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md @@ -205,7 +205,7 @@ Runs after architecture and tech-stack are adopted (Step 3.1) — both are prere - Way-of-working references correct tools from tech-stack - Infrastructure aligns with architecture patterns 3. **Act**: Fix any inconsistencies found. -4. **Verify**: The three checks from step 2 hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after step 3's fixes → return to step 3. +4. **Verify**: The three checks from **Step 4.1.2** hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after **Step 4.1.3**'s fixes → retry **Step 4.1.3** once; if still unresolved, **HALT**: "Consistency check unresolved — report the specific mismatch to the developer." ### Step 4.2: PM Tool Configuration From ced961a8379c5ac3799a6cb995c1312c7dfe9067 Mon Sep 17 00:00:00 2001 From: Gianluca Carucci Date: Thu, 16 Jul 2026 16:51:43 +0200 Subject: [PATCH 3/3] [#313] docs: fix pseudo-heading step refs in bootstrap consistency check Step 4.1.2/4.1.3 used Step X.Y.Z syntax for plain list items, clashing w/ the corpus's only genuine use (real ### headings). Reworded to descriptive refs (review finding, PR #335). --- .claude/skills/pair-process-bootstrap/SKILL.md | 2 +- .../knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.claude/skills/pair-process-bootstrap/SKILL.md b/.claude/skills/pair-process-bootstrap/SKILL.md index d3e6d756..7cad391d 100644 --- a/.claude/skills/pair-process-bootstrap/SKILL.md +++ b/.claude/skills/pair-process-bootstrap/SKILL.md @@ -205,7 +205,7 @@ Runs after architecture and tech-stack are adopted (Step 3.1) — both are prere - Way-of-working references correct tools from tech-stack - Infrastructure aligns with architecture patterns 3. **Act**: Fix any inconsistencies found. -4. **Verify**: The three checks from **Step 4.1.2** hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after **Step 4.1.3**'s fixes → retry **Step 4.1.3** once; if still unresolved, **HALT**: "Consistency check unresolved — report the specific mismatch to the developer." +4. **Verify**: The three checks above hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after the fix step above → retry that step once; if still unresolved, **HALT**: "Consistency check unresolved — report the specific mismatch to the developer." ### Step 4.2: PM Tool Configuration diff --git a/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md b/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md index 5b5ac135..0cb41e99 100644 --- a/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md +++ b/packages/knowledge-hub/dataset/.skills/process/bootstrap/SKILL.md @@ -205,7 +205,7 @@ Runs after architecture and tech-stack are adopted (Step 3.1) — both are prere - Way-of-working references correct tools from tech-stack - Infrastructure aligns with architecture patterns 3. **Act**: Fix any inconsistencies found. -4. **Verify**: The three checks from **Step 4.1.2** hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after **Step 4.1.3**'s fixes → retry **Step 4.1.3** once; if still unresolved, **HALT**: "Consistency check unresolved — report the specific mismatch to the developer." +4. **Verify**: The three checks above hold with no remaining mismatch — tech-stack versions match architecture references, way-of-working tooling matches tech-stack, infrastructure aligns with architecture. Any check still failing after the fix step above → retry that step once; if still unresolved, **HALT**: "Consistency check unresolved — report the specific mismatch to the developer." ### Step 4.2: PM Tool Configuration