agileflow 3.4.2 → 4.0.0-alpha.1

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

@@ -1,191 +0,0 @@
----
-description: List all Architecture Decision Records
-argument-hint: "[STATUS=<status>]"
-compact_context:
-  priority: medium
-  preserve_rules:
-    - "ACTIVE COMMAND: /agileflow:adr:list - Lists all ADRs with status and quick actions"
-    - "MUST read docs/03-decisions/ directory for ADR files"
-    - "MUST parse frontmatter for status, date, tags"
-    - "MUST display table sorted by number with status indicators"
-    - "MUST offer actions: view details, create new, update status"
-    - "This is READ-ONLY - no file writes"
-  state_fields:
-    - status_filter
-    - adr_count
----
-
-# /agileflow:adr:list
-
-Display all Architecture Decision Records with status and quick actions.
-
----
-
-## Purpose
-
-Shows all ADRs from `docs/03-decisions/` with:
-- Status (proposed, accepted, deprecated, superseded)
-- Date created
-- Summary
-- Quick action options
-
-**This is a read-only command** - no files are written.
-
----
-
-## STEP 0: Gather Context
-
-```bash
-node .agileflow/scripts/obtain-context.js adr:list
-```
-
----
-
-<!-- COMPACT_SUMMARY_START -->
-## Compact Summary
-
-**Command**: `/agileflow:adr:list [STATUS=<status>]`
-**Purpose**: Display ADRs with filters and offer quick actions
-
-### Flow
-1. Read docs/03-decisions/ directory
-2. Parse ADR frontmatter for status/date
-3. Display formatted table
-4. Offer actions: view details, create new, update status
-
-### Critical Rules
-- **Read-only**: No file writes
-- **Always offer actions**: End with AskUserQuestion for next steps
-- **Show status clearly**: Color-code by status
-<!-- COMPACT_SUMMARY_END -->
-
----
-
-## Arguments
-
-| Argument | Required | Description |
-|----------|----------|-------------|
-| STATUS | No | Filter by status (proposed, accepted, deprecated, superseded) |
-
----
-
-## IMMEDIATE ACTIONS
-
-Upon invocation, execute these steps:
-
-### Step 1: Read ADR Directory
-
-```bash
-ls docs/03-decisions/adr-*.md
-```
-
-### Step 2: Parse Each ADR
-
-For each ADR file, extract from frontmatter:
-- number
-- title
-- date
-- status
-- tags (if present)
-
-### Step 3: Apply Filters
-
-If STATUS provided, show only ADRs with that status.
-
-### Step 4: Display ADRs
-
-Format output as table sorted by number:
-
-```markdown
-## Architecture Decision Records
-
-| # | Title | Status | Date | Tags |
-|---|-------|--------|------|------|
-| 0003 | Use PostgreSQL for persistence | accepted | 2024-12-28 | database, architecture |
-| 0002 | Session management approach | accepted | 2024-12-25 | auth, sessions |
-| 0001 | AgileFlow agent system | accepted | 2024-12-20 | agents, architecture |
-
----
-**Summary**: 3 ADRs (3 accepted, 0 proposed, 0 deprecated)
-
-Statuses:
-- **proposed**: Under discussion, not yet decided
-- **accepted**: Decision made and in effect
-- **deprecated**: No longer applies (superseded or obsolete)
-- **superseded**: Replaced by a newer ADR
-```
-
-### 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 ADR details", "description": "Read full ADR with context and consequences"},
-    {"label": "Create new ADR", "description": "Document a new architecture decision"},
-    {"label": "Update ADR status", "description": "Change status of existing ADR"},
-    {"label": "Done", "description": "Exit"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-**If "View ADR details"**:
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "Which ADR would you like to view?",
-  "header": "Select",
-  "multiSelect": false,
-  "options": [
-    {"label": "ADR-0003: Use PostgreSQL for persistence", "description": "accepted - 2024-12-28"},
-    {"label": "ADR-0002: Session management approach", "description": "accepted - 2024-12-25"},
-    {"label": "ADR-0001: AgileFlow agent system", "description": "accepted - 2024-12-20"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-Then invoke: `/agileflow:adr:view NUMBER=<selected>`
-
-**If "Create new ADR"**:
-Invoke: `/agileflow:adr`
-
-**If "Update ADR status"**:
-Invoke: `/agileflow:adr:update`
-
----
-
-## Example Usage
-
-```bash
-# List all ADRs
-/agileflow:adr:list
-
-# List only proposed ADRs
-/agileflow:adr:list STATUS=proposed
-
-# List only accepted ADRs
-/agileflow:adr:list STATUS=accepted
-```
-
----
-
-## Rules
-
-- **Read-only**: No file writes
-- **Parse frontmatter**: Extract status, date, tags from YAML
-- **Show summary**: Include counts by status at the bottom
-- **Always offer actions**: End with next step options
-
----
-
-## Related Commands
-
-- `/agileflow:adr:view` - View full ADR details
-- `/agileflow:adr` - Create new ADR
-- `/agileflow:adr:update` - Update ADR status
-- `/agileflow:research:analyze` - Analyze research that may lead to ADR

package/src/core/commands/adr/update.md

@@ -1,258 +0,0 @@
----
-description: Update ADR status or content
-argument-hint: "NUMBER=<number> [STATUS=<status>] [REASON=<text>]"
-compact_context:
-  priority: high
-  preserve_rules:
-    - "NUMBER is REQUIRED - always ask if missing"
-    - "Every status change MUST have documented reason"
-    - "Show preview of changes before writing (diff-first pattern)"
-    - "If superseded, MUST link to replacement ADR"
-    - "Never delete content - always append amendments"
-    - "Update timestamps in frontmatter when modifying"
-  state_fields:
-    - adr_number
-    - current_status
-    - new_status
-    - reason
-    - superseded_by
----
-
-# /agileflow:adr:update
-
-Update an existing ADR's status or add amendments.
-
----
-
-## Purpose
-
-Allows you to:
-- Change ADR status (proposed → accepted, accepted → deprecated, etc.)
-- Add amendment notes explaining status changes
-- Mark an ADR as superseded by a newer ADR
-- Reactivate deprecated ADRs
-
----
-
-## STEP 0: Gather Context
-
-```bash
-node .agileflow/scripts/obtain-context.js adr:update
-```
-
----
-
-<!-- COMPACT_SUMMARY_START -->
-## Compact Summary
-
-**Command**: `/agileflow:adr:update NUMBER=<4-digit> [STATUS=<status>] [REASON=<text>]`
-**Purpose**: Update ADR status with optional reason/amendment
-
-### Flow
-1. Read existing ADR
-2. Ask for new status if not provided
-3. Require reason for status change
-4. Show preview of changes
-5. Update file if confirmed
-6. Offer next actions
-
-### Critical Rules
-- **Require reason**: Every status change needs a reason documented
-- **Show preview**: Display changes before writing
-- **Link superseding ADRs**: If superseded, require link to new ADR
-<!-- COMPACT_SUMMARY_END -->
-
----
-
-## Arguments
-
-| Argument | Required | Description |
-|----------|----------|-------------|
-| NUMBER | Yes | ADR number to update (e.g., 0042) |
-| STATUS | No | New status (proposed, accepted, deprecated, superseded) |
-| REASON | No | Reason for the status change |
-| SUPERSEDED_BY | No | If superseding, the new ADR number |
-
----
-
-## IMMEDIATE ACTIONS
-
-Upon invocation, execute these steps:
-
-### Step 1: Validate and Read ADR
-
-```bash
-cat docs/03-decisions/adr-<NUMBER>-*.md
-```
-
-If file not found, show error and suggest `/agileflow:adr:list`.
-
-### Step 2: Ask for New Status (if not provided)
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "What should the new status be for ADR-<NUMBER>?",
-  "header": "Status",
-  "multiSelect": false,
-  "options": [
-    {"label": "accepted", "description": "Decision approved and in effect"},
-    {"label": "deprecated", "description": "No longer applies (but not replaced)"},
-    {"label": "superseded", "description": "Replaced by a newer ADR"},
-    {"label": "proposed", "description": "Back to discussion phase"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-### Step 3: Get Reason for Change
-
-Always require a reason:
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "Why is this ADR being changed to '<STATUS>'?",
-  "header": "Reason",
-  "multiSelect": false,
-  "options": [
-    {"label": "Provide reason", "description": "Enter in 'Other' field (required)"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-### Step 4: If Superseded, Get Replacement ADR
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "Which ADR supersedes this one?",
-  "header": "Replacement",
-  "multiSelect": false,
-  "options": [
-    {"label": "ADR-0045 (latest)", "description": "Most recent ADR"},
-    {"label": "ADR-0044", "description": "Previous ADR"},
-    {"label": "Create new ADR", "description": "I need to create the replacement first"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-If "Create new ADR": Run `/agileflow:adr` first, then return to update this one.
-
-### Step 5: Preview Changes
-
-Show what will be updated:
-
-```markdown
-## ADR-0042 Update Preview
-
-**Current Status**: accepted
-**New Status**: superseded
-
-**Changes to file:**
-
-```diff
-- status: accepted
-+ status: superseded
-
-+ ## Amendment - 2024-12-30
-+
-+ **Status changed**: accepted → superseded
-+ **Reason**: New requirements made this approach obsolete.
-+ **Superseded by**: [ADR-0045](adr-0045-new-approach.md)
-```
-
-### Step 6: Confirm Update
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "Apply this update to ADR-<NUMBER>?",
-  "header": "Confirm",
-  "multiSelect": false,
-  "options": [
-    {"label": "Yes, update ADR", "description": "Apply changes to file"},
-    {"label": "No, cancel", "description": "Discard changes"}
-  ]
-}]</parameter>
-</invoke>
-```
-
-### Step 7: Update File
-
-If confirmed:
-1. Update frontmatter status
-2. Append Amendment section with:
-   - Date
-   - Status change (from → to)
-   - Reason
-   - Superseded by link (if applicable)
-
-### Step 8: Offer Next Actions
-
-```xml
-<invoke name="AskUserQuestion">
-<parameter name="questions">[{
-  "question": "ADR-<NUMBER> updated. What would you like to do next?",
-  "header": "Next Steps",
-  "multiSelect": false,
-  "options": [
-    {"label": "View updated ADR", "description": "See the changes with /agileflow:adr:view"},
-    {"label": "Update another ADR", "description": "Change status of a different ADR"},
-    {"label": "View all ADRs", "description": "Return to /agileflow:adr:list"},
-    {"label": "Done", "description": "Exit"}
-  ]
-}]</parameter>
-</invoke>
-```
-
----
-
-## Status Transitions
-
-| From | To | Common Reasons |
-|------|-----|----------------|
-| proposed | accepted | Team approved, ready to implement |
-| proposed | rejected | Alternative chosen, not viable |
-| accepted | deprecated | No longer relevant, context changed |
-| accepted | superseded | Better approach found, replaced by new ADR |
-| deprecated | accepted | Reconsidered, still valid |
-| superseded | accepted | Replacement didn't work out |
-
----
-
-## Example Usage
-
-```bash
-# Mark ADR as accepted
-/agileflow:adr:update NUMBER=0042 STATUS=accepted REASON="Team approved after review"
-
-# Mark ADR as superseded
-/agileflow:adr:update NUMBER=0042 STATUS=superseded SUPERSEDED_BY=0045 REASON="New requirements"
-
-# Deprecate an ADR
-/agileflow:adr:update NUMBER=0042 STATUS=deprecated REASON="Context no longer applies"
-
-# Interactive (no arguments)
-/agileflow:adr:update NUMBER=0042
-```
-
----
-
-## Rules
-
-- **Require reason**: Every status change must have documented reason
-- **Show preview**: Always display changes before writing
-- **Link superseding ADRs**: If superseded, must link to replacement
-- **Preserve history**: Never delete content, always append amendments
-- **Update timestamps**: Set updated date in frontmatter
-
----
-
-## Related Commands
-
-- `/agileflow:adr:view` - View ADR details
-- `/agileflow:adr:list` - View all ADRs
-- `/agileflow:adr` - Create new ADR