aiblueprint-cli 1.4.41 → 1.4.43

package/claude-code-config/skills/{workflow-apex → apex}/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: apex
-description: Systematic implementation using APEX methodology (Analyze-Plan-Execute-eXamine) with parallel agents, self-validation, and optional adversarial review. Use when implementing features, fixing bugs, or making code changes that benefit from structured workflow.
-argument-hint: "[-a] [-x] [-s] [-t] [-b] [-pr] [-i] [-r <task-id>] <task description>"
+description: Systematic implementation using APEX methodology (Analyze-Plan-Execute-Validate) with parallel agents and self-validation. Use when implementing features, fixing bugs, or making code changes that benefit from structured workflow.
+argument-hint: "[-a] [-s] [-e] [-b] [-i] [-r <task-id>] <task description>"
 ---
 
 <objective>
@@ -21,19 +21,11 @@ Execute systematic implementation workflows using the APEX methodology. This ski
 /apex -a -s implement user registration
 ```
 
-**With adversarial review:**
-
-```bash
-/apex -a -x -s fix login bug
-```
-
 **Flags:**
 
 - `-a` (auto): Skip confirmations
 - `-s` (save): Save outputs to `.claude/output/apex/`
-- `-x` (examine): Include adversarial code review
-- `-t` (test): Create and run tests
-- `-pr` (pull-request): Create PR at end
+- `-e` (economy): No subagents, save tokens
 
 See `<parameters>` for complete flag list.
 </quick_start>
@@ -45,25 +37,19 @@ See `<parameters>` for complete flag list.
 | Short | Long | Description |
 |-------|------|-------------|
 | `-a` | `--auto` | Autonomous mode: skip confirmations, auto-approve plans |
-| `-x` | `--examine` | Auto-examine mode: proceed to adversarial review |
 | `-s` | `--save` | Save mode: output each step to `.claude/output/apex/` |
-| `-t` | `--test` | Test mode: include test creation and runner steps |
 | `-e` | `--economy` | Economy mode: no subagents, save tokens (for limited plans) |
 | `-r` | `--resume` | Resume mode: continue from a previous task |
 | `-b` | `--branch` | Branch mode: verify not on main, create branch if needed |
-| `-pr` | `--pull-request` | PR mode: create pull request at end (enables -b) |
 | `-i` | `--interactive` | Interactive mode: configure flags via AskUserQuestion |
 
 **Disable flags (turn OFF):**
 | Short | Long | Description |
 |-------|------|-------------|
 | `-A` | `--no-auto` | Disable auto mode |
-| `-X` | `--no-examine` | Disable examine mode |
 | `-S` | `--no-save` | Disable save mode |
-| `-T` | `--no-test` | Disable test mode |
 | `-E` | `--no-economy` | Disable economy mode |
 | `-B` | `--no-branch` | Disable branch mode |
-| `-PR` | `--no-pull-request` | Disable PR mode |
 </flags>
 
 <examples>
@@ -74,14 +60,8 @@ See `<parameters>` for complete flag list.
 # Autonomous (skip confirmations)
 /apex -a add auth middleware
 
-# Save outputs + examine
-/apex -a -x -s add auth middleware
-
-# Full workflow with tests
-/apex -a -x -s -t add auth middleware
-
-# With PR creation
-/apex -a -pr add auth middleware
+# Save outputs
+/apex -a -s add auth middleware
 
 # Resume previous task
 /apex -r 01-auth-middleware
@@ -116,20 +96,13 @@ For detailed parsing algorithm, see `steps/step-00-init.md`.
 
 All outputs saved to PROJECT directory (where Claude Code is running):
 ```
-
 .claude/output/apex/{task-id}/
 ├── 00-context.md # Params, user request, timestamp
 ├── 01-analyze.md # Analysis findings
 ├── 02-plan.md # Implementation plan
 ├── 03-execute.md # Execution log
-├── 04-validate.md # Validation results
-├── 05-examine.md # Review findings (if -x)
-├── 06-resolve.md # Resolution log (if -x)
-├── 07-tests.md # Test analysis and creation (if --test)
-├── 08-run-tests.md # Test runner log (if --test)
-└── 09-finish.md # Workflow finish and PR creation (if --pull-request)
-
-````
+└── 04-validate.md # Validation results
+```
 
 **00-context.md structure:**
 ```markdown
