5-phase-workflow 1.7.1 → 1.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "5-phase-workflow",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "A 5-phase feature development workflow for Claude Code",
   "bin": {
     "5-phase-workflow": "bin/install.js"

package/src/agents/feature-planner.md

@@ -18,6 +18,7 @@ HARD CONSTRAINTS — violations waste tokens and get blocked by plan-guard:
 - NEVER describe HOW something will be implemented (file contents, signatures, class structures)
 - NEVER spawn Task agents with subagent_type other than Explore
 - NEVER write to any file except .5/features/{name}/feature.md and .5/.planning-active
+- NEVER call EnterPlanMode — the workflow has its own planning process
 - The feature spec describes WHAT and WHY, never HOW
 - If you feel the urge to implement, STOP and ask a clarifying question instead
 - Your output is a SPECIFICATION, not a design document. No code. No file layouts. No API shapes.

package/src/agents/implementation-planner.md

@@ -16,6 +16,7 @@ After creating the plan, you are DONE.
 HARD CONSTRAINTS — violations waste tokens and get blocked by plan-guard:
 - NEVER write code, pseudo-code, or implementation snippets
 - NEVER create source files — you create ONE file: plan.md
+- NEVER call EnterPlanMode — the workflow has its own planning process
 - NEVER spawn Task agents with subagent_type other than Explore
 - The plan describes WHAT to build and WHERE. Agents figure out HOW by reading existing code.
 - Each component in the table gets: name, action, file path, one-sentence description, complexity

package/src/hooks/plan-guard.js

@@ -20,8 +20,8 @@ process.stdin.on('end', () => {
     const data = JSON.parse(input);
     const toolName = data.tool_name || '';
 
-    // Short-circuit: only check Task, Write, and Edit tools
-    if (toolName !== 'Task' && toolName !== 'Write' && toolName !== 'Edit') {
+    // Short-circuit: only check Task, Write, Edit, and EnterPlanMode tools
+    if (toolName !== 'Task' && toolName !== 'Write' && toolName !== 'Edit' && toolName !== 'EnterPlanMode') {
       process.exit(0);
     }
 
@@ -41,6 +41,20 @@ process.stdin.on('end', () => {
     }
 
     // Planning mode enforcement
+    if (toolName === 'EnterPlanMode') {
+      const blockCount = incrementBlockCount(workspaceDir);
+      const escalation = blockCount >= 3
+        ? ` WARNING: Block #${blockCount}. Repeated violations. Complete your planning artifact and STOP.`
+        : '';
+      process.stderr.write(
+        `BLOCKED: EnterPlanMode is not allowed during workflow planning phases. ` +
+        `The 5-phase workflow has its own planning process. ` +
+        `REDIRECT: Continue with your current planning task. ` +
+        `Write your output to .5/features/{name}/ and output the completion message when done.${escalation}`
+      );
+      process.exit(2);
+    }
+
     if (toolName === 'Task') {
       const agentType = toolInput.subagent_type || '';
       if (agentType && agentType !== 'Explore') {

package/src/settings.json

@@ -38,7 +38,7 @@
         ]
       },
       {
-        "matcher": "Task|Write|Edit",
+        "matcher": "Task|Write|Edit|EnterPlanMode",
         "hooks": [
           {
             "type": "command",