aiblueprint-cli 1.4.24 → 1.4.26

package/claude-code-config/skills/workflow-apex-free/steps/step-00b-branch.md

@@ -0,0 +1,126 @@
+---
+name: step-00b-branch
+description: Verify and setup git branch for APEX workflow
+returns_to: step-00-init.md
+---
+
+# Step 0b: Branch Setup
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+- 🛑 NEVER commit directly to main/master when branch_mode enabled
+- 🛑 NEVER skip branch verification
+- ✅ ALWAYS check current branch first
+- ✅ ALWAYS store {branch_name} before returning
+- 📋 YOU ARE A BRANCH MANAGER, not an implementer
+- 💬 FOCUS on branch setup only
+- 🚫 FORBIDDEN to start any implementation work
+
+## CONTEXT BOUNDARIES:
+
+- Variables available: `{task_id}`, `{auto_mode}`, `{pr_mode}`
+- This sub-step sets: `{branch_name}`
+- Return to step-00-init.md after completion
+
+## YOUR TASK:
+
+Verify the current git branch and create a feature branch if on main/master.
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Check Current Branch
+
+```bash
+git branch --show-current
+```
+
+Store result as `{current_branch}`
+
+### 2. Evaluate Branch Status
+
+**If `{current_branch}` is `main` or `master`:**
+→ Go to step 3 (Create Branch)
+
+**If `{current_branch}` is NOT main/master:**
+→ Store `{branch_name}` = `{current_branch}`
+→ Display: "✓ Already on branch: {branch_name}"
+→ Return to step-00-init.md
+
+### 3. Create Feature Branch
+
+**If `{auto_mode}` = true:**
+→ Auto-create branch: `feat/{task_id}`
+
+**If `{auto_mode}` = false:**
+Use AskUserQuestion:
+```yaml
+questions:
+  - header: "Branch"
+    question: "You're on {current_branch}. Create a new branch for this task?"
+    options:
+      - label: "Create feat/{task_id} (Recommended)"
+        description: "Create new feature branch and switch to it"
+      - label: "Custom branch name"
+        description: "I'll specify a custom branch name"
+      - label: "Stay on {current_branch}"
+        description: "Continue without creating a branch (not recommended for PRs)"
+    multiSelect: false
+```
+
+### 4. Execute Branch Creation
+
+**If user chose "Create feat/{task_id}" or auto_mode:**
+```bash
+git checkout -b feat/{task_id}
+```
+→ `{branch_name}` = `feat/{task_id}`
+
+**If user chose "Custom branch name":**
+→ Ask for branch name
+```bash
+git checkout -b {custom_name}
+```
+→ `{branch_name}` = `{custom_name}`
+
+**If user chose "Stay on {current_branch}":**
+→ `{branch_name}` = `{current_branch}`
+→ Display warning if `{pr_mode}` = true:
+  "⚠️ Warning: Creating PR from {current_branch} directly"
+
+### 5. Confirm and Return
+
+Display:
+```
+✓ Branch: {branch_name}
+{if new branch created: "Created and switched to new branch"}
+```
+
+→ Return to step-00-init.md with `{branch_name}` set
+
+---
+
+## SUCCESS METRICS:
+
+✅ Current branch verified
+✅ Feature branch created if on main/master (unless user declined)
+✅ `{branch_name}` variable set
+✅ User warned if staying on main with PR mode
+
+## FAILURE MODES:
+
+❌ Starting implementation before returning
+❌ Not setting `{branch_name}` variable
+❌ Creating branch without user consent (when not auto_mode)
+❌ **CRITICAL**: Using plain text prompts instead of AskUserQuestion
+
+---
+
+## RETURN:
+
+After branch setup complete, return to `./step-00-init.md` to continue initialization.
+
+<critical>
+Remember: This sub-step ONLY handles branch setup. Return immediately after setting {branch_name}.
+</critical>

package/claude-code-config/skills/workflow-apex-free/steps/step-00b-economy.md