@@ -140,9 +113,8 @@ All outputs saved to PROJECT directory (where Claude Code is running):
 
 ## Flags
 - Auto mode: {auto_mode}
-- Examine mode: {examine_mode}
 - Save mode: {save_mode}
-- Test mode: {test_mode}
+- Economy mode: {economy_mode}
 
 ## User Request
 {original user input}
@@ -150,7 +122,7 @@ All outputs saved to PROJECT directory (where Claude Code is running):
 ## Acceptance Criteria
 - [ ] AC1: {inferred criterion}
 - [ ] AC2: {inferred criterion}
-````
+```
 
 </output_structure>
 
@@ -177,12 +149,7 @@ For implementation details, see `steps/step-00-init.md`.
 4. Load step-01-analyze.md → gather context
 5. Load step-02-plan.md → create strategy
 6. Load step-03-execute.md → implement
-7. Load step-04-validate.md → verify
-8. If `--test`: Load step-07-tests.md → analyze and create tests
-9. If `--test`: Load step-08-run-tests.md → run until green
-10. If `-x` or user requests: Load step-05-examine.md → adversarial review
-11. If findings: Load step-06-resolve.md → fix findings
-12. If `-pr`: Load step-09-finish.md → create pull request
+7. Load step-04-validate.md → verify and complete
 </workflow>
 
 <state_variables>
@@ -195,12 +162,9 @@ For implementation details, see `steps/step-00-init.md`.
 | `{task_id}`             | string  | Full identifier with number (e.g., `01-add-auth-middleware`) |
 | `{acceptance_criteria}` | list    | Success criteria (inferred or explicit)                |
 | `{auto_mode}`           | boolean | Skip confirmations, use recommended options            |
-| `{examine_mode}`        | boolean | Auto-proceed to adversarial review                     |
 | `{save_mode}`           | boolean | Save outputs to .claude/output/apex/                   |
-| `{test_mode}`           | boolean | Include test steps (07-08)                             |
 | `{economy_mode}`        | boolean | No subagents, direct tool usage only                   |
 | `{branch_mode}`         | boolean | Verify not on main, create branch if needed            |
-| `{pr_mode}`             | boolean | Create pull request at end                             |
 | `{interactive_mode}`    | boolean | Configure flags interactively                          |
 | `{resume_task}`         | string  | Task ID to resume (if -r provided)                     |
 | `{output_dir}`          | string  | Full path to output directory                          |
@@ -233,12 +197,7 @@ After initialization, step-00 loads step-01-analyze.md.
 | 01   | `steps/step-01-analyze.md`   | Smart context gathering with 1-10 parallel agents based on complexity |
 | 02   | `steps/step-02-plan.md`      | File-by-file implementation strategy                 |
 | 03   | `steps/step-03-execute.md`   | Todo-driven implementation                           |
-| 04   | `steps/step-04-validate.md`  | Self-check and validation                            |
-| 05   | `steps/step-05-examine.md`   | Adversarial code review (optional)                   |
-| 06   | `steps/step-06-resolve.md`   | Finding resolution (optional)                        |
-| 07   | `steps/step-07-tests.md`     | Test analysis and creation (if --test)               |
-| 08   | `steps/step-08-run-tests.md` | Test runner loop until green (if --test)             |
-| 09   | `steps/step-09-finish.md`    | Create pull request (if --pull-request)              |
+| 04   | `steps/step-04-validate.md`  | Self-check, validation, and workflow completion      |
 
 </step_files>
 
@@ -298,6 +257,5 @@ Step-00 runs `scripts/setup-templates.sh` to initialize all output files from `t
 - Each step loaded progressively
 - All validation checks passing
 - Outputs saved if `{save_mode}` enabled
-- Tests passing if `{test_mode}` enabled
 - Clear completion summary provided
-  </success_criteria>
+</success_criteria>

package/claude-code-config/skills/{workflow-apex → apex}/scripts/setup-templates.sh

@@ -11,15 +11,12 @@ set -e
 FEATURE_NAME="$1"
 TASK_DESCRIPTION="$2"
 AUTO_MODE="${3:-false}"
