wogiflow 1.0.21 → 1.0.23

package/.claude/commands/wogi-epics.md

@@ -0,0 +1,145 @@
+Manage epics (large initiatives) with hierarchical progress tracking.
+
+## Overview
+
+Epics are large work items (L0) that contain multiple stories (L1), which in turn contain tasks (L2) and subtasks (L3). Progress automatically propagates up the hierarchy.
+
+```
+Epic (L0) - 15+ files, multi-week effort
+├── Story (L1) - 5-15 files, days of work
+│   ├── Task (L2) - 1-5 files, hours of work
+│   │   └── Subtask (L3) - 1 file, atomic
+│   └── Task (L2)
+└── Story (L1)
+```
+
+## Commands
+
+### List Epics
+```bash
+node scripts/flow-epics.js list
+# or: flow epics list
+```
+
+### Create Epic
+```bash
+node scripts/flow-epics.js create <epicId> --title "Title" --desc "Description"
+```
+
+Example:
+```bash
+node scripts/flow-epics.js create epic-auth --title "Authentication System" --desc "Complete user authentication implementation"
+```
+
+### Add Story to Epic
+```bash
+node scripts/flow-epics.js add-story <epicId> <storyId>
+```
+
+Example:
+```bash
+node scripts/flow-epics.js add-story epic-auth wf-abc123
+```
+
+### View Epic Details
+```bash
+node scripts/flow-epics.js show <epicId>
+```
+
+### View Full Hierarchy Tree
+```bash
+node scripts/flow-epics.js tree <epicId>
+```
+
+Output:
+```
+→ 📦 Authentication System [45%]
+  → 📖 Login Flow [80%]
+    ✓ 📋 Create login form [100%]
+    → 📋 Add validation [50%]
+      ✓ ▪ Email validation [100%]
+      · ▪ Password validation [0%]
+  · 📖 OAuth Integration [0%]
+```
+
+### Update Progress
+```bash
+# Update specific epic
+node scripts/flow-epics.js update <epicId>
+
+# Update all epics
+node scripts/flow-epics.js update
+```
+
+### Remove Story from Epic
+```bash
+node scripts/flow-epics.js remove-story <epicId> <storyId>
+```
+
+### Delete Epic
+```bash
+node scripts/flow-epics.js delete <epicId>
+```
+
+## Progress Calculation
+
+Progress is calculated recursively:
+- **Leaf tasks**: Based on status (completed=100%, inProgress=50%, ready=0%)
+- **Parent tasks**: Average of children's progress
+- **Automatic propagation**: When a task is completed, parent progress updates
+
+## Integration with Stories
+
+When using `/wogi-story`:
+1. Create the story with acceptance criteria
+2. Add it to the appropriate epic:
+   ```bash
+   node scripts/flow-epics.js add-story <epicId> <storyId>
+   ```
+3. Progress will automatically track as you complete tasks
+
+## Workflow Example
+
+```bash
+# 1. Create an epic for a major initiative
+node scripts/flow-epics.js create epic-dashboard --title "Analytics Dashboard"
+
+# 2. Create stories for each component
+/wogi-story "Create data visualization charts"
+/wogi-story "Build filtering system"
+
+# 3. Add stories to epic
+node scripts/flow-epics.js add-story epic-dashboard wf-charts-123
+node scripts/flow-epics.js add-story epic-dashboard wf-filter-456
+
+# 4. Work on tasks (stories auto-decompose into tasks)
+/wogi-start wf-charts-task-001
+
+# 5. Check progress
+node scripts/flow-epics.js tree epic-dashboard
+```
+
+## Status Icons
+
+| Icon | Meaning |
+|------|---------|
+| ✓ | Completed (100%) |
+| → | In Progress (1-99%) |
+| · | Ready/Not Started (0%) |
+| ✗ | Blocked |
+
+## Level Icons
+
+| Icon | Level | Type |
+|------|-------|------|
+| 📦 | L0 | Epic |
+| 📖 | L1 | Story |
+| 📋 | L2 | Task |
+| ▪ | L3 | Subtask |
+
+## Tips
+
+- **Start with epics for major features** - Break down into stories before implementation
+- **Update progress regularly** - Run `flow epics update` to sync status
+- **Use tree view for standup** - Quick visual of project state
+- **Epics don't block work** - You can still use `/wogi-start` without epics

