agileflow 2.77.0 → 2.78.0

package/src/core/commands/board.md

@@ -1,7 +1,23 @@
 ---
 description: Display visual kanban board with WIP limits
-argument-hint: (no arguments)
+argument-hint: "[EPIC=<id>] [OWNER=<id>] [FORMAT=ascii|markdown|html] [GROUP_BY=status|owner|epic]"
 model: haiku
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:board - Kanban board visualizer (read-only)"
+    - "MUST read docs/09-agents/status.json (do NOT modify)"
+    - "MUST organize stories by status (ready, in-progress, in-review, done, blocked)"
+    - "MUST show WIP limits (2 stories per agent)"
+    - "MUST highlight blockers and WIP violations"
+    - "MUST provide ASCII art board visualization"
+    - "MUST show statistics (throughput, velocity, completion %)"
+    - "MUST suggest next actions based on board state"
+  state_fields:
+    - epic_filter
+    - owner_filter
+    - format
+    - group_by
 ---
 
 # board
@@ -17,82 +33,133 @@ node .agileflow/scripts/obtain-context.js board
 This gathers git status, stories/epics, session state, and registers for PreCompact.
 
 <!-- COMPACT_SUMMARY_START -->
-## Compact Summary
 
-**Command**: `board`
-**Purpose**: Generate visual kanban board from current story statuses
+## ⚠️ COMPACT SUMMARY - /agileflow:board IS ACTIVE
 
-**Quick Usage**:
+**CRITICAL**: You are the Board Visualizer. This command displays project state (read-only).
+
+---
+
+### 🚨 RULE #1: ALWAYS Read status.json (NEVER Modify)
+
+- Read-only operation (visualization only)
+- NEVER update status.json from this command
+- Extract story data and calculate WIP metrics
+- No file writes, no state changes
+
+### 🚨 RULE #2: ALWAYS Show Four Columns
+
+**Column Layout** (by default):
+1. **READY** (status="ready")
+2. **IN PROGRESS** (status="in-progress")
+3. **IN REVIEW** (status="in-review")
+4. **DONE** (status="done")
+
+Special handling:
+- Separate BLOCKED stories (show with 🔴 red)
+- Show WIP limits per agent (max 2 in-progress + in-review)
+
+### 🚨 RULE #3: ALWAYS Calculate & Show WIP Violations
+
+- Count in-progress + in-review per agent
+- Highlight if >2 stories (WIP limit exceeded)
+- Show with ⚠️ warning icon
+- Suggest unblocking action
+
+### 🚨 RULE #4: ALWAYS Include Statistics
+
+Show these stats:
+- Total stories in each status
+- WIP status per agent
+- Blockers count and reasons
+- Throughput (stories completed this week)
+- Velocity trend (↗ ↘ →)
+
+---
+
+## Key Parameters & Output
+
+**Input Parameters**:
+```
+EPIC=<EP_ID>           # Filter by specific epic (optional)
+OWNER=<agent_id>       # Filter by owner (optional)
+FORMAT=ascii|markdown|html  # Output format (default: ascii)
+GROUP_BY=status|owner|epic  # Grouping method (default: status)
+```
+
+**Output Formats**:
+| Format | Use Case | Visual |
+|--------|----------|--------|
+| ascii | Terminal viewing | Box drawing chars (╔╗╚╝) |
+| markdown | Documentation/wiki | Markdown tables |
+| html | Web export | Full HTML page |
+
+**Data Source**:
+- Read: docs/09-agents/status.json
+- Extract: story status, owner, epic, estimate
+
+---
+
+## Board Visualization Rules
+
+**ASCII Format** (default):
+- Box drawing characters (╔═╗║╚╝├┤┬┴┼)
+- Columns for each status
+- Story cards with ID, title, owner, estimate, epic
+- Color coded via emoji (🟢🟡🔵⚪🔴)
+- Max 80 char width for terminal viewing
+
+**Card Contents**:
 ```
-/agileflow:board
-/agileflow:board EPIC=EP-0010
-/agileflow:board OWNER=AG-UI FORMAT=markdown
-/agileflow:board GROUP_BY=owner
+🟢 US-0042
+Login form
+AG-UI · 1d
+EP-0010
 ```
 