-EXAMINE_MODE="${4:-false}"
-SAVE_MODE="${5:-false}"
-TEST_MODE="${6:-false}"
-ECONOMY_MODE="${7:-false}"
-BRANCH_MODE="${8:-false}"
-PR_MODE="${9:-false}"
-INTERACTIVE_MODE="${10:-false}"
-BRANCH_NAME="${11:-}"
-ORIGINAL_INPUT="${12:-}"
+SAVE_MODE="${4:-false}"
+ECONOMY_MODE="${5:-false}"
+BRANCH_MODE="${6:-false}"
+INTERACTIVE_MODE="${7:-false}"
+BRANCH_NAME="${8:-}"
+ORIGINAL_INPUT="${9:-}"
 
 # Validate required arguments
 if [[ -z "$FEATURE_NAME" ]]; then
@@ -73,33 +70,17 @@ render_template() {
     local template_file="$1"
     local output_file="$2"
 
-    # Determine status strings based on flags
-    local examine_status="⏭ Skip"
-    [[ "$EXAMINE_MODE" == "true" ]] && examine_status="⏸ Pending"
-
-    local test_status="⏭ Skip"
-    [[ "$TEST_MODE" == "true" ]] && test_status="⏸ Pending"
-
-    local pr_status="⏭ Skip"
-    [[ "$PR_MODE" == "true" ]] && pr_status="⏸ Pending"
-
     # Read template and replace variables
     sed -e "s|{{task_id}}|${TASK_ID}|g" \
         -e "s|{{task_description}}|${TASK_DESCRIPTION}|g" \
         -e "s|{{timestamp}}|${TIMESTAMP}|g" \
         -e "s|{{auto_mode}}|${AUTO_MODE}|g" \
-        -e "s|{{examine_mode}}|${EXAMINE_MODE}|g" \
         -e "s|{{save_mode}}|${SAVE_MODE}|g" \
-        -e "s|{{test_mode}}|${TEST_MODE}|g" \
         -e "s|{{economy_mode}}|${ECONOMY_MODE}|g" \
         -e "s|{{branch_mode}}|${BRANCH_MODE}|g" \
-        -e "s|{{pr_mode}}|${PR_MODE}|g" \
         -e "s|{{interactive_mode}}|${INTERACTIVE_MODE}|g" \
         -e "s|{{branch_name}}|${BRANCH_NAME}|g" \
         -e "s|{{original_input}}|${ORIGINAL_INPUT}|g" \
-        -e "s|{{examine_status}}|${examine_status}|g" \
-        -e "s|{{test_status}}|${test_status}|g" \
-        -e "s|{{pr_status}}|${pr_status}|g" \
         "$template_file" > "$output_file"
 }
 
@@ -112,21 +93,6 @@ render_template "${TEMPLATE_DIR}/02-plan.md" "${OUTPUT_DIR}/02-plan.md"
 render_template "${TEMPLATE_DIR}/03-execute.md" "${OUTPUT_DIR}/03-execute.md"
 render_template "${TEMPLATE_DIR}/04-validate.md" "${OUTPUT_DIR}/04-validate.md"
 
-# Conditional templates
-if [[ "$EXAMINE_MODE" == "true" ]]; then
-    render_template "${TEMPLATE_DIR}/05-examine.md" "${OUTPUT_DIR}/05-examine.md"
-    render_template "${TEMPLATE_DIR}/06-resolve.md" "${OUTPUT_DIR}/06-resolve.md"
-fi
-
-if [[ "$TEST_MODE" == "true" ]]; then
-    render_template "${TEMPLATE_DIR}/07-tests.md" "${OUTPUT_DIR}/07-tests.md"
-    render_template "${TEMPLATE_DIR}/08-run-tests.md" "${OUTPUT_DIR}/08-run-tests.md"
-fi
-
-if [[ "$PR_MODE" == "true" ]]; then
-    render_template "${TEMPLATE_DIR}/09-finish.md" "${OUTPUT_DIR}/09-finish.md"
-fi
-
 # Output the generated task_id for capture by caller
 echo "TASK_ID=${TASK_ID}"
 echo "OUTPUT_DIR=${OUTPUT_DIR}"

