pi-gsd 1.6.0 → 1.6.2

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm version](https://img.shields.io/npm/v/pi-gsd.svg)](https://www.npmjs.com/package/pi-gsd)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![skills: 60](https://img.shields.io/badge/skills-60-orange.svg)](#skills)
+[![skills: 60](https://img.shields.io/badge/skills-55-orange.svg)](#skills)
 
 GSD is a structured software-delivery framework for AI coding agents. It wraps any AI coding session with a six-step phase lifecycle, 57 slash commands, 18 specialized subagents, background hooks, and model profiles - all backed by a git-committed `.planning/` directory that survives context resets.
 
@@ -38,7 +38,7 @@ After install, run your first GSD command:
 
 | Artifact   | Count | Description                                                       |
 | ---------- | ----: | ----------------------------------------------------------------- |
-| Skills     |    60 | pi skill definitions (`/gsd-*`) loaded automatically              |
+| Skills     |    55 | pi skill definitions (`/gsd-*`) loaded automatically              |
 | CLI binary |     1 | `pi-gsd-tools` - state management, scaffolding, model routing     |
 | Hooks      |     5 | Background hooks (context monitor, workflow guard, statusline, …) |
 
@@ -123,8 +123,8 @@ Switch profile: `/gsd-set-profile <profile>`
 |                          Workstreams |     ✔️     |   ✔️    | Full workstream isolation                                                                        |
 |                     4 model profiles |     ✔️     |   ✔️    | quality / balanced / budget / inherit                                                            |
 |                         18 subagents |     ✔️     |   ✔️    | Identical agent definitions                                                                      |
-|                        60 GSD skills |     ✔️     |   ✔️    | All commands available via pi prompt dispatcher (replaces skill system)                          |
-|        Different skills paths for pi |     ✔️     |   ⚡    | All 60 skills moved to `.pi/gsd/` to enable advanced pi-gsd-tools integration                    |
+|                        55 GSD skills |     ✔️     |   ✔️    | All commands available via pi prompt dispatcher (replaces skill system)                          |
+|        Different skills paths for pi |     ✔️     |   ⚡    | All 55 skills moved to `.pi/gsd/` to enable advanced pi-gsd-tools integration                    |
 |                  pi harness (`.pi/`) |     ❌     |   ✔️    | New - GSD installs into pi's config dir                                                          |
 |                Background hooks (pi) |     ❌     |   ✔️    | TypeScript extension (`gsd-hooks.ts`) installed via postinstall                                  |
 |         Pi session history ingestion |     ❌     |   ✔️    | `/gsd-profile-user` reads pi JSONL sessions from `~/.pi/agent/sessions/`                         |
@@ -138,7 +138,7 @@ Switch profile: `/gsd-set-profile <profile>`
 |                   Smarter `--repair` |     ❌     |   ✔️    | Schema defaults fill missing `config.json` fields; W011 STATE.md issues trigger regeneration     |
 |       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 |     ❌     |   ✔️    | 57 pi prompt templates — clean autocomplete, arg hints, direct workflow dispatch                 |
+|       Prompt-dispatch for all skills |     ❌     |   ✔️    | 54 pi prompt templates — clean autocomplete, arg hints, direct workflow dispatch                 |
 |        `/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.6.0",
+	"version": "1.6.2",
 	"description": "Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",
 	"main": "dist/pi-gsd-tools.js",
 	"bin": {

package/scripts/postinstall.js

@@ -227,17 +227,21 @@ function main() {
 		else totalSkipped++;
 	});
 
-	// ── Pi prompt templates (.pi/prompts/gsd-*.md) ──────────────────────────────
-	const promptsSrc = path.join(PKG_DIR, "prompts");
+	// ── Pi prompt templates — cleanup stale local copies ───────────────────────
+	// Prompts are served directly from the npm package (user scope).
+	// Local copies in .pi/prompts/ cause collision warnings on every pi update.
+	// Remove any gsd-*.md files previously installed there.
 	const promptsDest = path.join(PROJECT_ROOT, ".pi", "prompts");
-	if (fs.existsSync(promptsSrc)) {
-		const p = copyDir(promptsSrc, promptsDest, FORCE);
-		totalCopied += p.copied;
-		totalSkipped += p.skipped;
-		if (p.copied > 0) {
-			log("ok", `.pi/prompts  (${p.copied} template${p.copied === 1 ? "" : "s"} installed)`);
-		} else {
-			log("skip", `.pi/prompts  (already up-to-date)`);
+	if (fs.existsSync(promptsDest)) {
+		const stale = fs
+			.readdirSync(promptsDest)
+			.filter((f) => f.startsWith("gsd-") && f.endsWith(".md"));
+		if (stale.length > 0) {
+			for (const f of stale) fs.rmSync(path.join(promptsDest, f));
+			log(
+				"ok",
+				`.pi/prompts  (removed ${stale.length} stale local gsd-*.md — served from package instead)`,
+			);
 		}
 	}
 

package/skills/gsd-health/SKILL.md

@@ -1,21 +0,0 @@
----
-name: gsd-health
-description: Diagnose planning directory health and optionally repair issues
----
-
-<objective>
-Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
-</objective>
-
-<execution_context>
-@.pi/gsd/workflows/health.md
-</execution_context>
-
-<process>
-1. Run: `pi-gsd-tools validate health --output toon`
-   - If successful, present the toon output to the user.
-   - If the command fails or toon output is unavailable, fall back to: `pi-gsd-tools validate health` (plain JSON output).
-
-2. Execute the health workflow from @.pi/gsd/workflows/health.md end-to-end.
-   Parse --repair flag from arguments and pass to workflow.
-</process>

package/skills/gsd-help/SKILL.md

@@ -1,24 +0,0 @@
----
-name: gsd-help
-description: Show available GSD commands and usage guide
----
-
-<objective>
-Display the complete GSD command reference.
-
-Output ONLY the reference content below. Do NOT add:
-
-- Project-specific analysis
-- Git status or file context
-- Next-step suggestions
-- Any commentary beyond the reference
-  </objective>
-
-<execution_context>
-@.pi/gsd/workflows/help.md
-</execution_context>
-
-<process>
-Output the complete GSD command reference from @.pi/gsd/workflows/help.md.
-Display the reference content directly - no additions or modifications.
-</process>

package/skills/gsd-next/SKILL.md

@@ -1,19 +0,0 @@
----
-name: gsd-next
-description: Automatically advance to the next logical step in the GSD workflow
----
-
-<objective>
-Detect the current project state and automatically invoke the next logical GSD workflow step.
-No arguments needed - reads STATE.md, ROADMAP.md, and phase directories to determine what comes next.
-
-Designed for rapid multi-project workflows where remembering which phase/step you're on is overhead.
-</objective>
-
-<execution_context>
-@.pi/gsd/workflows/next.md
-</execution_context>
-
-<process>
-Execute the next workflow from @.pi/gsd/workflows/next.md end-to-end.
-</process>

package/skills/gsd-progress/SKILL.md

@@ -1,23 +0,0 @@
----
-name: gsd-progress
-description: Check project progress, show context, and route to next action (execute or plan)
----
-
-<objective>
-Check project progress, summarize recent work and what's ahead, then intelligently route to the next action - either executing an existing plan or creating the next one.
-
-Provides situational awareness before continuing work.
-</objective>
-
-<execution_context>
-@.pi/gsd/workflows/progress.md
-</execution_context>
-
-<process>
-1. Run: `pi-gsd-tools progress --output toon`
-   - If successful, present the toon output to the user.
-   - If the command fails or toon output is unavailable, fall back to: `pi-gsd-tools progress` (plain JSON output).
-
-2. Execute the progress workflow from @.pi/gsd/workflows/progress.md end-to-end.
-   Preserve all routing logic (Routes A through F) and edge case handling.
-</process>

package/skills/gsd-stats/SKILL.md

@@ -1,20 +0,0 @@
----
-name: gsd-stats
-description: Display project statistics - phases, plans, requirements, git metrics, and timeline
----
-
-<objective>
-Display comprehensive project statistics including phase progress, plan execution metrics, requirements completion, git history stats, and project timeline.
-</objective>
-
-<execution_context>
-@.pi/gsd/workflows/stats.md
-</execution_context>
-
-<process>
-1. Run: `pi-gsd-tools stats --output toon`
-   - If successful, present the toon output to the user.
-   - If the command fails or toon output is unavailable, fall back to: `pi-gsd-tools stats` (plain JSON output).
-
-2. Execute the stats workflow from @.pi/gsd/workflows/stats.md end-to-end.
-</process>