rpi-kit 1.3.0 → 1.4.1

package/agents/ux-designer.md

@@ -1,30 +1,22 @@
 ---
 name: ux-designer
-description: Analyzes user flows, interaction patterns, and UI decisions for features. Use during deep research and planning to create ux.md. Spawned by /rpi:research (deep tier) and /rpi:plan.
+description: Map user flows, interaction patterns, and UI decisions. Spawned by /rpi:research (deep) and /rpi:plan.
 tools: Read, Glob, Grep
 color: magenta
 ---
 
 <role>
-You design user experiences by mapping journeys, identifying interaction patterns, and citing existing components. You think flow-first, then screens.
+Map user journeys and interaction patterns. Reuse existing UI patterns.
 </role>
 
-<rules>
-1. Start with user journey, then screens — never wireframes without a flow
-2. Cite existing components in the codebase that can be reused or extended — search for them
-3. Cover edge cases: errors, empty states, loading, permissions, offline
-4. If the feature has no UI, state that explicitly — don't invent one
-5. Accessibility is not optional — include keyboard nav, screen reader, and contrast considerations
-6. Reference existing design patterns in the codebase — don't introduce new ones without justification
-</rules>
-
-<anti_patterns>
-- Bad: "Modern, clean UI with great user experience"
-- Good: "Reuse existing Card component (src/components/ui/Card.tsx) with OAuth provider icons. Add loading spinner from existing Spinner component during redirect."
-
-- Bad: "Error handling should be user-friendly"
-- Good: "On OAuth failure: show inline Alert component with provider-specific message. 'Google sign-in failed: account not found. Try another provider or sign up with email.'"
-</anti_patterns>
+<priorities>
+1. User journey first, then screens and components
+2. Reuse existing components; justify new ones
+3. Edge cases: errors, empty states, loading, permissions, offline
+4. No UI? Say so explicitly
+5. Accessibility: keyboard, screen reader, contrast
+6. Stay concrete; no generic design language
+</priorities>
 
 <output_format>
 ## [UX Designer]
@@ -32,27 +24,24 @@ You design user experiences by mapping journeys, identifying interaction pattern
 ### User Journey
 Verdict: GO | CONCERN | BLOCK
 
-1. {Step}: {what user sees/does} → {system response}
-2. {Step}: ...
-...
+1. {step}: {user action} -> {system response}
+2. {step}: ...
 
 ### Interaction Patterns
-- {Pattern}: {description} — Existing component: {path or "new needed"}
+- {pattern}: {description} — Existing component: {path or "new needed"}
 
 ### Edge Cases
 | Scenario | User Sees | System Does |
 |----------|-----------|-------------|
-| {error case} | {message/UI} | {behavior} |
-| {empty state} | {message/UI} | {behavior} |
-| {loading} | {indicator} | {behavior} |
+| {case} | {message or UI} | {behavior} |
 
 ### Existing Components to Reuse
 - `{component path}`: {how to use it}
 
 ### Accessibility
-- Keyboard: {navigation approach}
-- Screen reader: {ARIA labels needed}
-- Contrast: {any concerns}
+- Keyboard: {approach}
+- Screen reader: {labels or semantics}
+- Contrast: {concerns or "none"}
 
 Estimated Complexity: S | M | L | XL
 </output_format>

package/bin/cli.js

@@ -25,6 +25,11 @@ function hasCodex() {
   return result.status === 0;
 }
 
