features:graph

Command /feature-list:graph

Regenerate the Mermaid dependency graph in the features README.

Instructions

Step 1: Find All Feature Files

Use Glob to find all feature files:

docs/technical-requirements/features/*.md

Exclude:

• README.md
• 00-template.md

Step 2: Parse Feature Frontmatter

For each feature file, read and parse YAML frontmatter:

---
id: core-01
title: User Management
phase: core
status: completed
dependencies:
  - integration-01
---

Extract:

• id — Feature identifier
• title — Display name
• phase — Category for grouping
• status — For status icon
• dependencies — Links to other features

Step 3: Validate Dependencies

Check each dependency exists:

all_ids = {f.id for f in features}
for feature in features:
    for dep in feature.dependencies:
        if dep not in all_ids:
            warnings.append(f"{feature.id} → {dep} (not found)")

Check for circular dependencies:

# Use DFS to detect cycles
def has_cycle(node, visited, rec_stack):
    visited.add(node)
    rec_stack.add(node)
    for dep in graph[node]:
        if dep in rec_stack:
            return True  # Cycle detected
        if dep not in visited and has_cycle(dep, visited, rec_stack):
            return True
    rec_stack.remove(node)
    return False

Step 4: Generate Mermaid Graph

Build the Mermaid flowchart:

flowchart TD
    subgraph Core
        core-01[User Management ✅]
        core-02[Product Catalog 🔄]
    end

    subgraph Workflow
        workflow-01[Checkout 📝]
    end

    subgraph Integration
        integration-01[Email Service ✅]
    end

    workflow-01 --> core-01
    workflow-01 --> core-02
    workflow-01 --> integration-01

Status icons:

• ✅ — completed
• 🔄 — in_progress
• 📝 — draft

Step 5: Update README

Read docs/technical-requirements/features/README.md

Find the markers:

<!-- dependency-graph:start -->
...existing content...
<!-- dependency-graph:end -->