package/.claude/commands/wogi-export.md

@@ -0,0 +1,100 @@
+Export workflow configuration as a shareable profile.
+
+**v2.1**: Enhanced with rules, learnings, and templates export.
+
+## Usage
+
+```bash
+/wogi-export my-team              # Core files only
+/wogi-export my-team --rules      # Include rules and decisions
+/wogi-export my-team --learnings  # Include feedback patterns and skill learnings
+/wogi-export my-team --full       # Include everything
+```
+
+## Options
+
+| Flag | Includes |
+|------|----------|
+| (none) | CLAUDE.md, agents/, config.json |
+| `--rules` | + decisions.md, .claude/rules/ |
+| `--learnings` | + feedback-patterns.md, skill learnings |
+| `--templates` | + project and roadmap templates |
+| `--full` | All of the above |
+| `--include-decisions` | Legacy: just decisions.md |
+| `--include-app-map` | Include app-map.md (usually project-specific) |
+
+## Export Categories
+
+**Core (always included):**
+- CLAUDE.md - Core workflow instructions
+- agents/*.md - Agent personas
+- .workflow/config.json - Configuration
+
+**Rules & Decisions (`--rules`):**
+- .workflow/state/decisions.md - Project rules
+- .claude/rules/*.md - Auto-synced coding rules
+
+**Learnings (`--learnings`):**
+- .workflow/state/feedback-patterns.md - Team learnings
+- .claude/skills/*/knowledge/ - Skill patterns and learnings
+
+**Templates (`--templates`):**
+- templates/project-template.md - Project spec template
+- templates/roadmap-template.md - Roadmap template
+
+## Output
+
+```
+╔══════════════════════════════════════════════════════════╗
+║  Exporting Profile: my-team                               ║
+╚══════════════════════════════════════════════════════════╝
+
+Core Files:
+  ✓ CLAUDE.md
+  ✓ agents/ (11 personas)
+  ✓ config.json
+
+Rules & Decisions:
+  ✓ decisions.md
+  ✓ .claude/rules/ (3 rules)
+
+Learnings:
+  ✓ feedback-patterns.md
+  ✓ skill learnings (2 skills)
+
+╔══════════════════════════════════════════════════════════╗
+║  ✓ Profile exported successfully                          ║
+╚══════════════════════════════════════════════════════════╝
+
+  File: wogi-profiles/my-team.zip
+  Size: 45K
+
+Share this file with team members.
+Import with: ./scripts/flow import-profile my-team.zip
+```
+
+## Import a Profile
+
+After installing WogiFlow, import a team profile:
+
+```bash
+npm install wogiflow
+npx flow import-profile ~/my-team.zip
+```
+
+## CLI
+
+Run the export script directly:
+
+```bash
+./scripts/flow export-profile my-team --full
+```
+
+## What This Enables
+
+Share with your team:
+- Refined agent instructions and personas
+- Coding conventions and decisions
+- Skill-specific patterns and learnings
+- Quality gate configuration
+- Template structures

package/.claude/commands/wogi-feature.md

