gsd-cc 0.1.0 → 0.2.1

package/bin/install.js

@@ -26,6 +26,12 @@ ${cyan}   ██████╗ ███████╗██████╗
   Get Shit Done on Claude Code ${dim}v${pkg.version}${reset}
 `;
 
+// Sub-skills that get their own top-level directory under .claude/skills/
+const SUB_SKILLS = ['apply', 'auto', 'discuss', 'plan', 'seed', 'status', 'unify', 'update'];
+
+// Shared directories that go into gsd-cc-shared/
+const SHARED_DIRS = ['checklists', 'prompts', 'templates'];
+
 // Parse args
 const args = process.argv.slice(2);
 const hasGlobal = args.includes('--global') || args.includes('-g');
@@ -39,8 +45,8 @@ if (hasHelp) {
   console.log(`  ${yellow}Usage:${reset} npx gsd-cc [options]
 
   ${yellow}Options:${reset}
-    ${cyan}-g, --global${reset}      Install globally to ~/.claude/skills/gsd/ ${dim}(default)${reset}
-    ${cyan}-l, --local${reset}       Install locally to ./.claude/skills/gsd/
+    ${cyan}-g, --global${reset}      Install globally to ~/.claude/skills/ ${dim}(default)${reset}
+    ${cyan}-l, --local${reset}       Install locally to ./.claude/skills/
     ${cyan}--uninstall${reset}       Remove GSD-CC skills
     ${cyan}-h, --help${reset}        Show this help message
 
@@ -88,13 +94,13 @@ function removeDir(dir) {
 }
 
 /**
- * Resolve target directory
+ * Resolve skills base directory
  */
