pi-gsd 1.11.5 → 1.12.0

package/.gsd/extensions/pi-gsd-hooks.ts

@@ -76,92 +76,145 @@ const ensureHarnessSymlink = (cwd: string): void => {
 	}
 };
 
-const syncReferenceToCore = (cwd: string, ref: string[]): void => {
-	try {
-		const refsDir = join(cwd, ".pi", "gsd", "references");
-		const refName = ref.join("-") + ".md";
-		const coreName = [...ref, "core"].join("-") + ".md";
-		const src = join(refsDir, refName);
-		const dst = join(refsDir, coreName);
-		if (!existsSync(src)) return;
-		const srcMtime = statSync(src).mtimeMs;
-		const dstMtime = existsSync(dst) ? statSync(dst).mtimeMs : 0;
-		if (srcMtime <= dstMtime) return; // already in sync
-		const content = readFileSync(src, "utf8");
-		const match = content.match(/<core>([\s\S]*?)<\/core>/i);
-		writeFileSync(dst, match ? match[1].trim() : content, "utf8");
-	} catch {
-		/* silent — never block session startup or tool execution */
-	}
-};
 
 export default function (pi: ExtensionAPI) {
-	// ── input: inject @file contents before the LLM sees the message ──────────
-	// Replaces @.pi/gsd/... and @.planning/... references with actual file
-	// contents programmatically. Zero tool calls, provider-agnostic.
-	// Missing files → red error + action:"handled" skips the LLM entirely.
+	// ── input: <gsd-include> injection ───────────────────────────────────
+	// Replaces <gsd-include path="..." /> tags with actual file contents.
+	// Supports selectors: tag:NAME, heading:TEXT, lines:N-M
+	// Valid chains: tag|heading, tag|lines, heading|lines, heading|tag
+	// On ANY failure: red error + abort (action:"handled"). No partial injection.
 	pi.on("input", async (event, ctx) => {
 		if (event.source === "extension") return { action: "continue" };
 
 		const text = event.text;
-		const fileRefPattern = /@(\.pi\/gsd\/[^\s]+|\.planning\/[^\s]+)/g;
-		const refs = [...text.matchAll(fileRefPattern)];
-		if (refs.length === 0) return { action: "continue" };
+		const includePattern = /<gsd-include\s+path="([^"]+)"(?:\s+select="([^"]*)")?\s*\/>/g;
+		const includes = [...text.matchAll(includePattern)];
+		if (includes.length === 0) return { action: "continue" };
 
-		// Fallback lookup: package harness root via this extension file's location
-		// <pkg>/.gsd/extensions/pi-gsd-hooks.ts → <pkg>/.gsd/harnesses/pi/get-shit-done
+		// Package harness fallback path
 		const extFile = typeof __filename !== "undefined" ? __filename : "";
-		const pkgHarness = extFile ? join(dirname(extFile), "..", "harnesses", "pi", "get-shit-done") : "";
+		const pkgHarness = extFile
+			? join(dirname(extFile), "..", "harnesses", "pi", "get-shit-done")
+			: "";
 
-		const failed: string[] = [];
+		const errors: string[] = [];
 		let transformed = text;
 
-		for (const match of refs) {
-			const relPath = match[1];
-			const subPath = relPath.replace(/^\.pi\/gsd\//, "");
+		for (const match of includes) {
+			const fullMatch = match[0];
+			const filePath = match[1];
+			const selectExpr = match[2] ?? "";
 
-			// Lookup order:
-			// 1. Project symlink:  <cwd>/.pi/gsd/<subPath>
-			// 2. Package harness:  <pkg>/.gsd/harnesses/pi/get-shit-done/<subPath>
+			// ── Resolve file path ───────────────────────────────────────
+			const subPath = filePath.replace(/^\.pi\/gsd\//, "");
 			const candidates = [
-				join(ctx.cwd, relPath),
-				...(relPath.startsWith(".pi/gsd/") ? [join(pkgHarness, subPath)] : []),
+				join(ctx.cwd, filePath),
+				...(filePath.startsWith(".pi/gsd/") && pkgHarness
+					? [join(pkgHarness, subPath)]
+					: []),
 			];
 
-			let fileContent: string | null = null;
-			for (const candidate of candidates) {
+			let raw: string | null = null;
+			for (const c of candidates) {
 				try {
-					if (existsSync(candidate)) {
-						fileContent = readFileSync(candidate, "utf8");
-						break;
-					}
+					if (existsSync(c)) { raw = readFileSync(c, "utf8"); break; }
 				} catch { /* try next */ }
 			}
+			if (raw === null) {
+				errors.push(`File not found: ${filePath}`);
+				continue;
+			}
 
-			if (fileContent === null) {
-				failed.push(relPath);
-			} else {
-				transformed = transformed.replace(match[0], fileContent);
+			// ── Apply selector ─────────────────────────────────────────
+			let result = raw;
+			if (selectExpr) {
+				const parts = selectExpr.split("|");
+				if (parts.length > 2) {
+					errors.push(`Invalid selector (max 2 segments): ${selectExpr}`);
+					continue;
+				}
+				// lines: must be standalone — reject any chain involving lines
+				if (parts.length > 1 && parts.some((p) => p.trim().startsWith("lines:"))) {
+					errors.push(`lines: cannot be chained — use it alone: ${selectExpr}`);
+					continue;
+				}
+
+				for (let i = 0; i < parts.length; i++) {
+					const part = parts[i].trim();
+					const prev = i > 0 ? parts[i - 1].trim().split(":")[0] : null;
+
+					if (part.startsWith("tag:")) {
+						const tagName = part.slice(4);
+						const tagRe = new RegExp(
+							`<${tagName}>([\\s\\S]*?)</${tagName}>`,
+							"i",
+						);
+						const tagMatch = result.match(tagRe);
+						if (!tagMatch) {
+							errors.push(`Tag <${tagName}> not found in ${filePath}`);
+							result = "";
+							break;
+						}
+						result = tagMatch[1].trim();
+
+					} else if (part.startsWith("heading:")) {
+						const headingText = part.slice(8);
+						const headingRe = new RegExp(
+							`(^|\\n)(#{1,6})\\s+${headingText.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&")}\\s*\\n`,
+						);
+						const hMatch = result.match(headingRe);
+						if (!hMatch) {
+							errors.push(`Heading \"${headingText}\" not found in ${filePath}`);
+							result = "";
+							break;
+						}
+						const level = hMatch[2].length;
+						const startIdx = (hMatch.index ?? 0) + hMatch[0].length;
+						const nextHeading = result.slice(startIdx).search(
+							new RegExp(`\\n#{1,${level}}\\s`),
+						);
+						result = nextHeading === -1
+							? result.slice(startIdx).trim()
+							: result.slice(startIdx, startIdx + nextHeading).trim();
+
+					} else if (part.startsWith("lines:")) {
+						const rangeMatch = part.match(/^lines:(\d+)-(\d+)$/);
+						if (!rangeMatch) {
+							errors.push(`Invalid lines selector: ${part}`);
+							result = "";
+							break;
+						}
+						const start = parseInt(rangeMatch[1], 10) - 1;
+						const end = parseInt(rangeMatch[2], 10);
+						result = result.split("\n").slice(start, end).join("\n");
+
+					} else {
+						errors.push(`Unknown selector: ${part}`);
+						result = "";
+						break;
+					}
+				}
+				if (result === "") continue; // error already logged
 			}
+
+			transformed = transformed.replace(fullMatch, result);
 		}
 
-		if (failed.length > 0) {
-			ctx.ui.notify(
-				`❌ GSD context injection failed — missing files:\n${failed.map((f) => `  • ${f}`).join("\n")}\n\nRun /gsd-setup-pi to reinstall the harness.`,
+		if (errors.length > 0) {
+			ctx.ui.notify("\u274c GSD include failed:\n" + errors.map((e) => "  \u2022 " + e).join("\n"),
 				"error",
 			);
-			return { action: "handled" }; // skip LLM entirely
+			return { action: "handled" };
 		}
 
 		return { action: "transform", text: transformed };
 	});
+
 	// ── session_start: GSD update check ──────────────────────────────────────
 	pi.on("session_start", async (_event, ctx) => {
 		// Ensure harness files are reachable via .pi/gsd/ symlink
 		ensureHarnessSymlink(ctx.cwd);
 
-		// Sync derived core files from tagged reference sources
-		syncReferenceToCore(ctx.cwd, ["ui", "brand"]);
 
 		try {
 			const cacheDir = join(homedir(), ".pi", "cache");
@@ -667,9 +720,6 @@ export default function (pi: ExtensionAPI) {
 	let lastLevel: "warning" | "critical" | null = null;
 
 	pi.on("tool_result", async (_event, ctx) => {
-		// Keep derived core files in sync after any tool write (e.g. gsd-new-project
-		// creating ui-brand.md mid-session — no reboot needed)
-		syncReferenceToCore(ctx.cwd, ["ui", "brand"]);
 
 		try {
 			const usage: ContextUsage | undefined = ctx.getContextUsage();

package/README.md

@@ -139,10 +139,8 @@ Switch profile: `/gsd-set-profile <profile>`
 |       Instant commands (no LLM cost) |     ❌     |   ✔️    | `/gsd-progress`, `/gsd-stats`, `/gsd-health`, `/gsd-help`, `/gsd-next` - zero LLM, editor pivot           |
 |             `/gsd-next` auto-advance |     ❌     |   ✔️    | Deterministic phase routing, pre-fills editor with the correct next command                               |
 |       Prompt-dispatch for all skills |     ❌     |   ✔️    | 54 pi prompt templates - clean autocomplete, arg hints, direct workflow dispatch                          |
-|        `ui-brand` context modularity |     ❌     |   ✔️    | `<core>` tag splits ui-brand.md — planning gets 103 lines, UI commands get full 166                       |
-|        `syncReferenceToCore` utility |     ❌     |   ✔️    | Auto-derives `-core.md` from any `<core>`-tagged reference; syncs on session start + after tool writes    |
-|  Programmatic `@file` injection      |     ❌     |   ✔️    | Extension intercepts `@.pi/gsd/...` refs, injects file contents before LLM sees them — zero tool calls   |
-|   Auto harness symlink + self-repair |     ❌     |   ✔️    | `.pi/gsd/` → package harness; detects stale dirs, replaces with symlink; fallback to package root        |
+|    `<gsd-include>` context injection |     ❌     |   ✔️    | `<gsd-include path select>` replaces file refs before LLM sees them — selectors: tag, heading, lines      |
+|   Auto harness symlink + self-repair |     ❌     |   ✔️    | `.pi/gsd/` → package harness; detects stale dirs, replaces with symlink; fallback to package root         |
 |        `/gsd-plan-milestone` command |     ❌     |   ✔️    | Plan all unplanned phases - one mode question, scope pre-check per phase, context-safe checkpoint         |
 |     `/gsd-execute-milestone` command |     ❌     |   ✔️    | Execute all phases + scope guardian + auto gap/debt retry loop (insert-phase) + audit→complete→cleanup    |
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-gsd",
-	"version": "1.11.5",
+	"version": "1.12.0",
 	"description": "Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",
 	"main": "dist/pi-gsd-tools.js",
 	"bin": {

package/prompts/gsd-add-phase.md

@@ -1,6 +1,6 @@
 ---
 description: Add phase to end of current milestone in roadmap
 ---
-@.pi/gsd/workflows/add-phase.md
+<gsd-include path=".pi/gsd/workflows/add-phase.md" />
 
 $ARGUMENTS

package/prompts/gsd-add-tests.md

@@ -1,6 +1,6 @@
 ---
 description: Generate tests for a completed phase based on UAT criteria and implementation
 ---
-@.pi/gsd/workflows/add-tests.md
+<gsd-include path=".pi/gsd/workflows/add-tests.md" />
 
 $ARGUMENTS

package/prompts/gsd-add-todo.md

@@ -1,6 +1,6 @@
 ---
 description: Capture idea or task as todo from current conversation context
 ---
-@.pi/gsd/workflows/add-todo.md
+<gsd-include path=".pi/gsd/workflows/add-todo.md" />
 
 $ARGUMENTS

package/prompts/gsd-audit-milestone.md

@@ -1,6 +1,6 @@
 ---
 description: Audit milestone completion against original intent before archiving
 ---
-@.pi/gsd/workflows/audit-milestone.md
+<gsd-include path=".pi/gsd/workflows/audit-milestone.md" />
 
 $ARGUMENTS

package/prompts/gsd-audit-uat.md

@@ -1,6 +1,6 @@
 ---
 description: Cross-phase audit of all outstanding UAT and verification items
 ---
-@.pi/gsd/workflows/audit-uat.md
+<gsd-include path=".pi/gsd/workflows/audit-uat.md" />
 
 $ARGUMENTS

package/prompts/gsd-autonomous.md

@@ -1,7 +1,7 @@
 ---
 description: Run all remaining phases autonomously - discuss→plan→execute per phase
 ---
-@.pi/gsd/workflows/autonomous.md
-@.pi/gsd/references/ui-brand-core.md
+<gsd-include path=".pi/gsd/workflows/autonomous.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 
 $ARGUMENTS

package/prompts/gsd-check-todos.md

@@ -1,6 +1,6 @@
 ---
 description: List pending todos and select one to work on
 ---
-@.pi/gsd/workflows/check-todos.md
+<gsd-include path=".pi/gsd/workflows/check-todos.md" />
 
 $ARGUMENTS

package/prompts/gsd-cleanup.md

@@ -1,6 +1,6 @@
 ---
 description: Archive accumulated phase directories from completed milestones
 ---
-@.pi/gsd/workflows/cleanup.md
+<gsd-include path=".pi/gsd/workflows/cleanup.md" />
 
 $ARGUMENTS

package/prompts/gsd-discuss-phase.md

@@ -1,8 +1,8 @@
 ---
 description: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (the agent picks recommended defaults).
 ---
-@.pi/gsd/workflows/discuss-phase.md
-@.pi/gsd/workflows/discuss-phase-assumptions.md
-@.pi/gsd/templates/context.md
+<gsd-include path=".pi/gsd/workflows/discuss-phase.md" />
+<gsd-include path=".pi/gsd/workflows/discuss-phase-assumptions.md" />
+<gsd-include path=".pi/gsd/templates/context.md" />
 
 $ARGUMENTS

package/prompts/gsd-do.md

@@ -1,7 +1,7 @@
 ---
 description: Route freeform text to the right GSD command automatically
 ---
-@.pi/gsd/workflows/do.md
-@.pi/gsd/references/ui-brand-core.md
+<gsd-include path=".pi/gsd/workflows/do.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 
 $ARGUMENTS

package/prompts/gsd-execute-milestone.md

@@ -1,10 +1,10 @@
 ---
 description: Execute all planned phases + full lifecycle (audit→complete→cleanup), scope guardian, UAT gates, worktree isolation
 ---
-@.pi/gsd/workflows/execute-milestone.md
-@.pi/gsd/references/ui-brand.md
-@.planning/REQUIREMENTS.md
-@.planning/ROADMAP.md
-@.planning/STATE.md
+<gsd-include path=".pi/gsd/workflows/execute-milestone.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" />
+<gsd-include path=".planning/REQUIREMENTS.md" />
+<gsd-include path=".planning/ROADMAP.md" />
+<gsd-include path=".planning/STATE.md" />
 
 $ARGUMENTS

package/prompts/gsd-execute-phase.md

@@ -1,7 +1,7 @@
 ---
 description: Execute all plans in a phase with wave-based parallelization
 ---
-@.pi/gsd/workflows/execute-phase.md
-@.pi/gsd/references/ui-brand.md
+<gsd-include path=".pi/gsd/workflows/execute-phase.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" />
 
 $ARGUMENTS

package/prompts/gsd-fast.md

@@ -1,6 +1,6 @@
 ---
 description: Execute a trivial task inline - no subagents, no planning overhead
 ---
-@.pi/gsd/workflows/fast.md
+<gsd-include path=".pi/gsd/workflows/fast.md" />
 
 $ARGUMENTS

package/prompts/gsd-forensics.md

@@ -1,6 +1,6 @@
 ---
 description: Post-mortem investigation for failed GSD workflows - analyzes git history, artifacts, and state to diagnose what went wrong
 ---
-@.pi/gsd/workflows/forensics.md
+<gsd-include path=".pi/gsd/workflows/forensics.md" />
 
 $ARGUMENTS

package/prompts/gsd-insert-phase.md

@@ -1,6 +1,6 @@
 ---
 description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
 ---
-@.pi/gsd/workflows/insert-phase.md
+<gsd-include path=".pi/gsd/workflows/insert-phase.md" />
 
 $ARGUMENTS

package/prompts/gsd-list-phase-assumptions.md

@@ -1,6 +1,6 @@
 ---
 description: Surface the agent's assumptions about a phase approach before planning
 ---
-@.pi/gsd/workflows/list-phase-assumptions.md
+<gsd-include path=".pi/gsd/workflows/list-phase-assumptions.md" />
 
 $ARGUMENTS

package/prompts/gsd-list-workspaces.md

@@ -1,6 +1,6 @@
 ---
 description: List active GSD workspaces and their status
 ---
-@.pi/gsd/workflows/list-workspaces.md
+<gsd-include path=".pi/gsd/workflows/list-workspaces.md" />
 
 $ARGUMENTS

package/prompts/gsd-manager.md

@@ -1,6 +1,6 @@
 ---
 description: Interactive command center for managing multiple phases from one terminal
 ---
-@.pi/gsd/workflows/manager.md
+<gsd-include path=".pi/gsd/workflows/manager.md" />
 
 $ARGUMENTS

package/prompts/gsd-map-codebase.md

@@ -1,6 +1,6 @@
 ---
 description: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
 ---
-@.pi/gsd/workflows/map-codebase.md
+<gsd-include path=".pi/gsd/workflows/map-codebase.md" />
 
 $ARGUMENTS

package/prompts/gsd-milestone-summary.md

@@ -1,6 +1,6 @@
 ---
 description: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
 ---
-@.pi/gsd/workflows/milestone-summary.md
+<gsd-include path=".pi/gsd/workflows/milestone-summary.md" />
 
 $ARGUMENTS

package/prompts/gsd-new-milestone.md

@@ -1,10 +1,10 @@
 ---
 description: Start a new milestone cycle - update PROJECT.md and route to requirements
 ---
-@.pi/gsd/workflows/new-milestone.md
-@.pi/gsd/references/questioning.md
-@.pi/gsd/references/ui-brand-core.md
-@.pi/gsd/templates/project.md
-@.pi/gsd/templates/requirements.md
+<gsd-include path=".pi/gsd/workflows/new-milestone.md" />
+<gsd-include path=".pi/gsd/references/questioning.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
+<gsd-include path=".pi/gsd/templates/project.md" />
+<gsd-include path=".pi/gsd/templates/requirements.md" />
 
 $ARGUMENTS

package/prompts/gsd-new-project.md

@@ -1,10 +1,10 @@
 ---
 description: Initialize a new project with deep context gathering and PROJECT.md
 ---
-@.pi/gsd/workflows/new-project.md
-@.pi/gsd/references/questioning.md
-@.pi/gsd/references/ui-brand-core.md
-@.pi/gsd/templates/project.md
-@.pi/gsd/templates/requirements.md
+<gsd-include path=".pi/gsd/workflows/new-project.md" />
+<gsd-include path=".pi/gsd/references/questioning.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
+<gsd-include path=".pi/gsd/templates/project.md" />
+<gsd-include path=".pi/gsd/templates/requirements.md" />
 
 $ARGUMENTS

package/prompts/gsd-new-workspace.md

@@ -1,6 +1,6 @@
 ---
 description: Create an isolated workspace with repo copies and independent .planning/
 ---
-@.pi/gsd/workflows/new-workspace.md
+<gsd-include path=".pi/gsd/workflows/new-workspace.md" />
 
 $ARGUMENTS

package/prompts/gsd-note.md

@@ -1,6 +1,6 @@
 ---
 description: Zero-friction idea capture. Append, list, or promote notes to todos.
 ---
-@.pi/gsd/workflows/note.md
+<gsd-include path=".pi/gsd/workflows/note.md" />
 
 $ARGUMENTS

package/prompts/gsd-pause-work.md

@@ -1,6 +1,6 @@
 ---
 description: Create context handoff when pausing work mid-phase
 ---
-@.pi/gsd/workflows/pause-work.md
+<gsd-include path=".pi/gsd/workflows/pause-work.md" />
 
 $ARGUMENTS

package/prompts/gsd-plan-milestone-gaps.md

@@ -1,6 +1,6 @@
 ---
 description: Create phases to close all gaps identified by milestone audit
 ---
-@.pi/gsd/workflows/plan-milestone-gaps.md
+<gsd-include path=".pi/gsd/workflows/plan-milestone-gaps.md" />
 
 $ARGUMENTS

package/prompts/gsd-plan-milestone.md

@@ -1,9 +1,9 @@
 ---
 description: Plan all unplanned phases in the current milestone — one mode question, scope pre-check per phase, context-safe checkpointing
 ---
-@.pi/gsd/workflows/plan-milestone.md
-@.pi/gsd/references/ui-brand-core.md
-@.planning/REQUIREMENTS.md
-@.planning/ROADMAP.md
+<gsd-include path=".pi/gsd/workflows/plan-milestone.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
+<gsd-include path=".planning/REQUIREMENTS.md" />
+<gsd-include path=".planning/ROADMAP.md" />
 
 $ARGUMENTS

package/prompts/gsd-plan-phase.md

@@ -1,7 +1,7 @@
 ---
 description: Create detailed phase plan (PLAN.md) with verification loop
 ---
-@.pi/gsd/workflows/plan-phase.md
-@.pi/gsd/references/ui-brand-core.md
+<gsd-include path=".pi/gsd/workflows/plan-phase.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 
 $ARGUMENTS

package/prompts/gsd-plant-seed.md

@@ -1,6 +1,6 @@
 ---
 description: Capture a forward-looking idea with trigger conditions - surfaces automatically at the right milestone
 ---
-@.pi/gsd/workflows/plant-seed.md
+<gsd-include path=".pi/gsd/workflows/plant-seed.md" />
 
 $ARGUMENTS

package/prompts/gsd-pr-branch.md

@@ -1,6 +1,6 @@
 ---
 description: Create a clean PR branch by filtering out .planning/ commits - ready for code review
 ---
-@.pi/gsd/workflows/pr-branch.md
+<gsd-include path=".pi/gsd/workflows/pr-branch.md" />
 
 $ARGUMENTS

package/prompts/gsd-profile-user.md

@@ -1,6 +1,6 @@
 ---
 description: Generate developer behavioral profile and create Claude-discoverable artifacts
 ---
-@.pi/gsd/workflows/profile-user.md
+<gsd-include path=".pi/gsd/workflows/profile-user.md" />
 
 $ARGUMENTS

package/prompts/gsd-quick.md

@@ -1,6 +1,6 @@
 ---
 description: Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
 ---
-@.pi/gsd/workflows/quick.md
+<gsd-include path=".pi/gsd/workflows/quick.md" />
 
 $ARGUMENTS

package/prompts/gsd-remove-phase.md

@@ -1,6 +1,6 @@
 ---
 description: Remove a future phase from roadmap and renumber subsequent phases
 ---
-@.pi/gsd/workflows/remove-phase.md
+<gsd-include path=".pi/gsd/workflows/remove-phase.md" />
 
 $ARGUMENTS

package/prompts/gsd-remove-workspace.md

@@ -1,6 +1,6 @@
 ---
 description: Remove a GSD workspace and clean up worktrees
 ---
-@.pi/gsd/workflows/remove-workspace.md
+<gsd-include path=".pi/gsd/workflows/remove-workspace.md" />
 
 $ARGUMENTS

package/prompts/gsd-resume-work.md

@@ -1,6 +1,6 @@
 ---
 description: Resume work from previous session with full context restoration
 ---
-@.pi/gsd/workflows/resume-project.md
+<gsd-include path=".pi/gsd/workflows/resume-project.md" />
 
 $ARGUMENTS

package/prompts/gsd-review.md

@@ -1,6 +1,6 @@
 ---
 description: Request cross-AI peer review of phase plans from external AI CLIs
 ---
-@.pi/gsd/workflows/review.md
+<gsd-include path=".pi/gsd/workflows/review.md" />
 
 $ARGUMENTS

package/prompts/gsd-session-report.md

@@ -1,6 +1,6 @@
 ---
 description: Generate a session report with token usage estimates, work summary, and outcomes
 ---
-@.pi/gsd/workflows/session-report.md
+<gsd-include path=".pi/gsd/workflows/session-report.md" />
 
 $ARGUMENTS

package/prompts/gsd-settings.md

@@ -1,6 +1,6 @@
 ---
 description: Configure GSD workflow toggles and model profile
 ---
-@.pi/gsd/workflows/settings.md
+<gsd-include path=".pi/gsd/workflows/settings.md" />
 
 $ARGUMENTS

package/prompts/gsd-ship.md

@@ -1,6 +1,6 @@
 ---
 description: Create PR, run review, and prepare for merge after verification passes
 ---
-@.pi/gsd/workflows/ship.md
+<gsd-include path=".pi/gsd/workflows/ship.md" />
 
 $ARGUMENTS

package/prompts/gsd-ui-phase.md

@@ -1,7 +1,7 @@
 ---
 description: Generate UI design contract (UI-SPEC.md) for frontend phases
 ---
-@.pi/gsd/workflows/ui-phase.md
-@.pi/gsd/references/ui-brand.md
+<gsd-include path=".pi/gsd/workflows/ui-phase.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" />
 
 $ARGUMENTS

package/prompts/gsd-ui-review.md

@@ -1,7 +1,7 @@
 ---
 description: Retroactive 6-pillar visual audit of implemented frontend code
 ---
-@.pi/gsd/workflows/ui-review.md
-@.pi/gsd/references/ui-brand.md
+<gsd-include path=".pi/gsd/workflows/ui-review.md" />
+<gsd-include path=".pi/gsd/references/ui-brand.md" />
 
 $ARGUMENTS

package/prompts/gsd-validate-phase.md

@@ -1,6 +1,6 @@
 ---
 description: Retroactively audit and fill Nyquist validation gaps for a completed phase
 ---
-@.pi/gsd/workflows/validate-phase.md
+<gsd-include path=".pi/gsd/workflows/validate-phase.md" />
 
 $ARGUMENTS

package/prompts/gsd-verify-work.md

@@ -1,7 +1,7 @@
 ---
 description: Validate built features through conversational UAT
 ---
-@.pi/gsd/workflows/verify-work.md
-@.pi/gsd/templates/UAT.md
+<gsd-include path=".pi/gsd/workflows/verify-work.md" />
+<gsd-include path=".pi/gsd/templates/UAT.md" />
 
 $ARGUMENTS