@@ -0,0 +1,244 @@
+---
+name: step-00b-economy
+description: Economy mode overrides - no subagents, direct tool usage to save tokens
+load_condition: economy_mode = true
+---
+
+# Economy Mode Overrides
+
+**This file is ONLY loaded when `-e` or `--economy` flag is active.**
+
+These instructions OVERRIDE the default behavior in all steps to save tokens by avoiding subagent launches.
+
+---
+
+<why_economy_mode>
+**Purpose:** Reduce token usage for users with limited Claude Code plans.
+
+**Trade-offs:**
+- ✅ Uses ~70% fewer tokens
+- ✅ Faster execution (no agent overhead)
+- ⚠️ Less thorough exploration
+- ⚠️ No parallel research
+- ⚠️ May miss some context
+
+**When to use:**
+- Limited monthly token budget
+- Simple, well-defined tasks
+- Familiar codebase
+- Quick fixes or small features
+</why_economy_mode>
+
+---
+
+<override_rules>
+
+## CRITICAL: Apply These Overrides to ALL Steps
+
+**When `{economy_mode}` = true, these rules OVERRIDE the default instructions:**
+
+---
+
+### Override 1: No Subagent Launches
+
+**DEFAULT behavior (when economy_mode = false):**
+```
+Launch parallel agents:
+- Agent 1: explore-codebase
+- Agent 2: explore-docs
+- Agent 3: websearch
+```
+
+**ECONOMY behavior (when economy_mode = true):**
+```
+Use direct tools instead:
+- Glob to find files
+- Grep to search content
+- Read to examine files
+- WebSearch only if absolutely necessary
+```
+
+**NEVER use Task tool with subagent_type in economy mode.**
+
+---
+
+### Override 2: Direct Tool Usage Pattern
+
+Instead of launching exploration agents, use this pattern:
+
+```
+1. Glob to find relevant files:
+   - Glob: "**/*auth*" or "**/*{keyword}*"
+   - Glob: "src/**/*.ts" for specific areas
+
+2. Grep to find specific code:
+   - Grep: "function login" or "class Auth"
+   - Grep: pattern in specific directory
+
+3. Read to examine found files:
+   - Read the most relevant 3-5 files
+   - Focus on files matching the task
+
+4. WebSearch ONLY if:
+   - Library documentation needed
+   - Unknown API or pattern
+   - Limit to 1-2 searches max
+```
+
+---
+
+### Override 3: Reduced Exploration Scope
+
+**DEFAULT:** Explore comprehensively, find all related code
+**ECONOMY:** Focus on most likely locations only
+
+```
+Economy exploration strategy:
+1. Start with obvious paths (src/auth/, src/api/, etc.)
+2. Search for exact keywords from task
+3. Read only files directly related to task
+4. Skip "nice to have" context
+5. Stop exploring when you have enough to proceed
+```
+
+---
+
+### Override 4: Skip Optional Steps
+
+**In economy mode, skip or minimize:**
+- Extensive documentation research (use existing knowledge)
+- Web searches for common patterns (use best practices you know)
+- Multiple rounds of exploration (one round is enough)
+- Deep pattern analysis (quick scan is sufficient)
+
+**Always do:**
+- Find the files to modify
+- Understand existing patterns (quick read)
+- Identify dependencies
+- Create the plan
+
+---
+
+### Override 5: Leaner Validation
+
+**DEFAULT:** Launch code-reviewer agent for adversarial review
+**ECONOMY:** Self-review without subagent
+
+```
+Economy validation:
+1. Run typecheck and lint (required)
+2. Run affected tests (required)
+3. Quick self-review checklist:
+   - [ ] No obvious bugs
+   - [ ] Follows existing patterns
+   - [ ] Error handling present
+   - [ ] No security issues
+4. Skip adversarial review agent
+```
+
+---
+
+### Override 6: Test Mode Adjustments
+
+**If both `{economy_mode}` and `{test_mode}` are true:**
+
+```
+Economy test strategy:
+1. Analyze tests with Glob + Grep (not explore-codebase agent)
+2. Read 1-2 similar test files for patterns
+3. Create essential tests only:
+   - 1 happy path test
+   - 1 error case test
+   - Skip edge cases unless critical
+4. Run tests directly (no agent)
+```
+
+</override_rules>
+
+---
+
+<step_specific_overrides>
+
+## Step-by-Step Economy Overrides
+
+### Step 01: Analyze (Economy)
+```
+INSTEAD OF: 3 parallel exploration agents
+DO:
+1. Glob "**/*{keyword}*" for task-related files
+2. Grep for specific patterns in src/
+3. Read top 3-5 most relevant files
+4. Skip web research unless stuck
+```
+
+### Step 02: Plan (Economy)
+```
+Same as default - planning doesn't use agents
+```
+
+### Step 03: Execute (Economy)
+```
+Same as default - execution doesn't use agents
+```
+
+### Step 04: Validate (Economy)
+```
+INSTEAD OF: Comprehensive validation
+DO:
+1. Run typecheck + lint
+2. Run only affected tests
+3. Quick manual review
+4. Skip coverage analysis
+```
+
+### Step 05: Examine (Economy)
+```
+INSTEAD OF: code-reviewer agent
+DO:
+1. Self-review with checklist:
+   - Security: no injection, no secrets
+   - Logic: handles errors, edge cases
+   - Quality: follows patterns, readable
+2. Note any concerns
+3. Move to resolve if issues found
+```
+
+### Step 07: Tests (Economy)
+```
+INSTEAD OF: Deep test analysis with agents
+DO:
+1. Glob for existing test files
+2. Read 1 similar test file
+3. Create minimal test coverage
+4. Focus on critical paths only
+```
+
+### Step 08: Run Tests (Economy)
+```
+Same as default - test running doesn't use agents
+```
+
+</step_specific_overrides>
+
+---
+
+<economy_indicator>
+**When economy mode is active, start each step with:**
+
+```
+⚡ ECONOMY MODE - Using direct tools, no subagents
+```
+
+This reminds both Claude and the user that economy mode is active.
+</economy_indicator>
+
+---
+
+<success_metrics>
+Economy mode is successful when:
+- No Task tool calls with subagent_type
+- Direct Glob/Grep/Read usage instead
+- Fewer than 3 WebSearch calls total
+- Implementation still correct and working
+- Tests pass (if test_mode enabled)
+</success_metrics>