@@ -0,0 +1,149 @@
+Manage features - coherent product capabilities that group related stories.
+
+## Overview
+
+Features (ft-XXXXXXXX) sit between epics and stories in the work hierarchy. They represent complete product capabilities that can be independently delivered.
+
+```
+Plan (pl-XXXXXXXX) - Strategic initiatives
+└── Epic (ep-XXXXXXXX) - Large initiative, 15+ files
+    └── Feature (ft-XXXXXXXX) - Coherent capability
+        └── Story (wf-XXXXXXXX) - Implementation spec
+            └── Sub-task (wf-XXXXXXXX-NN) - Atomic work
+```
+
+## Commands
+
+### Create Feature
+```bash
+node scripts/flow-feature.js create "<title>"
+
+# With parent epic
+node scripts/flow-feature.js create "<title>" --parent ep-a1b2c3d4
+```
+
+Example:
+```bash
+node scripts/flow-feature.js create "User Authentication Flow"
+```
+
+### List Features
+```bash
+node scripts/flow-feature.js list
+
+# JSON output
+node scripts/flow-feature.js list --json
+```
+
+### Show Feature Details
+```bash
+node scripts/flow-feature.js show <featureId>
+```
+
+### Add Story to Feature
+```bash
+node scripts/flow-feature.js add-story <featureId> <storyId>
+```
+
+Example:
+```bash
+node scripts/flow-feature.js add-story ft-a1b2c3d4 wf-e5f6g7h8
+```
+
+### Remove Story from Feature
+```bash
+node scripts/flow-feature.js remove-story <featureId> <storyId>
+```
+
+### Check Progress
+```bash
+node scripts/flow-feature.js progress <featureId>
+```
+
+### Delete Feature
+```bash
+node scripts/flow-feature.js delete <featureId>
+```
+
+## File Structure
+
+Features are stored as markdown files in `.workflow/features/`:
+
+```markdown
+# Feature: User Authentication Flow
+
+## Description
+Allow users to securely log in with email/password.
+
+## User Value
+**As a** user
+**I want** to log in securely
+**So that** I can access my account
+
+## Stories
+- wf-a1b2c3d4  # Login form implementation
+- wf-e5f6g7h8  # Password reset flow
+
+## Parent
+epic: ep-x9y8z7w6
+
+## Status: inProgress
+## Progress: 50%
+```
+
+## Auto-Completion
+
+When all stories in a feature are completed:
+1. Feature status automatically changes to `completed`
+2. Progress updates to 100%
+3. Feature file is archived to `.workflow/archive/features/YYYY-MM/`
+4. Parent epic progress is recalculated
+
+## Linking to Other Work Items
+
+```bash
+# Link feature to epic
+node scripts/flow-epics.js add-feature <epicId> <featureId>
+
+# Or when creating feature
+node scripts/flow-feature.js create "Title" --parent ep-a1b2c3d4
+```
+
+## Workflow Example
+
+```bash
+# 1. Create an epic for a major initiative
+node scripts/flow-epics.js create ep-auth --title "Authentication System"
+
+# 2. Create features for each capability
+node scripts/flow-feature.js create "Login Flow" --parent ep-auth
+# Creates: ft-a1b2c3d4
+
+# 3. Create stories for the feature
+/wogi-story "Build login form"
+# Creates: wf-e5f6g7h8
+
+# 4. Link story to feature
+node scripts/flow-feature.js add-story ft-a1b2c3d4 wf-e5f6g7h8
+
+# 5. Implement the story
+/wogi-start wf-e5f6g7h8
+
+# 6. Check progress
+node scripts/flow-feature.js progress ft-a1b2c3d4
+```
+
+## Status Icons
+
+| Icon | Status |
+|------|--------|
+| · | Ready (0%) |
+| → | In Progress (1-99%) |
+| ✓ | Completed (100%) |
+
+## Tips
+
+- **Features represent user-facing capabilities** - Not technical components
+- **Keep features small enough to ship independently** - 2-5 stories each
+- **Link features to epics for large initiatives** - Provides visibility
+- **Progress auto-updates** - No need to manually track

package/.claude/commands/wogi-guided-edit.md

