From c9c257d7362626f9b841c1eae38fa80b511db9c3 Mon Sep 17 00:00:00 2001
From: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
Date: Wed, 1 Apr 2026 04:24:09 -0700
Subject: [PATCH] refactor(checkpoint): inline workflow into SKILL.md and add
 global step rules
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Remove separate workflow.md — its content now lives directly in SKILL.md
with merged frontmatter. Replace scattered standing rules with a structured
Global Step Rules section (path:line format, front-load output, comm style).
---
 .../bmad-checkpoint-preview/SKILL.md          | 24 ++++++++++++++++++-
 .../bmad-checkpoint-preview/workflow.md       | 24 -------------------
 2 files changed, 23 insertions(+), 25 deletions(-)
 delete mode 100644 src/bmm-skills/4-implementation/bmad-checkpoint-preview/workflow.md

diff --git a/src/bmm-skills/4-implementation/bmad-checkpoint-preview/SKILL.md b/src/bmm-skills/4-implementation/bmad-checkpoint-preview/SKILL.md
index 540d07033..55419c58e 100644
--- a/src/bmm-skills/4-implementation/bmad-checkpoint-preview/SKILL.md
+++ b/src/bmm-skills/4-implementation/bmad-checkpoint-preview/SKILL.md
@@ -1,6 +1,28 @@
 ---
 name: bmad-checkpoint-preview
 description: 'Guided walkthrough of a change, from purpose and context into details. Use when the user says "walk me through this change", "human review", or "review walkthrough".'
+main_config: '{project-root}/_bmad/bmm/config.yaml'
 ---
 
-Follow the instructions in ./workflow.md.
+# Checkpoint Review Workflow
+
+**Goal:** Guide a human through reviewing a change — from purpose and context into details.
+
+You are assisting the user in reviewing a change.
+
+## Global Step Rules (apply to every step)
+
+- **Path:line format** — Every code reference must be clickable `path:line` (absolute or relative to repo root).
+- **Front-load then shut up** — Present the entire output for the current step in a single coherent message. Do not ask questions mid-step, do not drip-feed, do not pause between sections.
+- **Communication style** — Always output using the exact Agent communication style defined in SKILL.md and the loaded config.
+
+## INITIALIZATION
+
+Load and read full config from `{main_config}` and resolve:
+
+- `implementation_artifacts`
+- `communication_language`
+
+## FIRST STEP
+
+Read fully and follow `./step-01-orientation.md` to begin.
diff --git a/src/bmm-skills/4-implementation/bmad-checkpoint-preview/workflow.md b/src/bmm-skills/4-implementation/bmad-checkpoint-preview/workflow.md
deleted file mode 100644
index cb07e1272..000000000
--- a/src/bmm-skills/4-implementation/bmad-checkpoint-preview/workflow.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-main_config: '{project-root}/_bmad/bmm/config.yaml'
----
-
-# Checkpoint Review Workflow
-
-**Goal:** Guide a human through reviewing a change — from purpose and context into details.
-
-You are assisting the user in reviewing a change.
-
-**Standing rule:** Every code reference you produce must use clickable `path:line` format — absolute or relative to the current working directory (e.g., `src/auth/middleware.ts:42`).
-
-## INITIALIZATION
-
-Load and read full config from `{main_config}` and resolve:
-
-- `implementation_artifacts`
-- `communication_language`
-
-YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`.
-
-## FIRST STEP
-
-Read fully and follow `./step-01-orientation.md` to begin.