@hopla/claude-setup 1.2.9 → 1.3.1

package/README.md

@@ -4,15 +4,29 @@ Hopla team agentic coding system for Claude Code. Installs global rules and comm
 
 ## Install
 
+### Full install — for the implementer (Julio)
+
 ```bash
 npm install -g @hopla/claude-setup
 claude-setup
 ```
 
+Installs all commands: planning + execution + review.
+
+### Planning-only install — for the planner/non-technical role (Robert)
+
+```bash
+npm install -g @hopla/claude-setup
+claude-setup --planning
+```
+
+Installs only planning commands: `init-project`, `prime`, `create-prd`, `plan-feature`, `review-plan`, `git-commit`, `git-pr`. No execution or review commands. No bash permission prompts during planning.
+
 To overwrite existing files without prompting:
 
 ```bash
 claude-setup --force
+claude-setup --planning --force
 ```
 
 ## Update

package/cli.js

@@ -7,6 +7,7 @@ import readline from "readline";
 
 const FORCE = process.argv.includes("--force");
 const UNINSTALL = process.argv.includes("--uninstall");
+const PLANNING = process.argv.includes("--planning");
 const VERSION = process.argv.includes("--version") || process.argv.includes("-v");
 
 if (VERSION) {
@@ -129,8 +130,38 @@ function removeLegacyFiles() {
     }
 }
 
+const PLANNING_COMMANDS = [
+    "hopla-init-project.md",
+    "hopla-prime.md",
+    "hopla-create-prd.md",
+    "hopla-plan-feature.md",
+    "hopla-review-plan.md",
+    "hopla-git-commit.md",
+    "hopla-git-pr.md",
+];
+
+function removeExecutionCommands() {
+    const planningSet = new Set(PLANNING_COMMANDS);
+    const removed = [];
+    if (!fs.existsSync(COMMANDS_DIR)) return;
+    for (const file of fs.readdirSync(COMMANDS_DIR)) {
+        if (file.startsWith("hopla-") && !planningSet.has(file)) {
+            fs.rmSync(path.join(COMMANDS_DIR, file));
+            removed.push(file);
+        }
+    }
+    if (removed.length > 0) {
+        log(`${CYAN}Removing execution commands (planning mode)...${RESET}`);
+        for (const file of removed) {
+            log(`  ${RED}✕${RESET}  Removed: ~/.claude/commands/${file}`);
+        }
+        log("");
+    }
+}
+
 async function install() {
-    log(`\n${BOLD}@hopla/claude-setup${RESET} — Agentic Coding System\n`);
+    const modeLabel = PLANNING ? "Planning Mode (Robert)" : "Full Install";
+    log(`\n${BOLD}@hopla/claude-setup${RESET} — Agentic Coding System ${CYAN}[${modeLabel}]${RESET}\n`);
 
     // Create directories if needed
     fs.mkdirSync(CLAUDE_DIR, { recursive: true });
@@ -139,6 +170,9 @@ async function install() {
     // Remove old non-prefixed commands from previous versions
     removeLegacyFiles();
 
+    // In planning mode, remove any execution commands left from a previous full install
+    if (PLANNING) removeExecutionCommands();
+
     log(`${CYAN}Installing global rules...${RESET}`);
     await installFile(
         path.join(FILES_DIR, "CLAUDE.md"),
@@ -147,7 +181,10 @@ async function install() {
     );
 
     log(`\n${CYAN}Installing commands...${RESET}`);
-    const commandFiles = fs.readdirSync(path.join(FILES_DIR, "commands"));
+    const allCommandFiles = fs.readdirSync(path.join(FILES_DIR, "commands"));
+    const commandFiles = PLANNING
+        ? allCommandFiles.filter((f) => PLANNING_COMMANDS.includes(f))
+        : allCommandFiles;
     for (const file of commandFiles.sort()) {
         await installFile(
             path.join(FILES_DIR, "commands", file),
@@ -161,7 +198,11 @@ async function install() {
         const name = file.replace(".md", "");
         log(`  ${CYAN}/${name}${RESET}`);
     }
-    log(`\nRun with ${BOLD}--force${RESET} to overwrite all files without prompting.\n`);
+    if (PLANNING) {
+        log(`\n${YELLOW}Planning mode:${RESET} Only planning commands installed. Run without ${BOLD}--planning${RESET} for the full set.\n`);
+    } else {
+        log(`\nRun with ${BOLD}--force${RESET} to overwrite all files without prompting.\n`);
+    }
 
     await setupPermissions();
 }

package/files/commands/hopla-create-prd.md

@@ -74,10 +74,8 @@ Ask one topic at a time and wait for the answer before continuing. Adapt follow-
 
 First, explore the codebase to understand what's already built:
 
-```bash
-git ls-files | head -60
-git log --oneline -10
-```
+Use the Glob tool to list project files (pattern: `**/*`, head_limit: 60).
+Run `git log --oneline -10` to understand recent history.
 
 Read key files: entry points, main modules, config files, existing tests.
 

package/files/commands/hopla-plan-feature.md

@@ -42,9 +42,7 @@ Investigate the areas of the codebase relevant to this feature:
 - Find the entry points that will need to be modified or extended
 - Identify potential conflicts or dependencies
 
-```bash
-git ls-files | grep -i <relevant-keyword>
-```
+Use the Grep tool to find relevant files (pattern: relevant keyword, case-insensitive).
 
 Read the key files in their entirety — not just the parts that seem relevant.
 
@@ -146,4 +144,4 @@ Before saving the draft, review the plan against these criteria:
 
 **Finalize:**
 1. Rename `.agents/plans/[feature-name].draft.md` → `.agents/plans/[feature-name].md`
-2. Confirm: "✅ Plan saved to `.agents/plans/[feature-name].md`. Run `/hopla-execute .agents/plans/[feature-name].md` to implement it, or `/hopla-git-commit` to save the plan first."
+2. Confirm: "✅ Plan saved to `.agents/plans/[feature-name].md`. Run `/hopla-git-commit` to commit it, then share with the team to execute with `/hopla-execute .agents/plans/[feature-name].md`."

package/files/commands/hopla-prime.md

@@ -6,13 +6,13 @@ Get oriented in this project before doing any work.
 
 ## Step 1: Project Structure
 
-```bash
-git ls-files | head -60
-```
+Use the Glob tool to list project files (up to 60):
+- Pattern: `**/*` with head_limit: 60
 
-```bash
-find . -name "CLAUDE.md" -o -name "AGENTS.md" -o -name "README.md" | head -10
-```
+Use the Glob tool to find key config files:
+- `**/CLAUDE.md`
+- `**/AGENTS.md`
+- `**/README.md`
 
 ## Step 2: Read Key Files
 
@@ -31,9 +31,8 @@ git status
 
 ## Step 4: Check Pending Work
 
-```bash
-ls .agents/plans/ 2>/dev/null
-```
+Use the Glob tool to check for pending plans:
+- Pattern: `.agents/plans/*.md`
 
 If `.agents/plans/` exists, identify:
 - `.draft.md` files — unfinished drafts waiting for review

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hopla/claude-setup",
-  "version": "1.2.9",
+  "version": "1.3.1",
   "description": "Hopla team agentic coding system for Claude Code",
   "type": "module",
   "bin": {