@hopla/claude-setup 1.2.8 → 1.3.0

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
@@ -89,6 +103,7 @@ After each PIV loop, run `/hopla-execution-report` + `/hopla-system-review` to f
 | `/hopla-prime` | Load project context at the start of a session |
 | `/hopla-create-prd` | Create a Product Requirements Document through guided questions |
 | `/hopla-plan-feature` | Research codebase and create a structured implementation plan |
+| `/hopla-review-plan` | Review a plan before execution — get a concise summary and approve |
 | `/hopla-execute` | Execute a structured plan from start to finish with validation |
 | `/hopla-git-commit` | Create a Conventional Commit with Git Flow awareness |
 | `/hopla-git-pr` | Create a GitHub Pull Request with a structured description |
@@ -112,6 +127,7 @@ After each PIV loop, run `/hopla-execution-report` + `/hopla-system-review` to f
 ```
 /hopla-prime          → load context at session start
 /hopla-plan-feature   → research codebase and create plan
+/hopla-review-plan    → review plan summary and approve
 /hopla-execute        → implement the plan with validation
 /hopla-code-review    → technical review of changes
 /hopla-code-review-fix → fix issues found

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,19 @@ 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",
+];
+
 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 });
@@ -147,7 +159,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 +176,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/files/commands/hopla-review-plan.md

@@ -0,0 +1,51 @@
+---
+description: Review a plan before execution — get a concise summary and approve or request changes
+argument-hint: "<plan-file-path>"
+---
+
+Review the implementation plan and give the executing developer a clear, concise summary before they commit to running it.
+
+## Step 1: Read the Plan
+
+Read `$1` entirely before doing anything else.
+
+## Step 2: Present Executive Summary
+
+Do NOT reproduce the full plan. Instead, present a structured summary in the user's language:
+
+**Plan: [Feature Name]**
+
+**What is being built:**
+[2-3 sentences max — what the feature does and why]
+
+**Tasks ([N] total):**
+| # | Action | File | Risk |
+|---|--------|------|------|
+| 1 | create/modify/delete | `path/to/file` | ⚠️ gotcha if any / — |
+| 2 | ... | ... | ... |
+
+**Files touched:** [count] files — [list key ones]
+
+**Validation plan:**
+- [ ] [exact lint command]
+- [ ] [exact type check command]
+- [ ] [exact test command]
+- [ ] [integration check]
+
+**Acceptance criteria:**
+- [ ] [criterion 1]
+- [ ] [criterion 2]
+
+**⚠️ Watch out for:**
+[List any gotchas, risks, or dependencies flagged in the plan. If none, say "Nothing flagged."]
+
+## Step 3: Ask for Approval
+
+After the summary, ask:
+> "¿Todo claro? Puedes aprobar para ejecutar, pedir cambios, o hacer preguntas sobre alguna tarea."
+> (or in English if the conversation is in English)
+
+**Review loop:**
+- If the user has questions → answer them based on the plan content
+- If the user requests changes → note them and tell the user to ask Robert to update the plan, or apply minor clarifications directly if they are unambiguous
+- If the user approves → confirm: "✅ Plan approved. Run `/hopla-execute $1` to start."

package/package.json

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