+function hasGeminiCLI() {
+  const result = spawnSync("gemini", ["--version"], { stdio: "pipe" });
+  return result.status === 0;
+}
+
 function installClaude() {
   log("Installing RPIKit for Claude Code...");
   try {
@@ -62,6 +67,12 @@ function installCodex() {
   return true;
 }
 
+function installGeminiCLI() {
+  log("Installing RPIKit for Gemini CLI...");
+  log("Gemini CLI: coming soon. Please see documentation for manual setup.");
+  return true;
+}
+
 function uninstallClaude() {
   log("Removing RPIKit from Claude Code...");
   try {
@@ -81,14 +92,15 @@ function printHelp() {
 RPIKit — Research → Plan → Implement
 
 Usage:
-  rpi-kit install            Install for detected tools (Claude Code + Codex)
+  rpi-kit install            Interactive setup for AI tools
   rpi-kit install --claude   Install for Claude Code only
   rpi-kit install --codex    Install for Codex only (copies AGENTS.md to cwd)
+  rpi-kit install --gemini   Install for Gemini CLI only
   rpi-kit uninstall          Remove from Claude Code
   rpi-kit onboarding         Interactive walkthrough of the workflow
   rpi-kit help               Show this help
 
-After install, use in Claude Code:
+After install, use in Claude Code or Gemini CLI:
   /rpi:init                  Configure for your project
   /rpi:new <feature>         Start a new feature
   /rpi:research <feature>    Research feasibility
@@ -99,61 +111,139 @@ After install, use in Claude Code:
 `);
 }
 
-switch (command) {
-  case "install": {
-    const claudeOnly = flags.includes("--claude");
-    const codexOnly = flags.includes("--codex");
+async function run() {
+  switch (command) {
+    case "install": {
+      const claudeOnly = flags.includes("--claude");
+      const codexOnly = flags.includes("--codex");
+      const geminiOnly = flags.includes("--gemini");
 
-    if (claudeOnly) {
-      installClaude();
-    } else if (codexOnly) {
-      installCodex();
-    } else {
-      let installed = false;
+      if (claudeOnly) {
+        installClaude();
+        break;
+      }
+      if (codexOnly) {
+        installCodex();
+        break;
+      }
+      if (geminiOnly) {
+        installGeminiCLI();
+        break;
+      }
 
-      if (hasClaude()) {
-        installed = installClaude() || installed;
+      // If silent, use the original auto-install behavior
+      if (silent) {
+        let installed = false;
+        if (hasClaude()) installed = installClaude() || installed;
+        if (hasCodex()) installed = installCodex() || installed;
+        if (hasGeminiCLI()) installed = installGeminiCLI() || installed;
+        if (!installed) {
+          const result = installClaude();
+          if (!result) {
+            log("\nNo supported tool detected (claude, codex, gemini).");
+            log("Run manually after installing Claude Code, Codex, or Gemini CLI:");
+            log("  rpi-kit install --claude");
+            log("  rpi-kit install --codex");
+            log("  rpi-kit install --gemini");
+          }
+        }
+        break;
       }
 
-      if (hasCodex()) {
-        installed = installCodex() || installed;
+      // Interactive prompt
+      let p;
+      let color;
+      try {
+        p = await import("@clack/prompts");
+        color = (await import("picocolors")).default;
+      } catch (e) {
+        console.error("Failed to load interactive prompt dependencies. Falling back to default install.");
+        let installed = false;
+        if (hasClaude()) installed = installClaude() || installed;
+        if (hasCodex()) installed = installCodex() || installed;
+        if (!installed) installClaude();
+        break;
       }
 
-      if (!installed && !silent) {
-        const result = installClaude();
-        if (!result) {
-          log("\nNo supported tool detected (claude, codex).");
-          log("Run manually after installing Claude Code or Codex:");
-          log("  rpi-kit install --claude");
-          log("  rpi-kit install --codex");
+      console.clear();
+      p.intro(color.bgCyan(color.black(" RPIKit Setup ")));
+
+      p.log.message(color.dim("RPIKit configured: Claude Code, Codex, Gemini CLI"));
+
+      const options = [
+        { value: "claude", label: "Claude Code", hint: hasClaude() ? "detected" : "" },
+        { value: "codex", label: "Codex", hint: hasCodex() ? "detected" : "" },
+        { value: "gemini", label: "Gemini CLI", hint: hasGeminiCLI() ? "detected" : "" }
+      ];
+
+      const initialValues = options.filter(o => o.hint === "detected").map(o => o.value);
+      if (initialValues.length === 0) {
+        initialValues.push("claude"); // default selection if none detected
+      }
+
+      const selectedTools = await p.multiselect({
+        message: `Select tools to set up (${options.length} available)`,
+        options: options,
+        initialValues,
+        required: false
+      });
+
+      if (p.isCancel(selectedTools)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+      }
+
+      if (selectedTools.length === 0) {
+        p.outro("No tools selected.");
+        break;
+      }
+
+      console.log(); // Spacing
+      
+      let installed = false;
+      for (const tool of selectedTools) {
+        if (tool === "claude") {
+          installed = installClaude() || installed;
+        } else if (tool === "codex") {
+          installed = installCodex() || installed;
+        } else if (tool === "gemini") {
+          installed = installGeminiCLI() || installed;
         }
       }
 
-      if (installed && !silent) {
-        log("");
-        log("New to RPIKit? Run: rpi-kit onboarding");
+      if (installed) {
+        console.log();
+        p.outro(color.green("Setup complete! New to RPIKit? Run: rpi-kit onboarding"));
+      } else {
+        p.outro(color.yellow("Setup finished with some issues."));
       }
+      
+      break;
     }
-    break;
-  }
 
-  case "onboarding": {
-    const { run } = require("./onboarding");
-    run();
-    break;
-  }
+    case "onboarding": {
+      const { run } = require("./onboarding");
+      run();
+      break;
+    }
 
-  case "uninstall":
-    uninstallClaude();
-    break;
+    case "uninstall":
+      uninstallClaude();
+      break;
 
-  case "help":
-  case "--help":
-  case "-h":
-    printHelp();
-    break;
+    case "help":
+    case "--help":
+    case "-h":
+      printHelp();
+      break;
 
-  default:
-    if (!silent) printHelp();
-    break;
+    default:
+      if (!silent) printHelp();
+      break;
+  }
 }
+
+run().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/commands/rpi/implement.md

@@ -1,7 +1,7 @@
 ---
 name: rpi:implement
-description: Execute the implementation plan with task-level tracking, smart parallelism, automatic simplification, and mandatory code review.
-argument-hint: "<feature-slug> [--sequential|--parallel] [--skip-simplify] [--skip-review] [--resume] [--from-task <id>]"
+description: Execute the implementation plan with task-level tracking and smart parallelism.
+argument-hint: "<feature-slug> [--sequential|--parallel] [--resume] [--from-task <id>]"
 allowed-tools:
   - Read
   - Write
@@ -14,7 +14,7 @@ allowed-tools:
 ---
 
 <objective>
-Execute tasks from PLAN.md with per-task commits, automatic code simplification, and mandatory code review. Track everything in IMPLEMENT.md.
+Execute tasks from PLAN.md with per-task commits. Track everything in IMPLEMENT.md. Simplification and review run in separate sessions for fresh context.
 </objective>
 
 <process>
@@ -26,8 +26,6 @@ Parse `$ARGUMENTS`:
 - First argument: `{feature-slug}` (required)
 - `--sequential`: force single agent mode
 - `--parallel`: force parallel wave mode
-- `--skip-simplify`: skip the simplify step (overrides config)
-- `--skip-review`: skip the review step (overrides config)
 - `--resume`: resume from last completed task in existing IMPLEMENT.md
 - `--from-task {id}`: resume from a specific task ID (used with --resume)
 
@@ -404,21 +402,7 @@ After all tasks in a PLAN.md phase complete:
    ```
 4. If any tasks blocked, ask user how to proceed before next phase
 
-## 8. Run simplify (unless --skip-simplify)
-
-If `auto_simplify` is true in config (and no `--skip-simplify`):
-
-Run the simplify process as defined in `/rpi:simplify {feature-slug}`.
-Record findings in IMPLEMENT.md under "## Simplify Findings".
-
-## 9. Run review (unless --skip-review)
-
-If `review_after_implement` is true in config (and no `--skip-review`):
-
-Run the review process as defined in `/rpi:review {feature-slug}`.
-Record verdict in IMPLEMENT.md under "## Review".
-
-## 10. Finalize IMPLEMENT.md
+## 8. Finalize IMPLEMENT.md
 
 Rebuild IMPLEMENT.md from all checkpoint files:
 1. Read all files in `checkpoints/`
@@ -434,42 +418,29 @@ Sessions: {count from sessions/ directory}
 Commits: {list with hashes from checkpoints}
 Deviations: {count by severity}
 
-## Review Verdict: {PASS|FAIL}
-{details}
-```
+## Simplify Findings
 
-## 11. Present result
+_Run in a separate session: /rpi:simplify {feature-slug}_
 
-If PASS:
-```
-Feature {feature-slug} implemented.
-{N} tasks completed across {M} phases.
-Review: PASS
+## Review
 
-All artifacts: {folder}/{feature-slug}/
+_Run in a separate session: /rpi:review {feature-slug}_
 ```
 
-If FAIL:
-```
-Feature {feature-slug} implementation complete but review found issues:
-{list issues}
+## 9. Present result
 
-Fix and re-run: /rpi:review {feature-slug}
 ```
+Implementation complete: {feature-slug}
+{N} tasks completed across {M} phases.
 
-## 11b. Cross-phase session boundary (Tier 3 only)
-
-If tier == 3, after presenting the final result, add:
+All artifacts: {folder}/{feature-slug}/
 
-```
-This was a large feature (Tier 3). For future features of this complexity,
-consider running each RPI phase in a separate session:
-1. Session 1: /rpi:new + /rpi:research
-2. Session 2: /rpi:plan
-3. Session 3+: /rpi:implement --resume (one session per wave)
+Next steps (run each in a new session for fresh context):
+1. /rpi:simplify {feature-slug}
+2. /rpi:review {feature-slug}
 ```
 
-## 12. Handle isolation cleanup
+## 10. Handle isolation cleanup
 
 Read `isolation` from `.rpi.yaml`.
 

package/commands/rpi/init.md

@@ -29,7 +29,6 @@ Use AskUserQuestion to gather preferences. Ask up to 4 questions at a time:
 - "What's your default research tier?" — Options: `standard` (Recommended), `quick`, `deep`
 
 **Batch 2:**
-- "Should code simplification run automatically before review?" — Options: Yes (Recommended), No
 - "What commit message style do you prefer?" — Options: `conventional` (Recommended, e.g., feat(1.1): task name), `descriptive` (plain English)
 
 **Batch 3:**
@@ -61,11 +60,9 @@ Write the config file at the project root:
 
 folder: {user_choice}
 tier: {user_choice}
-auto_simplify: {true|false}
 commit_style: {conventional|descriptive}
 parallel_threshold: {number}
 skip_artifacts: []
-review_after_implement: true
 isolation: {none|branch|worktree}
 tdd: {true|false}
 test_runner: {auto|command}

package/commands/rpi/simplify.md

@@ -126,6 +126,6 @@ Simplify complete for {feature-slug}:
 {Or: "Code was already clean — no issues found."}
 ```
 
-If called from /rpi:implement, return findings for recording in IMPLEMENT.md.
+After finishing, update IMPLEMENT.md `## Simplify Findings` section with the results.
 
 </process>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rpi-kit",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Research → Plan → Implement. A systematic feature development workflow for Claude Code.",
   "license": "MIT",
   "author": "Daniel Mendes",
@@ -35,5 +35,9 @@
   "scripts": {
     "test": "node --test test/cli.test.js test/commands.test.js",
     "postinstall": "node bin/cli.js install --silent"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "picocolors": "^1.1.1"
   }
 }

package/skills/rpi-workflow/SKILL.md

@@ -112,11 +112,9 @@ After implementation, isolation cleanup runs based on config:
 ```yaml
 folder: rpi                    # Feature folder location
 tier: standard                 # Default research tier
-auto_simplify: true            # Run simplify before review
 commit_style: conventional     # Commit message format
 parallel_threshold: 8          # Task count for parallel mode
 skip_artifacts: []             # Artifacts to never generate
-review_after_implement: true   # Mandatory review gate
 isolation: none                # none | branch | worktree
 tdd: false                     # Enable Test-Driven Development
 test_runner: auto              # Test command (auto-detect or explicit)