package/claude-code-config/skills/{workflow-apex → apex}/steps/step-00-init.md

@@ -49,18 +49,15 @@ Initialize the APEX workflow by parsing flags, detecting continuation state, and
 # ===========================================
 
 auto_mode: false # -a: Skip confirmations, use recommended options
-examine_mode: false # -x: Auto-proceed to adversarial review
 save_mode: false # -s: Save outputs to .claude/output/apex/
-test_mode: false # -t: Include test creation and runner steps
 economy_mode: false # -e: No subagents, save tokens (for limited plans)
 branch_mode: false # -b: Verify not on main, create branch if needed
-pr_mode: false # -pr: Create pull request at end (enables -b)
 interactive_mode: false # -i: Configure flags interactively
 
 # Presets:
 # Budget-friendly:  economy_mode: true
-# Full quality:     examine_mode: true, save_mode: true, test_mode: true
-# Autonomous:       auto_mode: true, examine_mode: true, save_mode: true, test_mode: true
+# Full quality:     save_mode: true
+# Autonomous:       auto_mode: true, save_mode: true
 ```
 
 **Flag Reference:** See `SKILL.md` for complete flag documentation and examples.
@@ -77,12 +74,9 @@ interactive_mode: false # -i: Configure flags interactively
 
 ```
 {auto_mode}    = <default>
-{examine_mode} = <default>
 {save_mode}    = <default>
-{test_mode}    = <default>
 {economy_mode} = <default>
 {branch_mode}  = <default>
-{pr_mode}      = <default>
 {interactive_mode} = <default>
 ```
 
@@ -91,23 +85,15 @@ interactive_mode: false # -i: Configure flags interactively
 ```
 Enable flags (lowercase - turn ON):
   -a or --auto     → {auto_mode} = true
-  -x or --examine  → {examine_mode} = true
   -s or --save     → {save_mode} = true
-  -t or --test     → {test_mode} = true
   -e or --economy  → {economy_mode} = true
+  -b or --branch   → {branch_mode} = true
 
 Disable flags (UPPERCASE - turn OFF):
   -A or --no-auto         → {auto_mode} = false
-  -X or --no-examine      → {examine_mode} = false
   -S or --no-save         → {save_mode} = false
-  -T or --no-test         → {test_mode} = false
   -E or --no-economy      → {economy_mode} = false
   -B or --no-branch       → {branch_mode} = false
-  -PR or --no-pull-request → {pr_mode} = false
-
-Branch/PR flags:
-  -b or --branch        → {branch_mode} = true
-  -pr or --pull-request → {pr_mode} = true, {branch_mode} = true
 
 Interactive:
   -i or --interactive   → {interactive_mode} = true
@@ -191,12 +177,9 @@ bash {skill_dir}/scripts/setup-templates.sh \
   "{feature_name}" \
   "{task_description}" \
   "{auto_mode}" \
-  "{examine_mode}" \
   "{save_mode}" \
-  "{test_mode}" \
   "{economy_mode}" \
   "{branch_mode}" \
-  "{pr_mode}" \
   "{interactive_mode}" \
   "{branch_name}" \
   "{original_input}"
@@ -211,7 +194,6 @@ This script:
 - Creates `.claude/output/apex/{task_id}/` directory
 - Initializes `00-context.md` with configuration and progress table
 - Pre-creates all step files from templates (01-analyze.md, 02-plan.md, etc.)
-- Only creates files for enabled steps (examine, tests, PR)
 - Outputs the generated `{task_id}` for use in subsequent steps
 
 ### 5. Initialize and Proceed
@@ -227,12 +209,9 @@ Show COMPACT initialization summary (one table, then proceed immediately):
 |----------|-------|
 | `{task_id}` | 01-kebab-name |
 | `{auto_mode}` | true/false |
-| `{examine_mode}` | true/false |
 | `{save_mode}` | true/false |
-| `{test_mode}` | true/false |
 | `{economy_mode}` | true/false |
 | `{branch_mode}` | true/false |