-function getTargetDir(isGlobal) {
+function getSkillsBase(isGlobal) {
   if (isGlobal) {
-    return path.join(os.homedir(), '.claude', 'skills', 'gsd');
+    return path.join(os.homedir(), '.claude', 'skills');
   }
-  return path.join(process.cwd(), '.claude', 'skills', 'gsd');
+  return path.join(process.cwd(), '.claude', 'skills');
 }
 
 /**
@@ -102,10 +108,10 @@ function getTargetDir(isGlobal) {
  */
 function install(isGlobal) {
   const skillsSrc = path.join(__dirname, '..', 'skills', 'gsd');
-  const targetDir = getTargetDir(isGlobal);
+  const skillsBase = getSkillsBase(isGlobal);
   const label = isGlobal
-    ? targetDir.replace(os.homedir(), '~')
-    : targetDir.replace(process.cwd(), '.');
+    ? skillsBase.replace(os.homedir(), '~')
+    : skillsBase.replace(process.cwd(), '.');
 
   if (!fs.existsSync(skillsSrc)) {
     console.error(`  ${red}Error:${reset} Skills source not found at ${skillsSrc}`);
@@ -114,28 +120,40 @@ function install(isGlobal) {
 
   console.log(`  Installing to ${cyan}${label}${reset}\n`);
 
-  // Copy skills
-  copyDir(skillsSrc, targetDir);
+  let fileCount = 0;
 
-  // Make auto-loop.sh executable if it exists
-  const autoLoop = path.join(targetDir, 'auto', 'auto-loop.sh');
-  if (fs.existsSync(autoLoop)) {
-    fs.chmodSync(autoLoop, 0o755);
+  // 1. Install main router: gsd-cc/SKILL.md
+  const routerDest = path.join(skillsBase, 'gsd-cc');
+  fs.mkdirSync(routerDest, { recursive: true });
+  fs.copyFileSync(path.join(skillsSrc, 'SKILL.md'), path.join(routerDest, 'SKILL.md'));
+  fileCount++;
+
+  // 2. Install each sub-skill as its own top-level directory
+  for (const skill of SUB_SKILLS) {
+    const srcDir = path.join(skillsSrc, skill);
+    const destDir = path.join(skillsBase, `gsd-cc-${skill}`);
+
+    if (fs.existsSync(srcDir)) {
+      copyDir(srcDir, destDir);
+      fileCount += countFiles(destDir);
+    }
   }
 
-  // Count installed files
-  let fileCount = 0;
-  function countFiles(dir) {
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        countFiles(path.join(dir, entry.name));
-      } else {
-        fileCount++;
-      }
+  // 3. Install shared resources (templates, checklists, prompts)
+  const sharedDest = path.join(skillsBase, 'gsd-cc-shared');
+  for (const dir of SHARED_DIRS) {
+    const srcDir = path.join(skillsSrc, dir);
+    if (fs.existsSync(srcDir)) {
+      copyDir(srcDir, path.join(sharedDest, dir));
+      fileCount += countFiles(path.join(sharedDest, dir));
     }
   }
-  countFiles(targetDir);
+
+  // 4. Make auto-loop.sh executable
+  const autoLoop = path.join(skillsBase, 'gsd-cc-auto', 'auto-loop.sh');
+  if (fs.existsSync(autoLoop)) {
+    fs.chmodSync(autoLoop, 0o755);
+  }
 
   console.log(`  ${green}✓${reset} Installed ${fileCount} files to ${label}`);
   console.log(`
@@ -143,23 +161,48 @@ function install(isGlobal) {
 `);
 }
 
+/**
+ * Count files in a directory recursively
+ */
+function countFiles(dir) {
+  let count = 0;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      count += countFiles(path.join(dir, entry.name));
+    } else {
+      count++;
+    }
+  }
+  return count;
+}
+
 /**
  * Uninstall skills
  */
 function uninstall() {
-  const globalDir = getTargetDir(true);
-  const localDir = getTargetDir(false);
+  const locations = [getSkillsBase(true), getSkillsBase(false)];
+  const allDirs = ['gsd-cc', ...SUB_SKILLS.map(s => `gsd-cc-${s}`), 'gsd-cc-shared', 'gsd'];
 
   let removed = false;
 
-  if (removeDir(globalDir)) {
-    console.log(`  ${green}✓${reset} Removed global install (${globalDir.replace(os.homedir(), '~')})`);
-    removed = true;
-  }
+  for (const base of locations) {
+    const label = base.includes(os.homedir())
+      ? base.replace(os.homedir(), '~')
+      : base.replace(process.cwd(), '.');
 
-  if (removeDir(localDir)) {
-    console.log(`  ${green}✓${reset} Removed local install (${localDir.replace(process.cwd(), '.')})`);
-    removed = true;
+    let removedFromLocation = false;
+    for (const dir of allDirs) {
+      const fullPath = path.join(base, dir);
+      if (removeDir(fullPath)) {
+        removedFromLocation = true;
+      }
+    }
+
+    if (removedFromLocation) {
+      console.log(`  ${green}✓${reset} Removed GSD-CC from ${label}`);
+      removed = true;
+    }
   }
 
   if (!removed) {
@@ -178,12 +221,12 @@ function promptLocation() {
     output: process.stdout,
   });
 
-  const globalPath = getTargetDir(true).replace(os.homedir(), '~');
+  const globalPath = getSkillsBase(true).replace(os.homedir(), '~');
 
   console.log(`  ${yellow}Where would you like to install?${reset}
 
   ${cyan}1${reset}) Global ${dim}(${globalPath})${reset} — available in all projects
-  ${cyan}2${reset}) Local  ${dim}(./.claude/skills/gsd/)${reset} — this project only
+  ${cyan}2${reset}) Local  ${dim}(./.claude/skills/)${reset} — this project only
 `);
 
   rl.question(`  Choice ${dim}[1]${reset}: `, (answer) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-cc",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Get Shit Done on Claude Code — structured AI development with your Max plan",
   "author": "Philipp Briese (https://github.com/0ui-labs)",
   "homepage": "https://github.com/0ui-labs/GSD-CC#readme",

package/skills/gsd/SKILL.md

@@ -12,6 +12,10 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 
 You are the GSD-CC router. Your job is to read the current project state and suggest **exactly one** next action. Not a menu. Not "what do you want to do?". One clear recommendation.
 
+## Language
+
+Read the `language` field from `.gsd/STATE.md`. All output — messages, suggestions, file content — must use that language. If no language is set, default to English.
+
 ## Step 1: Detect State
 
 Check what exists on disk:
@@ -143,6 +147,7 @@ When routing to a sub-skill, tell the user what you're doing and then invoke the
 - Reconciliation → `/gsd-cc-unify`
 - Auto mode → `/gsd-cc-auto`
 - Status overview → `/gsd-cc-status`
+- Update skills → `/gsd-cc-update`
 
 Power users can invoke these directly. But the default path only needs `/gsd-cc` + Enter.
 

package/skills/gsd/apply/SKILL.md

@@ -12,6 +12,10 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 
 You execute one task at a time from the current slice plan. Each task has a plan with acceptance criteria and boundaries. Follow the plan precisely.
 
+## Language
+
+Read the `language` field from `.gsd/STATE.md`. All output — messages, summaries, commit messages — must use that language. If no language is set, default to English.
+
 ## Step 1: Determine Current Task
 
 1. Read `.gsd/STATE.md` — get `current_slice` and `current_task`

package/skills/gsd/auto/SKILL.md

@@ -11,6 +11,10 @@ allowed-tools: Read, Write, Bash, Glob
 
 You start the auto-loop that executes tasks autonomously, each in a fresh context window.
 
+## Language
+
+Read the `language` field from `.gsd/STATE.md`. All output — messages, status updates — must use that language. If no language is set, default to English.
+
 ## Step 1: Check Prerequisites
 
 Before starting, verify ALL of these:
@@ -80,10 +84,10 @@ Resolve the script location:
 
 ```bash
 # Check local first, then global
-if [[ -f ".claude/skills/gsd/auto/auto-loop.sh" ]]; then
-  SCRIPT=".claude/skills/gsd/auto/auto-loop.sh"
-elif [[ -f "$HOME/.claude/skills/gsd/auto/auto-loop.sh" ]]; then
-  SCRIPT="$HOME/.claude/skills/gsd/auto/auto-loop.sh"
+if [[ -f ".claude/skills/gsd-cc-auto/auto-loop.sh" ]]; then
+  SCRIPT=".claude/skills/gsd-cc-auto/auto-loop.sh"
+elif [[ -f "$HOME/.claude/skills/gsd-cc-auto/auto-loop.sh" ]]; then
+  SCRIPT="$HOME/.claude/skills/gsd-cc-auto/auto-loop.sh"
 fi
 ```
 

package/skills/gsd/discuss/SKILL.md

@@ -12,6 +12,10 @@ allowed-tools: Read, Write, Edit, Glob, Grep
 
 You help the user resolve ambiguities BEFORE planning begins. Your job is to identify gray areas in the current slice and turn them into concrete decisions.
 
+## Language
+
+Read the `language` field from `.gsd/STATE.md`. All output — messages, questions, decision records — must use that language. If no language is set, default to English.
+
 ## Step 1: Load Context
 
 1. Read `.gsd/STATE.md` — get `current_slice` and `milestone`

package/skills/gsd/plan/SKILL.md

@@ -11,6 +11,10 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 
 You turn a slice description into a set of executable task plans. Each task gets BDD acceptance criteria and explicit boundaries. The result is a set of files that `/gsd-cc-apply` or `auto-loop.sh` can execute without ambiguity.
 
+## Language
+
+Read the `language` field from `.gsd/STATE.md`. All output — messages, plans, acceptance criteria, boundaries — must use that language. If no language is set, default to English.
+
 ## Step 1: Load Context
 
 Read these files (all that exist):
@@ -197,8 +201,8 @@ One file per task, using the PLAN.xml template format:
 
 Before finishing, check against `checklists/planning-ready.md`:
 
-Read: `~/.claude/skills/gsd/checklists/planning-ready.md`
-(or `./.claude/skills/gsd/checklists/planning-ready.md`)
+Read: `~/.claude/skills/gsd-cc-shared/checklists/planning-ready.md`
+(or `./.claude/skills/gsd-cc-shared/checklists/planning-ready.md`)
 
 Verify ALL of these:
 

package/skills/gsd/seed/SKILL.md

@@ -14,13 +14,26 @@ You are a project coach. You think WITH the user, not interrogate them. Your job
 
 ## Behavior
 
-### Step 1: Ask What They're Building
+### Step 0: Language Selection
 
-Start with a simple, open question:
+Before anything else, ask the user which language to use:
 
 ```
 No .gsd/ directory found. Let's start a new project.
 
+Which language should I use? (e.g. English, Deutsch, Français, ...)
+Default: English
+```
+
+If the user responds with a project description instead of a language, default to English and continue with Step 1 using their response as the project description.
+
+Store the chosen language. **All communication, generated files, plans, acceptance criteria, UNIFY reports, and status output will use this language from now on.**
+
+### Step 1: Ask What They're Building
+
+If not already answered in Step 0, ask:
+
+```
 What are you building?
 Tell me in a sentence or two — I'll figure out the rest.
 ```
@@ -52,14 +65,14 @@ If ambiguous, ask ONE clarifying question. Don't overthink it.
 
 Read the type-specific guide from:
 ```
-~/.claude/skills/gsd/seed/types/{type}/guide.md
+~/.claude/skills/gsd-cc-seed/types/{type}/guide.md
 ```
 
-If installed locally, check `./.claude/skills/gsd/seed/types/{type}/guide.md` instead.
+If installed locally, check `./.claude/skills/gsd-cc-seed/types/{type}/guide.md` instead.
 
 Also read the config:
 ```
-~/.claude/skills/gsd/seed/types/{type}/config.md
+~/.claude/skills/gsd-cc-seed/types/{type}/config.md
 ```
 
 The guide contains numbered sections with `Explore` and `Suggest` fields. The config sets the rigor level and section count.
@@ -95,8 +108,8 @@ Walk through the guide sections **one at a time**. For each section:
 
 After completing all sections, mentally check against `checklists/planning-ready.md`:
 
-Read: `~/.claude/skills/gsd/seed/../../checklists/planning-ready.md`
-(or `./.claude/skills/gsd/checklists/planning-ready.md`)
+Read: `~/.claude/skills/gsd-cc-shared/checklists/planning-ready.md`
+(or `./.claude/skills/gsd-cc-shared/checklists/planning-ready.md`)
 
 Verify:
 - Is there enough information to create a roadmap?
@@ -111,7 +124,7 @@ Create the `.gsd/` directory and write these files:
 
 #### `.gsd/PLANNING.md`
 
-Use the template from `templates/PLANNING.md`. Fill in all sections from the conversation:
+Use the template from `~/.claude/skills/gsd-cc-shared/templates/PLANNING.md` (or `./.claude/skills/gsd-cc-shared/templates/PLANNING.md`). Fill in all sections from the conversation:
 - Vision (from their initial description + refinements)
 - Users (from user/auth discussions)
 - Requirements v1, v2, Out of Scope (from exploration)
@@ -137,7 +150,8 @@ Short project vision — 3-5 sentences max. This is the "elevator pitch" that ev
 ```json
 {
   "type": "{type}",
-  "rigor": "{rigor}"
+  "rigor": "{rigor}",
+  "language": "{language}"
 }
 ```
 
@@ -150,6 +164,7 @@ Initialize from the STATE.md template with:
 - `phase: seed-complete`
 - `rigor: {rigor}`
 - `project_type: {type}`
+- `language: {language}`
 - `auto_mode: false`
 - `last_updated: {now ISO}`
 

package/skills/gsd/status/SKILL.md

@@ -11,6 +11,10 @@ allowed-tools: Read, Glob, Grep, Bash
 
 You show a clear, concise overview of where the project stands. No actions — just information and one suggested next step.
 
+## Language
+
+Read the `language` field from `.gsd/STATE.md`. All output — messages, progress reports — must use that language. If no language is set, default to English.
+
 ## Step 1: Read State
 
 1. Read `.gsd/STATE.md`

package/skills/gsd/templates/STATE.md

@@ -7,6 +7,7 @@ loop_position: 0
 unify_required: false
 rigor: standard
 project_type: application
+language: English
 auto_mode: false
 last_updated: {{ISO_DATE}}
 ---

package/skills/gsd/unify/SKILL.md

@@ -13,6 +13,10 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 
 UNIFY is not optional. It runs after every slice. The `/gsd-cc` router blocks all other actions until UNIFY is complete. This is the single most important quality mechanism in GSD-CC.
 
+## Language
+
+Read the `language` field from `.gsd/STATE.md`. All output — messages, UNIFY reports, deviation analysis — must use that language. If no language is set, default to English.
+
 ## Why UNIFY Exists
 
 - Without UNIFY, the next slice builds on assumptions instead of facts.
@@ -163,14 +167,14 @@ If the roadmap needs an update, describe what should change but do NOT modify th
 
 Check against `checklists/unify-complete.md`:
 
-Read: `~/.claude/skills/gsd/checklists/unify-complete.md`
-(or `./.claude/skills/gsd/checklists/unify-complete.md`)
+Read: `~/.claude/skills/gsd-cc-shared/checklists/unify-complete.md`
+(or `./.claude/skills/gsd-cc-shared/checklists/unify-complete.md`)
 
 Verify ALL items pass. If any fails, fix the UNIFY document before proceeding.
 
 ## Step 9: Write UNIFY.md
 
-Write `.gsd/S{nn}-UNIFY.md` using the template from `templates/UNIFY.md`. Include all sections from Steps 2-7.
+Write `.gsd/S{nn}-UNIFY.md` using the template from `~/.claude/skills/gsd-cc-shared/templates/UNIFY.md` (or `./.claude/skills/gsd-cc-shared/templates/UNIFY.md`). Include all sections from Steps 2-7.
 
 Set frontmatter:
 ```yaml

package/skills/gsd/update/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: gsd-cc-update
+description: >
+  Update GSD-CC skills to the latest version from npm. Use when user says
+  /gsd-cc-update, /gsd-cc update, or asks to update GSD-CC.
+allowed-tools: Read, Bash, Glob
+---
+
+# /gsd-cc-update — Update GSD-CC
+
+You update GSD-CC to the latest version by running the installer.
+
+## Step 1: Detect Current Installation
+
+Check where GSD-CC is installed:
+
+```
+1. Check ~/.claude/skills/gsd-cc/SKILL.md (global)
+2. Check ./.claude/skills/gsd-cc/SKILL.md (local)
+```
+
+Use `Glob` to find which exists. If both exist, update both.
+
+## Step 2: Get Current Version
+
+Run:
+```bash
+npm view gsd-cc version
+```
+
+This shows the latest available version on npm.
+
+Also check if a `package.json` exists in the installed skills directory's parent to find the current version. If not available, report "unknown".
+
+## Step 3: Confirm with User
+
+Show:
+```
+GSD-CC Update
+
+  Installed: {current_version or "unknown"}
+  Latest:    {latest_version}
+  Location:  {global and/or local path}
+
+Update now? (y/n)
+```
+
+If the versions match, tell the user they're already on the latest version and stop.
+
+## Step 4: Run Update
+
+Based on where it's installed, run:
+
+- **Global only:** `npx gsd-cc@latest --global`
+- **Local only:** `npx gsd-cc@latest --local`
+- **Both:** `npx gsd-cc@latest --global && npx gsd-cc@latest --local`
+
+## Step 5: Confirm
+
+```
+✓ GSD-CC updated to {version}.
+  Your .gsd/ project state is unchanged.
+```
+
+## Safety
+
+- **Never touch .gsd/ directory.** The update only replaces skill files, not project state.
+- **Existing project state (STATE.md, plans, summaries) is preserved.**
+- **Custom project types** in `seed/types/` will be overwritten if they share a name with built-in types. Warn the user if custom types are detected.