agileflow 3.4.2 → 4.0.0-alpha.1

package/src/core/commands/update.md

@@ -1,591 +0,0 @@
----
-description: Generate stakeholder progress report
-argument-hint: "[PERIOD=week|sprint|month|quarter] [AUDIENCE=exec|client|team|board] [FORMAT=email|markdown]"
-compact_context:
-  priority: high
-  preserve_rules:
-    - "ACTIVE COMMAND: /agileflow:stakeholder-update - Stakeholder communication generator"
-    - "CRITICAL: Aggregate data from 10 sources (status, epics, stories, roadmap, risks, git, bus, ADRs, milestones, releases)"
-    - "CRITICAL: PREVIEW before sending (diff-first, YES/NO/EDIT)"
-    - "CRITICAL: Always HONEST about blockers and risks (never hide problems)"
-    - "MUST focus on business value, not technical jargon (for exec/client audiences)"
-    - "MUST save all updates to docs/08-project/updates/ for historical record"
-    - "MUST include specific metrics with trends (velocity, coverage, bugs, test coverage)"
-    - "Update structure: Executive Summary | Progress | Upcoming | Metrics | Blockers | Decisions | Resources"
-  state_fields:
-    - period
-    - audience
-    - format
-    - date_range
----
-
-# stakeholder-update
-
-Generate stakeholder communication updates from project status.
-
----
-
-## STEP 0: Gather Context
-
-```bash
-node .agileflow/scripts/obtain-context.js update
-```
-
----
-
-<!-- COMPACT_SUMMARY_START -->
-## Compact Summary
-
-**Command**: `stakeholder-update` - Generate high-level project updates from status, epics, stories, and git history
-
-**Quick Usage**:
-```
-/agileflow:stakeholder-update PERIOD=week AUDIENCE=exec FORMAT=markdown
-```
-
-**Critical Rules**:
-- MUST aggregate data from 10 sources (status, epics, stories, roadmap, risks, git history, bus log, ADRs)
-- MUST preview before sending (diff-first, YES/NO/EDIT)
-- MUST save to docs/08-project/updates/ for history
-- MUST be honest about blockers and risks
-- Focus on business value, not technical jargon
-
-### Tool Usage Examples
-
-**Read** (to gather data from all 10 sources):
-```xml
-<invoke name="Read">
-<parameter name="file_path">/full/path/to/docs/09-agents/status.json</parameter>
-</invoke>
-```
-
-**Write** (to save update):
-```xml
-<invoke name="Write">
-<parameter name="file_path">/full/path/to/docs/08-project/updates/20251222-update.md</parameter>
-<parameter name="content"># Weekly Update - Project XYZ (Dec 15-22, 2025)
-
-## Executive Summary
-Status: On Track. Completed 12 stories, velocity up 20%. Payment integration on track for EOMonth.
-
-## Progress This Period
-- Completed auth epic (5 stories, 7.5 days)
-- Velocity: 18 points (↗ +20% from last week)
-- Test coverage: 87% (↗ +2%)
-
-## Blockers & Risks
-- Stripe API rate limits (Medium) - Mitigation in progress
-- Third-party OAuth downtime (Low) - Fallback available
-
-## Upcoming Priorities
-1. Complete payment integration MVP
-2. Start notification system
-3. Address technical debt</parameter>
-</invoke>
-```
-
-**Bash** (to get git commit history):
-```xml
-<invoke name="Bash">
-<parameter name="command">git log --oneline --since="7 days ago" | head -20</parameter>
-<parameter name="description">Get recent commits for this week</parameter>
-</invoke>
-```
-
-**Glob** (to find update files):
-```xml
-<invoke name="Glob">
-<parameter name="pattern">docs/08-project/updates/*.md</parameter>
-</invoke>
-```
-
-**AskUserQuestion** (for confirmation):
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{"question": "Send this update?", "header": "Preview", "multiSelect": false, "options": [{"label": "Yes, save and send", "description": "Save to docs/08-project/updates/ and email stakeholders"}, {"label": "Edit first", "description": "Let me review and edit"}, {"label": "Cancel", "description": "Don't send"}]}]</parameter>
-</invoke>
-```
-
-**Optional Inputs**:
-- PERIOD=week|sprint|month|quarter|custom (default: week)
-- START_DATE=<YYYY-MM-DD> (for custom period)
-- END_DATE=<YYYY-MM-DD> (for custom period)
-- AUDIENCE=exec|client|team|board (default: exec)
-- FORMAT=email|markdown|slides|pdf (default: markdown)
-
-**Data Sources**: Status.json | Epics | Stories | Roadmap | Milestones | Risks | Git history | Bus log | ADRs
-
-**Update Structure**:
-- Executive Summary | Progress This Period | Upcoming Work | Metrics | Blockers & Risks | Decisions Made | Budget/Resources
-
-**Output Files**: `docs/08-project/updates/<YYYYMMDD>-update.md` | Log entry in bus/log.jsonl
-
-<!-- COMPACT_SUMMARY_END -->
-
-## Prompt
-
-ROLE: Stakeholder Communication Generator
-
-OBJECTIVE
-Automatically generate high-level project updates suitable for stakeholders, executives, or clients.
-
-INPUTS (optional)
-- PERIOD=week|sprint|month|quarter|custom (default: week)
-- START_DATE=<YYYY-MM-DD> (optional: for custom period)
-- END_DATE=<YYYY-MM-DD> (optional: for custom period)
-- AUDIENCE=exec|client|team|board (default: exec)
-- FORMAT=email|markdown|slides|pdf (default: markdown)
-
-DATA SOURCES
-
-Aggregate information from:
-1. **Status**: docs/09-agents/status.json
-2. **Epics**: docs/05-epics/*.md
-3. **Stories**: docs/06-stories/**/US-*.md
-4. **Backlog**: docs/08-project/backlog.md
-5. **Roadmap**: docs/08-project/roadmap.md
-6. **Milestones**: docs/08-project/milestones.md
-7. **Risks**: docs/08-project/risks.md
-8. **Git History**: Commits, PRs merged
-9. **Bus Log**: docs/09-agents/bus/log.jsonl (for context)
-10. **ADRs**: docs/03-decisions/adr-*.md (recent decisions)
-
-UPDATE STRUCTURE
-
-### Executive Summary
-- 2-3 sentence overview
-- Key accomplishments
-- Critical issues (if any)
-- Overall status (On Track / At Risk / Blocked)
-
-### Progress This Period
-- Stories completed
-- Epics progress
-- Milestones reached
-
-### Upcoming Work
-- Next priorities
-- Upcoming milestones
-
-### Metrics
-- Velocity
-- Completion rate
-- Quality metrics
-
-### Blockers & Risks
-- Current blockers
-- Risk mitigation
-
-### Decisions Made
-- Recent ADRs
-
-### Budget/Resources (if applicable)
-- Sprint capacity used
-- Team changes
-
-EXAMPLE OUTPUT (Email Format)
-
-```markdown
-Subject: Weekly Update - Project XYZ (Oct 9-16, 2025)
-
-Hi Team,
-
-Here's this week's progress update for Project XYZ.
-
----
-
-## 📊 Executive Summary
-
-**Status**: 🟢 On Track
-
-We completed the user authentication epic this week, delivering all planned features on schedule. The team is now focused on the payment integration milestone. No critical blockers at this time.
-
-**Key Highlights**:
-- ✅ User authentication fully implemented and tested
-- ✅ 12 stories completed (velocity: 18 points)
-- 🎯 Payment integration on track for end-of-month launch
-
----
-
-## ✅ Completed This Week
-
-### Epic: User Authentication (EP-0010) - 100%
-- ✅ US-0050: User registration with email verification
-- ✅ US-0051: Login with session management
-- ✅ US-0052: Password reset flow
-- ✅ US-0053: OAuth login (Google)
-- ✅ US-0054: Rate limiting for security
-
-**Impact**: Users can now create accounts, log in securely, and reset passwords. OAuth support enables faster onboarding.
-
-### Other Completions
-- ✅ US-0048: Improved dashboard loading time by 60%
-- ✅ US-0049: Fixed critical bug in payment processing
-
----
-
-## 🚀 In Progress
-
-### Epic: Payment Integration (EP-0011) - 40%
-- 🔄 US-0060: Stripe integration (in review)
-- 🔄 US-0061: Checkout flow UI (in progress)
-- ⏳ US-0062: Invoice generation (ready to start)
-
-**Expected Completion**: October 30, 2025
-
----
-
-## 📅 Upcoming Priorities (Next Week)
-
-1. **Complete payment integration MVP** (EP-0011)
-   - Finish Stripe integration
-   - Build and test checkout flow
-   - Generate invoices
-
-2. **Start notification system** (EP-0012)
-   - Email notifications for key events
-   - In-app notification center
-
-3. **Address technical debt**
-   - Refactor auth service (improves maintainability)
-   - Add missing integration tests
-
----
-
-## 📈 Metrics
-
-| Metric | This Week | Last Week | Trend |
-|--------|-----------|-----------|-------|
-| Stories Completed | 12 | 10 | ↗️ +20% |
-| Velocity (points) | 18 | 15 | ↗️ +20% |
-| Test Coverage | 87% | 85% | ↗️ +2% |
-| Open Bugs | 3 | 5 | ↗️ -40% |
-| Deployment Success Rate | 100% | 95% | ↗️ +5% |
-
-**Sprint Burndown**: On track. 18 of 20 planned points completed.
-
----
-
-## 🎯 Milestone Progress
-
-### Q4 2025 Roadmap
-
-- ✅ **User Authentication** (Oct 16) - COMPLETED
-- 🔄 **Payment Integration** (Oct 30) - 40% complete, on track
-- ⏳ **Public Beta Launch** (Nov 15) - On schedule
-- ⏳ **Mobile App MVP** (Dec 1) - Planning phase
-
----
-
-## ⚠️ Blockers & Risks
-
-### Current Blockers
-*None at this time*
-
-### Risks Being Monitored
-
-1. **Stripe API rate limits** (Medium Risk)
-   - *Mitigation*: Implementing request queuing and caching
-   - *Owner*: AG-API
-   - *Status*: Mitigation in progress
-
-2. **Third-party OAuth service downtime** (Low Risk)
-   - *Mitigation*: Fallback to email login always available
-   - *Owner*: AG-API
-   - *Status*: Fallback implemented
-
----
-
-## 🏗️ Key Decisions Made
-
-### ADR-0015: Use Stripe for payment processing
-**Decision**: Selected Stripe over PayPal for payment integration
-**Rationale**: Better developer experience, lower fees, excellent documentation
-**Impact**: Faster integration, reduced costs
-
-### ADR-0016: Implement JWT-based authentication
-**Decision**: Use JWT tokens with 15-minute expiry + refresh tokens
-**Rationale**: Stateless, scalable, industry-standard
-**Impact**: Simplified auth architecture
-
----
-
-## 👥 Team Updates
-
-- Team velocity increased 20% this week (improved planning)
-- AG-CI agent optimized CI pipeline (reduced build time from 8min → 5min)
-- No team changes
-
----
-
-## 📦 Releases
-
-- **v1.3.0** deployed to production (Oct 15)
-  - User authentication features
-  - Performance improvements
-  - Security patches
-
----
-
-## 💬 Additional Notes
-
-The team is performing well and morale is high after completing the auth epic ahead of schedule. We're confident in hitting the October 30 payment integration milestone.
-
-Next stakeholder update: October 23, 2025
-
----
-
-Best regards,
-Project Team
-
----
-
-*Generated with AgileFlow /stakeholder-update*
-*Data sources: status.json, epics, stories, git history*
-```
-
-AUDIENCE CUSTOMIZATION
-
-### Executive (C-level)
-- Very high-level
-- Focus on business impact
-- Include metrics and ROI
-- Highlight risks early
-- 1-page max
-
-### Client
-- Feature-focused
-- Emphasize user benefits
-- Transparent about issues
-- Include screenshots/demos
-- Show progress toward contract deliverables
-
-### Team
-- More technical detail
-- Include architecture decisions
-- Celebrate wins
-- Retrospective insights
-- Action items
-
-### Board
-- Strategic overview
-- Financial implications
-- Competitive positioning
-- Long-term roadmap
-- Risk assessment
-
-FORMAT VARIATIONS
-
-### Email (default)
-Plain text or HTML email ready to send
-
-### Markdown
-For posting to internal wikis, documentation platforms, etc.
-
-### Slides
-Generate slide deck outline:
-```markdown
-Slide 1: Title
-- Project XYZ Update
-- Week of Oct 9-16, 2025
-
-Slide 2: Executive Summary
-- Status: On Track
-- 12 stories completed
-- Auth epic finished
-
-Slide 3: Progress This Week
-- [Bullet points]
-
-Slide 4: Metrics Dashboard
-- [Charts/graphs data]
-
-Slide 5: Next Priorities
-- [Upcoming work]
-
-Slide 6: Risks & Mitigation
-- [Risk table]
-```
-
-### PDF
-Formatted report with:
-- Cover page
-- Table of contents
-- Charts/graphs
-- Appendices
-
-METRICS & VISUALIZATION
-
-Include data visualizations (as ASCII art or suggest tools):
-```
-Sprint Burndown Chart (Remaining Points)
-20 │     ●
-18 │    ╱
-16 │   ●
-14 │  ╱
-12 │ ●
-10 │╱
- 8 │●
- 6 │ ╲
- 4 │  ●
- 2 │   ╲
- 0 │    ●
-   └────────────
-   M T W T F
-
-● = Actual
-╱╲ = Ideal
-```
-
-Or suggest: "Generate charts with Chart.js / Google Sheets / Tableau"
-
-AUTOMATION
-
-### Scheduled Reports
-Suggest adding to CI:
-```yaml
-- cron: '0 9 * * 1'  # Every Monday at 9am
-  jobs:
-    stakeholder-update:
-      runs-on: ubuntu-latest
-      steps:
-        - name: Generate update
-          run: npx claude-code /agileflow:stakeholder-update PERIOD=week
-
-        - name: Email stakeholders
-          uses: dawidd6/action-send-mail@v3
-          with:
-            server_address: smtp.gmail.com
-            subject: Weekly Project Update
-            body: file://update.md
-            to: stakeholders@example.com
-```
-
-### Slack/Discord Integration
-Post summary to team channels
-
-WORKFLOW
-
-1. Determine period (this week, last sprint, etc.)
-2. Collect data from all sources
-3. Calculate metrics and trends
-4. Identify completed work
-5. Identify blockers and risks
-6. Format for audience
-7. Preview (show to user)
-8. Ask: "Send update? (YES/NO/EDIT)"
-9. If YES:
-   - Save to docs/08-project/updates/<YYYYMMDD>-update.md
-   - Optionally email stakeholders
-   - Log to bus/log.jsonl
-
-INTEGRATION
-
-- Link to epics and stories for details
-- Reference ADRs for context on decisions
-- Include GitHub PR links
-- Optionally attach screenshots or demo videos
-
-CUSTOMIZATION
-
-Read project-specific settings from `.agileflow/stakeholder-config.json`:
-```json
-{
-  "stakeholders": {
-    "exec": ["ceo@example.com", "cto@example.com"],
-    "client": ["client@example.com"],
-    "board": ["board@example.com"]
-  },
-  "schedule": {
-    "exec": "weekly",
-    "client": "bi-weekly",
-    "board": "monthly"
-  },
-  "metrics": ["velocity", "coverage", "bugs"],
-  "includeFinancials": false
-}
-```
-
-RULES
-- Always be honest about blockers and risks
-- Focus on business value, not technical jargon (for exec/client)
-- Include specific numbers and metrics
-- Highlight trends (improving/declining)
-- Preview before sending (diff-first, YES/NO)
-- Save all updates to docs/08-project/updates/ for history
-- Never expose sensitive data (credentials, internal conflicts)
-
-OUTPUT
-- Stakeholder update (formatted for audience)
-- Saved to docs/08-project/updates/
-- Optional: Email sent to stakeholders
-- Log entry in bus/log.jsonl
-
----
-
-## Expected Output
-
-### Success - Update Generated
-
-```
-📊 Stakeholder Update Generated
-══════════════════════════════════════════════════════════════
-
-Period: Oct 9-16, 2025 (Week)
-Audience: Executive
-Format: Markdown
-
-Data collected from:
-  ✓ status.json (45 stories)
-  ✓ 3 epics
-  ✓ Git history (28 commits)
-  ✓ Bus log (142 events)
-  ✓ 2 ADRs
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Preview
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-## Executive Summary
-**Status**: 🟢 On Track
-
-We completed the user authentication epic this week,
-delivering all planned features on schedule.
-
-**Key Highlights**:
-- ✅ 12 stories completed (velocity: 18 points)
-- 🎯 Payment integration on track for end-of-month
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Save to: docs/08-project/updates/20251016-update.md
-
-Send update? (YES/NO/EDIT)
-```
-
-### Error - No Data for Period
-
-```
-⚠️ Insufficient data for update
-
-Period: Oct 1-7, 2025
-Stories completed: 0
-Commits: 3
-
-Not enough activity to generate meaningful update.
-
-Options:
-1. Expand period to last 2 weeks
-2. Generate minimal status report
-3. Cancel
-```
-
----
-
-## Related Commands
-
-- `/agileflow:docs` - Synchronize documentation with code
-- `/agileflow:metrics` - Analytics dashboard with cycle time
-- `/agileflow:board` - Visual kanban board
-- `/agileflow:retro` - Generate sprint retrospective
-- `/agileflow:changelog` - Generate changelog from commits