agent-flow

agent-flow

v1.0.0 — Initial public release. View on GitHub

A Claude Code plugin that automates the full development lifecycle — from bug triage through fix, review, test, and publish. 17 specialized AI agents, 17 orchestration skills, 17 core contracts, zero dependencies.

graph LR
    User["User<br/><code>/fix-bugs</code> · <code>/implement-feature</code> · <code>/scaffold</code>"]

    subgraph Plugin["agent-flow Plugin"]
        Skills["<b>Skills</b> (17)<br/>Orchestration — WHAT to do"]
        Agents["<b>Agents</b> (17)<br/>Specialists — HOW to do it"]
        Skills -->|dispatches| Agents
    end

    subgraph Project["Your Project"]
        Config["CLAUDE.md<br/><code>## Automation Config</code>"]
        MCP[".mcp.json<br/>API tokens"]
    end

    subgraph External["External Services"]
        Tracker["Issue Tracker<br/>GitHub · Gitea · YouTrack<br/>Jira · Linear · Redmine"]
        SCM["Source Control<br/>Git repository"]
    end

    User --> Skills
    Skills -->|reads config| Config
    Agents -->|uses tokens| MCP
    Agents -->|queries/updates| Tracker
    Agents -->|branch · commit · PR| SCM

    style Plugin fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
    style Project fill:#f0fff0,stroke:#2d8a4e,stroke-width:2px
    style External fill:#fff8f0,stroke:#c47a20,stroke-width:2px

What It Does

• Bug-fix pipeline — Triage, analyze, fix, review, test, and publish. Fully automated from issue tracker query to merged PR.
• Feature pipeline — Specification extraction, architecture design, task decomposition, implementation, review, test, and publish.
• Project scaffolding — Describe a project in natural language. Get a specification, buildable skeleton, and fully implemented features with tests. Use --yolo for full automation or --step-mode for per-step debugging.
• 17 specialized agents — Each with a defined role, model assignment (opus/sonnet/haiku), and constraints. Read-only analysts never touch code; execution agents make changes.
• Zero dependencies — Pure markdown definitions. No build system, no runtime, no package manager. Works on macOS, Linux, and Windows (Git Bash required on Windows).

Quick Start

# 1. Add the marketplace
/plugin marketplace add asysta-act/agent-flow

# 2. Install the plugin
/plugin install agent-flow@agent-flow

# 3. Run the interactive setup wizard
/agent-flow:onboard

# 4. Validate your configuration
/agent-flow:check-setup

# 5. Fix your first bug
/agent-flow:fix-bugs ISSUE-123

The /onboard wizard will guide you through setting up your issue tracker, source control, PR rules, and build commands. No manual copy-paste needed.

New to agent-flow? See the Getting Started tutorial for a complete walkthrough.

Pipelines

Bug-Fix Pipeline

flowchart TD
    Query["Issue Tracker Query"] --> Triage
    Triage["Analyst (--phase triage)<br/><i>sonnet</i>"]
    Triage -->|valid| CodeAnalyst["Analyst (--phase impact)<br/><i>sonnet</i>"]
    Triage -->|invalid / duplicate| Block1["Block"]
    CodeAnalyst --> Fixer["Fixer ↔ Reviewer<br/><i>opus · max 5 iterations</i>"]
    Fixer -->|approved| TestEng["Test Engineer<br/><i>sonnet · max 3 attempts</i>"]
    Fixer -->|rejected 5x| Block2["Block + Rollback"]
    TestEng -->|pass| Publisher["Publisher<br/><i>haiku</i>"]
    TestEng -->|fail 3x| Block3["Block + Rollback"]
    Publisher --> Done["PR Created ✓"]
    style Block1 fill:#ffe0e0,stroke:#cc0000
    style Block2 fill:#ffe0e0,stroke:#cc0000
    style Block3 fill:#ffe0e0,stroke:#cc0000
    style Done fill:#e0ffe0,stroke:#00cc00

Feature Pipeline

flowchart TD
    Query["Issue Tracker Query"] --> Spec["Spec Analyst<br/><i>sonnet</i>"]
    Spec --> Arch["Architect<br/><i>opus</i>"]
    Arch -->|decompose| Tasks["Subtask 1..N"]
    Arch -->|single task| Fixer
    Tasks --> Fixer["Fixer ↔ Reviewer<br/><i>opus · per subtask</i>"]
    Fixer -->|approved| TestEng["Test Engineer<br/><i>sonnet</i>"]
    TestEng -->|pass| Publisher["Publisher<br/><i>haiku</i>"]
    style Tasks fill:#f0f4ff,stroke:#4a6cf7

Scaffold Pipeline