agileflow 3.4.3 → 4.0.0-alpha.10

package/src/core/commands/epic/list.md

@@ -1,190 +0,0 @@
----
-description: List all epics with status and progress
-argument-hint: "[STATUS=<status>]"
-compact_context:
-  priority: medium
-  preserve_rules:
-    - "ACTIVE COMMAND: /agileflow:epic:list - Lists all epics with progress tracking"
-    - "MUST read status.json for epic data"
-    - "MUST calculate story progress (completed/total) for each epic"
-    - "MUST display table with status, progress percentage, owner"
-    - "MUST offer actions: view details, add story, create new epic"
-    - "This is READ-ONLY - no file writes"
-  state_fields:
-    - status_filter
-    - epic_count
----
-
-# /agileflow:epic:list
-
-Display all epics with progress tracking and quick actions.
-
----
-
-## Purpose
-
-Shows all epics from `docs/09-agents/status.json` with:
-- Status (active, complete, on-hold)
-- Story count and completion percentage
-- Owner assignment
-- Quick action options
-
-**This is a read-only command** - no files are written.
-
----
-
-## STEP 0: Gather Context
-
-```bash
-node .agileflow/scripts/obtain-context.js epic:list
-```
-
----
-
-<!-- COMPACT_SUMMARY_START -->
-## Compact Summary
-
-**Command**: `/agileflow:epic:list [STATUS=<status>]`
-**Purpose**: Display epics with progress and offer quick actions
-
-### Flow
-1. Read status.json for epics
-2. Calculate story progress for each epic
-3. Display formatted table
-4. Offer actions: view details, add story, create new
-
-### Critical Rules
-- **Read-only**: No file writes
-- **Show progress**: Include story completion percentage
-- **Always offer actions**: End with AskUserQuestion for next steps
-<!-- COMPACT_SUMMARY_END -->
-
----
-
-## Arguments
-
-| Argument | Required | Description |
-|----------|----------|-------------|
-| STATUS | No | Filter by status (active, complete, on-hold) |
-
----
-
-## IMMEDIATE ACTIONS
-
-Upon invocation, execute these steps:
-
-### Step 1: Read Status File
-
-```bash
-cat docs/09-agents/status.json
-```
-
-### Step 2: Calculate Progress
-
-For each epic:
-- Count total stories
-- Count completed stories
-- Calculate percentage
-
-### Step 3: Apply Filters
-
-If STATUS provided, show only epics with that status.
-
-### Step 4: Display Epics
-
-Format output as table sorted by status then number:
-
-```markdown
-## Epics
-
-| Epic | Title | Status | Progress | Owner |
-|------|-------|--------|----------|-------|
-| EP-0003 | User Dashboard | active | 2/5 (40%) | AG-UI |
-| EP-0002 | Authentication | active | 4/6 (67%) | AG-API |
-| EP-0001 | Core Setup | complete | 3/3 (100%) | AG-DEVOPS |
-
----
-**Summary**: 3 epics (2 active, 1 complete)
-**Stories**: 9/14 complete (64%)
-
-Legend:
-- **active**: In progress, accepting new stories
-- **complete**: All stories done
-- **on-hold**: Paused, not currently worked on
-```
-
-### Step 5: Offer Actions
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "What would you like to do?",
-  "header": "Actions",
-  "multiSelect": false,
-  "options": [
-    {"label": "View epic details", "description": "See all stories in an epic with progress"},
-    {"label": "Add story to epic", "description": "Create a new story in an existing epic"},
-    {"label": "Create new epic", "description": "Start a new feature epic"},
-    {"label": "Done", "description": "Exit"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-**If "View epic details"**:
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "Which epic would you like to view?",
-  "header": "Select",
-  "multiSelect": false,
-  "options": [
-    {"label": "EP-0003: User Dashboard (40%)", "description": "active - 2/5 stories"},
-    {"label": "EP-0002: Authentication (67%)", "description": "active - 4/6 stories"},
-    {"label": "EP-0001: Core Setup (100%)", "description": "complete - 3/3 stories"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-Then invoke: `/agileflow:epic:view EPIC=<selected>`
-
-**If "Add story to epic"**:
-Ask which epic, then invoke: `/agileflow:story EPIC=<selected>`
-
-**If "Create new epic"**:
-Invoke: `/agileflow:epic`
-
----
-
-## Example Usage
-
-```bash
-# List all epics
-/agileflow:epic:list
-
-# List only active epics
-/agileflow:epic:list STATUS=active
-
-# List completed epics
-/agileflow:epic:list STATUS=complete
-```
-
----
-
-## Rules
-
-- **Read-only**: No file writes
-- **Show progress**: Calculate and display story completion
-- **Show summary**: Include totals at the bottom
-- **Always offer actions**: End with next step options
-
----
-
-## Related Commands
-
-- `/agileflow:epic:view` - View epic details with all stories
-- `/agileflow:epic` - Create new epic
-- `/agileflow:story:list` - View all stories
-- `/agileflow:board` - Visual kanban board
-- `/agileflow:sprint` - Sprint planning

package/src/core/commands/epic/view.md

@@ -1,267 +0,0 @@
----
-description: View epic details with stories and contextual actions
-argument-hint: "EPIC=<EP-ID>"
-compact_context:
-  priority: medium
-  preserve_rules:
-    - "ACTIVE COMMAND: /agileflow:epic:view - Views epic with all stories and context-aware actions"
-    - "MUST read epic from status.json and load all stories"
-    - "MUST display overview: title, owner, goal, progress bar"
-    - "MUST group stories by status: in_progress, ready, done"
-    - "MUST offer CONTEXT-AWARE actions based on progress"
-    - "Progress <50% → Add stories, start work, plan sprint"
-    - "Progress 50-99% → Work on remaining, view details"
-    - "Progress 100% → Close epic, view summary"
-    - "Status on-hold → Resume, view blockers, close"
-    - "ALWAYS offer next steps via AskUserQuestion"
-  state_fields:
-    - selected_epic_id
-    - epic_progress
-    - epic_status
----
-
-# /agileflow:epic:view
-
-View full epic details including all stories and contextual actions.
-
----
-
-## Purpose
-
-Displays complete epic information and offers **context-aware actions** based on epic state:
-- **active, low progress** → Add stories, start work
-- **active, high progress** → Complete remaining stories, close epic
-- **complete** → View summary, reopen if needed
-- **on-hold** → Resume, view blockers
-
----
-
-## STEP 0: Gather Context
-
-```bash
-node .agileflow/scripts/obtain-context.js epic:view
-```
-
----
-
-<!-- COMPACT_SUMMARY_START -->
-## Compact Summary
-
-**Command**: `/agileflow:epic:view EPIC=<EP-ID>`
-**Purpose**: View epic with all stories and context-aware actions
-
-### Flow
-1. Read epic from status.json
-2. Load all stories for this epic
-3. Display epic overview and story breakdown
-4. Offer actions based on epic progress
-5. Execute selected action
-
-### Critical Rules
-- **Show all stories**: Group by status (in_progress, ready, done)
-- **Context-aware actions**: Different options based on progress
-- **Always offer next steps**: End with relevant AskUserQuestion
-<!-- COMPACT_SUMMARY_END -->
-
----
-
-## Arguments
-
-| Argument | Required | Description |
-|----------|----------|-------------|
-| EPIC | Yes | Epic ID (e.g., EP-0001) |
-
----
-
-## IMMEDIATE ACTIONS
-
-Upon invocation, execute these steps:
-
-### Step 1: Validate Input
-
-If EPIC not provided, list recent epics:
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "Which epic would you like to view?",
-  "header": "Select",
-  "multiSelect": false,
-  "options": [
-    {"label": "EP-0003: User Dashboard", "description": "active - 40% complete"},
-    {"label": "EP-0002: Authentication", "description": "active - 67% complete"},
-    {"label": "Show all epics", "description": "View full epic list"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-### Step 2: Read Epic Data
-
-Read from status.json:
-- Epic metadata (title, owner, status, goal)
-- All stories belonging to this epic
-
-### Step 3: Display Epic Overview
-
-```markdown
-## EP-0002: Authentication System
-
-**Status**: active
-**Owner**: AG-API
-**Goal**: Implement secure user authentication with OAuth and sessions
-**Created**: 2024-12-20
-**Updated**: 2024-12-28
-
-**Progress**: 4/6 stories complete (67%)
-
-███████████████░░░░░░░ 67%
-
----
-
-### Stories by Status
-
-#### In Progress (1)
-| Story | Title | Owner | Estimate |
-|-------|-------|-------|----------|
-| US-0012 | Session management | AG-API | 4h |
-
-#### Ready (1)
-| Story | Title | Owner | Estimate |
-|-------|-------|-------|----------|
-| US-0013 | Remember me feature | AG-UI | 2h |
-
-#### Done (4)
-| Story | Title | Owner | Completed |
-|-------|-------|-------|-----------|
-| US-0011 | OAuth Google login | AG-API | 2024-12-27 |
-| US-0010 | Login form UI | AG-UI | 2024-12-26 |
-| US-0009 | User model | AG-API | 2024-12-25 |
-| US-0008 | Auth API setup | AG-API | 2024-12-24 |
-
----
-
-### Related
-
-- **Research**: [OAuth Best Practices](../10-research/20241220-oauth.md)
-- **ADR**: [ADR-0002: Use NextAuth](../03-decisions/adr-0002.md)
-```
-
-### Step 4: Offer Context-Aware Actions
-
-**Based on epic progress, show different options:**
-
-#### If Progress < 50%
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "This epic is 40% complete. What would you like to do?",
-  "header": "Actions",
-  "multiSelect": false,
-  "options": [
-    {"label": "Add more stories", "description": "Epic may need more work items"},
-    {"label": "Start work on a ready story", "description": "Pick a story to begin"},
-    {"label": "Plan sprint for this epic", "description": "Schedule stories with /agileflow:sprint"},
-    {"label": "Back to epic list", "description": "Return to /agileflow:epic:list"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-#### If Progress >= 50% but < 100%
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "This epic is 67% complete. What would you like to do?",
-  "header": "Actions",
-  "multiSelect": false,
-  "options": [
-    {"label": "Work on remaining stories (Recommended)", "description": "Continue toward completion"},
-    {"label": "View story details", "description": "Check a specific story"},
-    {"label": "Add more stories", "description": "Epic scope may have grown"},
-    {"label": "Mark epic as complete", "description": "If remaining work is deferred"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-**If "Work on remaining stories"**:
-- Show ready stories
-- Let user pick one
-- Run `/agileflow:story:view STORY=<selected>`
-
-#### If Progress = 100%
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "This epic is 100% complete! What would you like to do?",
-  "header": "Actions",
-  "multiSelect": false,
-  "options": [
-    {"label": "Close epic (Recommended)", "description": "Mark as complete in status.json"},
-    {"label": "View completion summary", "description": "See what was delivered"},
-    {"label": "Add follow-up stories", "description": "Epic needs more work after all"},
-    {"label": "Back to epic list", "description": "Return to /agileflow:epic:list"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-**If "Close epic"**:
-- Update epic status to "complete" in status.json
-- Add completion timestamp
-- Show summary of delivered stories
-
-#### If Status = on-hold
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "This epic is on hold. What would you like to do?",
-  "header": "Actions",
-  "multiSelect": false,
-  "options": [
-    {"label": "Resume epic", "description": "Change status back to active"},
-    {"label": "View why it's on hold", "description": "Check blockers or notes"},
-    {"label": "Close epic", "description": "No longer needed"},
-    {"label": "Back to epic list", "description": "Return to /agileflow:epic:list"}
-  ]
-}]</parameter>
-</invoke>
-```
-
----
-
-## Example Usage
-
-```bash
-# View specific epic
-/agileflow:epic:view EPIC=EP-0002
-
-# Will prompt for selection if no ID
-/agileflow:epic:view
-```
-
----
-
-## Rules
-
-- **Show all stories**: Group by status for clarity
-- **Progress visualization**: Show percentage and progress bar
-- **Context-aware**: Actions match epic state
-- **Connect to related**: Show linked research, ADRs
-- **Always offer next steps**: End with relevant action options
-
----
-
-## Related Commands
-
-- `/agileflow:epic:list` - View all epics
-- `/agileflow:epic` - Create new epic
-- `/agileflow:story` - Add story to epic
-- `/agileflow:story:view` - View story details
-- `/agileflow:sprint` - Plan sprint
-- `/agileflow:board` - Kanban view