@nextsparkjs/ai-workflow 0.1.0-beta.86

package/claude/commands/session/resume.md

@@ -0,0 +1,192 @@
+# /session:resume
+
+Resume an existing session by recovering all context.
+
+---
+
+## Syntax
+
+```
+/session:resume [session-path]
+```
+
+---
+
+## Behavior
+
+### Without path (wizard)
+
+```
+/session:resume
+```
+
+Shows list of active sessions to select from.
+
+### With path
+
+```
+/session:resume stories/2026-01-11-new-entity
+/session:resume 2026-01-11-new-entity
+```
+
+Resumes the specified session directly.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:resume                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. SESSION SELECTION                                           │
+│     │                                                           │
+│     ├─► With path: Use that session                             │
+│     │                                                           │
+│     └─► Without path: Show wizard                               │
+│         ┌─────────────────────────────────────┐                 │
+│         │ Active sessions:                    │                 │
+│         │                                     │                 │
+│         │ STORIES:                            │                 │
+│         │ [1] 2026-01-11-new-entity (iter-02) │                 │
+│         │ [2] 2026-01-08-refactor-auth        │                 │
+│         │                                     │                 │
+│         │ TASKS:                              │                 │
+│         │ [3] 2026-01-10-improve-search       │                 │
+│         │                                     │                 │
+│         │ Which one to resume? [1-3]          │                 │
+│         └─────────────────────────────────────┘                 │
+│     ↓                                                           │
+│  2. CONTEXT LOADING                                             │
+│     │                                                           │
+│     │  For Stories:                                             │
+│     │  [✓] context.md                                           │
+│     │  [✓] requirements.md                                      │
+│     │  [✓] plan.md                                              │
+│     │  [✓] scope.json                                           │
+│     │  [✓] pendings.md                                          │
+│     │  [✓] iterations/*/closed.json                             │
+│     │  [✓] current/progress.md                                  │
+│     │                                                           │
+│     │  For Tasks:                                               │
+│     │  [✓] requirements.md                                      │
+│     │  [✓] progress.md                                          │
+│     ↓                                                           │
+│  3. CONTEXT SUMMARY                                             │
+│     ↓                                                           │
+│  4. ASK NEXT STEPS                                              │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+📋 SESSION LOADED
+
+Project: New Entity - Products
+Type: Story (STORY workflow)
+T-Shirt: L
+Iteration: 02-scope-change
+
+─────────────────────────────────────────
+
+📝 Objective:
+Implement Products entity with complete CRUD...
+
+📊 Current state:
+- Phase: EXECUTE (backend-developer completed)
+- Progress: 60%
+- Next: frontend-developer
+
+🔄 Scope change (iteration-02):
+- Added "variants" field to entity
+- Requires updating migrations and API
+
+📌 Global pending items:
+- [ ] Add performance tests
+- [ ] Document API endpoints
+- [ ] Review DB indexes
+
+─────────────────────────────────────────
+
+What would you like to do?
+[1] Continue from where you left off
+[2] View more details
+[3] Create new iteration
+[4] Change phase
+```
+
+---
+
+## File Reading Order
+
+### For Stories
+
+1. `context.md` → Understand the project
+2. `requirements.md` → What needs to be achieved
+3. `plan.md` → How to achieve it
+4. `scope.json` → What files are in scope
+5. `pendings.md` → What was left pending
+6. `iterations/*/closed.json` → Why each iteration was closed
+7. `current/progress.md` → Current phase state
+8. `current/changes.md` → What files were modified
+
+### For Tasks
+
+1. `requirements.md` → What needs to be achieved
+2. `progress.md` → Current state
+
+---
+
+## Iteration Evaluation
+
+For each closed iteration:
+
+```json
+{
+  "iteration": "01-initial",
+  "status": "completed",
+  "closedAt": "2026-01-05T10:30:00Z",
+  "summary": "Initial implementation, pending scope change",
+  "nextIteration": "02-scope-change"
+}
+```
+
+Claude must:
+1. **Read** closing reason
+2. **Extract** learnings (what worked, what didn't)
+3. **Not repeat** mistakes from previous iterations
+4. **Respect** previous decisions
+
+---
+
+## Special Considerations
+
+| Situation | Action |
+|-----------|--------|
+| High business risk | Remind when resuming |
+| Critical pending items | Show highlighted |
+| Previous iteration failed | Explain what went wrong |
+| Long time since last activity | Suggest reviewing code changes |
+
+---
+
+## Example with Alert
+
+```
+⚠️ RISK REMINDER
+
+This session works with: Checkout Flow (critical)
+
+Last activity: 5 days ago
+There have been 12 commits in the repo since then.
+
+Recommendation: Verify there are no conflicts with
+recent changes before continuing.
+
+Continue? [Yes/Review changes first]
+```

package/claude/commands/session/review.md

@@ -0,0 +1,192 @@
+# /session:review
+
+Request or perform code review for the session.
+
+---
+
+## Required Skills
+
+**[MANDATORY]** Reference these skills during review:
+- `.claude/skills/service-layer/SKILL.md` - Validate service patterns
+- `.claude/skills/react-patterns/SKILL.md` - Validate component patterns
+- `.claude/skills/zod-validation/SKILL.md` - Validate schema usage
+- `.claude/skills/tanstack-query/SKILL.md` - Validate data fetching patterns
+
+For security review:
+- `.claude/skills/api-bypass-layers/SKILL.md` - Multi-layer security validation
+- `.claude/skills/better-auth/SKILL.md` - Authentication patterns
+- `.claude/skills/permissions-system/SKILL.md` - Authorization validation
+
+---
+
+## Syntax
+
+```
+/session:review [--self]
+```
+
+---
+
+## Behavior
+
+Initiates code review process for the current session changes.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:review                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Collect changes                                             │
+│     - Read scope.json                                           │
+│     - Get modified files                                        │
+│     ↓                                                           │
+│  2. Analyze changes                                             │
+│     - Code quality                                              │
+│     - Security patterns                                         │
+│     - Performance implications                                  │
+│     - Best practices                                            │
+│     ↓                                                           │
+│  3. Generate review report                                      │
+│     - Issues found                                              │
+│     - Suggestions                                               │
+│     - Approval status                                           │
+│     ↓                                                           │
+│  4. Update session status                                       │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+🔍 CODE REVIEW
+
+Session: stories/2026-01-11-new-products-entity
+Files changed: 12
+Lines added: 450
+Lines removed: 23
+
+─────────────────────────────────────────
+
+📋 REVIEW CATEGORIES
+
+## Security ✓
+No security issues found.
+
+## Performance ⚠
+- ProductsService.ts:45 - Consider caching for
+  frequently accessed products
+- Suggestion: Add index on `categoryId`
+
+## Code Quality ✓
+- Follows existing patterns
+- Proper TypeScript types
+- Good error handling
+
+## Best Practices ⚠
+- products.cy.ts:12 - Missing negative test case
+- ProductForm.tsx:89 - Consider extracting validation
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Critical Issues:  0
+Warnings:         2
+Suggestions:      2
+
+─────────────────────────────────────────
+
+Review Status: APPROVED WITH SUGGESTIONS
+
+Proceed to close session? [Yes/Address suggestions first]
+```
+
+---
+
+## With Critical Issues
+
+```
+❌ CODE REVIEW - CHANGES REQUIRED
+
+─────────────────────────────────────────
+
+## Security ❌
+
+CRITICAL: SQL injection vulnerability
+Location: ProductsService.ts:67
+
+```typescript
+// BAD - Direct string interpolation
+const query = `SELECT * FROM products WHERE name = '${name}'`;
+
+// GOOD - Use parameterized queries
+const query = `SELECT * FROM products WHERE name = $1`;
+```
+
+## Performance ❌
+
+CRITICAL: N+1 query detected
+Location: ProductsList.tsx:34
+- Each product triggers separate category fetch
+- Solution: Use eager loading or batch fetch
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Critical Issues:  2
+Warnings:         1
+Suggestions:      3
+
+─────────────────────────────────────────
+
+Review Status: CHANGES REQUIRED
+
+You must fix critical issues before proceeding.
+Run /session:execute to address the issues.
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--self` | Self-review mode (Claude reviews) |
+| `--detailed` | Show line-by-line analysis |
+| `--security-only` | Focus on security review |
+
+---
+
+## Task Manager Integration
+
+If `taskManager.enabled`:
+
+```
+📋 POSTING REVIEW
+
+ClickUp: #abc123
+
+Posting review comment...
+✓ Review posted
+
+Updating status to "In Review"...
+✓ Status updated
+```
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:validate` | Validate before review |
+| `/session:execute` | Fix review issues |
+| `/session:close` | Close after approval |

package/claude/commands/session/scope-change.md

@@ -0,0 +1,181 @@
+# /session:scope-change
+
+Handle a scope change by creating a new iteration.
+
+---
+
+## Syntax
+
+```
+/session:scope-change <reason> [description]
+```
+
+---
+
+## Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `reason` | `scope-change` \| `blocked` \| `review-feedback` \| `continuation` |
+| `description` | Brief description of the change (optional) |
+
+---
+
+## When to Use
+
+| Situation | Reason |
+|-----------|--------|
+| Scope changed (new ACs, fields, etc.) | `scope-change` |
+| There's a blocker that requires replanning | `blocked` |
+| Code review requires major changes | `review-feedback` |
+| Resuming after a long pause | `continuation` |
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:scope-change                                           │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Verify active session (must be story)                       │
+│     ↓                                                           │
+│  2. Document change                                             │
+│     - What changed?                                             │
+│     - Why?                                                      │
+│     - How does it affect the plan?                              │
+│     ↓                                                           │
+│  3. Execute iteration-init.sh                                   │
+│     - Close current iteration                                   │
+│     - Create new iteration                                      │
+│     - Update symlinks                                           │
+│     ↓                                                           │
+│  4. Create scope-change.md (if reason=scope-change)             │
+│     ↓                                                           │
+│  5. Ask whether to update plan/requirements                     │
+│     ↓                                                           │
+│  6. Update task manager (if enabled)                            │
+│     ↓                                                           │
+│  7. Show next step                                              │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Usage Example
+
+```
+/session:scope-change scope-change "add variants field"
+```
+
+Output:
+
+```
+🔄 SCOPE CHANGE
+
+Session: stories/2026-01-11-new-products-entity
+Current iteration: 01-initial (60% completed)
+
+─────────────────────────────────────────
+
+📝 DOCUMENTING CHANGE
+
+What changed?
+> Need to add "variants" field to products
+
+Why?
+> New client requirement for products with variants
+
+How does it affect the plan?
+> Requires updating migration, API and UI
+
+─────────────────────────────────────────
+
+Closing iteration 01-initial...
+✓ Iteration closed
+
+Creating iteration 02-scope-change-add-variants-field...
+✓ Iteration created
+
+─────────────────────────────────────────
+
+📁 FILES CREATED
+
+iterations/02-scope-change-add-variants-field/
+├── scope-change.md   (change documentation)
+├── progress.md       (new progress)
+└── changes.md        (new changes)
+
+─────────────────────────────────────────
+
+Update requirements.md with new ACs? [Yes/No]
+Update plan.md? [Yes/No]
+```
+
+---
+
+## scope-change.md
+
+File that documents the change:
+
+```markdown
+# Scope Change: 02-scope-change-add-variants-field
+
+**Date:** 2026-01-14 15:30
+**Previous Iteration:** 01-initial
+**Reason:** scope-change
+
+## What Changed
+
+Need to add "variants" field to the products entity.
+
+## Why
+
+New client requirement for products with variants
+(e.g., sizes, colors).
+
+## Impact on Plan
+
+### Affected phases:
+- Phase 5: db-developer → New migration
+- Phase 7: backend-developer → Update API
+- Phase 11: frontend-developer → New UI for variants
+
+### Additional estimate:
+- Original T-Shirt: L
+- Increment: +S
+- New T-Shirt: L (high)
+
+## Updated Acceptance Criteria
+
+- AC5: [NEW] User can create product variants
+- AC6: [NEW] Variants have unique SKU
+```
+
+---
+
+## Task Manager Integration
+
+If `taskManager.enabled`:
+
+```
+📋 UPDATING TASK
+
+ClickUp: #abc123
+
+Posting scope change comment...
+✓ Comment posted
+
+Add new ACs as subtasks? [Yes/No]
+```
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:status` | View status with iterations |
+| `/session:execute` | Continue from new iteration |