-| `{pr_mode}` | true/false |
 
 → Analyzing...
 ```

package/claude-code-config/skills/{workflow-apex → apex}/steps/step-04-validate.md

@@ -1,8 +1,8 @@
 ---
 name: step-04-validate
-description: Self-check - run tests, verify AC, audit implementation quality
+description: Self-check - run tests, verify AC, audit implementation quality, complete workflow
 prev_step: steps/step-03-execute.md
-next_step: steps/step-05-examine.md
+next_step: null
 ---
 
 # Step 4: Validate (Self-Check)
@@ -48,8 +48,7 @@ From previous steps:
 | `{acceptance_criteria}` | Success criteria |
 | `{auto_mode}` | Skip confirmations |
 | `{save_mode}` | Save outputs to files |
-| `{test_mode}` | Include test steps |
-| `{examine_mode}` | Auto-proceed to review |
+| `{economy_mode}` | No subagents mode |
 | `{output_dir}` | Path to output (if save_mode) |
 | Implementation | Completed in step-03 |
 </available_state>
@@ -171,38 +170,28 @@ Both MUST pass.
 **Summary:** All checks passing, ready for next step.
 ```
 
-### 8. Determine Next Step
+### 8. Complete Workflow
 
-**Decision tree:**
+**Show final summary:**
 
 ```
-IF {test_mode} = true:
-    → Load step-07-tests.md (test analysis and creation)
+✅ APEX Workflow Complete
 
-ELSE IF {examine_mode} = true:
-    → Load step-05-examine.md (adversarial review)
+**Task:** {task_description}
+**Task ID:** {task_id}
 
-ELSE IF {auto_mode} = false:
-    → Ask user:
-```
+**Validation Results:**
+- Typecheck: ✓ Passed
+- Lint: ✓ Passed
+- Tests: ✓ Passed
 
-```yaml
-questions:
-  - header: "Next"
-    question: "Validation complete. What would you like to do?"
-    options:
-      - label: "Run adversarial review"
-        description: "Deep review for security, logic, and quality"
-      - label: "Complete workflow"
-        description: "Skip review and finalize"
-      - label: "Add tests"
-        description: "Create additional tests first"
-    multiSelect: false
-```
+**Acceptance Criteria:**
+- [✓] AC1: Verified
+- [✓] AC2: Verified
 
-```
-ELSE:
-    → Complete workflow (show final summary)
+**Files Modified:** {list}
+
+🎉 Implementation complete and validated!
 ```
 
 ### 9. Complete Save Output (if save_mode)
@@ -217,10 +206,12 @@ Append to `{output_dir}/04-validate.md`:
 **Typecheck:** ✓
 **Lint:** ✓
 **Tests:** ✓
