@slamb2k/mad-skills 2.0.44 → 2.0.45

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mad-skills",
   "description": "AI-assisted planning, development and governance tools",
-  "version": "2.0.44",
+  "version": "2.0.45",
   "author": {
     "name": "slamb2k",
     "url": "https://github.com/slamb2k"

package/hooks/lib/state.cjs

@@ -70,4 +70,33 @@ function savePrefs(projectDir, prefs) {
   writeFileSync(prefsPath(projectDir), JSON.stringify(prefs, null, 2));
 }
 
-module.exports = { save, load, clear, isRecentlyChecked, loadPrefs, savePrefs };
+// ─── pending build marker ─────────────────────────────────────────────
+
+function pendingBuildPath(projectDir) {
+  return join(STATE_DIR, `${projectKey(projectDir)}-pending-build.json`);
+}
+
+function savePendingBuild(projectDir, specPath) {
+  ensureDir();
+  writeFileSync(pendingBuildPath(projectDir), JSON.stringify({
+    specPath,
+    projectDir,
+    timestamp: Date.now(),
+  }, null, 2));
+}
+
+function loadPendingBuild(projectDir) {
+  const path = pendingBuildPath(projectDir);
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function clearPendingBuild(projectDir) {
+  try { unlinkSync(pendingBuildPath(projectDir)); } catch { /* noop */ }
+}
+
+module.exports = { save, load, clear, isRecentlyChecked, loadPrefs, savePrefs, savePendingBuild, loadPendingBuild, clearPendingBuild };

package/hooks/session-guard.cjs

@@ -80,7 +80,10 @@ function check() {
   // 3) Staleness evaluation
   checkStaleness(PROJECT_DIR, CLAUDE_MD, gitRoot, output);
 
-  // 4) Staleness summary
+  // 4) Pending build check
+  checkPendingBuild(PROJECT_DIR, output);
+
+  // 5) Staleness summary
   if (output.score >= config.staleness.threshold) {
     output.blank();
     output.add(`[SESSION GUARD] \u26A0\uFE0F  CLAUDE.md appears STALE (score: ${output.score}/${config.staleness.threshold})`);
@@ -231,6 +234,26 @@ function checkRig(projectDir, output) {
   );
 }
 
+// ─── pending build check ──────────────────────────────────────────────
+
+function checkPendingBuild(projectDir, output) {
+  const pending = state.loadPendingBuild(projectDir);
+  if (!pending) return;
+
+  const specPath = pending.specPath;
+  const specExists = existsSync(join(projectDir, specPath));
+
+  if (!specExists) {
+    // Spec file was deleted — clean up stale marker
+    state.clearPendingBuild(projectDir);
+    return;
+  }
+
+  output.blank();
+  output.add(`[SESSION GUARD] 📋 Pending spec ready for build: ${specPath}`);
+  output.add(`[SESSION GUARD] → Run: /build ${specPath}`);
+}
+
 // ─── helpers ───────────────────────────────────────────────────────────
 
 function emit(output) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slamb2k/mad-skills",
-  "version": "2.0.44",
+  "version": "2.0.45",
   "description": "Claude Code skills collection — full lifecycle development tools",
   "type": "module",
   "repository": {

package/skills/build/SKILL.md

@@ -102,12 +102,17 @@ For each row, in order:
 4. After all checks: summarize what's available and what's degraded
 
 1. Capture **PLAN** (the user's argument) and **FLAGS**
-2. **Load project context** — invoke `/prime` to load domain-specific context
+2. **Clear pending-build marker** — if a marker was left by `/speccy`, clear it:
+   ```bash
+   PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/slamb2k}"
+   node -e "require('$PLUGIN_ROOT/hooks/lib/state.cjs').clearPendingBuild(process.cwd())"
+   ```
+3. **Load project context** — invoke `/prime` to load domain-specific context
    (CLAUDE.md, specs, memory). If /prime is unavailable, fall back to
    manually scanning CLAUDE.md and specs/ directory.
-3. Detect project type using `references/project-detection.md` to populate
+4. Detect project type using `references/project-detection.md` to populate
    **PROJECT_CONFIG** (language, test_runner, test_setup)
-4. **Create task list** — ALWAYS create tasks upfront for all stages using
+5. **Create task list** — ALWAYS create tasks upfront for all stages using
    `TaskCreate`. This provides visible progress tracking throughout the build:
    - Task: "Stage 1: Explore codebase"
    - Task: "Stage 2: Clarifying questions" (if not `--skip-questions`)
@@ -117,11 +122,11 @@ For each row, in order:
    - Task: "Stage 7: Verify"
    - Task: "Stage 9: Ship" (if not `--no-ship`)
    Mark each task `in_progress` when starting and `completed` when done.
-5. Check for outstanding items from previous work:
+6. Check for outstanding items from previous work:
    - Query persistent tasks via `TaskList` for incomplete items
    - Search CLAUDE.md for a "Known Issues" or "Open Questions" section
    - Search memory (if available) for recent unresolved items
-4. If outstanding items found, present via AskUserQuestion:
+7. If outstanding items found, present via AskUserQuestion:
    ```
    "Found {count} outstanding items from previous work:"
    {numbered list with summary of each}

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-03-24T15:07:20.484Z",
+  "generated": "2026-03-24T21:58:11.133Z",
   "count": 10,
   "skills": [
     {
@@ -16,7 +16,7 @@
       "name": "build",
       "directory": "build",
       "description": "Context-isolated feature development pipeline. Takes a detailed design/plan as argument and executes the full feature-dev lifecycle (explore, question, architect, implement, review, ship) inside subagents so the primary conversation stays compact. Use when you have a well-defined plan and want autonomous execution with minimal context window consumption.",
-      "lines": 451,
+      "lines": 456,
       "hasScripts": false,
       "hasReferences": true,
       "hasAssets": false,
@@ -86,7 +86,7 @@
       "name": "speccy",
       "directory": "speccy",
       "description": "Deep-dive interview skill for creating comprehensive specifications. Reviews existing code and docs, then interviews the user through multiple rounds of targeted questions covering technical implementation, UI/UX, concerns, and tradeoffs. Produces a structured spec in specs/. Use when starting a new feature, system, or major change that needs a spec.",
-      "lines": 249,
+      "lines": 260,
       "hasScripts": false,
       "hasReferences": true,
       "hasAssets": false,

package/skills/speccy/SKILL.md

@@ -232,10 +232,21 @@ After the spec is created, report to the user:
 └─────────────────────────────────────────────────
 ```
 
+Then write a **pending-build marker** so the next session knows about this spec:
+
+```bash
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/slamb2k}"
+node -e "require('$PLUGIN_ROOT/hooks/lib/state.cjs').savePendingBuild(process.cwd(), '{spec file path}')"
+```
+
+This marker is picked up by the session-guard hook on the next session start
+(including after `/clear`), which surfaces the build command automatically.
+
 Then display the build command:
 
 ```
 ⚡ To implement, run: /build {spec file path}
+   (You can /clear first — the spec is saved and the next session will remind you)
 ```
 
 The spec file persists on disk, so the user can `/clear` the conversation