From 4fa25e8c405077dc4c0b970db1cef0ea88a08be9 Mon Sep 17 00:00:00 2001 From: Alex Verkhovsky Date: Thu, 20 Aug 2026 03:25:36 -0700 Subject: [PATCH] style(skills): finish the dot-slash reference sweep All intra-skill references are now spelled from the skill root. checkpoint-preview's step files move into steps/ (matching code-review) and generate-trail.md into references/ so the whole chain falls under the file-refs checker; 305 refs verified, both validators clean. --- skills/bmad-checkpoint-preview/SKILL.md | 2 +- .../{ => references}/generate-trail.md | 0 .../{ => steps}/step-01-orientation.md | 4 ++-- .../{ => steps}/step-02-walkthrough.md | 6 +++--- .../{ => steps}/step-03-detail-pass.md | 6 +++--- .../bmad-checkpoint-preview/{ => steps}/step-04-testing.md | 2 +- .../bmad-checkpoint-preview/{ => steps}/step-05-wrapup.md | 0 skills/bmad-code-review/SKILL.md | 2 +- skills/bmad-code-review/steps/step-01-gather-context.md | 2 +- skills/bmad-code-review/steps/step-02-review.md | 2 +- skills/bmad-code-review/steps/step-03-triage.md | 2 +- skills/bmad-create-epics-and-stories/SKILL.md | 2 +- .../steps/step-03-create-stories.md | 2 +- skills/bmad-qa-generate-e2e-tests/SKILL.md | 2 +- 14 files changed, 17 insertions(+), 17 deletions(-) rename skills/bmad-checkpoint-preview/{ => references}/generate-trail.md (100%) rename skills/bmad-checkpoint-preview/{ => steps}/step-01-orientation.md (93%) rename skills/bmad-checkpoint-preview/{ => steps}/step-02-walkthrough.md (97%) rename skills/bmad-checkpoint-preview/{ => steps}/step-03-detail-pass.md (97%) rename skills/bmad-checkpoint-preview/{ => steps}/step-04-testing.md (97%) rename skills/bmad-checkpoint-preview/{ => steps}/step-05-wrapup.md (100%) diff --git a/skills/bmad-checkpoint-preview/SKILL.md b/skills/bmad-checkpoint-preview/SKILL.md index 0b5152adc..00fcb88cb 100644 --- a/skills/bmad-checkpoint-preview/SKILL.md +++ b/skills/bmad-checkpoint-preview/SKILL.md @@ -62,4 +62,4 @@ Activation is complete. If `activation_steps_prepend` or `activation_steps_appen ## FIRST STEP -Read fully and follow `./step-01-orientation.md` to begin. +Read fully and follow `steps/step-01-orientation.md` to begin. diff --git a/skills/bmad-checkpoint-preview/generate-trail.md b/skills/bmad-checkpoint-preview/references/generate-trail.md similarity index 100% rename from skills/bmad-checkpoint-preview/generate-trail.md rename to skills/bmad-checkpoint-preview/references/generate-trail.md diff --git a/skills/bmad-checkpoint-preview/step-01-orientation.md b/skills/bmad-checkpoint-preview/steps/step-01-orientation.md similarity index 93% rename from skills/bmad-checkpoint-preview/step-01-orientation.md rename to skills/bmad-checkpoint-preview/steps/step-01-orientation.md index 26f3554d0..7a35d27f4 100644 --- a/skills/bmad-checkpoint-preview/step-01-orientation.md +++ b/skills/bmad-checkpoint-preview/steps/step-01-orientation.md @@ -98,8 +98,8 @@ Omit any metric you cannot compute rather than guessing. ## FALLBACK TRAIL GENERATION -If review mode is not `full-trail`, read fully and follow `./generate-trail.md` to build one from the diff. Then return here and continue to NEXT. If trail generation fails (e.g., git unavailable), the original review mode is preserved — step-02 handles this with its non-trail path. +If review mode is not `full-trail`, read fully and follow `references/generate-trail.md` to build one from the diff. Then return here and continue to NEXT. If trail generation fails (e.g., git unavailable), the original review mode is preserved — step-02 handles this with its non-trail path. ## NEXT -Read fully and follow `./step-02-walkthrough.md` +Read fully and follow `steps/step-02-walkthrough.md` diff --git a/skills/bmad-checkpoint-preview/step-02-walkthrough.md b/skills/bmad-checkpoint-preview/steps/step-02-walkthrough.md similarity index 97% rename from skills/bmad-checkpoint-preview/step-02-walkthrough.md rename to skills/bmad-checkpoint-preview/steps/step-02-walkthrough.md index aec40c4c8..bcb1ca427 100644 --- a/skills/bmad-checkpoint-preview/step-02-walkthrough.md +++ b/skills/bmad-checkpoint-preview/steps/step-02-walkthrough.md @@ -80,10 +80,10 @@ When you're ready, say **next** and I'll surface the highest-risk spots. If at any point the human signals they want to make a decision about this {change_type} (e.g., "let's ship it", "this needs a rethink", "I'm done reviewing", or anything suggesting they're ready to decide), confirm their intent: -- If they want to **approve and ship** → read fully and follow `./step-05-wrapup.md` -- If they want to **reject and rework** → read fully and follow `./step-05-wrapup.md` +- If they want to **approve and ship** → read fully and follow `steps/step-05-wrapup.md` +- If they want to **reject and rework** → read fully and follow `steps/step-05-wrapup.md` - If you misread them → acknowledge and continue the current step. ## NEXT -Default: read fully and follow `./step-03-detail-pass.md` +Default: read fully and follow `steps/step-03-detail-pass.md` diff --git a/skills/bmad-checkpoint-preview/step-03-detail-pass.md b/skills/bmad-checkpoint-preview/steps/step-03-detail-pass.md similarity index 97% rename from skills/bmad-checkpoint-preview/step-03-detail-pass.md rename to skills/bmad-checkpoint-preview/steps/step-03-detail-pass.md index 49d8024a4..a3c8b9f5c 100644 --- a/skills/bmad-checkpoint-preview/step-03-detail-pass.md +++ b/skills/bmad-checkpoint-preview/steps/step-03-detail-pass.md @@ -83,8 +83,8 @@ You've seen the design and the risk landscape. From here: If at any point the human signals they want to make a decision about this {change_type} (e.g., "let's ship it", "this needs a rethink", "I'm done reviewing", or anything suggesting they're ready to decide), confirm their intent: -- If they want to **approve and ship** → read fully and follow `./step-05-wrapup.md` -- If they want to **reject and rework** → read fully and follow `./step-05-wrapup.md` +- If they want to **approve and ship** → read fully and follow `steps/step-05-wrapup.md` +- If they want to **reject and rework** → read fully and follow `steps/step-05-wrapup.md` - If you misread them → acknowledge and continue the current step. ## TARGETED RE-REVIEW @@ -103,4 +103,4 @@ The human can trigger multiple targeted re-reviews. Each time, present new findi ## NEXT -Read fully and follow `./step-04-testing.md` +Read fully and follow `steps/step-04-testing.md` diff --git a/skills/bmad-checkpoint-preview/step-04-testing.md b/skills/bmad-checkpoint-preview/steps/step-04-testing.md similarity index 97% rename from skills/bmad-checkpoint-preview/step-04-testing.md rename to skills/bmad-checkpoint-preview/steps/step-04-testing.md index f81807998..ba342c51f 100644 --- a/skills/bmad-checkpoint-preview/step-04-testing.md +++ b/skills/bmad-checkpoint-preview/steps/step-04-testing.md @@ -71,4 +71,4 @@ You've seen the change and how to verify it. When you're ready to make a call, j ## NEXT -When the human signals they're ready to make a decision about this {change_type}, read fully and follow `./step-05-wrapup.md` +When the human signals they're ready to make a decision about this {change_type}, read fully and follow `steps/step-05-wrapup.md` diff --git a/skills/bmad-checkpoint-preview/step-05-wrapup.md b/skills/bmad-checkpoint-preview/steps/step-05-wrapup.md similarity index 100% rename from skills/bmad-checkpoint-preview/step-05-wrapup.md rename to skills/bmad-checkpoint-preview/steps/step-05-wrapup.md diff --git a/skills/bmad-code-review/SKILL.md b/skills/bmad-code-review/SKILL.md index f3883cfed..1cc55173f 100644 --- a/skills/bmad-code-review/SKILL.md +++ b/skills/bmad-code-review/SKILL.md @@ -86,4 +86,4 @@ This uses **step-file architecture** for disciplined execution: ## FIRST STEP -Read fully and follow: `./steps/step-01-gather-context.md` +Read fully and follow: `steps/step-01-gather-context.md` diff --git a/skills/bmad-code-review/steps/step-01-gather-context.md b/skills/bmad-code-review/steps/step-01-gather-context.md index 8b056f46d..db329bafc 100644 --- a/skills/bmad-code-review/steps/step-01-gather-context.md +++ b/skills/bmad-code-review/steps/step-01-gather-context.md @@ -91,4 +91,4 @@ Present a summary before proceeding: diff stats (files changed, lines added/remo ## NEXT -Read fully and follow `./step-02-review.md` +Read fully and follow `steps/step-02-review.md` diff --git a/skills/bmad-code-review/steps/step-02-review.md b/skills/bmad-code-review/steps/step-02-review.md index 04bc67f06..e40705065 100644 --- a/skills/bmad-code-review/steps/step-02-review.md +++ b/skills/bmad-code-review/steps/step-02-review.md @@ -29,4 +29,4 @@ failed_layers: '' # set at runtime: comma-separated list of layers that failed o ## NEXT -Read fully and follow `./step-03-triage.md` +Read fully and follow `steps/step-03-triage.md` diff --git a/skills/bmad-code-review/steps/step-03-triage.md b/skills/bmad-code-review/steps/step-03-triage.md index c51f5a14b..0733f3716 100644 --- a/skills/bmad-code-review/steps/step-03-triage.md +++ b/skills/bmad-code-review/steps/step-03-triage.md @@ -40,4 +40,4 @@ ## NEXT -Read fully and follow `./step-04-present.md` +Read fully and follow `steps/step-04-present.md` diff --git a/skills/bmad-create-epics-and-stories/SKILL.md b/skills/bmad-create-epics-and-stories/SKILL.md index 4399c7bed..9c68e8937 100644 --- a/skills/bmad-create-epics-and-stories/SKILL.md +++ b/skills/bmad-create-epics-and-stories/SKILL.md @@ -87,4 +87,4 @@ Activation is complete. If `activation_steps_prepend` or `activation_steps_appen ## Execution -Read fully and follow: `./steps/step-01-validate-prerequisites.md` to begin the workflow. +Read fully and follow: `steps/step-01-validate-prerequisites.md` to begin the workflow. diff --git a/skills/bmad-create-epics-and-stories/steps/step-03-create-stories.md b/skills/bmad-create-epics-and-stories/steps/step-03-create-stories.md index 599a6786b..8a48363fa 100644 --- a/skills/bmad-create-epics-and-stories/steps/step-03-create-stories.md +++ b/skills/bmad-create-epics-and-stories/steps/step-03-create-stories.md @@ -228,7 +228,7 @@ Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Cont ## CRITICAL STEP COMPLETION NOTE -ONLY WHEN [C continue option] is selected and [all epics and stories saved to document following the template structure exactly], will you then read fully and follow: `./step-04-final-validation.md` to begin final validation phase. +ONLY WHEN [C continue option] is selected and [all epics and stories saved to document following the template structure exactly], will you then read fully and follow: `steps/step-04-final-validation.md` to begin final validation phase. --- diff --git a/skills/bmad-qa-generate-e2e-tests/SKILL.md b/skills/bmad-qa-generate-e2e-tests/SKILL.md index aaf73fcec..429b0bf61 100644 --- a/skills/bmad-qa-generate-e2e-tests/SKILL.md +++ b/skills/bmad-qa-generate-e2e-tests/SKILL.md @@ -166,7 +166,7 @@ If the project needs: Save summary to: `{default_output_file}` -**Done!** Tests generated and verified. Validate against `./checklist.md`. +**Done!** Tests generated and verified. Validate against `checklist.md`. ## On Complete