guardian-framework 0.1.135 → 0.1.137

package/dist/cli.js

@@ -3206,7 +3206,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.135", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.137", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {
@@ -10873,7 +10873,7 @@ Run with --force to overwrite.`);
     }
     const generatedFiles = {};
     for (const tool of toolsToGenerate) {
-      const exportDir = tool === "pi" ? path7.join(targetDir, ".agents") : path7.join(targetDir, `.${tool}`);
+      const exportDir = path7.join(targetDir, `.${tool}`);
       if (options.dryRun) {
         if (s)
           s.stop(`Dry run: Would generate .${tool}/ from .pi/`);
@@ -10907,7 +10907,7 @@ Run with --force to overwrite.`);
     s.stop("Exports generated successfully!");
     outro(`
 Generated exports:
-  ${toolsToGenerate.map((t2) => t2 === "pi" ? ".agents/skills/ (pi skills)" : `.${t2}/`).join(`
+  ${toolsToGenerate.map((t2) => t2 === "pi" ? ".pi/skills/ (pi skills)" : `.${t2}/`).join(`
   `)}
 
 From .pi/ source.
@@ -11301,8 +11301,6 @@ function isFrontMatterFile(userContent, newContent) {
 function regenerateAllExports(targetDir, manifest) {
   const piDir = path9.join(targetDir, ".pi");
   for (const tool of manifest.tools) {
-    if (tool === "pi")
-      continue;
     const exportDir = path9.join(targetDir, `.${tool}`);
     generateExport(exportDir, tool, piDir, manifest, {});
   }
@@ -12412,7 +12410,7 @@ function scaffoldFromExploration(sessionId, options) {
     entityContext[entity.name] = entity.context;
   }
   function contextToModule(name) {
-    return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+    return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[^A-Za-z0-9]+/g, "-").replace(/(^-|-$)/g, "").toLowerCase();
   }
   function inferContextDependencies(contextName) {
     const deps = [];
@@ -13891,7 +13889,6 @@ async function askExistingFrameworkAction() {
 init_templates();
 init_generate();
 var PI_DIR = ".pi";
-var AGENTS_DIR = ".agents";
 async function runInit(targetDir = process.cwd()) {
   if (!templatesExist()) {
     showError("Templates not found. Ensure templates/pi/ exists.");
@@ -13947,7 +13944,7 @@ async function scaffoldFramework(targetDir, options) {
     const scaffoldErrors = scaffoldPiDirectory(piDir, context, scaffoldedFiles);
     const generatedFiles = {};
     for (const tool of options.tools) {
-      const exportDir = tool === "pi" ? path10.join(targetDir, AGENTS_DIR) : path10.join(targetDir, `.${tool}`);
+      const exportDir = path10.join(targetDir, `.${tool}`);
       generateExport(exportDir, tool, piDir, manifest, generatedFiles);
     }
     for (const [filePath, record] of Object.entries(generatedFiles)) {
@@ -13976,7 +13973,7 @@ async function scaffoldFramework(targetDir, options) {
     }
     updateManifestAfterScaffold(targetDir, manifest, scaffoldedFiles);
     s.stop("Framework scaffolded successfully!");
-    const exportPaths = options.tools.map((t2) => t2 === "pi" ? ".agents/skills/ (pi skills)" : `.${t2}/`);
+    const exportPaths = options.tools.map((t2) => t2 === "pi" ? ".pi/skills/ (pi skills)" : `.${t2}/`);
     showSuccess(`
 Scaffolded Guardian framework:
   .pi/         (source of truth)

package/dist/exports.js

@@ -1991,7 +1991,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.135", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.137", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {
@@ -9997,7 +9997,7 @@ Run with --force to overwrite.`);
     }
     const generatedFiles = {};
     for (const tool of toolsToGenerate) {
-      const exportDir = tool === "pi" ? path4.join(targetDir, ".agents") : path4.join(targetDir, `.${tool}`);
+      const exportDir = path4.join(targetDir, `.${tool}`);
       if (options.dryRun) {
         if (s)
           s.stop(`Dry run: Would generate .${tool}/ from .pi/`);
@@ -10031,7 +10031,7 @@ Run with --force to overwrite.`);
     s.stop("Exports generated successfully!");
     outro(`
 Generated exports:
-  ${toolsToGenerate.map((t2) => t2 === "pi" ? ".agents/skills/ (pi skills)" : `.${t2}/`).join(`
+  ${toolsToGenerate.map((t2) => t2 === "pi" ? ".pi/skills/ (pi skills)" : `.${t2}/`).join(`
   `)}
 
 From .pi/ source.
@@ -10425,8 +10425,6 @@ function isFrontMatterFile(userContent, newContent) {
 function regenerateAllExports(targetDir, manifest) {
   const piDir = path5.join(targetDir, ".pi");
   for (const tool of manifest.tools) {
-    if (tool === "pi")
-      continue;
     const exportDir = path5.join(targetDir, `.${tool}`);
     generateExport(exportDir, tool, piDir, manifest, {});
   }
@@ -10963,7 +10961,6 @@ async function askExistingFrameworkAction() {
 init_templates();
 init_generate();
 var PI_DIR = ".pi";
-var AGENTS_DIR = ".agents";
 async function runInit(targetDir = process.cwd()) {
   if (!templatesExist()) {
     showError("Templates not found. Ensure templates/pi/ exists.");
@@ -11019,7 +11016,7 @@ async function scaffoldFramework(targetDir, options) {
     const scaffoldErrors = scaffoldPiDirectory(piDir, context, scaffoldedFiles);
     const generatedFiles = {};
     for (const tool of options.tools) {
-      const exportDir = tool === "pi" ? path6.join(targetDir, AGENTS_DIR) : path6.join(targetDir, `.${tool}`);
+      const exportDir = path6.join(targetDir, `.${tool}`);
       generateExport(exportDir, tool, piDir, manifest, generatedFiles);
     }
     for (const [filePath, record] of Object.entries(generatedFiles)) {
@@ -11048,7 +11045,7 @@ async function scaffoldFramework(targetDir, options) {
     }
     updateManifestAfterScaffold(targetDir, manifest, scaffoldedFiles);
     s.stop("Framework scaffolded successfully!");
-    const exportPaths = options.tools.map((t2) => t2 === "pi" ? ".agents/skills/ (pi skills)" : `.${t2}/`);
+    const exportPaths = options.tools.map((t2) => t2 === "pi" ? ".pi/skills/ (pi skills)" : `.${t2}/`);
     showSuccess(`
 Scaffolded Guardian framework:
   .pi/         (source of truth)
@@ -12736,7 +12733,7 @@ function scaffoldFromExploration(sessionId, options) {
     entityContext[entity.name] = entity.context;
   }
   function contextToModule(name2) {
-    return name2.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+    return name2.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[^A-Za-z0-9]+/g, "-").replace(/(^-|-$)/g, "").toLowerCase();
   }
   function inferContextDependencies(contextName) {
     const deps = [];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.135",
+	"version": "0.1.137",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/pi/extensions/domain-explorer.ts

@@ -304,135 +304,130 @@ function maxSeqId(items: unknown[] | undefined, prefix: string): number {
 	return max;
 }
 
-const DRIVER_RULES = [
-	"- Reply with ONLY the small JSON for the requested step — no prose, no fences, no reasoning.",
-	"- Emit AT MOST 5 items per message (fewer if any item is long). Keep the JSON well under",
-	"  ~2,500 tokens so the domain_save_result call that follows always fits in the same message.",
-	"- Call domain_save_result with { sessionId, responseJson: <that exact JSON> } and STOP —",
-	"  nothing after the tool call. The driver sends your next step after it saves.",
-].join("\n");
-
-function buildStrategicMessage(sessionId: string, businessContext: string): string {
-	return [
-		"Analyze this business domain with Domain-Driven Design. Work in SMALL incremental steps —",
-		"one phase per message; the driver will send each next phase after you save. This first",
-		"message is the STRATEGIC PASS only.",
-		"",
-		"Session: " + sessionId,
-		"Business Context: " + businessContext,
-		"",
-		"Reply with ONLY this JSON:",
-		'```json',
-		'{',
-		'  "businessContext": "one-line summary of the domain",',
-		'  "actors": [{ "name": "...", "description": "...", "interactions": "..." }],',
-		'  "assumptions": [{ "assumption": "...", "impactIfWrong": "...", "mitigation": "..." }],',
-		'  "boundedContexts": [',
-		'    { "name": "...", "description": "...", "entities": ["..."],',
-		'      "subdomainType": "core|supporting|generic", "subdomainRationale": "one line" }',
-		'  ],',
-		'  "contextMap": [{ "from": "A", "to": "B", "relationship": "partnership|shared-kernel|conformist|anticorruption-layer|open-host", "note": "..." }],',
-		'  "openQuestions": "..."',
-		'}',
-		'```',
-		"",
-		DRIVER_RULES,
-	].join("\n");
-}
-
-function buildRequirementsMessage(raw: Record<string, unknown>, sessionId: string): string {
-	const fr = Array.isArray(raw.functionalRequirements) ? (raw.functionalRequirements as Record<string, unknown>[]) : [];
-	const nfr = Array.isArray(raw.nonFunctionalRequirements) ? (raw.nonFunctionalRequirements as Record<string, unknown>[]) : [];
-	const nextFr = maxSeqId(fr, "FR") + 1;
-	const nextNfr = maxSeqId(nfr, "NFR") + 1;
-	return [
-		"Session " + sessionId + " — REQUIREMENTS PASS (batch). Saved so far: " +
-			fr.length + " functional, " + nfr.length + " non-functional.",
-		"Produce the NEXT contiguous batch: up to 5 functional requirements starting at FR-" +
-			String(nextFr).padStart(3, "0") + (fr.length === 0 ? "" : " (continue from the last saved id)") +
-			" and/or up to 5 non-functional requirements starting at NFR-" + String(nextNfr).padStart(3, "0") + ".",
-		"Only include the type you still have left to deliver.",
-		"",
-		"Reply with ONLY this JSON:",
-		'```json',
-		'{',
-		'  "functionalRequirements": [',
-		'    { "id": "FR-001", "requirement": "The system shall...", "priority": "critical|high|medium|low", "boundedContext": "ContextName" }',
-		'  ],',
-		'  "nonFunctionalRequirements": [',
-		'    { "id": "NFR-001", "requirement": "The system shall...", "category": "performance|security|scalability|availability|maintainability", "target": "measurable target" }',
-		'  ]',
-		'}',
-		'```',
-		"On your FINAL requirements batch add \"requirementsComplete\": true to the JSON",
-		"(omit both arrays if a type is done and only send the flag).",
-		"",
-		DRIVER_RULES,
-	].join("\n");
-}
-
-function buildUsecasesMessage(sessionId: string): string {
-	return [
-		"Session " + sessionId + " — USE-CASES PASS (batch). Produce up to 4 application services for the",
-		"core contexts (name the owning context exactly as in the strategic pass).",
-		"",
-		"Reply with ONLY this JSON:",
-		'```json',
-		'{',
-		'  "applicationServices": [',
-		'    { "name": "ApproveRequest", "context": "ApprovalWorkflow", "useCase": "what this application service orchestrates",',
-		'      "commands": ["verify intent", "consume"], "aggregates": ["ApprovalTicket"], "mapsToFr": "FR-00x" }',
-		'  ]',
-		'}',
-		'```',
-		"On your FINAL use-cases batch add \"usecasesComplete\": true to the JSON.",
-		"",
-		DRIVER_RULES,
-	].join("\n");
-}
 
-function buildContextMessage(raw: Record<string, unknown>, sessionId: string, contextName: string): string {
-	const bc = (Array.isArray(raw.boundedContexts) ? (raw.boundedContexts as Record<string, unknown>[]) : [])
-		.find((x) => String(x.name ?? "") === contextName);
-	const need = (Array.isArray(bc?.entities) ? (bc!.entities as unknown[]) : []).map(String).filter(Boolean);
-	const done = Array.isArray(raw.entities) ? (raw.entities as Record<string, unknown>[])
-		.filter((e) => String(e.context ?? "") === contextName).map((e) => String(e.name ?? "")) : [];
-	const remaining = need.filter((n) => !done.includes(n));
+function buildExploreProtocolMessage(sessionId: string, businessContext: string): string {
 	return [
-		"Session " + sessionId + " — PER-CONTEXT PASS for \"" + contextName + "\"" +
-			(remaining.length > 0 ? " (still needed from strategic list: " + remaining.join(", ") + ")" : "") + ".",
-		"Enrich this ONE context: entities with entity-vs-VO justification, domain events with triage,",
-		"invariants, and this context's ubiquitous language. Up to 6 entities per message — if the",
-		"context has more, the driver will ask you to continue this same context.",
-		"",
-		"Reply with ONLY this JSON:",
-		'```json',
-		'{',
-		'  "boundedContexts": [{ "name": "' + contextName + '", "description": "...", "entities": ["Entity1"],',
-		'    "invariants": [{ "rule": "...", "illegalStatePrevented": "..." }] }],',
-		'  "entities": [',
-		'    { "name": "Entity1", "context": "' + contextName + '", "type": "entity|value-object|aggregate-root",',
-		'      "description": "...",',
-		'      "justification": { "identityPersists": true, "immutable": false, "equalByState": false } }',
-		'  ],',
-		'  "domainEvents": [',
-		'    { "name": "Event", "context": "' + contextName + '", "description": "...", "triggeredBy": "...",',
-		'      "triage": { "domainExpertCares": true, "crossesAggregateBoundary": false, "needsAudit": false } }',
-		'  ],',
-		'  "ubiquitousLanguage": [{ "term": "...", "definition": "...", "boundedContext": "' + contextName + '", "aliases": [], "examples": "" }]',
-		'}',
-		'```',
-		"",
-		DRIVER_RULES,
-	].join("\n");
+					"Analyze this business domain with Domain-Driven Design. You MUST work in SMALL",
+					"incremental steps — never produce the whole model in one message, or you will be",
+					"truncated mid-JSON and lose work.",
+					"",
+					"Session: " + sessionId,
+					"Business Context: " + businessContext,
+					"",
+					"STEP PROTOCOL (strict — one step per message, each message <= ~1,500 tokens of JSON):",
+					"",
+					"1. STRATEGIC PASS (this message): reply with ONLY this JSON, nothing else —",
+					'```json',
+					'{',
+					'  "businessContext": "one-line summary of the domain",',
+					'  "actors": [{ "name": "...", "description": "...", "interactions": "..." }],',
+					'  "assumptions": [{ "assumption": "...", "impactIfWrong": "...", "mitigation": "..." }],',
+					'  "boundedContexts": [',
+					'    { "name": "...", "description": "...", "entities": ["..."],',
+					'      "subdomainType": "core|supporting|generic", "subdomainRationale": "one line" }',
+					'  ],',
+					'  "contextMap": [{ "from": "A", "to": "B", "relationship": "partnership|shared-kernel|conformist|anticorruption-layer|open-host", "note": "..." }],',
+					'  "openQuestions": "..."',
+					'}',
+					'```',
+					"then call domain_save_result with { sessionId, responseJson: <that JSON> }. It merges;",
+					"the file is saved for you. Do NOT also edit exploration.md by hand.",
+					"",
+					"1b. REQUIREMENTS PASS (next message): reply with ONLY this JSON, then call domain_save_result",
+					"again (merge is by id — existing entries are untouched):",
+					'```json',
+					'{',
+					'  "functionalRequirements": [',
+					'    { "id": "FR-001", "requirement": "The system shall...", "priority": "critical|high|medium|low", "boundedContext": "ContextName" }',
+					'  ],',
+					'  "nonFunctionalRequirements": [',
+					'    { "id": "NFR-001", "requirement": "The system shall...", "category": "performance|security|scalability|availability|maintainability", "target": "measurable target" }',
+					'  ]',
+					'}',
+					'```',
+					"",
+					"1c. USE-CASES PASS (next message): reply with ONLY this JSON for ALL core contexts, then call",
+					"domain_save_result (merge is by name+context):",
+					'```json',
+					'{',
+					'  "applicationServices": [',
+					'    { "name": "ApproveRequest", "context": "ApprovalWorkflow", "useCase": "what this application service orchestrates",',
+					'      "commands": ["verify intent", "consume"], "aggregates": ["ApprovalTicket"], "mapsToFr": "FR-00x" }',
+					'  ]',
+					'}',
+					'```',
+					"",
+					"2. PER-CONTEXT PASS (repeat for EACH core/tactical bounded context, one context per message):",
+					"reply with ONLY this JSON for one context, then call domain_save_result again:",
+					'```json',
+					'{',
+					'  "boundedContexts": [{ "name": "TheContext", "description": "...", "entities": ["Entity1"],',
+					'    "invariants": [{ "rule": "...", "illegalStatePrevented": "..." }] }],',
+					'  "entities": [',
+					'    { "name": "Entity1", "context": "TheContext", "type": "entity|value-object|aggregate-root",',
+					'      "description": "...",',
+					'      "justification": { "identityPersists": true, "immutable": false, "equalByState": false } }',
+					'  ],',
+					'  "domainEvents": [',
+					'    { "name": "Event", "context": "TheContext", "description": "...", "triggeredBy": "...",',
+					'      "triage": { "domainExpertCares": true, "crossesAggregateBoundary": false, "needsAudit": false } }',
+					'  ],',
+					'  "ubiquitousLanguage": [{ "term": "...", "definition": "...", "boundedContext": "TheContext", "aliases": [], "examples": "" }]',
+					'}',
+					'```',
+					"Supporting/generic contexts need no detail pass — the strategic entry is enough.",
+					"",
+					"RULES:",
+					"- If a message of yours is cut off mid-JSON, continue from exactly where you stopped in the",
+					"  NEXT message (never restart the whole model).",
+					"- Never emit the full model in one response and never exceed ~1,500 tokens of JSON per message.",
+					"- HARD RULE: never narrate or reason in chat. No prose analysis, no relationship",
+					"  deliberation, no summaries — those burn your output budget and truncate the JSON.",
+					"  Emit ONLY the small JSON step for the current phase and stop.",
+					"- After the last context, run /domain --validate " + sessionId + " and report the checks.",
+				].join("\n");
 }
-
-function buildPhaseMessage(kind: PhaseKind, raw: Record<string, unknown>, sessionId: string, contextName?: string): string {
-	if (kind === "strategic") return buildStrategicMessage(sessionId, String(raw.businessContext ?? ""));
-	if (kind === "requirements") return buildRequirementsMessage(raw, sessionId);
-	if (kind === "usecases") return buildUsecasesMessage(sessionId);
-	if (kind === "context") return buildContextMessage(raw, sessionId, contextName ?? "");
-	return "";
+function buildPhaseNudge(kind: PhaseKind, raw: Record<string, unknown>, sessionId: string, contextName?: string): string {
+	if (kind === "strategic") return buildExploreProtocolMessage(sessionId, String(raw.businessContext ?? ""));
+	if (kind === "requirements") {
+		const fr = Array.isArray(raw.functionalRequirements) ? (raw.functionalRequirements as Record<string, unknown>[]) : [];
+		const nfr = Array.isArray(raw.nonFunctionalRequirements) ? (raw.nonFunctionalRequirements as Record<string, unknown>[]) : [];
+		const nextFr = maxSeqId(fr, "FR") + 1;
+		const nextNfr = maxSeqId(nfr, "NFR") + 1;
+		return [
+			"Continue — REQUIREMENTS PASS (" + fr.length + " FR, " + nfr.length + " NFR saved).",
+			"Emit the next batch using the requirements schema from the original protocol: up to 5",
+			"functional requirements starting at FR-" + String(nextFr).padStart(3, "0") +
+				" and/or up to 5 non-functional starting at NFR-" + String(nextNfr).padStart(3, "0") + ".",
+			'Call domain_save_result after each batch; add "requirementsComplete": true to your FINAL batch.',
+			"Reply with ONLY the JSON, then the tool call.",
+		].join("\n");
+	}
+	if (kind === "usecases") {
+		return [
+			"Continue — USE-CASES PASS.",
+			"Deliver the application services for the core contexts using the use-cases schema from the",
+			'original protocol. Call domain_save_result when done; add "usecasesComplete": true to your',
+			"FINAL batch. Reply with ONLY the JSON, then the tool call.",
+		].join("\n");
+	}
+	if (kind === "context") {
+		const bcs = Array.isArray(raw.boundedContexts) ? (raw.boundedContexts as Record<string, unknown>[]) : [];
+		const bc = bcs.find((x) => String(x.name ?? "") === contextName);
+		const need = (Array.isArray(bc?.entities) ? (bc!.entities as unknown[]) : []).map(String).filter(Boolean);
+		const have = new Set((Array.isArray(raw.entities) ? (raw.entities as Record<string, unknown>[]) : [])
+			.filter((e) => String(e.context ?? "") === contextName).map((e) => String(e.name ?? "")));
+		const remaining = need.filter((n) => !have.has(n));
+		return [
+			'Continue — PER-CONTEXT PASS for "' + (contextName ?? "") + '"' +
+				(remaining.length > 0 ? " (still needed: " + remaining.join(", ") + ")" : "") + ".",
+			"Enrich this ONE context (entities with entity-vs-VO justification, domain events with triage,",
+			"invariants, ubiquitous language) using the schema from the original protocol. Up to 6 entities",
+			"per message; if more remain, call domain_save_result and you will be nudged to continue.",
+			"Reply with ONLY the JSON, then the tool call.",
+		].join("\n");
+	}
+	return "Continue with the next exploration phase using the schemas from the original protocol.";
 }
 
 function moduleHasCode(cwd: string, moduleName: string): boolean {
@@ -837,7 +832,7 @@ export default function (pi: ExtensionAPI) {
 				return { content: [{ type: "text" as const, text: savedNote + " Exploration content complete — run /domain --validate " + sessionId }] };
 			}
 			const label = decision.kind === "context" ? "context " + (decision.contextName ?? "") : decision.kind;
-			const nextMsg = buildPhaseMessage(decision.kind, parsedJson, sessionId, decision.contextName);
+			const nextMsg = buildPhaseNudge(decision.kind, parsedJson, sessionId, decision.contextName);
 			try {
 				pi.sendMessage(
 					{ content: nextMsg, display: true },
@@ -1155,7 +1150,7 @@ export default function (pi: ExtensionAPI) {
 				// Inject the DDD analysis prompt as a follow-up message to the agent.
 				// Using sendMessage with triggerTurn=true causes the agent to process
 				// this as a new conversation turn, not as a command response.
-				const analysisPrompt = buildStrategicMessage(sessionId, sanitized);
+				const analysisPrompt = buildExploreProtocolMessage(sessionId, sanitized);
 				
 
 				try {
@@ -1196,7 +1191,7 @@ export default function (pi: ExtensionAPI) {
 				}
 				const label = decision.kind === "context" ? "context " + decision.contextName : decision.kind;
 				ctx.ui.notify("Resumed " + sessionId + " at phase: " + label, "success");
-				const msg = buildPhaseMessage(decision.kind, raw, sessionId, decision.contextName);
+				const msg = buildPhaseNudge(decision.kind, raw, sessionId, decision.contextName);
 				try {
 					pi.sendMessage(
 						{ content: msg, display: true },

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-09-07T07:58:06Z",
+  "timestamp": "2026-09-25T16:13:52Z",
   "mode": "all",
   "stages_run": [],
   "summary": {

package/templates/workflow.md

@@ -9,7 +9,7 @@ Architecture-first: every change traces back to canonical architecture docs.
 
 1. Ensure `git init` has been run and `.gitignore` is in place (Guardian scaffolds a comprehensive `.gitignore`)
 2. Fill in project context in `.pi/agent/AGENTS.md` (replace `[bracketed]` placeholders)
-3. Run `npx guardian-framework generate` to create `.agents/`, `.claude/`, etc.
+3. Run `npx guardian-framework generate` to regenerate tool exports (pi skills under `.pi/skills/`, plus `.claude/` etc. for other tools)
 
 > **Multi-techstack repos:** If your repository has both backend and frontend (e.g., Java + TypeScript), run `guardian-framework init` in each directory with the same repository URL. Each gets its own `.pi/`, manifest, build config, and CI pipeline. Scope CI path triggers to avoid collisions (`backend/**`, `frontend/**`).