-**Next:** {next step based on flags}
+**Workflow:** Complete
 **Timestamp:** {ISO timestamp}
 ```
 
+Run: `bash {skill_dir}/scripts/update-progress.sh "{task_id}" "04" "validate" "complete"`
+
 ---
 
 ## SUCCESS METRICS:
@@ -231,6 +222,7 @@ Append to `{output_dir}/04-validate.md`:
 ✅ All AC verified
 ✅ Code formatted
 ✅ User informed of status
+✅ Workflow completed
 
 ## FAILURE MODES:
 
@@ -239,7 +231,6 @@ Append to `{output_dir}/04-validate.md`:
 ❌ Skipping tests for modified code
 ❌ Missing AC verification
 ❌ Proceeding with failures
-❌ **CRITICAL**: Not using AskUserQuestion for next step
 
 ## VALIDATION PROTOCOLS:
 
@@ -251,14 +242,10 @@ Append to `{output_dir}/04-validate.md`:
 
 ---
 
-## NEXT STEP:
+## WORKFLOW COMPLETE
 
-Based on flags (check in order):
-- **If test_mode:** Load `./step-07-tests.md`
-- **If examine_mode OR user requests:** Load `./step-05-examine.md`
-- **If pr_mode:** Load `./step-09-finish.md` to create pull request
-- **Otherwise:** Workflow complete - show summary
+This is the final step. After validation passes, the APEX workflow is complete.
 
 <critical>
-Remember: NEVER proceed with failing checks - fix everything first!
+Remember: NEVER claim completion with failing checks - fix everything first!
 </critical>

package/claude-code-config/skills/{workflow-apex → apex}/templates/00-context.md

@@ -10,12 +10,9 @@
 | Flag | Value |
 |------|-------|
 | Auto mode (`-a`) | {{auto_mode}} |
-| Examine mode (`-x`) | {{examine_mode}} |
 | Save mode (`-s`) | {{save_mode}} |
-| Test mode (`-t`) | {{test_mode}} |
 | Economy mode (`-e`) | {{economy_mode}} |
 | Branch mode (`-b`) | {{branch_mode}} |
-| PR mode (`-pr`) | {{pr_mode}} |
 | Interactive mode (`-i`) | {{interactive_mode}} |
 | Branch name | {{branch_name}} |
 
@@ -44,8 +41,3 @@ _To be defined in step-01-analyze.md_
 | 02-plan | ⏸ Pending | |
 | 03-execute | ⏸ Pending | |
 | 04-validate | ⏸ Pending | |
-| 05-examine | {{examine_status}} | |
-| 06-resolve | {{examine_status}} | |
-| 07-tests | {{test_status}} | |
-| 08-run-tests | {{test_status}} | |
-| 09-finish | {{pr_status}} | |

package/claude-code-config/skills/{workflow-apex → apex}/templates/README.md

@@ -12,12 +12,7 @@ This directory contains template files used to initialize APEX workflow outputs
 | `01-analyze.md` | Analysis findings | Always (if save_mode) |
 | `02-plan.md` | Implementation plan | Always (if save_mode) |
 | `03-execute.md` | Implementation log | Always (if save_mode) |
-| `04-validate.md` | Validation results | Always (if save_mode) |
-| `05-examine.md` | Adversarial review findings | Only if examine_mode enabled |
-| `06-resolve.md` | Finding resolution log | Only if examine_mode enabled |
-| `07-tests.md` | Test analysis and creation | Only if test_mode enabled |
-| `08-run-tests.md` | Test runner log | Only if test_mode enabled |
-| `09-finish.md` | PR creation log | Only if pr_mode enabled |
+| `04-validate.md` | Validation results and workflow completion | Always (if save_mode) |
 | `step-complete.md` | Completion marker template | Referenced in steps |
 
 ## Template Variables
@@ -30,18 +25,12 @@ Templates use `{{variable}}` syntax for placeholders:
 | `{{task_description}}` | Plain text task description | `add authentication middleware` |
 | `{{timestamp}}` | ISO 8601 timestamp | `2026-01-12T10:30:00Z` |
 | `{{auto_mode}}` | Auto mode flag | `true` or `false` |
-| `{{examine_mode}}` | Examine mode flag | `true` or `false` |
 | `{{save_mode}}` | Save mode flag | `true` or `false` |
-| `{{test_mode}}` | Test mode flag | `true` or `false` |
 | `{{economy_mode}}` | Economy mode flag | `true` or `false` |
 | `{{branch_mode}}` | Branch mode flag | `true` or `false` |
-| `{{pr_mode}}` | PR mode flag | `true` or `false` |
 | `{{interactive_mode}}` | Interactive mode flag | `true` or `false` |
 | `{{branch_name}}` | Git branch name | `feature/add-auth` |
 | `{{original_input}}` | Raw user input | `/apex -a -s add auth` |
-| `{{examine_status}}` | Progress status for examine steps | `⏸ Pending` or `⏭ Skip` |
-| `{{test_status}}` | Progress status for test steps | `⏸ Pending` or `⏭ Skip` |
-| `{{pr_status}}` | Progress status for PR step | `⏸ Pending` or `⏭ Skip` |
 
 ## Setup Script
 
@@ -52,15 +41,12 @@ Initializes all template files in the output directory with variables replaced.
 **Usage:**
 ```bash
 bash scripts/setup-templates.sh \
-  "task_id" \
+  "feature_name" \
   "task_description" \
   "auto_mode" \
-  "examine_mode" \
   "save_mode" \
-  "test_mode" \
   "economy_mode" \
   "branch_mode" \
-  "pr_mode" \
   "interactive_mode" \
   "branch_name" \
   "original_input"
@@ -73,12 +59,7 @@ bash scripts/setup-templates.sh \
 ├── 01-analyze.md      # Always created
 ├── 02-plan.md         # Always created
 ├── 03-execute.md      # Always created
