agileflow 2.77.0 → 2.79.0

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 -->

package/src/core/commands/context/export.md

@@ -1,6 +1,18 @@
 ---
 description: Export concise context excerpt for web AI tools
 argument-hint: (no arguments)
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:context:export - Read-only export command"
+    - "READ-ONLY: No file writes, no confirmation needed, no state changes"
+    - "OUTPUT LIMIT: ≤300 lines maximum for easy pasting into web AI tools"
+    - "REQUIRED INPUT: docs/context.md must exist (run /agileflow:context:full first if missing)"
+    - "EXTRACT ONLY: overview, focus, tech, decisions, features, next steps (skip progress, notes)"
+    - "NO TodoWrite needed - single-step read-only operation"
+  state_fields:
+    - context_file_exists
+    - output_line_count
 ---
 
 # /agileflow:context:export
@@ -18,11 +30,188 @@ Reads `docs/context.md` and outputs a condensed excerpt (≤300 lines) ready to
 ---
 
 <!-- COMPACT_SUMMARY_START -->
-## Compact Summary
 
-**Command**: `/agileflow:context:export`
-**Purpose**: Output concise context brief for pasting into web AI tools
-**Key Rule**: Read-only, no file writes, ≤300 lines output
+## ⚠️ COMPACT SUMMARY - /agileflow:context:export IS ACTIVE
+
+**CRITICAL**: You are exporting a condensed context brief from `docs/context.md`. Follow these rules EXACTLY.
+
+**PURPOSE**: Extract ≤300 line excerpt ready to paste into ChatGPT, Perplexity, Gemini, or Claude web for immediate context loading.
+
+---
+
+### 🚨 RULE #1: READ-ONLY COMMAND
+
+**This command NEVER writes, modifies, or changes state:**
+- ✓ Read docs/context.md
+- ✓ Extract and format
+- ✓ Output to code block
+- ✗ NO file writes
+- ✗ NO Edit tool calls
+- ✗ NO confirmation needed
+- ✗ NO state changes
+
+**Purpose**: Simple read → extract → display workflow.
+
+---
+
+### 🚨 RULE #2: OUTPUT LIMIT IS STRICT - ≤300 LINES
+
+**Maximum output size is 300 lines.** This is critical for pasting into web AI tools.
+
+**If context.md is longer:**
+1. Extract ONLY these sections (in order):
+   - What We're Building (overview)
+   - Current Focus (active work)
+   - Tech Stack (technologies)
+   - Key Decisions (ADRs list only, not full descriptions)
+   - Feature Map (one-line-per-epic summary)
+   - Next Steps (upcoming work)
+
+2. **SKIP these to save space:**
+   - Recent Progress (too verbose)
+   - Notes section (too long)
+   - Detailed story descriptions
+   - Full ADR content
+
+3. **Count lines as you extract** - use line counter to stay under 300
+
+**Format as:**
+```markdown
+# Project Context Brief
+Last updated: [timestamp from context.md]
+
+## What We're Building
+[Max 5 lines]
+
+## Current Focus
+[Max 5 lines]
+
+## Tech Stack
+[Max 8 lines]
+
+## Key Decisions
+[Max 10 lines - ADR titles only]
+
+## Feature Map
+[Max 15 lines - one per epic]
+
+## Next Steps
+[Max 15 lines - ready stories only]
+```
+
+---
+
+### 🚨 RULE #3: REQUIRED INPUT FILE
+
+**docs/context.md MUST exist before exporting.**
+
+**If missing:**
+```
+Error: docs/context.md not found.
+
+To create it, run: /agileflow:context:full
+
+Then you can export with: /agileflow:context:export
+```
+
+**Do NOT create placeholder or fallback - user must run :full first.**
+
+---
+
+### 🚨 RULE #4: EXTRACTION SEQUENCE
+
+**Extract in this EXACT order (don't rearrange):**
+
+| Step | Section | Source | Max Lines |
+|------|---------|--------|-----------|
+| 1 | Header | "# Project Context Brief" | 1 |
+| 2 | Timestamp | Last updated: [from context.md] | 1 |
+| 3 | What We're Building | From overview section | 5 |
+| 4 | Current Focus | From overview/focus section | 5 |
+| 5 | Tech Stack | From tech section (short list) | 8 |
+| 6 | Key Decisions | From decisions section (titles only) | 10 |
+| 7 | Feature Map | From features section (one per epic) | 15 |
+| 8 | Next Steps | From next section (ready stories) | 15 |
+| 9 | Footer | Paste instructions | 3 |
+| | | **TOTAL** | **≤300** |
+
+---
+
+### 🚨 RULE #5: CONTENT CONDENSING RULES
+
+**When extracting, apply these rules to stay under limit:**
+
+| Element | Full Size | Condensed Size | Rule |
+|---------|-----------|----------------|------|
+| ADRs | Full description | Title + status only | "ADR-001: Feature X (Accepted)" |
+| Stories | Title + description | Title + status | "US-0042 (in-progress)" |
+| Tech | Full list + versions | Framework + key deps only | "Next.js 16, TensorFlow.js, Tailwind" |
+| Epics | Title + stories list | Title + story count + status | "EP-001: Auth (3 stories, 1 done)" |
+| Decisions | Full context | One-liner | "JWT instead of sessions" |
+
+---
+
+### 🚨 RULE #6: OUTPUT FORMAT IS EXACT
+
+**Always output in code block for easy copying:**
+
+```
+markdown
+# Project Context Brief
+Last updated: [ISO timestamp]
+
+[Extracted sections...]
+
+---
+**Paste this into**: ChatGPT, Perplexity, Gemini, or Claude web
+**Purpose**: Load full project context for AI assistance
+**Limit**: This excerpt is ≤300 lines for easy pasting
+```
+
+**DO NOT output as plain text, tables, or separate sections - use single code block for easy selection and copy.**
+
+---
+
+### KEY FILES & STATE TO REMEMBER
+
+| File/State | Purpose | Notes |
+|-----------|---------|-------|
+| docs/context.md | Source file | Must exist, read-only |
+| Output limit | Max 300 lines | Count carefully |
+| Line counter | Track total | Update as you extract |
+| Code block | Output format | For easy copy-paste |
+
+---
+
+### ANTI-PATTERNS & CORRECT PATTERNS
+
+❌ **DON'T**: Modify docs/context.md
+✅ **DO**: Read-only extract only
+
+❌ **DON'T**: Output >300 lines
+✅ **DO**: Condense to fit limit
+
+❌ **DON'T**: Include full ADR descriptions
+✅ **DO**: ADR titles + status only
+
+❌ **DON'T**: Include progress/notes sections
+✅ **DO**: Overview, focus, tech, decisions, features, next only
+
+❌ **DON'T**: Output as plain text
+✅ **DO**: Single markdown code block for copy-paste
+
+---
+
+### REMEMBER AFTER COMPACTION
+
+After this command completes:
+- ✓ Excerpt extracted from docs/context.md (read-only)
+- ✓ Output ≤300 lines (verified count)
+- ✓ Formatted in markdown code block
+- ✓ Ready to paste into ChatGPT, Perplexity, Gemini, Claude web
+- ✓ Use `/agileflow:context:full` to regenerate docs/context.md
+- ✓ Use `/agileflow:context:note` to add timestamped notes to context.md
+
 <!-- COMPACT_SUMMARY_END -->
 
 ---