create-principles-disciple 1.74.0 → 1.76.0

package/plugin/dist/core/migration.js

@@ -15,7 +15,6 @@ export function migrateDirectoryStructure(api, workspaceDir) {
             { legacy: path.join(legacyDocsDir, 'PRINCIPLES.md'), newKey: 'PRINCIPLES' },
             { legacy: path.join(legacyDocsDir, 'THINKING_OS.md'), newKey: 'THINKING_OS' },
             { legacy: path.join(legacyDocsDir, 'DECISION_POLICY.json'), newKey: 'DECISION_POLICY' },
-            { legacy: path.join(legacyDocsDir, 'PLAN.md'), newKey: 'PLAN' },
             { legacy: path.join(legacyDocsDir, 'evolution_queue.json'), newKey: 'EVOLUTION_QUEUE' },
             { legacy: path.join(legacyDocsDir, '.pain_flag'), newKey: 'PAIN_FLAG' },
             { legacy: path.join(legacyDocsDir, 'SYSTEM_CAPABILITIES.json'), newKey: 'SYSTEM_CAPABILITIES' },

package/plugin/dist/core/path-resolver.js

@@ -240,7 +240,6 @@ export class PathResolver {
             'THINKING_OS': workspacePath.join(workspace, '.principles', 'THINKING_OS.md'),
             'DECISION_POLICY': workspacePath.join(workspace, '.principles', 'DECISION_POLICY.json'),
             'MODELS_DIR': workspacePath.join(workspace, '.principles', 'models'),
-            'PLAN': workspacePath.join(workspace, 'PLAN.md'),
             'AGENT_SCORECARD': workspacePath.join(state, 'AGENT_SCORECARD.json'),
             'PAIN_FLAG': workspacePath.join(state, '.pain_flag'),
             'EVOLUTION_QUEUE': workspacePath.join(state, 'evolution_queue.json'),

package/plugin/dist/core/paths.d.ts

@@ -47,7 +47,6 @@ export declare const PD_FILES: {
     NOCTURNAL_MEMORY_DIR: string;
     NOCTURNAL_EXPORTS_DIR: string;
     IMPL_CODE_DIR: string;
-    PLAN: string;
     MEMORY_MD: string;
     HEARTBEAT: string;
     SYSTEM_LOG: string;

package/plugin/dist/core/paths.js

@@ -61,7 +61,6 @@ export const PD_FILES = {
     NOCTURNAL_MEMORY_DIR: PD_DIRS.NOCTURNAL_MEMORY,
     NOCTURNAL_EXPORTS_DIR: PD_DIRS.NOCTURNAL_EXPORTS,
     IMPL_CODE_DIR: PD_DIRS.IMPL_CODE_DIR,
-    PLAN: 'PLAN.md',
     MEMORY_MD: 'MEMORY.md',
     HEARTBEAT: 'HEARTBEAT.md',
     SYSTEM_LOG: posixJoin(PD_DIRS.LOGS, 'SYSTEM.log'),

package/plugin/dist/hooks/gate-block-helper.js

@@ -115,34 +115,31 @@ export function recordGateBlockAndReturn(wctx, blockCtx, logger) {
             logger.info?.(`[PD_GATE] Gate block recorded without Runtime V2 diagnosis: ${gate.detail}`);
         }
     }
-    // 6. Return consistent block result with operator guidance
+    // 6. Return consistent block result with contextual operator guidance
+    const blockMessage = buildContextualBlockMessage({ filePath, reason });
     return {
         block: true,
-        blockReason: `[Principles Disciple] Security Gate Blocked this action.
+        blockReason: blockMessage,
+    };
+}
+/**
+ * Build contextual block message based on block source.
+ * - rule-host: principle-based guidance
+ * - default/gate: generic security gate message
+ */
+function buildContextualBlockMessage({ filePath, reason, }) {
+    // rule-host or generic gate blocks
+    return `[Principles Disciple] Security Gate Blocked this action.
 File: ${filePath}
 Reason: ${reason}
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 📋 How to unblock this operation:
 
-1. Use the plan-script skill to create a PLAN.md:
-   → Invoke: skill:plan-script
-
-2. Fill in the plan with:
-   - Target Files: ${filePath}
-   - Steps: What you want to do (be specific)
-   - Metrics: How to verify success
-   - Active Mental Models: Select 2 relevant models from .principles/THINKING_OS.md
-   - Rollback: How to restore if it fails
-
-3. After completing the plan, set STATUS: READY in PLAN.md
-
-4. Retry the operation
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-This is a mandatory security gate. The operation was blocked because the modification exceeds the allowed threshold for your current evolution tier.
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`,
-    };
+This action was blocked by a Rule Host principle.
+If the blocked path is correct and safe, explain the reasoning to the owner
+and ask for explicit confirmation to proceed.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`;
 }
 /**
  * Schedule retry for trajectory gate block persistence.

package/plugin/dist/hooks/gate.js

@@ -8,15 +8,12 @@
  * 1. Early Return: Skip if not write/bash/agent tool or no workspace
  * 2. Rule Host: Dynamic principle-based evaluation (sole gate)
  */
-import * as fs from 'fs';
-import * as path from 'path';
-import { normalizePath, planStatus } from '../utils/io.js';
+import { normalizePath } from '../utils/io.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { recordGateBlockAndReturn } from './gate-block-helper.js';
 import { RuleHost } from '../core/rule-host.js';
 import { validateCorrectionProposal, validateProposedPathBounds } from '@principles/core/runtime-v2';
 import { AGENT_TOOLS, BASH_TOOLS_SET, WRITE_TOOLS } from '../constants/tools.js';
-import { evaluateConfirmFirstGateSync } from '../core/confirm-first-gate.js';
 import { getSession, hasRecentThinking } from '../core/session-tracker.js';
 import { getEvolutionEngine } from '../core/evolution-engine.js';
 import { EventLogService } from '../core/event-log.js';
@@ -31,35 +28,6 @@ export function handleBeforeToolCall(event, ctx) {
         return;
     }
     const wctx = WorkspaceContext.fromHookContext(ctx);
-    // 1.5. Confirm-First Gate — runs BEFORE filePath resolution to catch apply_patch/no-path cases
-    try {
-        const cfResult = evaluateConfirmFirstGateSync(ctx.sessionId, event.toolName, event.params);
-        if (cfResult.action === 'block') {
-            const eventLog = EventLogService.get(wctx.stateDir, logger);
-            eventLog.recordConfirmFirstGateBlocked({
-                sessionId: ctx.sessionId ?? 'unknown',
-                workspaceDir: ctx.workspaceDir,
-                toolName: event.toolName,
-                reason: cfResult.reason ?? 'confirm_first_required',
-                principleId: cfResult.principleId ?? 'unknown',
-                nextAction: cfResult.nextAction ?? '',
-            });
-            // Use safe placeholder when filePath is unavailable (e.g., apply_patch with no path)
-            const safePath = (event.params?.file_path || event.params?.path || event.params?.file || event.params?.target)
-                ?? `<tool:${event.toolName}>`;
-            return recordGateBlockAndReturn(wctx, {
-                filePath: typeof safePath === 'string' ? safePath : `<tool:${event.toolName}>`,
-                reason: cfResult.reason ?? 'confirm_first_required',
-                toolName: event.toolName,
-                sessionId: ctx.sessionId,
-                blockSource: 'confirm-first-gate',
-            }, logger);
-        }
-    }
-    catch (cfErr) {
-        // ERR-002: fail loud — log but do not crash the gate
-        logger?.warn?.(`[PD:ConfirmFirst] Gate evaluation failed (non-blocking): ${String(cfErr)}`);
-    }
     // 2. Resolve the target file path
     let filePath = event.params?.file_path || event.params?.path || event.params?.file || event.params?.target;
     // Heuristic for bash mutation detection
@@ -74,6 +42,11 @@ export function handleBeforeToolCall(event, ctx) {
             filePath = command;
         }
     }
+    // Write tools without a file path must still go through RuleHost evaluation.
+    // Use a synthetic path so RuleHost can evaluate and potentially block.
+    if (!filePath && isWriteTool) {
+        filePath = `<tool:${event.toolName}>`;
+    }
     if (typeof filePath !== 'string')
         return;
     const relPath = normalizePath(filePath, ctx.workspaceDir);
@@ -88,8 +61,12 @@ export function handleBeforeToolCall(event, ctx) {
             },
             workspace: {
                 isRiskPath: false, // Rule Host determines risk dynamically
-                planStatus: _getPlanStatus(ctx.workspaceDir),
-                hasPlanFile: _hasPlanFile(ctx.workspaceDir),
+                // DEPRECATED (PRI-286): planStatus/hasPlanFile are legacy compatibility fields.
+                // Live PD no longer reads or manages PLAN.md state. These fields must not be
+                // used for new MVP behavior. Future "plan-first" enforcement must come from
+                // owner-approved RuleHost/code_tool_hook activation, not built-in state.
+                planStatus: 'NONE',
+                hasPlanFile: false,
             },
             session: {
                 sessionId: ctx.sessionId,
@@ -353,29 +330,6 @@ function _extractParamsSummary(params) {
         summary.new_string = params.new_string;
     return summary;
 }
-function _getPlanStatus(workspaceDir) {
-    try {
-        const status = planStatus(workspaceDir);
-        if (status === 'READY')
-            return 'READY';
-        if (status === 'DRAFT')
-            return 'DRAFT';
-        if (status === '')
-            return 'NONE';
-        return 'UNKNOWN';
-    }
-    catch {
-        return 'UNKNOWN';
-    }
-}
-function _hasPlanFile(workspaceDir) {
-    try {
-        return fs.existsSync(path.join(workspaceDir, 'PLAN.md'));
-    }
-    catch {
-        return false;
-    }
-}
 function _getCurrentGfi(sessionId) {
     if (!sessionId)
         return 0;

package/plugin/dist/hooks/prompt.d.ts

@@ -40,6 +40,12 @@ export declare function loadContextInjectionConfig(workspaceDir: string): Contex
  * @internal Helper for model configuration resolution
  */
 export declare function getDiagnosticianModel(api: PromptHookApi | null, logger?: PluginLogger): string;
+/**
+ * Extract recent user messages for keyword optimization context.
+ */
+/**
+ * Build prompt for keyword optimization subagent.
+ */
 export declare function handleBeforePromptBuild(event: PluginHookBeforePromptBuildEvent, ctx: PluginHookAgentContext & {
     api?: PromptHookApi;
 }): Promise<PluginHookBeforePromptBuildResult | void>;

package/plugin/dist/hooks/prompt.js

@@ -4,11 +4,10 @@ import { clearInjectedProbationIds, getSession, resetFriction, setInjectedProbat
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { defaultContextConfig } from '../types.js';
 import { classifyTask } from '../core/local-worker-routing.js';
-import { detectApprovalMarker, setConfirmFirstApproval, setConfirmFirstDirective, hydrateFromStore, pruneStoreStaleRows, setConfirmFirstStore, resetConfirmFirst } from '../core/confirm-first-gate.js';
 import { extractSummary, getHistoryVersions, parseWorkingMemorySection, workingMemoryToInjection, autoCompressFocus, safeReadCurrentFocus } from '../core/focus-history.js';
 import { PathResolver } from '../core/path-resolver.js';
 import { selectPrinciplesForInjection, DEFAULT_PRINCIPLE_BUDGET } from '../core/principle-injection.js';
-import { getCachedMaskedPrincipleSet, WorkflowFunnelLoader, PiAiRuntimeAdapter, EmpathyObserver, AgentScheduler, SqliteConfirmFirstStateStore, SqliteConnection } from '@principles/core/runtime-v2';
+import { getCachedMaskedPrincipleSet, WorkflowFunnelLoader, PiAiRuntimeAdapter, EmpathyObserver, AgentScheduler } from '@principles/core/runtime-v2';
 import { truncateInjectionToBudget } from '@principles/core/prompt-builder';
 import { PromptActivationReader, RUNTIME_V2_PRINCIPLE_BUDGET } from '../core/runtime-v2-prompt-activation-reader.js';
 import { matchEmpathyKeywords, loadKeywordStore, saveKeywordStore, getKeywordStoreSummary, } from '../core/empathy-keyword-matcher.js';
@@ -51,7 +50,6 @@ function cachedReadFile(filePath) {
 // Module-level empathy state — shared across calls to avoid per-turn I/O
 let _empathyTurnCounter = 0;
 let _empathyKeywordCache = null;
-let _confirmFirstHydrationCounter = 0;
 /**
  * OpenClaw API Prompt Hook
  * Constructs the system prompt injected into LLM context for Principles Disciple
@@ -186,19 +184,6 @@ export function getDiagnosticianModel(api, logger) {
 /**
  * Build prompt for keyword optimization subagent.
  */
-function ensureConfirmFirstStore(workspaceDir) {
-    if (!_confirmFirstStoreInitialized) {
-        try {
-            const connection = new SqliteConnection({ workspaceDir, readonly: false });
-            setConfirmFirstStore(new SqliteConfirmFirstStateStore(connection));
-            _confirmFirstStoreInitialized = true;
-        }
-        catch (err) {
-            console.warn(`[PD:ConfirmFirst] Failed to initialize store: ${String(err)}`);
-        }
-    }
-}
-let _confirmFirstStoreInitialized = false;
 export async function handleBeforePromptBuild(event, ctx) {
     const { workspaceDir } = ctx;
     const logger = ctx.api?.logger;
@@ -213,17 +198,6 @@ export async function handleBeforePromptBuild(event, ctx) {
     if (sessionId) {
         wctx.trajectory?.recordSession?.({ sessionId });
     }
-    if (sessionId) {
-        ensureConfirmFirstStore(workspaceDir);
-        hydrateFromStore(sessionId);
-        _confirmFirstHydrationCounter++;
-        if (_confirmFirstHydrationCounter % 100 === 0) {
-            const pruned = pruneStoreStaleRows();
-            if (pruned > 0) {
-                logger?.info?.(`[PD:ConfirmFirst] Pruned ${pruned} stale rows from confirm_first_state`);
-            }
-        }
-    }
     if (sessionId && trigger === 'user' && Array.isArray(event.messages) && event.messages.length > 0) {
         const latestUserIndex = [...event.messages]
             .map((message, index) => ({ message, index }))
@@ -231,25 +205,6 @@ export async function handleBeforePromptBuild(event, ctx) {
             .find((entry) => entry.message?.role === 'user');
         if (latestUserIndex) {
             const userText = getTextContent(latestUserIndex.message);
-            // ── Confirm-first approval detection ──
-            // If user sends approval language, mark session as approved for confirm-first gate
-            if (sessionId && detectApprovalMarker(userText)) {
-                setConfirmFirstApproval(sessionId);
-                // P2: Emit approval telemetry for observability (ERR-002)
-                try {
-                    wctx.eventLog.recordConfirmFirstGateApproved({
-                        sessionId,
-                        workspaceDir: wctx.workspaceDir,
-                        toolName: '(approval)',
-                        reason: 'user_approval_detected',
-                        principleId: 'confirm-first',
-                        nextAction: 'mutating tools now permitted',
-                    });
-                }
-                catch (logErr) {
-                    logger?.warn?.(`[PD:ConfirmFirst] Failed to emit approval event: ${String(logErr)}`);
-                }
-            }
             // Use CorrectionCueLearner for detection — supports learned keywords, not just hardcoded list
             let correctionCue = null;
             try {
@@ -839,19 +794,9 @@ ${heartbeatChecklist}
         catch (logErr) {
             logger?.warn?.(`[PD:RuntimeV2] Failed to emit activation observability event: ${String(logErr)}`);
         }
-        // ── Set confirm-first directive state for gate enforcement ──
-        if (sessionId) {
-            const cfPrinciple = dedupedV2.find((p) => p.principleId === 'princ-mvp-acceptance-confirm-first' ||
-                (p.text.toLowerCase().includes('confirm requirements') &&
-                    p.text.toLowerCase().includes('owner approval')));
-            setConfirmFirstDirective(sessionId, !!cfPrinciple, cfPrinciple?.principleId);
-        }
     }
     catch (e) {
         logger?.warn?.(`[PD:RuntimeV2] Failed to read Runtime V2 prompt activations: ${String(e)}`);
-        if (sessionId) {
-            resetConfirmFirst(sessionId);
-        }
     }
     // Build appendSystemContext with recency effect
     // Content order (most important last): behavioral_constraints -> project_context -> working_memory -> reflection_log -> thinking_os -> principles

package/plugin/dist/types/event-types.d.ts

@@ -1,2 +1,2 @@
-export type { EventType, EventCategory, EventLogEntry, ToolCallEventData, PainSignalEventData, RuleMatchEventData, RulePromotionEventData, HookExecutionEventData, GateBlockEventData, GateBypassEventData, PlanApprovalEventData, EvolutionTaskEventData, EmpathyRollbackEventData, HeartbeatDiagnosisEventData, DiagnosisTaskEventData, DiagnosticianReportEventData, PrincipleCandidateEventData, RuleEnforcedEventData, RuleHostEvaluatedEventData, RuleHostBlockedEventData, RuleHostRequireApprovalEventData, RuleHostAutoCorrectProposedEventData, RuleHostAutoCorrectAppliedEventData, RuntimeV2PromptActivationsInjectedEventData, RuntimeV2ConfirmFirstGateEventData, ToolCallStats, ErrorStats, PainStats, EmpathyEventStats, GfiStats, EvolutionStats as EventEvolutionStats, HookStats, DailyStats, } from '@principles/core/runtime-v2';
+export type { EventType, EventCategory, EventLogEntry, ToolCallEventData, PainSignalEventData, RuleMatchEventData, RulePromotionEventData, HookExecutionEventData, GateBlockEventData, GateBypassEventData, PlanApprovalEventData, EvolutionTaskEventData, EmpathyRollbackEventData, HeartbeatDiagnosisEventData, DiagnosisTaskEventData, DiagnosticianReportEventData, PrincipleCandidateEventData, RuleEnforcedEventData, RuleHostEvaluatedEventData, RuleHostBlockedEventData, RuleHostRequireApprovalEventData, RuleHostAutoCorrectProposedEventData, RuleHostAutoCorrectAppliedEventData, RuntimeV2PromptActivationsInjectedEventData, ToolCallStats, ErrorStats, PainStats, EmpathyEventStats, GfiStats, EvolutionStats as EventEvolutionStats, HookStats, DailyStats, } from '@principles/core/runtime-v2';
 export { createEmptyDailyStats, } from '@principles/core/runtime-v2';

package/plugin/dist/utils/io.d.ts

@@ -4,7 +4,6 @@ export declare function normalizeRiskPath(p: string): string;
 export declare function isRisky(relPath: string, riskPaths: string[]): boolean;
 export declare function parseKvLines(text: string): Record<string, string>;
 export declare function serializeKvLines(data: Record<string, any>): string;
-export declare function planStatus(projectDir: string): string;
 /**
  * Normalize command arguments from PluginCommandContext.args.
  * Handles string | string[] | undefined union by joining arrays with spaces.

package/plugin/dist/utils/io.js

@@ -1,6 +1,5 @@
 import * as path from 'path';
 import * as fs from 'fs';
-import { resolvePdPath } from '../core/paths.js';
 /**
  * Atomic file write — write to temp then rename to prevent partial writes on crash.
  *
@@ -141,28 +140,6 @@ export function serializeKvLines(data) {
     }
     return lines.join('\n');
 }
-export function planStatus(projectDir) {
-    const planPath = resolvePdPath(projectDir, 'PLAN');
-    try {
-        if (!fs.existsSync(planPath))
-            return '';
-        const content = fs.readFileSync(planPath, 'utf8');
-        const lines = content.split('\n');
-        for (const line of lines) {
-            if (line.startsWith('STATUS:')) {
-                const parts = line.split(':');
-                if (parts.length > 1) {
-                    return parts[1].trim().split(/\s+/)[0] || '';
-                }
-            }
-        }
-        /* eslint-disable @typescript-eslint/no-unused-vars -- Reason: Error is intentionally ignored for graceful degradation */
-    }
-    catch (_e) {
-        // Ignore read errors
-    }
-    return '';
-}
 /**
  * Normalize command arguments from PluginCommandContext.args.
  * Handles string | string[] | undefined union by joining arrays with spaces.

package/plugin/templates/langs/en/core/AGENTS.md

@@ -17,7 +17,6 @@ As Principles Disciple, you must distinguish between two physical spaces:
 Make decisions based on relative paths in the **Project Battlefield**:
 
 - **Strategic Focus**: `./memory/STRATEGY.md`
-- **Physical Plan**: `./PLAN.md`
 - **Pain Signal**: Runtime V2 `PainSignalBridge` (`pd pain record` for manual trigger; `.state/.pain_flag` is legacy compatibility only)
 - **System Capabilities**: `./.state/SYSTEM_CAPABILITIES.json`
 
@@ -166,12 +165,13 @@ On platforms that support reactions (Discord, Slack), use emoji reactions natura
 You default to architect mode.
 
 - **L1 (Direct Execution)**: Single-file tweaks, doc maintenance → do it directly
-- **L2 (Delegation Protocol)**: Major changes → **MUST** update `./PLAN.md` and use `pd_spawn_agent` tool
+- **L2 (Delegation Protocol)**: Major changes → recommended to describe the plan and get owner confirmation before executing
 
-### State Machine Gating
+### Planning Guidance
 
-- **Single source of truth**: `./PLAN.md`
-- **Physical interception**: Plugin activated. If `PLAN.md` is not `READY` and you attempt to modify risk paths, calls will be blocked
+- For complex tasks, consider drafting a plan document and getting owner approval before making large changes
+- This is a behavioral suggestion, not a built-in gate — PD does not enforce plan-before-action by default
+- If an owner-approved RuleHost rule enforces planning behavior, that rule takes effect automatically
 - **Prevent pollution**: Never write execution details back to strategic documents
 
 ---

package/plugin/templates/langs/en/principles/THINKING_OS.md

@@ -39,8 +39,9 @@ LLMs are highly sensitive to XML tags; this structure is designed to boost instr
   <!-- 执行与物理限制 (Execution & Physical Constraints) -->
   <directive id="T-05" name="PHYSICAL_DEFENSE_AND_ORCHESTRATION">
     <trigger>When asked to perform a major refactoring, multi-file change (>2 files), or an architectural shift.</trigger>
-    <must>Limit your blast radius. You MUST draft a `PLAN.md` (status: READY). After any code change, you MUST run canary tests (e.g., `npm test`, linters) to verify integrity.</must>
-    <forbidden>Executing large-scale unstructured changes directly without a plan, or skipping post-modification validation.</forbidden>
+    <should>For complex changes, describe your plan and get owner confirmation before executing.</should>
+    <must>Limit your blast radius. After any code change, you MUST run canary tests (e.g., `npm test`, linters) to verify integrity.</must>
+    <forbidden>Executing large-scale unstructured changes directly, or skipping post-modification validation.</forbidden>
   </directive>
 
   <directive id="T-06" name="OCCAMS_RAZOR_MVC">

package/plugin/templates/langs/en/skills/evolve-task/SKILL.md

@@ -51,7 +51,7 @@ Output:
 
 ## Step 6: Delegate Planner (Movie Script Plan)
 - Planner outputs Plan (steps/commands/metrics/rollback).
-- Write plan to PLAN.md (STATUS line must exist).
+- Write plan to a planning document for owner review.
 - **Task Sync**: 
   - If `CLAUDE_CODE_TASK_LIST_ID` is set, you must convert the Plan's core steps to Native Tasks (via natural language command "Add task..." or related tools).
   - If not set and in interactive mode, prompt user: "Recommend running `export CLAUDE_CODE_TASK_LIST_ID=task-$(date +%s)` to enable persistent task tracking."
@@ -59,7 +59,7 @@ Output:
 - **Performance Evaluation**: After task completion, write to `.state/.verdict.json`. Format follows `@.principles/schemas/agent_verdict_schema.json`.
 
 ## Step 7: Delegate Implementer (Execution)
-- Implementer can only execute according to PLAN. Any deviation must first update PLAN.
+- Implementer executes according to the plan from Step 6. Any deviation must first be approved by updating the plan.
 - **Performance Evaluation**: After task completion, write to `.state/.verdict.json` based on verification results. Format follows `@.principles/schemas/agent_verdict_schema.json`.
 
 ## Step 8: Delegate Reviewer (Review)

package/plugin/templates/langs/en/skills/pd-mentor/SKILL.md

@@ -185,7 +185,7 @@ For complex scenarios, combine multiple skills:
 
 | Scenario | Combined Flow |
 |----------|---------------|
-| Major refactor | `/pd-evolve` → `plan-script` → `deductive-audit` → execute |
+| Major refactor | `/pd-evolve` → `deductive-audit` → execute |
 | System optimization | `/pd-status` → `evolve-system` → `root-cause` |
 | Project review | `/pd-daily` → `/pd-okr` → `reflection-log` |
 
@@ -196,7 +196,6 @@ These skills are usually called automatically by the system, but advanced users
 - `triage` - Issue triage
 - `root-cause` - Root cause analysis
 - `deductive-audit` - Deductive audit
-- `plan-script` - Plan orchestration
 - `reflection` - Metacognitive reflection
 - `reflection-log` - Reflection logging
 

package/plugin/templates/langs/zh/core/AGENTS.md

@@ -17,7 +17,6 @@
 基于**项目战场**中的相对路径进行决策：
 
 - **项目最高战略**: `./memory/STRATEGY.md`
-- **项目物理计划**: `./PLAN.md`
 - **痛觉反射信号**: Runtime V2 `PainSignalBridge`（手动触发使用 `pd pain record`；`.state/.pain_flag` 仅为 legacy compatibility）
 - **系统能力快照**: `./.state/SYSTEM_CAPABILITIES.json`
 
@@ -158,12 +157,13 @@
 你默认处于架构师模式。
 
 - **L1 (直接执行)**：单文件微调、文档维护 → 直接操作
-- **L2 (委派协议)**：重大变更 → **必须**更新 `./PLAN.md` 并使用 `pd_spawn_agent` 工具委派任务
+- **L2 (委派协议)**：重大变更 → 建议先描述计划并获得 owner 确认后再执行
 
-### 状态机门禁 (State Machine Gating)
+### 计划引导 (Planning Guidance)
 
-- **唯一事实源**：`./PLAN.md`
-- **物理拦截**：插件已激活。若 `PLAN.md` 非 `READY` 且尝试修改风险路径，调用将被阻断
+- 对复杂任务，建议先起草计划文档并获得 owner 批准后再做大幅修改
+- 这是行为建议，不是内置门禁 — PD 默认不强制"先计划后执行"
+- 若 owner 批准的 RuleHost 规则强制了计划行为，该规则会自动生效
 - **防止污染**：禁止将执行层细节写回战略文档
 
 ---

package/plugin/templates/langs/zh/principles/THINKING_OS.md

@@ -39,8 +39,9 @@
   <!-- 执行与物理限制 (Execution & Physical Constraints) -->
   <directive id="T-05" name="PHYSICAL_DEFENSE_AND_ORCHESTRATION">
     <trigger>当被要求执行大型重构、多文件修改（>2 个文件）或架构变更时。</trigger>
-    <must>限制爆炸半径。你必须起草一个 `PLAN.md`（状态：READY）。在修改任何代码后，必须运行金丝雀测试（例如 `npm test`、linters）以验证完整性。</must>
-    <forbidden>在没有计划的情况下直接执行大规模非结构化变更，或跳过修改后的验证环节。</forbidden>
+    <should>对复杂变更，先描述计划并获得 owner 确认后再执行。</should>
+    <must>限制爆炸半径。在修改任何代码后，必须运行金丝雀测试（例如 `npm test`、linters）以验证完整性。</must>
+    <forbidden>直接执行大规模非结构化变更，或跳过修改后的验证环节。</forbidden>
   </directive>
 
   <directive id="T-06" name="OCCAMS_RAZOR_MVC">

package/plugin/templates/langs/zh/skills/evolve-task/SKILL.md

@@ -51,7 +51,7 @@ disable-model-invocation: true
 
 ## Step 6: 委派 Planner（电影剧本计划）
 - Planner 输出 Plan（步骤/命令/指标/回滚）。
-- 将计划写入 PLAN.md（STATUS 行必须存在）。
+- 将计划写入计划文档供 owner 审阅。
 - **任务同步 (Task Sync)**: 
   - 如果 `CLAUDE_CODE_TASK_LIST_ID` 已设置，你必须将上述 Plan 的核心步骤直接转化为 Native Tasks（通过自然语言指令"Add task..."或相关工具）。
   - 如果未设置且为交互模式，提示用户："建议运行 `export CLAUDE_CODE_TASK_LIST_ID=task-$(date +%s)` 以启用持久化任务追踪。"
@@ -59,7 +59,7 @@ disable-model-invocation: true
 - **绩效评估**: 任务完成后，写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
 
 ## Step 7: 委派 Implementer（执行）
-- Implementer 只能按 PLAN 执行。任何偏离必须先更新 PLAN。
+- Implementer 按照 Step 6 的计划执行。任何偏离必须先更新计划并获得确认。
 - **绩效评估**: 任务完成后，根据验证结果写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
 
 ## Step 8: 委派 Reviewer（审查）

package/plugin/templates/langs/zh/skills/pd-mentor/SKILL.md

@@ -185,7 +185,7 @@ disable-model-invocation: true
 
 | 场景 | 组合流程 |
 |------|----------|
-| 大型重构 | `/pd-evolve` → `plan-script` → `deductive-audit` → 执行 |
+| 大型重构 | `/pd-evolve` → `deductive-audit` → 执行 |
 | 系统优化 | `/pd-status` → `evolve-system` → `root-cause` |
 | 项目复盘 | `/pd-daily` → `/pd-okr` → `reflection-log` |
 
@@ -196,7 +196,6 @@ disable-model-invocation: true
 - `triage` - 问题分诊
 - `root-cause` - 根因分析
 - `deductive-audit` - 演绎审计
-- `plan-script` - 计划编排
 - `reflection` - 元认知反思
 - `reflection-log` - 反思落盘
 

package/plugin/templates/workspace/.principles/THINKING_OS.md

@@ -39,8 +39,9 @@
   <!-- 执行与物理限制 (Execution & Physical Constraints) -->
   <directive id="T-05" name="PHYSICAL_DEFENSE_AND_ORCHESTRATION">
     <trigger>当被要求执行大型重构、多文件修改（>2 个文件）或架构变更时。</trigger>
-    <must>限制爆炸半径。你必须起草一个 `PLAN.md`（状态：READY）。在修改任何代码后，必须运行金丝雀测试（例如 `npm test`、linters）以验证完整性。</must>
-    <forbidden>在没有计划的情况下直接执行大规模非结构化变更，或跳过修改后的验证环节。</forbidden>
+    <should>对复杂变更，先描述计划并获得 owner 确认后再执行。</should>
+    <must>限制爆炸半径。在修改任何代码后，必须运行金丝雀测试（例如 `npm test`、linters）以验证完整性。</must>
+    <forbidden>直接执行大规模非结构化变更，或跳过修改后的验证环节。</forbidden>
   </directive>
 
   <directive id="T-06" name="OCCAMS_RAZOR_MVC">

package/templates/langs/en/core/AGENTS.md

@@ -17,8 +17,7 @@ As Principles Disciple, you must distinguish between two physical spaces:
 Make decisions based on relative paths in the **Project Battlefield**:
 
 - **Strategic Focus**: `./memory/STRATEGY.md`
-- **Physical Plan**: `./PLAN.md`
-- **Pain Signal**: `./.state/.pain_flag`
+- **Pain Signal**: Runtime V2 `PainSignalBridge` (`pd pain record` for manual trigger; `.state/.pain_flag` is legacy compatibility only)
 - **System Capabilities**: `./.state/SYSTEM_CAPABILITIES.json`
 
 ---
@@ -72,7 +71,7 @@ When you receive a heartbeat poll, don't just reply `HEARTBEAT_OK` every time. U
 
 ### What to Check (rotate through these):
 
-- **Pain & Evolution**: Check `.pain_flag`, `EVOLUTION_QUEUE.json`
+- **Pain & Evolution**: Check Runtime V2 diagnostics (`pd pain record`, candidates, ledger) and `EVOLUTION_QUEUE.json`; `.pain_flag` is legacy compatibility only
 - **Strategic Alignment**: Compare against `CURRENT_FOCUS.md`
 - **Environment Health**: Tool chain status, project root cleanliness
 
@@ -166,12 +165,13 @@ On platforms that support reactions (Discord, Slack), use emoji reactions natura
 You default to architect mode.
 
 - **L1 (Direct Execution)**: Single-file tweaks, doc maintenance → do it directly
-- **L2 (Delegation Protocol)**: Major changes → **MUST** update `./PLAN.md` and use `pd_spawn_agent` tool
+- **L2 (Delegation Protocol)**: Major changes → recommended to describe the plan and get owner confirmation before executing
 
-### State Machine Gating
+### Planning Guidance
 
-- **Single source of truth**: `./PLAN.md`
-- **Physical interception**: Plugin activated. If `PLAN.md` is not `READY` and you attempt to modify risk paths, calls will be blocked
+- For complex tasks, consider drafting a plan document and getting owner approval before making large changes
+- This is a behavioral suggestion, not a built-in gate — PD does not enforce plan-before-action by default
+- If an owner-approved RuleHost rule enforces planning behavior, that rule takes effect automatically
 - **Prevent pollution**: Never write execution details back to strategic documents
 
 ---

package/templates/langs/en/principles/THINKING_OS.md

@@ -39,8 +39,9 @@ LLMs are highly sensitive to XML tags; this structure is designed to boost instr
   <!-- 执行与物理限制 (Execution & Physical Constraints) -->
   <directive id="T-05" name="PHYSICAL_DEFENSE_AND_ORCHESTRATION">
     <trigger>When asked to perform a major refactoring, multi-file change (>2 files), or an architectural shift.</trigger>
-    <must>Limit your blast radius. You MUST draft a `PLAN.md` (status: READY). After any code change, you MUST run canary tests (e.g., `npm test`, linters) to verify integrity.</must>
-    <forbidden>Executing large-scale unstructured changes directly without a plan, or skipping post-modification validation.</forbidden>
+    <should>For complex changes, describe your plan and get owner confirmation before executing.</should>
+    <must>Limit your blast radius. After any code change, you MUST run canary tests (e.g., `npm test`, linters) to verify integrity.</must>
+    <forbidden>Executing large-scale unstructured changes directly, or skipping post-modification validation.</forbidden>
   </directive>
 
   <directive id="T-06" name="OCCAMS_RAZOR_MVC">

package/templates/langs/en/skills/evolve-task/SKILL.md

@@ -10,7 +10,7 @@ You must execute the following steps in order (no skipping). ARGUMENTS: $ARGUMEN
 - Read the last entry in memory/CHECKPOINT.md
 - Read the last 3 entries in memory/ISSUE_LOG.md
 - Read recent decisions in memory/DECISIONS.md
-- If .state/.pain_flag exists, handle breakpoint recovery first
+- Runtime V2 pain diagnosis uses task input/context, not `.state/.pain_flag`
 
 ## Step 1: Read Runtime Parameters & Self-Check
 - Read .principles/PROFILE.json, understand risk_paths, gate, tests.commands.
@@ -51,7 +51,7 @@ Output:
 
 ## Step 6: Delegate Planner (Movie Script Plan)
 - Planner outputs Plan (steps/commands/metrics/rollback).
-- Write plan to PLAN.md (STATUS line must exist).
+- Write plan to a planning document for owner review.
 - **Task Sync**: 
   - If `CLAUDE_CODE_TASK_LIST_ID` is set, you must convert the Plan's core steps to Native Tasks (via natural language command "Add task..." or related tools).
   - If not set and in interactive mode, prompt user: "Recommend running `export CLAUDE_CODE_TASK_LIST_ID=task-$(date +%s)` to enable persistent task tracking."
@@ -59,7 +59,7 @@ Output:
 - **Performance Evaluation**: After task completion, write to `.state/.verdict.json`. Format follows `@.principles/schemas/agent_verdict_schema.json`.
 
 ## Step 7: Delegate Implementer (Execution)
-- Implementer can only execute according to PLAN. Any deviation must first update PLAN.
+- Implementer executes according to the plan from Step 6. Any deviation must first be approved by updating the plan.
 - **Performance Evaluation**: After task completion, write to `.state/.verdict.json` based on verification results. Format follows `@.principles/schemas/agent_verdict_schema.json`.
 
 ## Step 8: Delegate Reviewer (Review)

package/templates/langs/en/skills/pd-mentor/SKILL.md

@@ -185,7 +185,7 @@ For complex scenarios, combine multiple skills:
 
 | Scenario | Combined Flow |
 |----------|---------------|
-| Major refactor | `/pd-evolve` → `plan-script` → `deductive-audit` → execute |
+| Major refactor | `/pd-evolve` → `deductive-audit` → execute |
 | System optimization | `/pd-status` → `evolve-system` → `root-cause` |
 | Project review | `/pd-daily` → `/pd-okr` → `reflection-log` |
 
@@ -196,7 +196,6 @@ These skills are usually called automatically by the system, but advanced users
 - `triage` - Issue triage
 - `root-cause` - Root cause analysis
 - `deductive-audit` - Deductive audit
-- `plan-script` - Plan orchestration
 - `reflection` - Metacognitive reflection
 - `reflection-log` - Reflection logging