@@ -0,0 +1,83 @@
+Guide through multi-file changes step by step.
+
+Usage:
+- `/wogi-guided-edit "rename Button to BaseButton"` - Start guided edit
+- `/wogi-guided-edit --from schema.prisma` - Detect affected files from schema change
+
+## Examples
+
+```
+/wogi-guided-edit "rename UserService to UserManager"
+/wogi-guided-edit "replace console.log with logger.debug"
+/wogi-guided-edit "find deprecated API calls"
+/wogi-guided-edit "update all imports from @old/lib to @new/lib"
+```
+
+## Workflow
+
+1. **Analyze**: Find all files affected by the change
+2. **Plan**: Show list of files with match counts
+3. **Step Through**: For each file:
+   - Show current match locations
+   - Show proposed diff (if replace operation)
+   - User: approve / reject / skip
+4. **Apply**: Make approved changes
+5. **Summary**: Show completion stats
+
+## Commands During Session
+
+Once a session starts, use these commands:
+
+| Command | Action |
+|---------|--------|
+| `next` / `n` | Show next file to review |
+| `approve` / `a` | Approve and apply changes |
+| `reject` / `r` | Reject file, skip changes |
+| `skip` / `s` | Skip for now (review later) |
+| `status` | Show progress |
+| `abort` / `q` | Cancel session |
+
+## Session Persistence
+
+Progress is saved to `.workflow/state/guided-edit-session.json`. You can:
+- Close Claude and resume later
+- Use `status` to see where you left off
+- Use `abort` to cancel and start fresh
+
+## Use Cases
+
+### Large Refactors
+Rename a component across 20+ files with confidence:
+```
+/wogi-guided-edit "rename Button to BaseButton"
+```
+
+### Library Upgrades
+Update imports everywhere:
+```
+/wogi-guided-edit "replace import { X } from 'old-lib' with import { X } from 'new-lib'"
+```
+
+### Code Cleanup
+Find and review deprecated patterns:
+```
+/wogi-guided-edit "find componentWillMount"
+```
+
+### Schema Changes
+After changing an entity, update all related files:
+```
+/wogi-guided-edit "find UserEntity"
+```
+
+## Claude's Role
+
+When running this command, Claude will:
+
+1. Parse the description to understand the operation
+2. Run the script to find affected files
+3. Present each file for your review
+4. Apply changes only when you approve
+5. Track progress and provide summary
+
+The goal is methodical, confident multi-file editing with human oversight.

package/.claude/commands/wogi-health.md

@@ -0,0 +1,43 @@
+Check workflow health and report issues.
+
+Verify:
+1. **Required files exist**:
+   - `.workflow/config.json`
+   - `.workflow/state/ready.json`
+   - `.workflow/state/request-log.md`
+   - `.workflow/state/app-map.md`
+   - `.workflow/state/decisions.md`
+   - `CLAUDE.md`
+
+2. **JSON validity**:
+   - Parse config.json - report if invalid
+   - Parse ready.json - report if invalid
+
+3. **App-map sync**:
+   - Check if components in app-map exist in codebase
+   - Report orphaned entries
+
+4. **Git status**:
+   - Check for uncommitted workflow files
+
+Output:
+```
+🏥 Workflow Health
+
+Files:
+  ✓ config.json
+  ✓ ready.json
+  ✓ request-log.md
+  ✓ app-map.md
+  ✓ decisions.md
+  ✓ CLAUDE.md
+
+Validation:
+  ✓ config.json valid
+  ✓ ready.json valid
+
+Sync:
+  ⚠ 2 components in app-map not found in codebase
+
+Overall: Healthy (1 warning)
+```

package/.claude/commands/wogi-help.md

