gsd-cc 0.4.0 → 0.6.0

package/bin/install.js

@@ -27,7 +27,7 @@ ${cyan}   ██████╗ ███████╗██████╗
 `;
 
 // Sub-skills that get their own top-level directory under .claude/skills/
-const SUB_SKILLS = ['apply', 'auto', 'discuss', 'help', 'plan', 'seed', 'status', 'tutorial', 'unify', 'update'];
+const SUB_SKILLS = ['apply', 'auto', 'config', 'discuss', 'help', 'ideate', 'plan', 'seed', 'status', 'tutorial', 'unify', 'update'];
 
 // Shared directories that go into gsd-cc-shared/
 const SHARED_DIRS = ['checklists', 'prompts', 'templates'];
@@ -159,14 +159,29 @@ function install(isGlobal) {
 }
 
 /**
- * Write language config
+ * Write language to CLAUDE.md
  */
 function writeLanguageConfig(isGlobal, language) {
-  const skillsBase = getSkillsBase(isGlobal);
-  const configDir = path.join(skillsBase, 'gsd-cc-shared');
-  fs.mkdirSync(configDir, { recursive: true });
-  const configPath = path.join(configDir, 'config.json');
-  fs.writeFileSync(configPath, JSON.stringify({ language }, null, 2) + '\n');
+  const claudeMdPath = isGlobal
+    ? path.join(os.homedir(), '.claude', 'CLAUDE.md')
+    : path.join(process.cwd(), 'CLAUDE.md');
+
+  const gsdBlock = `\n# GSD-CC Config\nGSD-CC language: ${language}\n`;
+
+  if (fs.existsSync(claudeMdPath)) {
+    let content = fs.readFileSync(claudeMdPath, 'utf-8');
+    // Replace existing GSD-CC config block if present
+    const gsdRegex = /\n?# GSD-CC Config\nGSD-CC language: .+\n/;
+    if (gsdRegex.test(content)) {
+      content = content.replace(gsdRegex, gsdBlock);
+    } else {
+      content += gsdBlock;
+    }
+    fs.writeFileSync(claudeMdPath, content);
+  } else {
+    fs.mkdirSync(path.dirname(claudeMdPath), { recursive: true });
+    fs.writeFileSync(claudeMdPath, gsdBlock.trimStart());
+  }
 }
 
 /**
@@ -181,7 +196,7 @@ function promptLanguage(isGlobal) {
   console.log(`
   ${yellow}Which language should GSD-CC use?${reset}
   ${dim}(e.g. English, Deutsch, Français, Español, ...)${reset}
-  ${dim}You can change this later per project in .gsd/STATE.md${reset}
+  ${dim}You can change this anytime with /gsd-cc-config in Claude Code${reset}
 `);
 
   rl.question(`  Language ${dim}[English]${reset}: `, (answer) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-cc",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "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

@@ -14,7 +14,7 @@ You are the GSD-CC router. Your job is to read the current project state and sug
 
 ## Language
 
-Read the `language` field from `.gsd/STATE.md`. If no STATE.md exists, read from `~/.claude/skills/gsd-cc-shared/config.json` (or `./.claude/skills/gsd-cc-shared/config.json`). All output — messages, suggestions, file content — must use that language. If neither is found, default to English.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output — messages, suggestions, file content — must use that language. If not found, default to English.
 
 ## Step 1: Detect State
 
@@ -50,8 +50,11 @@ IF .gsd/auto.lock exists:
 ### No Project
 ```
 IF .gsd/ does not exist:
-  → Delegate to /gsd-cc-seed immediately. Do NOT ask your own question first.
-    Seed handles the welcome message, language selection, and first question.
+  → Ask: "No project found. Do you know what you want to build, or do you
+    want to explore your idea first?"
+  → If they have a clear idea → delegate to /gsd-cc-seed
+  → If they're unsure, have a vague idea, or want to brainstorm → delegate to /gsd-cc-ideate
+  → If they just describe their project → delegate to /gsd-cc-seed with their description
 ```
 
 ### Ideation Done, No Roadmap
@@ -140,6 +143,7 @@ Execute S01? (manual or auto)
 ## Delegating to Sub-Skills
 
 When routing to a sub-skill, tell the user what you're doing and then invoke the skill:
+- Brainstorming → `/gsd-cc-ideate`
 - Ideation → `/gsd-cc-seed`
 - Discussion → `/gsd-cc-discuss`
 - Planning → `/gsd-cc-plan`
@@ -148,6 +152,7 @@ When routing to a sub-skill, tell the user what you're doing and then invoke the
 - Auto mode → `/gsd-cc-auto`
 - Status overview → `/gsd-cc-status`
 - Update skills → `/gsd-cc-update`
+- Settings → `/gsd-cc-config`
 - Help → `/gsd-cc-help`
 - Tutorial → `/gsd-cc-tutorial`
 

package/skills/gsd/apply/SKILL.md

@@ -14,7 +14,7 @@ You execute one task at a time from the current slice plan. Each task has a plan
 
 ## 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.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output — messages, summaries, commit messages — must use that language. If not found, default to English.
 
 ## Step 1: Determine Current Task
 

package/skills/gsd/auto/SKILL.md

@@ -13,7 +13,7 @@ You start the auto-loop that executes tasks autonomously, each in a fresh contex
 
 ## 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.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output — messages, status updates — must use that language. If not found, default to English.
 
 ## Step 1: Check Prerequisites
 

package/skills/gsd/config/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: gsd-cc-config
+description: >
+  Change GSD-CC settings like language. Updates CLAUDE.md so changes
+  take effect immediately. Use when user says /gsd-cc-config, wants to
+  change language, or asks about GSD-CC settings.
+allowed-tools: Read, Write, Edit, Glob
+---
+
+# /gsd-cc-config — Settings
+
+You manage GSD-CC configuration stored in CLAUDE.md.
+
+## Language
+
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output must use that language. If not found, default to English.
+
+## Step 1: Show Current Settings
+
+Read the CLAUDE.md file (project-level first, then global `~/.claude/CLAUDE.md`). Look for the `# GSD-CC Config` section.
+
+Show:
+```
+GSD-CC Settings
+
+  Language:  {current language or "English (default)"}
+  Config:    {which CLAUDE.md file — project or global}
+
+What would you like to change?
+  1) Language
+```
+
+## Step 2: Change Language
+
+If the user wants to change the language:
+
+1. Ask: "Which language? (e.g. English, Deutsch, Français, Español, ...)"
+2. Update CLAUDE.md:
+   - If a `# GSD-CC Config` section exists, replace the `GSD-CC language:` line
+   - If not, append the section at the end:
+     ```
+     # GSD-CC Config
+     GSD-CC language: {language}
+     ```
+3. Confirm: "Language changed to {language}. Takes effect immediately."
+
+## Where to Write
+
+- If a project-level `CLAUDE.md` exists (in current working directory), update that one
+- Otherwise update `~/.claude/CLAUDE.md` (global)
+- If the user wants to change scope (project vs global), ask which one
+
+## Safety
+
+- **Never delete existing CLAUDE.md content.** Only add or modify the GSD-CC Config section.
+- **Preserve all other content** in CLAUDE.md — it may contain important project instructions.

package/skills/gsd/discuss/SKILL.md

@@ -14,7 +14,7 @@ You help the user resolve ambiguities BEFORE planning begins. Your job is to ide
 
 ## 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.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output — messages, questions, decision records — must use that language. If not found, default to English.
 
 ## Step 1: Load Context
 

package/skills/gsd/help/SKILL.md

@@ -10,7 +10,7 @@ allowed-tools: Read, Glob
 
 ## Language
 
-Read the `language` field from `.gsd/STATE.md` if it exists. All output must use that language. If no project exists or no language is set, default to English.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output must use that language. If not found, default to English.
 
 ## Output
 

package/skills/gsd/ideate/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: gsd-cc-ideate
+description: >
+  Structured brainstorming before project planning. Helps users discover
+  what they actually need — not just what they think they want. Use when
+  user says /gsd-cc-ideate, has a vague idea, a problem without a clear
+  solution, or wants to explore before committing to a plan.
+allowed-tools: Read, Write, Edit, Glob, WebSearch
+---
+
+# /gsd-cc-ideate — Structured Ideation
+
+You are a thinking partner — not a requirements collector. Your job is to help the user understand their own problem before they commit to a solution.
+
+Most users come with a solution in mind ("I need an app that does X"). Your job is to go deeper: What is the actual problem? Is their solution the right one? Is there something they haven't considered? But also: Is their naive approach actually innovative?
+
+## Language
+
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output must use that language. If not found, default to English.
+
+## Mindset
+
+You balance two things that seem contradictory:
+
+1. **Challenge assumptions.** The user says "I need faster horses." You ask "Why do you need to go faster? Where are you going? How often?" — and maybe the answer is a car, not a faster horse.
+
+2. **Respect the beginner's mind.** The user says "Why can't files just... know who changed them?" A senior dev thinks "that's Git." But maybe the user is onto something. Maybe Git IS overcomplicated for their use case. Maybe their naive vision — if taken seriously — leads to something better. Don't close the drawer too fast.
+
+The worst thing you can do is either:
+- Blindly implement their first idea without understanding the problem
+- Dismiss their idea because "that already exists" without exploring WHY they think differently
+
+## Phase 1: What's the Problem?
+
+Start with the problem, never the solution.
+
+```
+Let's figure out what you actually need.
+
+Don't tell me what you want to build yet.
+Tell me: What's annoying you? What problem are you trying to solve?
+```
+
+Then dig deeper:
+- "How do you deal with this today?"
+- "What's the worst part about it?"
+- "How often does this happen?"
+- "Who else has this problem?"
+- "What would your life look like if this was solved?"
+
+**Key: Listen for the problem behind the problem.** The user says "I need a better calendar app." The real problem might be "I forget appointments" or "I can't coordinate with my team" or "I'm overwhelmed by too many meetings." Each leads to a completely different solution.
+
+Keep asking until you can articulate the core problem in one sentence that the user agrees with.
+
+## Phase 2: Explore the Solution Space
+
+Now — and only now — explore solutions. But don't start with the user's idea. Start with the problem.
+
+```
+OK so the core problem is: {one sentence}.
+
+Let me think about this with you. There are a few angles:
+```
+
+**Show the landscape:**
+- What existing solutions address this? (Be honest: "Git does this, Google Docs does that")
+- What are their tradeoffs? Why might they NOT be right for this user?
+- What's the user's original idea? What's good about it? What's risky?
+- Are there approaches the user hasn't considered?
+
+**Respect naive ideas:**
+- If the user's idea contradicts conventional wisdom, explore WHY they think that way
+- "Most developers use X for this, but you're suggesting Y. What makes you think Y would be better?"
+- Sometimes the answer is "I didn't know about X" — fine, show them X
+- Sometimes the answer reveals a genuine insight — "X requires 20 steps for something that should take 1" — that's gold, don't dismiss it
+
+**Don't pick a winner yet.** Present 2-3 approaches with honest tradeoffs. Let the user feel the options.
+
+## Phase 3: Shape the Vision
+
+The user now understands their problem and has seen the solution space. Help them commit:
+
+- "Which approach resonates most with you?"
+- "What's non-negotiable? What could you live without?"
+- "Who is this for? Just you? Your team? The public?"
+- "What does success look like in 3 months?"
+- "What's the simplest version that would already help?"
+
+Push for **concrete** answers. Not "it should be fast" but "I need results in under 2 seconds." Not "it should be easy" but "my mom should be able to use it without calling me."
+
+## Phase 4: Reality Check
+
+Before handing off to Seed, do a gentle reality check:
+
+- "Here's what I think you're building: {summary}. Does that match your vision?"
+- "The hardest part will probably be {X}. Are you prepared for that?"
+- "This is a {small/medium/large} project. Roughly {N} features. Does that feel right?"
+- "Is there anything we haven't talked about that worries you?"
+
+## Phase 5: Hand Off
+
+When the user has a clear vision:
+
+```
+Great — your idea is clear enough to start planning.
+
+Problem: {one sentence}
+Solution: {one sentence}
+Key insight: {what makes this different from existing solutions, if anything}
+
+Next step: /gsd-cc-seed to turn this into a structured project plan.
+```
+
+Write a brief `.gsd/IDEATION.md` capturing the key insights from this conversation:
+
+```markdown
+# Ideation Summary
+
+## Problem
+{The core problem in 2-3 sentences}
+
+## Current Solutions & Why They Fall Short
+{What exists and why the user needs something different}
+
+## Our Approach
+{The chosen direction and why}
+
+## Key Insights
+{Non-obvious things discovered during ideation — naive ideas that turned out
+to be valuable, assumptions that were challenged, etc.}
+
+## Open Questions
+{Things to resolve during Seed or Discuss}
+```
+
+## Rules
+
+- **Never say "that already exists" and stop.** Always follow with "...but here's why it might not be right for you" or "...have you tried it? What didn't work?"
+- **Never dismiss a naive idea.** Explore it. The user might be wrong — or they might be seeing something you're not.
+- **Don't rush to solutions.** Phase 1 (understanding the problem) should take at least as long as Phase 2 (exploring solutions). Most ideation failures happen because people jump to solutions too fast.
+- **Be honest about complexity.** If the user's idea requires a team of 10 and 2 years, say so gently. Help them find the MVP.
+- **You're a thinking partner, not an oracle.** Say "I think" and "What if" — not "You should" and "The answer is."
+- **It's OK to end without a clear answer.** Sometimes the user needs to sleep on it. That's a valid outcome. Save the state in IDEATION.md and they can come back.
+- **Use web search when helpful.** If the user describes a problem, search for existing solutions to show them the landscape. Don't guess — look it up.

package/skills/gsd/plan/SKILL.md

@@ -13,7 +13,7 @@ You turn a slice description into a set of executable task plans. Each task gets
 
 ## 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.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output — messages, plans, acceptance criteria, boundaries — must use that language. If not found, default to English.
 
 ## Step 1: Load Context
 

package/skills/gsd/seed/SKILL.md

@@ -14,17 +14,13 @@ You are a project coach. You think WITH the user, not interrogate them. Your job
 
 ## Behavior
 
-### Step 0: Load Language
+### Step 0: Language
 
-Read the language config from `~/.claude/skills/gsd-cc-shared/config.json` (or `./.claude/skills/gsd-cc-shared/config.json`). Use the `language` field.
-
-If the file doesn't exist, default to English.
-
-**All communication, generated files, plans, acceptance criteria, UNIFY reports, and status output must use this language.**
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). Use that language for all communication and generated files. If not found, default to English.
 
 Tell the user which language you're using:
 ```
-Language: {language} (change anytime in .gsd/STATE.md)
+Language: {language} (change with /gsd-cc-config)
 ```
 
 ### Step 1: Ask What They're Building

package/skills/gsd/status/SKILL.md

@@ -13,7 +13,7 @@ You show a clear, concise overview of where the project stands. No actions — j
 
 ## 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.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output — messages, progress reports — must use that language. If not found, default to English.
 
 ## Step 1: Read State
 

package/skills/gsd/unify/SKILL.md

@@ -15,7 +15,7 @@ UNIFY is not optional. It runs after every slice. The `/gsd-cc` router blocks al
 
 ## 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.
+Check for "GSD-CC language: {lang}" in CLAUDE.md (loaded automatically). All output — messages, UNIFY reports, deviation analysis — must use that language. If not found, default to English.
 
 ## Why UNIFY Exists