AgileFlow

/adr:list

PreviousNext

List all Architecture Decision Records with status and quick actions

/adr:list

Display all Architecture Decision Records with their status, dates, and quick action options.

Quick Start

/agileflow:adr:list

Parameters

ParameterRequiredDefaultDescription
STATUSNo-Filter by status: proposed, accepted, deprecated, superseded

Examples

List All ADRs

/agileflow:adr:list

Shows all ADRs sorted by number with their current status.

List Only Accepted ADRs

/agileflow:adr:list STATUS=accepted

Filters to show only ADRs that have been approved and are in effect.

List Only Proposed ADRs

/agileflow:adr:list STATUS=proposed

Shows ADRs still under discussion, awaiting team approval.

Output Format

The command displays ADRs in a structured table:

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

Status Definitions

StatusMeaningAction
proposedUnder discussion, not yet decidedReview and approve or request changes
acceptedDecision made and in effectImplement or create related stories
deprecatedNo longer applies (but not replaced)Consider reactivating if context changes
supersededReplaced by a newer ADRView replacement ADR to understand evolution

Quick Actions

After displaying the list, you can:

View ADR Details

Select an ADR to see full content including:

  • Complete context explaining the decision
  • Decision rationale and alternatives considered
  • Consequences (positive and negative)
  • Related ADRs and stories
/agileflow:adr:view NUMBER=0003

Create New ADR

Jump to ADR creation from the list:

/agileflow:adr NUMBER=0004 TITLE="..." CONTEXT="..." DECISION="..." CONSEQUENCES="..."

Update ADR Status

Change status of existing ADR (e.g., proposed → accepted):

/agileflow:adr:update NUMBER=0003 STATUS=accepted

Workflow Integration

After Architecture Review

/agileflow:adr:list STATUS=proposed
# Review proposed decisions
/agileflow:adr:view NUMBER=0003  # View each for discussion
/agileflow:adr:update NUMBER=0003 STATUS=accepted  # Approve decision

Planning Implementation

/agileflow:adr:list STATUS=accepted
# See all approved architectural decisions
/agileflow:adr:view NUMBER=0003
# If needed: /agileflow:epic to create implementation work

Tracking Decisions

/agileflow:adr:list
# Comprehensive view of all decisions and their status
# Superseded ADRs show decision evolution

Related Commands

  • /adr - Create new ADR
  • /adr:view - View full ADR details
  • /adr:update - Update ADR status
  • /epic - Create implementation epic for accepted ADR
  • /story - Create implementation story