-├── 04-validate.md     # Always created
-├── 05-examine.md      # Only if examine_mode
-├── 06-resolve.md      # Only if examine_mode
-├── 07-tests.md        # Only if test_mode
-├── 08-run-tests.md    # Only if test_mode
-└── 09-finish.md       # Only if pr_mode
+└── 04-validate.md     # Always created
 ```
 
 ## Progress Update Script
@@ -137,7 +118,7 @@ Update `00-context.md` progress:
 ```
 ```
 
-**Token cost per step:** ~200 tokens × 9 steps = ~1,800 tokens
+**Token cost per step:** ~200 tokens × 5 steps = ~1,000 tokens
 
 ### After Optimization
 
@@ -158,9 +139,9 @@ bash {skill_dir}/scripts/update-progress.sh "{task_id}" "01" "analyze" "in_progr
 Append your findings to `01-analyze.md` as you work.
 ```
 
-**Token cost per step:** ~50 tokens × 9 steps = ~450 tokens
+**Token cost per step:** ~50 tokens × 5 steps = ~250 tokens
 
-**Total savings:** ~1,350 tokens per workflow execution (75% reduction)
+**Total savings:** ~750 tokens per workflow execution (75% reduction)
 
 ## How It Works
 

package/claude-code-config/skills/{meta-claude-memory → claude-memory}/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: claude-memory
 description: Create and optimize CLAUDE.md memory files or .claude/rules/ modular rules for Claude Code projects. Comprehensive guidance on file hierarchy, content structure, path-scoped rules, best practices, and anti-patterns. Use when working with CLAUDE.md files, .claude/rules directories, setting up new projects, or improving Claude Code's context awareness.
-argument-hint: [task description or "optimize"]
+argument-hint: [init | optimize | task description]
 ---
 
 <core_principle>
@@ -168,6 +168,64 @@ Before creating or updating memory files, use AskUserQuestion:
 | Path rules not applying | Verify glob pattern matches target files |
 </workflow>
 
+<init_workflow>
+## `/claude-memory init` — Create Minimal CLAUDE.md
+
+When the user argument contains "init", execute this workflow to scaffold a CLAUDE.md with only the essential sections.
+
+### Step 1: Detect project context
+
+Read `package.json` (or equivalent: `pyproject.toml`, `Cargo.toml`, `go.mod`, etc.) to detect:
+- Project name
+- Tech stack (framework, language)
+- Available scripts/commands (dev, build, test)
+
+Also check for existing linter configs (ESLint, Biome, Prettier, tsconfig) — do NOT include rules they already enforce.
+
+### Step 2: Identify important files
+
+Scan for non-obvious architecture-critical files. Look for:
+- Auth config files
+- Server action wrappers, API helpers
+- Database schema files
+- Custom middleware or shared utilities
+- Skip standard framework files (package.json, tsconfig, next.config, etc.)
+
+### Step 3: Generate CLAUDE.md
+
+Create the file with ONLY these sections. Each section should be compact — the whole file should be under 50 lines.
+
+```markdown
+# [Project Name]
+[One-line description of what this project is]
+
+## Tech Stack
+- [Only non-obvious technologies — skip deps detectable from config files]
+
+## Commands
+- `[dev command]` - Dev server
+- `[build command]` - Build
+- `[test command]` - Tests
+- [Any non-obvious commands like db:push, seed, etc.]
+
+## Important Files
+- [Only files the agent wouldn't discover naturally]
+
+## Rules
+- [Leave empty with a comment: "Add project-specific rules as you encounter friction"]
+```
+
+### Step 4: Present and write
+
+Show the generated file to the user. Write it to `./CLAUDE.md` after approval.
+
+**Rules:**
+- NEVER include directory structure, code style rules, generic best practices, or marketing text
+- NEVER include anything a linter or TypeScript already enforces
+- Target: 20-50 lines. If it's longer, you're including too much
+- The Rules section starts empty — it gets populated over time as mistakes happen
+</init_workflow>
+
 <optimize_workflow>
 ## `/claude-memory optimize` — Deep CLAUDE.md Cleanup
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiblueprint-cli",
-  "version": "1.4.41",
+  "version": "1.4.43",
   "description": "AIBlueprint CLI for setting up Claude Code configurations",
   "author": "AIBlueprint",
   "license": "MIT",