@lifeaitools/rdc-skills 0.9.9 → 0.9.11

package/hooks/check-cwd.js

@@ -1,10 +1,16 @@
 #!/usr/bin/env node
-// Hard blocks session if CWD is not C:\Dev\regen-root.
+// Hard blocks session if CWD is not the regen-root project directory.
 // Exits with code 1 to fail the hook + outputs a blocking systemMessage.
 
-const hookLog  = require('./hook-logger');
-const cwd      = process.cwd().replace(/\\/g, '/');
-const expected = 'C:/Dev/regen-root';
+const { execSync } = require('child_process');
+const hookLog = require('./hook-logger');
+const cwd     = process.cwd().replace(/\\/g, '/');
+
+let expected = 'regen-root';
+try {
+  expected = execSync('git rev-parse --show-toplevel', { encoding: 'utf8', stdio: 'pipe' })
+    .trim().replace(/\\/g, '/');
+} catch (_) {}
 
 if (!cwd.endsWith('regen-root')) {
   hookLog('check-cwd', 'SessionStart', 'block', { cwd, expected });
@@ -15,7 +21,7 @@ if (!cwd.endsWith('regen-root')) {
       `Required:      "${expected}"\n\n` +
       `DO NOT proceed with any task. DO NOT read files, run commands, or help with anything.\n\n` +
       `Tell the user:\n` +
-      `"Session is blocked. Claude Code must be launched from C:\\Dev\\regen-root.\n` +
+      `"Session is blocked. Claude Code must be launched from ${expected}.\n` +
       ` Close this session and relaunch from the correct directory."\n\n` +
       `Then stop.`
   }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "description": "RDC typed-agent dispatch skill suite for Claude Code \u00e2\u20ac\u201d plan, build, review, overnight builds",
   "keywords": [
     "claude-code",

package/skills/build/SKILL.md

@@ -71,12 +71,26 @@ Read the task title and description, then:
 
 ## Procedure
 
-1. **Load the epic:**
+1. **Load the epic and run pre-flight gate:**
    ```sql
    SELECT get_work_items_by_epic('<epic-id>', 'todo');
    ```
-   - Interactive (no args): show open epics, ask which to build
-   - Unattended (no tasks found): escalate via advisor tool
+
+   **Pre-flight gate — run before any agent dispatch:**
+
+   | Condition | Action |
+   |-----------|--------|
+   | No child tasks returned | → Invoke `rdc:plan` on this epic. Do NOT proceed with build. |
+   | Tasks exist but all have empty `description` fields | → Invoke `rdc:plan` on this epic. Tasks without descriptions cannot be safely dispatched. |
+   | Tasks exist and have descriptions | → Continue with build. |
+
+   **Re-planning is not a failure — it is correct behavior.** The build skill is the last gate before agent dispatch; catching an under-specified epic here is cheaper than a wasted agent run.
+
+   **How to re-plan:**
+   - Interactive: tell the user — "Epic has no tasks / tasks lack descriptions — invoking rdc:plan first." Then invoke `rdc:plan <epic-id>`.
+   - Unattended: invoke `rdc:plan <epic-id> --unattended` inline, wait for it to complete, then reload tasks and re-run this gate once. If tasks still missing after re-plan, escalate via advisor.
+
+   **Interactive (no args):** show open epics, ask which to build.
 
 2. **CHECK FOR EXISTING WORK (mandatory — never skip):**
    ```sql
@@ -131,11 +145,31 @@ Read the task title and description, then:
    Without `max_turns: 70`, agents hit the default turn cap mid-task and stop.
    `isolation: "worktree"` gives each agent its own git worktree and branch — eliminates push race conditions and index lock contention when multiple agents commit in parallel. The supervisor merges worktree branches after each wave (Step 9).
 
+   ### Forked agents vs. standalone agents
+
+   **When the supervisor has already read the plan** (via a prior `Read` tool call in the same session),
+   dispatch **forked agents** with short prompts. Forked agents inherit the full conversation context —
+   including every file the supervisor has read — so you do NOT need to copy plan sections, file specs,
+   or architecture details into the prompt. The agent already sees them.
+
+   Short forked prompt template:
+   ```
+   You are a frontend agent building <WP name>. Work item: <uuid>.
+   Scope: <one sentence>. Files: <list>. Verification: tsc --noEmit.
+   Set item to review when done, return AGENT_COMPLETE with verification evidence.
+   Read .rdc/guides/agent-bootstrap.md + .rdc/guides/frontend.md before starting.
+   ```
+
+   **When the supervisor has NOT read the plan** (e.g. dispatching from a fresh `rdc:build` call with
+   only an epic ID), the agent has no plan context — write a full briefing prompt with all specs.
+
+   ---
+
    ### Required agent prompt contents
    - Set work item to `in_progress` before dispatching
    - Each agent prompt MUST include:
      - `"Read {PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md first (fallback: .rdc/guides/agent-bootstrap.md), then {PROJECT_ROOT}/.rdc/guides/<type>.md (fallback: .rdc/guides/<type>.md) before starting."`
-     - Specific files to create/modify
+     - Specific files to create/modify (or omit if forked agent inherits plan context)
      - Exact deliverables and commit message
      - `"NEVER run pnpm build/test. NEVER modify files outside your scope."`
      - **`"You are running in an isolated git worktree. Commit your work normally. Do NOT push to origin — the supervisor merges your branch after the wave completes."`**