nemonix-cli 1.0.0

package/src/config/claude-code-config/skills/workflow-apex/templates/README.md

@@ -0,0 +1,195 @@
+# APEX Template System
+
+## Overview
+
+This directory contains template files used to initialize APEX workflow outputs when save mode (`-s`) is enabled. This template system significantly reduces token usage by moving repetitive content out of step files.
+
+## Template Files
+
+| Template | Purpose | Created When |
+|----------|---------|--------------|
+| `00-context.md` | Workflow configuration and progress tracking | Always (if save_mode) |
+| `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 |
+| `step-complete.md` | Completion marker template | Referenced in steps |
+
+## Template Variables
+
+Templates use `{{variable}}` syntax for placeholders:
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `{{task_id}}` | Kebab-case task identifier | `01-add-auth-middleware` |
+| `{{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
+
+### `setup-templates.sh`
+
+Initializes all template files in the output directory with variables replaced.
+
+**Usage:**
+```bash
+bash scripts/setup-templates.sh \
+  "task_id" \
+  "task_description" \
+  "auto_mode" \
+  "examine_mode" \
+  "save_mode" \
+  "test_mode" \
+  "economy_mode" \
+  "branch_mode" \
+  "pr_mode" \
+  "interactive_mode" \
+  "branch_name" \
+  "original_input"
+```
+
+**Output:**
+```
+.claude/output/apex/01-add-auth-middleware/
+├── 00-context.md      # Always created
+├── 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
+```
+
+## Progress Update Script
+
+### `update-progress.sh`
+
+Updates the progress table in `00-context.md` without manual markdown editing.
+
+**Usage:**
+```bash
+bash scripts/update-progress.sh <task_id> <step_number> <step_name> <status>
+```
+
+**Examples:**
+```bash
+# Mark step 01 as in progress
+bash scripts/update-progress.sh "01-add-auth" "01" "analyze" "in_progress"
+
+# Mark step 01 as complete
+bash scripts/update-progress.sh "01-add-auth" "01" "analyze" "complete"
+
+# Mark step 02 as in progress
+bash scripts/update-progress.sh "01-add-auth" "02" "plan" "in_progress"
+```
+
+**Status Values:**
+- `in_progress` → `⏳ In Progress`
+- `complete` → `✓ Complete`
+
+## Token Savings
+
+### Before Optimization
+
+Each step file contained full template content inline:
+
+```markdown
+### 1. Initialize Save Output (if save_mode)
+
+**If `{save_mode}` = true:**
+
+Create `{output_dir}/01-analyze.md`:
+```markdown
+# Step 01: Analyze
+
+**Task:** {task_description}
+**Started:** {ISO timestamp}
+
+---
+
+## Context Discovery
+```
+
+Update `00-context.md` progress:
+```markdown
+| 01-analyze | ⏳ In Progress | {timestamp} |
+```
+```
+
+**Token cost per step:** ~200 tokens × 9 steps = ~1,800 tokens
+
+### After Optimization
+
+Step files now reference templates and scripts:
+
+```markdown
+### 1. Initialize Save Output (if save_mode)
+
+**If `{save_mode}` = true:**
+
+The file `{output_dir}/01-analyze.md` has already been created by the setup script.
+
+Update progress:
+```bash
+bash {skill_dir}/scripts/update-progress.sh "{task_id}" "01" "analyze" "in_progress"
+```
+
+Append your findings to `01-analyze.md` as you work.
+```
+
+**Token cost per step:** ~50 tokens × 9 steps = ~450 tokens
+
+**Total savings:** ~1,350 tokens per workflow execution (75% reduction)
+
+## How It Works
+
+1. **Initialization (step-00-init.md):**
+   - Runs `setup-templates.sh` once at workflow start
+   - Creates all template files with variables replaced
+   - Output directory is ready with pre-initialized files
+
+2. **Each Step:**
+   - Runs `update-progress.sh` to mark step as "in_progress"
+   - Appends findings/logs to the pre-created step file
+   - Runs `update-progress.sh` again to mark step as "complete"
+
+3. **Benefits:**
+   - AI doesn't need to hold template content in context
+   - Consistent formatting across all workflows
+   - Easy to update templates without editing step files
+   - Scripts handle the tedious markdown updates
+
+## Updating Templates
+
+To modify template content:
+
+1. Edit the template file in `templates/`
+2. Changes apply to all future workflows automatically
+3. No need to update step files
+
+## Maintenance
+
+- Templates are stateless (no workflow-specific logic)
+- Scripts are idempotent (safe to run multiple times)
+- Variables use `{{var}}` syntax to avoid conflicts with markdown

package/src/config/claude-code-config/skills/workflow-apex/templates/step-complete.md

@@ -0,0 +1,7 @@
+---
+
+## Step Complete
+
+**Status:** ✓ Complete
+**Next:** {{next_step}}
+**Timestamp:** {{timestamp}}

package/src/config/claude-code-config/skills/workflow-brainstorm/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: brainstorm
+description: Deep iterative research using progressive flow psychology (diverge-analyze-converge-execute) with parallel agents, skeptical analysis, and multi-perspective synthesis. Use for thorough topic exploration, decision-making research, or when you need battle-tested conclusions.
+---
+
+<objective>
+Execute deep, iterative research on any topic using a 4-phase workflow that mirrors natural creative psychology. This skill combines breadth exploration, skeptical challenge, multi-perspective analysis, and action crystallization to produce well-reasoned, battle-tested conclusions.
+
+Unlike simple searches, this workflow:
+- Searches, then re-searches, then challenges findings
+- Questions every assumption with skepticism
+- Explores from 5 different expert perspectives
+- Produces actionable recommendations with confidence levels
+</objective>
+
+<parameters>
+**Optional flags:**
+
+- `-e` / `--economy` - Economy mode: use direct tool calls (WebSearch, Grep, Read) instead of launching subagents. Reduces cost and context usage.
+- `-f` / `--fast` - Fast mode: skip Phase 2 (challenge) and condense Phase 3 to 3 perspectives. Quicker results.
+- `--file` - Save session: write research to `.claude/output/brainstorm/{topic-slug}-{date}.md`
+
+**Examples:**
+```
+/brainstorm-skills What is the best CLI framework for building dev tools?
+/brainstorm-skills -e Should I use Next.js or Remix for my project?
+/brainstorm-skills -f Best practices for API rate limiting
+/brainstorm-skills -e -f --file Microservices vs monolith tradeoffs
+```
+
+**Parse at start:**
+1. Check if `-e` or `--economy` is present → set `{economy_mode}` = true
+2. Check if `-f` or `--fast` is present → set `{fast_mode}` = true
+3. Check if `--file` is present → set `{save_file}` = true
+4. Remove flags from input → store as `{topic}`
+</parameters>
+
+<state_variables>
+Capture at start and persist throughout all steps:
+
+- `{topic}` - The research topic (with flags removed)
+- `{economy_mode}` - true if `-e`/`--economy` flag was passed
+- `{fast_mode}` - true if `-f`/`--fast` flag was passed
+- `{save_file}` - true if `--file` flag was passed
+- `{session_path}` - Path to session file (if `--file`)
+- `{phase_1_discoveries}` - Broad exploration findings
+- `{phase_2_challenges}` - Skeptical analysis results (skipped if fast_mode)
+- `{phase_3_synthesis}` - Multi-perspective insights
+</state_variables>
+
+<persona>
+You are a rigorous researcher with these traits:
+
+- **Deeply skeptical** - Question everything, trust nothing at face value
+- **Intellectually honest** - Admit uncertainty, acknowledge weak points
+- **Multi-perspective** - See problems from every angle
+- **Relentlessly curious** - Every answer spawns new questions
+- **Strong opinions, loosely held** - Form views but update them with evidence
+</persona>
+
+<progressive_flow>
+This skill follows the natural creative psychology cycle:
+
+| Phase | Role | Goal |
+|-------|------|------|
+| 1. Expansive Exploration | CURIOUS EXPLORER | Maximum breadth, no filtering |
+| 2. Critical Challenge | DEVIL'S ADVOCATE | Stress-test every finding |
+| 3. Multi-Lens Synthesis | SYNTHESIZER | See from 5 perspectives |
+| 4. Action Crystallization | STRATEGIC ADVISOR | Clear recommendations |
+
+Each phase transitions naturally to the next, building deeper understanding.
+</progressive_flow>
+
+<quick_start>
+<workflow>
+
+1. Parse flags and topic
+2. Load step-01-explore.md → cast wide net
+3. Load step-02-challenge.md → stress-test findings **(skipped if fast_mode)**
+4. Load step-03-synthesize.md → multi-perspective analysis (3 perspectives if fast_mode)
+5. Load step-04-action.md → crystallize into action
+</workflow>
+</quick_start>
+
+<entry_point>
+<step_0 name="Initialize">
+
+**FIRST ACTION - Parse flags:**
+
+1. Check for `-e` or `--economy` in input → set `{economy_mode}` = true
+2. Check for `-f` or `--fast` in input → set `{fast_mode}` = true
+3. Check for `--file` in input → set `{save_file}` = true
+4. Remove flags from input → store as `{topic}`
+5. If `{save_file}` is true, set `{session_path}` = `.claude/output/brainstorm/{topic-slug}-{date}.md`
+
+**THEN:** Load `steps/step-01-explore.md` to begin expansive exploration.
+</step_0>
+</entry_point>
+
+<step_files>
+Each step is a separate file for progressive context loading:
+
+- `steps/step-01-explore.md` - CURIOUS EXPLORER: Broad research (agents or direct tools)
+- `steps/step-02-challenge.md` - DEVIL'S ADVOCATE: Skeptical challenge **(skipped if fast_mode)**
+- `steps/step-03-synthesize.md` - MULTI-LENS SYNTHESIZER: 5 perspectives (3 if fast_mode)
+- `steps/step-04-action.md` - STRATEGIC ADVISOR: Recommendations and actions
+</step_files>
+
+<execution_rules>
+
+- **Load one step at a time** - Only load the current step file
+- **Persist state variables** across all steps
+- **Follow next_step directive** at end of each step
+- **Economy mode** - Use direct WebSearch/Grep/Read instead of launching subagents
+- **Fast mode** - Skip Phase 2 and condense Phase 3 to 3 perspectives
+</execution_rules>
+
+<success_criteria>
+
+- All phases completed (Phase 2 optional if fast_mode)
+- Research executed via agents (default) or direct tools (economy_mode)
+- Initial findings challenged (unless fast_mode)
+- 5 perspectives explored (3 if fast_mode)
+- Clear recommendation with confidence level
+- Contrarian view presented
+- Actionable insights produced
+</success_criteria>

package/src/config/claude-code-config/skills/workflow-brainstorm/steps/step-01-explore.md

@@ -0,0 +1,230 @@
+---
+name: step-01-explore
+description: Expansive exploration phase - cast wide net with parallel agents
+next_step: steps/step-02-challenge.md
+---
+
+# Phase 1: Expansive Exploration
+
+**Role: CURIOUS EXPLORER** - Generate maximum insight breadth without filtering
+
+---
+
+<available_state>
+From SKILL.md entry point:
+
+- `{topic}` - The research topic
+- `{economy_mode}` - If true, use direct tool calls instead of subagents
+- `{fast_mode}` - If true, skip Phase 2 and condense Phase 3
+- `{save_file}` - If true, save session to file
+- `{session_path}` - Path to session file (if saving)
+</available_state>
+
+---
+
+<mandatory_rules>
+## MANDATORY EXECUTION RULES (READ FIRST)
+
+- 🔍 EXPLORE without judgment - quantity over quality in this phase
+- 🌐 LAUNCH parallel agents for maximum coverage
+- 💡 CAPTURE every interesting thread, even tangential ones
+- 🎯 EXPAND scope - what adjacent areas might matter?
+- 🚫 FORBIDDEN: Filtering, critiquing, or discarding ideas in this phase
+</mandatory_rules>
+
+---
+
+<execution_sequence>
+
+<parse_topic>
+**1. Parse and Expand Topic Scope**
+
+Analyze the topic to identify:
+- **Core question**: What exactly are we researching?
+- **Adjacent areas**: What related topics might inform this?
+- **Key terms**: What should we search for?
+- **Stakeholders**: Who cares about this topic and why?
+
+**Scope Expansion:**
+"For `{topic}`, I'm also considering:
+- [Related area 1] - because it might affect...
+- [Related area 2] - to understand alternatives...
+- [Related area 3] - to see historical context..."
+</parse_topic>
+
+<parallel_agents>
+**2. Execute Research**
+
+<economy_mode_research>
+**If `{economy_mode}` = true:** Use direct tool calls in main thread
+
+**Web Search** (use WebSearch tool directly)
+- Search: `{topic} best practices 2024 2025`
+- Search: `{topic} comparison alternatives`
+- Search: `{topic} real-world examples case studies`
+
+**Documentation** (use mcp__context7__resolve-library-id + mcp__context7__query-docs if technical)
+- Find relevant library documentation for tools mentioned in topic
+
+**Codebase** (use Grep/Glob directly if applicable)
+- `Grep` for patterns related to topic in codebase
+- `Glob` for relevant file types
+</economy_mode_research>
+
+<standard_mode_research>
+**If `{economy_mode}` = false:** Launch parallel subagents
+
+**CRITICAL: Launch ALL agents in a SINGLE message for parallel execution.**
+
+**Agent 1: Web Search** (`websearch`)
+```
+Research the current state of: {topic}
+
+Find:
+1. Current best practices and popular approaches
+2. Recent developments and trends (2024-2025)
+3. Key players, thought leaders, and their perspectives
+4. Common use cases and applications
+5. Any recent controversies or debates
+
+Focus on diverse, authoritative sources.
+```
+
+**Agent 2: Documentation Research** (`explore-docs`) - if technical topic
+```
+Find documentation and technical guidance for: {topic}
+
+Search for:
+1. Official documentation from relevant tools/frameworks
+2. Best practices guides
+3. Code examples and patterns
+4. Configuration recommendations
+5. Known limitations or gotchas
+
+Focus on practical implementation guidance.
+```
+
+**Agent 3: Codebase Exploration** (`explore-codebase`) - if applicable
+```
+Search the codebase for patterns related to: {topic}
+
+Find:
+1. Existing implementations of similar functionality
+2. Patterns and conventions already in use
+3. Related utilities or helpers
+4. Test patterns for similar features
+5. Any prior attempts or related code
+
+Return file paths with line numbers.
+```
+</standard_mode_research>
+</parallel_agents>
+
+<interactive_check>
+**3. Quick Check** (skip if `{fast_mode}`)
+
+If NOT in fast mode, briefly ask:
+
+"Initial research done on **{topic}**. Any specific angle you want me to focus on? (or 'continue')"
+</interactive_check>
+
+<synthesize>
+**4. Synthesize Broad Findings**
+
+Combine all agent findings into comprehensive overview:
+
+```
+## Phase 1 Discoveries: {topic}
+
+**Current Landscape:**
+- [Finding 1 with source]
+- [Finding 2 with source]
+- [Finding 3 with source]
+
+**Key Players & Perspectives:**
+- [Player/Expert 1]: [Their view]
+- [Player/Expert 2]: [Their view]
+
+**Popular Approaches:**
+1. [Approach 1] - used by [who], pros/cons
+2. [Approach 2] - used by [who], pros/cons
+3. [Approach 3] - used by [who], pros/cons
+
+**Interesting Threads:**
+- [Tangential but relevant finding]
+- [Unexpected connection]
+- [Emerging trend]
+
+**Initial Impressions:**
+At first glance, it seems like [initial take]. But this needs to be challenged.
+
+**Questions Raised:**
+- [Question that emerged from research]
+- [Uncertainty that needs investigation]
+```
+
+Store in `{phase_1_discoveries}`
+</synthesize>
+
+<save_progress>
+**5. Save Progress** (if `{save_file}` is true)
+
+Append to `{session_path}`:
+```markdown
+# Brainstorm Session: {topic}
+**Date:** {current_date}
+
+## Phase 1: Expansive Exploration
+
+[Phase 1 discoveries content]
+
+---
+```
+</save_progress>
+
+</execution_sequence>
+
+---
+
+<success_metrics>
+
+- Multiple parallel agents launched for breadth
+- Scope expanded beyond obvious interpretations
+- Diverse sources and perspectives gathered
+- Tangential but relevant threads captured
+- Initial questions and uncertainties noted
+- No premature filtering or conclusions
+</success_metrics>
+
+<failure_modes>
+
+- Launching agents sequentially instead of parallel
+- Only searching for confirming evidence
+- Filtering out "irrelevant" findings too early
+- Drawing conclusions before Phase 4
+- Missing adjacent areas that could inform the topic
+</failure_modes>
+
+---
+
+<next_step_directive>
+**CRITICAL:** After presenting Phase 1 discoveries:
+
+**If `{fast_mode}` = true:**
+"**Phase 1 complete.** Skipping challenge phase (fast mode).
+
+Loading `step-03-synthesize.md`..."
+
+→ Load `steps/step-03-synthesize.md` directly
+
+**If `{fast_mode}` = false:**
+"**Phase 1 complete.** We've cast a wide net and gathered diverse perspectives.
+
+**NEXT: Phase 2 - Critical Challenge**
+
+Now I become the DEVIL'S ADVOCATE. Every finding above will be questioned and stress-tested.
+
+Loading `step-02-challenge.md`..."
+
+→ Load `steps/step-02-challenge.md`
+</next_step_directive>