ralph-prd 1.0.0 → 1.0.1

package/README.md

@@ -23,6 +23,7 @@ cd your-project && ../ralph-prd/install.sh
 This installs:
 - `.claude/ralph/` — the phased runner
 - `.claude/skills/` — 6 Claude Code skills for the full PRD-to-ship workflow
+- On first install, adds `.claude/ralph/` and `.claude/skills/` to `.gitignore` (skipped if `.claude/` already exists, so shared setups are respected)
 
 ### Updating
 

package/bin/install.mjs

@@ -37,6 +37,9 @@ const claudeDir = resolve(projectRoot, '.claude');
 
 info(`Installing into ${claudeDir}`);
 
+// Track whether .claude/ is a fresh install (for gitignore decision)
+const isFirstInstall = !existsSync(claudeDir);
+
 // Ensure .claude exists
 mkdirSync(claudeDir, { recursive: true });
 
@@ -73,6 +76,21 @@ for (const skillName of readdirSync(skillsSrc)) {
   ok(`Installed skill: ${skillName}`);
 }
 
+// Only add to .gitignore on first install — if .claude/ already existed,
+// the user may be sharing it via git intentionally.
+if (isFirstInstall) {
+  const gitignorePath = resolve(projectRoot, '.gitignore');
+  const ignoreEntries = ['.claude/ralph/', '.claude/skills/'];
+  let gitignoreContent = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf8') : '';
+  const missing = ignoreEntries.filter(entry => !gitignoreContent.split('\n').some(line => line.trim() === entry));
+  if (missing.length > 0) {
+    const block = (gitignoreContent.length > 0 && !gitignoreContent.endsWith('\n') ? '\n' : '') +
+      '\n# ralph-prd (installed via npx ralph-prd)\n' + missing.join('\n') + '\n';
+    writeFileSync(gitignorePath, gitignoreContent + block, 'utf8');
+    ok(`Added ${missing.join(', ')} to .gitignore`);
+  }
+}
+
 // Summary
 console.log('');
 ok('ralph-prd installed successfully!');

package/install.sh

@@ -34,6 +34,10 @@ CLAUDE_DIR="$PROJECT_ROOT/.claude"
 
 info "Installing into $CLAUDE_DIR"
 
+# Track whether .claude/ is a fresh install (for gitignore decision)
+IS_FIRST_INSTALL=false
+[ ! -d "$CLAUDE_DIR" ] && IS_FIRST_INSTALL=true
+
 # Determine source: local clone or download
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
@@ -91,6 +95,21 @@ if [ -f "$SOURCE_DIR/package.json" ]; then
   info "Stamped version: $VERSION"
 fi
 
+# Only add to .gitignore on first install — if .claude/ already existed,
+# the user may be sharing it via git intentionally.
+if [ "$IS_FIRST_INSTALL" = true ]; then
+  GITIGNORE="$PROJECT_ROOT/.gitignore"
+  for entry in ".claude/ralph/" ".claude/skills/"; do
+    if [ ! -f "$GITIGNORE" ] || ! grep -qxF "$entry" "$GITIGNORE"; then
+      if [ ! -f "$GITIGNORE" ] || ! grep -qF "# ralph-prd" "$GITIGNORE"; then
+        printf '\n# ralph-prd (installed via install.sh)\n' >> "$GITIGNORE"
+      fi
+      echo "$entry" >> "$GITIGNORE"
+      ok "Added $entry to .gitignore"
+    fi
+  done
+fi
+
 # Summary
 echo ""
 ok "ralph-prd installed successfully!"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-prd",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI-powered phased implementation runner for Claude Code — from PRD to shipped code",
   "bin": {
     "ralph-prd": "./bin/install.mjs"