-**What It Does**:
-1. Reads `docs/09-agents/status.json` for story data
-2. Organizes stories by status (or owner/epic if specified)
-3. Calculates WIP limits and identifies violations
-4. Renders visual board with color coding
-5. Shows statistics (throughput, velocity, blockers)
-6. Suggests actions based on board state
-
-**Input Options**:
-- `EPIC=<EP_ID>` - Filter by specific epic
-- `OWNER=<agent_id>` - Filter by owner
-- `FORMAT=ascii|markdown|html` - Output format (default: ascii)
-- `GROUP_BY=status|owner|epic` - Grouping method (default: status)
-
-**Board Layout** (ASCII):
+**WIP Indicator**:
 ```
-╔══════════════════════════════════════════════════════════════╗
-║                   AGILEFLOW KANBAN BOARD                      ║
-║                  Updated: 2025-12-22 14:30                    ║
-╠══════════════════════════════════════════════════════════════╣
-║ 📊 Summary: 15 stories | 3 ready | 4 in-progress | 6 done   ║
-║ ⚠️  WIP Limit: 2/agent (AG-UI: 2/2 ⚠️, AG-API: 1/2 ✓)       ║
-╚══════════════════════════════════════════════════════════════╝
-
-┌──────────────┬──────────────┬──────────────┬──────────────┐
-│ 📋 READY (3) │ 🔄 IN PROG   │ 👀 REVIEW    │ ✅ DONE (6)  │
-│              │ (4) WIP: 4/6 │ (2)          │              │
-├──────────────┼──────────────┼──────────────┼──────────────┤
-│ 🟢 US-0042   │ 🟡 US-0038   │ 🔵 US-0035   │ ⚪ US-0030   │
-│ Login form   │ OAuth flow   │ Pwd reset    │ User reg     │
-│ AG-UI · 1d   │ AG-API · 1.5d│ AG-API · 1d  │ AG-API · 1d  │
-└──────────────┴──────────────┴──────────────┴──────────────┘
+🔄 IN PROGRESS (4)
+WIP: 4/6 ⚠️ (at limit)
 ```
 
-**Color Coding**:
-- 🟢 Green: High priority / ready to start
-- 🟡 Yellow: In progress / medium priority
-- 🔵 Blue: In review / low priority
-- ⚪ White: Done
-- 🔴 Red: Blocked
-- ⚠️ Warning: WIP limit exceeded
+**Blocked Indicator**:
+```
+🔴 BLOCKED (1)
+US-0041: Waiting on API keys
+```
+
+---
 
-**Statistics Provided**:
-- Throughput (stories completed per week)
-- Velocity (points per week)
-- Status distribution
-- Owner workload
-- Blockers and warnings
+## Action Suggestions
 
-**Action Suggestions**:
+After displaying board, suggest actions:
 - "AG-UI at WIP limit. Complete US-0038 before starting new work."
-- "US-0041 blocked. Unblock by reviewing US-0035?"
+- "US-0041 blocked >3 days. Escalate for API access?"
 - "3 stories ready. Which should we prioritize?"
+- "AG-DEVOPS has no work. Assign unblocking tasks?"
 
-**Best Practices**:
-- Review board daily to identify bottlenecks
-- Keep WIP limits respected (default: 2/agent)
-- Export board snapshots to track velocity over time
-- Use GROUP_BY=owner to balance workload
+---
+
+## Anti-Patterns & Correct Usage
+
+❌ **DON'T**:
+- Modify status.json (read-only command)
+- Hide blockers or WIP violations
+- Skip statistics and trend data
+- Make board too wide (>80 chars)
+
+✅ **DO**:
+- Read status.json (no updates)
+- Highlight WIP violations clearly
+- Include statistics and trends
+- Suggest next actions based on board state
+
+---
 
-**Tool Usage Examples**:
+## Confirmation & Follow-up
 
-AskUserQuestion (for actions after displaying board):
+After displaying board:
 ```xml
 <invoke name="AskUserQuestion">
 <parameter name="questions">[{
@@ -100,15 +167,26 @@ AskUserQuestion (for actions after displaying board):
   "header": "Board Actions",
   "multiSelect": false,
   "options": [
-    {"label": "Update a story status", "description": "Change story status on board"},
-    {"label": "Export board", "description": "Save board snapshot to file"},
-    {"label": "View story details", "description": "See full story information"},
-    {"label": "Filter board", "description": "Filter by epic/owner"}
+    {"label": "Update story status", "description": "Change status on board"},
+    {"label": "View blockers", "description": "See blocker details"},
+    {"label": "Filter board", "description": "Filter by epic/owner"},
+    {"label": "Export snapshot", "description": "Save board to file"}
   ]
 }]</parameter>
 </invoke>
 ```
 