@@ -0,0 +1,96 @@
+Show all available Wogi Flow commands.
+
+Usage: `/wogi-help`
+
+## Output
+
+```
+🚀 Wogi Flow - Command Reference
+
+═══════════════════════════════════════════════════════════════
+SETUP & ONBOARDING
+═══════════════════════════════════════════════════════════════
+/wogi-onboard            Analyze existing project, set up context
+/wogi-init               Initialize workflow structure
+/wogi-config             Show/modify configuration
+/wogi-skills             Manage skill packages
+/wogi-rules              View/manage coding rules
+
+═══════════════════════════════════════════════════════════════
+TASK MANAGEMENT
+═══════════════════════════════════════════════════════════════
+/wogi-ready              Show tasks by status, recommend next
+/wogi-start [id]         Start task, load context
+/wogi-done [id]          Complete task with quality gates
+/wogi-bulk               Execute multiple tasks in sequence
+/wogi-status             Full project overview
+/wogi-deps [id]          Show task dependency tree
+
+═══════════════════════════════════════════════════════════════
+STORY & FEATURE CREATION
+═══════════════════════════════════════════════════════════════
+/wogi-story [title]      Create detailed story with acceptance criteria
+/wogi-feature [name]     Create new feature with tasks
+/wogi-bug [title]        Create bug report
+
+═══════════════════════════════════════════════════════════════
+WORKFLOW
+═══════════════════════════════════════════════════════════════
+/wogi-health             Check all workflow files
+/wogi-standup            Generate standup summary
+/wogi-session-end        End session properly
+/wogi-compact            Prepare for context compaction
+/wogi-roadmap            Show phase-based roadmap (if enabled)
+
+═══════════════════════════════════════════════════════════════
+COMPONENT MANAGEMENT
+═══════════════════════════════════════════════════════════════
+/wogi-map                Show full component registry
+/wogi-map-add [name]     Add component to registry
+/wogi-map-scan [dir]     Find unmapped components
+/wogi-map-check          Check for drift
+
+═══════════════════════════════════════════════════════════════
+SEARCH & CONTEXT
+═══════════════════════════════════════════════════════════════
+/wogi-search [query]     Search request-log
+/wogi-context [id]       Load all task context
+/wogi-log                Add request-log entry
+
+═══════════════════════════════════════════════════════════════
+DOCUMENTATION
+═══════════════════════════════════════════════════════════════
+/wogi-changelog          Generate changelog
+/wogi-correction [id]    Create detailed correction report
+
+═══════════════════════════════════════════════════════════════
+CONFIGURATION
+═══════════════════════════════════════════════════════════════
+/wogi-config             Show/modify configuration
+/wogi-skills             Manage skill packages
+/wogi-export [name]      Export workflow profile
+/wogi-import [file]      Import team profile
+
+═══════════════════════════════════════════════════════════════
+TESTING (if enabled)
+═══════════════════════════════════════════════════════════════
+/wogi-test-browser [flow]  Execute browser test flow
+/wogi-test-browser all     Run all test flows
+
+═══════════════════════════════════════════════════════════════
+SKILL COMMANDS (when installed)
+═══════════════════════════════════════════════════════════════
+Run /wogi-skills to see commands from installed skills.
+
+Example (NestJS skill):
+  /nestjs-scaffold [name]  Create complete module
+  /nestjs-entity [name]    Create TypeORM entity
+  /nestjs-db migrate       Run migrations
+```
+
+## Quick Tips
+
+• Start your day: `/wogi-ready`
+• End your day: `/wogi-session-end`
+• Check health: `/wogi-health`
+• Get task context: `/wogi-context wf-XXXXXXXX`

package/.claude/commands/wogi-hybrid-edit.md

@@ -0,0 +1,36 @@
+---
+description: Edit the current execution plan before running
+---
+
+# Edit Hybrid Plan
+
+Show me the current plan and what you'd like to change.
+
+## Current Plan
+
+```bash
+if [ -f ".workflow/state/current-plan.json" ]; then
+    jq '.' .workflow/state/current-plan.json
+else
+    echo "No plan currently loaded"
+fi
+```
+
+## Edit Options
+
+Tell me what you'd like to change:
+
+1. **Add a step** - Describe what you want to add
+2. **Remove a step** - Tell me which step number to remove
+3. **Modify a step** - Tell me which step and what to change
+4. **Reorder steps** - Specify the new order
+5. **Change execution mode** - Mark steps as parallel/sequential
+
+## Example Requests
+
+- "Add a step to create unit tests after the service"
+- "Remove step 3, I'll handle that manually"
+- "Change step 2 to use React Hook Form instead"
+- "Make steps 1-3 run in parallel"
+
+What would you like to change?

package/.claude/commands/wogi-hybrid-off.md

@@ -0,0 +1,24 @@
+---
+description: Disable hybrid mode and return to normal operation
+---
+
+# Disable Hybrid Mode
+
+Turning off hybrid mode. I'll go back to executing everything directly.
+
+```bash
+# Update config
+cd "$(pwd)" && cat .workflow/config.json | jq '.hybrid.enabled = false' > /tmp/config.tmp && mv /tmp/config.tmp .workflow/config.json
+
+echo "✅ Hybrid mode disabled"
+```
+
+## What Changes
+
+- I'll write code directly instead of creating plans
+- All execution happens via Claude (no local LLM)
+- No token savings, but simpler workflow
+
+## Re-enabling
+
+Run `/wogi-hybrid` to enable again with your previous settings.