package/claude-code-config/skills/workflow-apex-free/steps/step-00b-interactive.md

@@ -0,0 +1,153 @@
+---
+name: step-00b-interactive
+description: Interactively configure APEX workflow flags
+returns_to: step-00-init.md
+---
+
+# Step 0b: Interactive Configuration
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+- 🛑 NEVER skip the interactive menu
+- 🛑 NEVER assume user preferences
+- ✅ ALWAYS use AskUserQuestion for flag selection
+- ✅ ALWAYS update all flag variables before returning
+- 📋 YOU ARE A CONFIGURATOR, not an implementer
+- 💬 FOCUS on flag configuration only
+- 🚫 FORBIDDEN to start any workflow steps
+
+## CONTEXT BOUNDARIES:
+
+- Variables available: All current flag values from step-00-init
+- This sub-step updates: All flag variables based on user selection
+- Return to step-00-init.md after completion
+
+## YOUR TASK:
+
+Present an interactive menu for the user to enable/disable workflow flags.
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Display Current Configuration
+
+Show current flag values:
+```
+**Current APEX Configuration:**
+
+| Flag | Status | Description |
+|------|--------|-------------|
+| Auto (`-a`) | {auto_mode ? "✓ ON" : "✗ OFF"} | Skip confirmations |
+| Examine (`-x`) | {examine_mode ? "✓ ON" : "✗ OFF"} | Adversarial review |
+| Save (`-s`) | {save_mode ? "✓ ON" : "✗ OFF"} | Save outputs to files |
+| Test (`-t`) | {test_mode ? "✓ ON" : "✗ OFF"} | Include test steps |
+| Economy (`-e`) | {economy_mode ? "✓ ON" : "✗ OFF"} | No subagents |
+| Branch (`-b`) | {branch_mode ? "✓ ON" : "✗ OFF"} | Verify/create branch |
+| PR (`-pr`) | {pr_mode ? "✓ ON" : "✗ OFF"} | Create pull request |
+```
+
+### 2. Ask for Flag Changes
+
+Use AskUserQuestion with multiSelect:
+```yaml
+questions:
+  - header: "Configure"
+    question: "Select flags to TOGGLE (currently shown flags will flip their state):"
+    options:
+      - label: "Auto mode"
+        description: "{auto_mode ? 'Disable' : 'Enable'} - skip confirmations"
+      - label: "Examine mode"
+        description: "{examine_mode ? 'Disable' : 'Enable'} - adversarial review at end"
+      - label: "Save mode"
+        description: "{save_mode ? 'Disable' : 'Enable'} - save outputs to .claude/output/"
+      - label: "Test mode"
+        description: "{test_mode ? 'Disable' : 'Enable'} - include test creation/runner"
+    multiSelect: true
+```
+
+### 3. Ask for Additional Flags
+
+Use AskUserQuestion with multiSelect:
+```yaml
+questions:
+  - header: "More"
+    question: "Select additional flags to TOGGLE:"
+    options:
+      - label: "Economy mode"
+        description: "{economy_mode ? 'Disable' : 'Enable'} - no subagents, save tokens"
+      - label: "Branch mode"
+        description: "{branch_mode ? 'Disable' : 'Enable'} - verify/create git branch"
+      - label: "PR mode"
+        description: "{pr_mode ? 'Disable' : 'Enable'} - create pull request at end"
+      - label: "Done - keep current"
+        description: "No more changes, proceed with workflow"
+    multiSelect: true
+```
+
+### 4. Apply Changes
+
+For each selected flag, toggle its value:
+```
+IF "Auto mode" selected → {auto_mode} = !{auto_mode}
+IF "Examine mode" selected → {examine_mode} = !{examine_mode}
+IF "Save mode" selected → {save_mode} = !{save_mode}
+IF "Test mode" selected → {test_mode} = !{test_mode}
+IF "Economy mode" selected → {economy_mode} = !{economy_mode}
+IF "Branch mode" selected → {branch_mode} = !{branch_mode}
+IF "PR mode" selected → {pr_mode} = !{pr_mode}
+```
+
+**Special rule:** If PR mode enabled, auto-enable branch mode:
+```
+IF {pr_mode} = true → {branch_mode} = true
+```
+
+### 5. Show Final Configuration
+
+Display updated configuration:
+```
+**Updated APEX Configuration:**
+
+| Flag | Status |
+|------|--------|
+| Auto | {auto_mode ? "✓ ON" : "✗ OFF"} |
+| Examine | {examine_mode ? "✓ ON" : "✗ OFF"} |
+| Save | {save_mode ? "✓ ON" : "✗ OFF"} |
+| Test | {test_mode ? "✓ ON" : "✗ OFF"} |
+| Economy | {economy_mode ? "✓ ON" : "✗ OFF"} |
+| Branch | {branch_mode ? "✓ ON" : "✗ OFF"} |
+| PR | {pr_mode ? "✓ ON" : "✗ OFF"} |
+```
+
+### 6. Return
+
+→ Return to step-00-init.md with all flags updated
+
+---
+
+## SUCCESS METRICS:
+
+✅ Current configuration displayed
+✅ User able to toggle any flag
+✅ All selected flags properly toggled
+✅ PR mode auto-enables branch mode
+✅ Final configuration shown
+
+## FAILURE MODES:
+
+❌ Not showing current flag states
+❌ Forgetting to toggle selected flags
+❌ Not enabling branch_mode when pr_mode selected
+❌ Starting workflow instead of returning
+❌ **CRITICAL**: Using plain text prompts instead of AskUserQuestion
+
+---
+
+## RETURN:
+
+After configuration complete, return to `./step-00-init.md` to continue initialization.
+
+<critical>
+Remember: This sub-step ONLY handles flag configuration. Return immediately after updating flags.
+</critical>