+---
+
+## REMEMBER AFTER COMPACTION
+
+- Command is read-only (displays status.json, doesn't modify)
+- Shows kanban board with 4 columns (ready, in-progress, in-review, done)
+- Highlights blockers and WIP violations
+- Includes statistics (throughput, velocity, trends)
+- Suggests actionable next steps
+- No file writes, no state changes
+
 <!-- COMPACT_SUMMARY_END -->
 
 ## Prompt

package/src/core/commands/changelog.md

@@ -1,5 +1,20 @@
 ---
 description: Auto-generate changelog from commit history
+compact_context:
+  priority: high
+  preserve_rules:
+    - "Auto-detect version from latest git tag if VERSION not provided"
+    - "Parse conventional commits (feat:→Added, fix:→Fixed, perf:→Changed, security:→Security)"
+    - "Detect BREAKING CHANGES (! suffix or BREAKING CHANGE: footer)"
+    - "Follow Keep a Changelog format strictly (standard markdown structure)"
+    - "Include PR/issue numbers for traceability (#123)"
+    - "ALWAYS show diff-first preview before updating CHANGELOG.md"
+    - "Suggest semantic version bump based on changes (major/minor/patch)"
+    - "Never remove old changelog entries"
+  state_fields:
+    - next_version
+    - version_suggestion_accepted
+    - changelog_updated
 ---
 
 # generate-changelog

package/src/core/commands/ci.md

@@ -1,6 +1,18 @@
 ---
 description: Bootstrap CI/CD workflow with testing and quality checks
 argument-hint: (no arguments)
+compact_context:
+  priority: high
+  preserve_rules:
+    - "CI setup creates .github/workflows/ci.yml with lint/typecheck/test jobs"
+    - "MUST parse OWNERS input (comma-separated GitHub handles or team names)"
+    - "MUST create CODEOWNERS file with owner mappings for src/ and docs/03-decisions/"
+    - "ALWAYS show diff-first preview before creating files (YES/NO confirmation required)"
+    - "Concurrency control and minimal permissions are required for security"
+  state_fields:
+    - owners_input
+    - workflow_created
+    - codeowners_created
 ---
 
 # ci-setup
@@ -15,92 +27,190 @@ If the user confirms they want the full details, continue. Otherwise, stop here.
 Bootstrap minimal CI workflow and CODEOWNERS.
 
 <!-- COMPACT_SUMMARY_START -->
-## Compact Summary
 
-**Purpose**: Bootstrap minimal CI/CD workflow with testing and quality checks
+## ⚠️ COMPACT SUMMARY - /agileflow:ci-setup IS ACTIVE
 
-**Quick Usage**:
-```
-/agileflow:ci-setup OWNERS=@username,@team
-```
-
-**What It Does**:
-1. Creates `.github/workflows/ci.yml` with lint/typecheck/test jobs
-2. Creates `CODEOWNERS` file with owner mappings
-3. Shows preview and waits for YES/NO confirmation
-4. Provides notes for enabling required checks in GitHub
-
-**Required Inputs**:
-- `OWNERS=<@handles>` - GitHub usernames or team handles (comma-separated)
-
-**Optional Inputs**:
-- None
+**CRITICAL**: You are bootstrapping CI/CD workflow. All steps must complete to create production-ready CI.
 
-**Output Files**:
-- `.github/workflows/ci.yml` - GitHub Actions workflow
-- `CODEOWNERS` - Code ownership mappings
+**ROLE**: CI Bootstrapper - Create GitHub Actions workflow with quality gates (lint/typecheck/test) and code ownership rules
 
-**CI Jobs Created**:
-- Lint job (generic placeholder for ESLint, Prettier, etc.)
-- Typecheck job (TypeScript, Flow, mypy, etc.)
-- Test job (Jest, pytest, cargo test, etc.)
-- Minimal permissions (contents: read)
-- Concurrency control (cancel in-progress runs)
-
-**CODEOWNERS Mappings**:
-```
-/src/ @owners
-/docs/03-decisions/ @owners
-```
+---
 
-**Tools Used**:
-- TodoWrite: Track 5-step setup workflow
+### 🚨 RULE #1: ALWAYS USE TodoWrite FOR TRACKING
 
-**TodoWrite Example**:
+Track all 5 steps explicitly:
 ```xml
 <invoke name="TodoWrite">
 <parameter name="content">
-1. Parse input (OWNERS)
-2. Create .github/workflows/ci.yml with lint/typecheck/test jobs
-3. Create CODEOWNERS file with owner mappings
-4. Show preview and wait for YES/NO confirmation
-5. Print notes for enabling required checks
+1. Parse OWNERS input (required, comma-separated)
+2. Generate .github/workflows/ci.yml with 3 jobs
+3. Generate CODEOWNERS file with mappings
+4. Show diff preview (both files side-by-side)
+5. Create files after YES/NO confirmation
 </parameter>
 <parameter name="status">in-progress</parameter>
 </invoke>
 ```
 
-**Workflow**:
-1. Parse OWNERS input
-2. Generate CI workflow with generic job placeholders
-3. Generate CODEOWNERS file
-4. Show preview of both files
-5. Ask: "Create these files? (YES/NO)"
-6. If YES: Write files
-7. Display notes for enabling required checks
-
-**Next Steps**:
-- Customize job commands for your project
-- Enable branch protection in GitHub settings
-- Add required status checks
-- Configure merge queue (optional)
-
-**Example CI Workflow**:
-```yaml
+Mark each step complete as you finish. This ensures nothing is forgotten.
+
+---
+
+### 🚨 RULE #2: REQUIRED PARAMETERS
+
+`OWNERS` is required (no default):
+- Format: `@username` or `@org/team-name`
+- Multiple: Comma-separated, no spaces
+- Example: `OWNERS=@alice,@dev-team,@bob`
+
+If missing:
+```
+❌ Missing OWNERS parameter
+
+Usage: /agileflow:ci-setup OWNERS=@username,@team
+
+Examples:
+  /agileflow:ci-setup OWNERS=@alice
+  /agileflow:ci-setup OWNERS=@alice,@bob,@dev-team
+```
+
+---
+
+### 🚨 RULE #3: DIFF-FIRST PATTERN
+
+ALWAYS show preview of BOTH files before creating:
+
+```
+Preview of files to create:
+
+========== .github/workflows/ci.yml ==========
 name: CI
 on: [push, pull_request]
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - run: npm run lint
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - run: npm test
+... [full YAML preview]
+
+========== CODEOWNERS ==========
+/src/ @alice @dev-team
+/docs/03-decisions/ @alice @dev-team
+```
+
+Then ask: "Create these files? (YES/NO)"
+
+---
+
+### 🚨 RULE #4: JOBS REQUIRED
+
+Always generate these 3 jobs (generic placeholders OK):
+1. **lint**: `npm run lint` (or project equivalent)
+2. **typecheck**: `npm run typecheck` (or project equivalent)
+3. **test**: `npm test` (or project equivalent)
+
+Each job:
+- `runs-on: ubuntu-latest`
+- `permissions: { contents: read }` (minimal security)
+- `concurrency: { group: ... cancel-in-progress: true }` (cost control)
+
+---
+
+### 🚨 RULE #5: CODEOWNERS MAPPINGS
+
+Required mappings:
+```
+/src/ @owners  # All source code
+/docs/03-decisions/ @owners  # ADRs require owner review
+```
+
+Both paths MUST include the parsed OWNERS.
+
+---
+
+### ANTI-PATTERNS (DON'T DO THESE)
+
+❌ Skip diff preview - go directly to file creation
+❌ Hardcode owners instead of parsing input
+❌ Create workflow without concurrency control
+❌ Forget to validate OWNERS parameter format
+❌ Create CODEOWNERS without /src/ and /docs/03-decisions/ mappings
+❌ Use overly permissive permissions (contents: write)
+
+### DO THESE INSTEAD
+
+✅ ALWAYS show diff preview first
+✅ Parse OWNERS parameter, validate format
+✅ Include concurrency with cancel-in-progress
+✅ Use minimal permissions (contents: read)
+✅ Include both required path mappings
+✅ Track with TodoWrite for safety
+
+---
+
+### WORKFLOW PHASES
+
+**Phase 1: Validate Input (Step 1)**
+- Parse OWNERS parameter
+- Validate format (looks like @username or @org/team)
+- If invalid: show error and ask for correction
+
+**Phase 2: Generate Files (Steps 2-3)**
+- Create workflow YAML with 3 jobs
+- Create CODEOWNERS with owner mappings
+
+**Phase 3: Preview & Confirm (Step 4)**
+- Display both files in unified diff
+- Ask: "Create these files? (YES/NO)"
+
+**Phase 4: Complete (Step 5)**
+- Write .github/workflows/ci.yml
+- Write CODEOWNERS
+- Display next steps note
+
+---
+
+### NEXT STEPS TO DISPLAY
+
+```
+✅ CI setup complete!
+
+Next steps:
+1. Customize job commands for your project:
+   - Update lint command (currently: npm run lint)
+   - Update typecheck command
+   - Update test command
+
+2. Enable branch protection in GitHub:
+   - Settings → Branches → Branch protection rules
+   - Require "ci" status check
+   - Require branches to be up-to-date
+
+3. Optional: Configure merge queue
+   - Settings → Branches → Branch protection
+   - Enable merge queue for faster merges
+
+4. Optional: Add required checks
+   - Each job can be marked as required
 ```
+
+---
+
+### KEY FILES TO REMEMBER
+
+| File | Purpose |
+|------|---------|
+| `.github/workflows/ci.yml` | GitHub Actions workflow with 3 jobs |
+| `CODEOWNERS` | Code ownership rules for PR reviews |
+| Parsed `OWNERS` | Critical - determines who gets PRs routed |
+
+---
+
+### REMEMBER AFTER COMPACTION
+
+- `/agileflow:ci-setup` IS ACTIVE - create CI workflow
+- OWNERS parameter is required (validate format)
+- ALWAYS show diff-first before creating files
+- Include lint, typecheck, test jobs
+- Map both /src/ and /docs/03-decisions/ in CODEOWNERS
+- Use TodoWrite to track 5 steps
+- Display next steps for GitHub configuration
+
 <!-- COMPACT_SUMMARY_END -->
 
 ## Prompt

package/src/core/commands/compress.md

@@ -1,6 +1,24 @@
 ---
 description: Compress status.json by removing verbose fields and keeping only tracking metadata
 argument-hint: (no arguments)
+compact_context:
+  priority: high
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:compress - Status.json compression utility"
+    - "CRITICAL: Operates on docs/09-agents/status.json ONLY"
+    - "CRITICAL: Creates backup (status.json.backup) BEFORE writing"
+    - "MUST remove verbose fields: description, AC, architectureContext, technicalNotes, testingStrategy, devAgentRecord"
+    - "MUST keep only tracking: story_id, epic, title, owner, status, estimate, timestamps, dependencies, branch, summary"
+    - "MUST validate JSON before/after compression"
+    - "MUST calculate and show token estimate (target: <25000 tokens)"
+    - "MUST show before/after stats and savings percentage"
+    - "Combine with archival for best results (archive old completed stories first, then compress)"
+  state_fields:
+    - file_path
+    - before_size
+    - after_size
+    - savings_percentage
+    - token_estimate
 ---
 
 # compress

package/src/core/commands/configure.md

@@ -1,6 +1,22 @@
 ---
 description: Configure advanced AgileFlow features (git, hooks, archival, CI, status line)
 argument-hint: [--profile=full|basic|minimal|none] [--enable/--disable=features] [--migrate] [--upgrade] [--repair] [--version] [--list-scripts]
+compact_context:
+  priority: critical
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:configure - Configuration manager for AgileFlow features"
+    - "CRITICAL: ALWAYS run --detect FIRST to check status before anything else"
+    - "CRITICAL: If ⚠️ INVALID FORMAT shown → offer --migrate BEFORE other options"
+    - "CRITICAL: If 🔄 OUTDATED shown → offer --upgrade to re-deploy latest scripts"
+    - "MUST backup created on migrate: .claude/settings.json.backup"
+    - "MUST show RED RESTART banner after ANY changes (quit, wait 5s, restart)"
+    - "Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, autoupdate"
+    - "Stop hooks (ralphloop, selfimprove) run when Claude completes or pauses"
+  state_fields:
+    - detection_status
+    - has_format_issues
+    - has_outdated_scripts
+    - enabled_features
 ---
 
 <!-- COMPACT_SUMMARY_START -->