Thanks to visit codestin.com
Credit goes to github.com

Skip to content

asysta-act/agent-flow

BranchesTags

Repository files navigation

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
Loading

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
Loading

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
Loading

Scaffold Pipeline

flowchart TD
    Desc["Project Description<br/><i>natural language</i>"] --> Infra["Infrastructure Declaration<br/><i>tracker · source control</i>"]
    Infra --> Mode["Mode Flags<br/><i>--yolo · default · --step-mode</i>"]
    Mode --> Spec["Spec Writer ↔ Spec Reviewer<br/><i>opus · up to 5 iterations</i>"]
    Spec --> Scaffolder["Scaffolder<br/><i>sonnet</i>"]
    Scaffolder --> Git["Git Init + Auto-Config"]
    Git --> Push["Push to Remote<br/><i>if SC ready</i>"]
    Git --> Issues["Create Tracker Issues<br/><i>if tracker ready</i>"]
    Push --> Arch["Architect<br/><i>opus</i>"]
    Issues --> Arch
    Arch --> Impl["Fixer ↔ Reviewer<br/><i>opus · per subtask</i>"]
    Impl --> Test["Test Engineer + E2E<br/><i>sonnet</i>"]
    Test --> Report["Final Report ✓"]
    style Desc fill:#fff8f0,stroke:#c47a20
    style Infra fill:#f0f4ff,stroke:#4a6cf7
    style Report fill:#e0ffe0,stroke:#00cc00
Loading

With --no-implement: Infrastructure Declaration → Scaffolder (with stack flags) → Validate → Git Init + Push (skeleton only, no implementation).

Hook integration points (pre-fix, post-fix, pre-publish, post-publish) and pipeline profiles are supported. See Pipeline Reference for full details.

Skills

Command Description
/analyze-bug ISSUE-ID Analyze a bug from the issue tracker (triage + impact, no code changes)
/fix-bugs <ISSUE-ID> or /fix-bugs --batch <N> Analyzes and fixes issues — single ticket (<ISSUE-ID>) or batch (--batch <N>)
/implement-feature ISSUE-ID Feature pipeline — spec, design, fix, review, test, publish
/scaffold Creates a new project from scratch; use 'add <component>' to extend an existing project
/publish Create PR and update issue tracker states (auto-detects PR-only vs full-publish from branch name)
/check-setup Validate Automation Config, MCP servers, and tokens
/onboard Interactive wizard for generating Automation Config
/changelog Generate changelog from merged PRs
/version-check Compare installed plugin version against latest available
/metrics Pipeline analytics report — success rates, per-agent effectiveness
/prioritize AI backlog prioritization — impact, risk, effort scoring
/create-backlog Creates backlog epics in issue tracker from specification
/sprint-plan Plans a sprint with capacity constraints and priority ranking
/setup-mcp Developer environment setup — MCP servers, tokens, permissions
/discuss Multi-agent discussion — 2-3 agents respond from their expertise, then synthesis
/setup-agents Project scanner — generates smart TOML customization defaults for all agents
/autopilot Headless dispatcher for cron / batch / CI — reads Bug/Feature queries, dispatches fix-bugs / implement-feature

All skills are namespaced: /agent-flow:<skill>. Most support additional flags (--dry-run, --profile <name>, --decompose).

Full syntax, flags, and examples: Skills Reference

Tip: Always use the namespaced form /agent-flow:<skill> to avoid conflicts with Claude Code built-in commands.

Agents

Agent Model Role
analyst sonnet Triage and impact analysis — --phase triage (severity, AC) or --phase impact (affected files, call-graph)
fixer opus Implements minimal surgical fixes targeting root cause
reviewer opus Quality gate — ensures root cause fix, convention compliance, no regressions
test-engineer sonnet Writes and runs unit/E2E tests — default (unit) or --e2e=true (E2E flows)
publisher haiku Creates branch, commits, pushes, creates PR, updates issue tracker
rollback-agent haiku Reverts failed fix attempts — resets git state, posts block comment
spec-analyst sonnet Extracts structured specifications with acceptance criteria from feature requests
architect opus Designs architecture and generates task trees for implementation
scaffolder sonnet Generates minimal buildable project skeleton with tests, CI, Docker
priority-engine opus Analyzes backlog and recommends fix order by impact, risk, effort
backlog-creator sonnet Extracts structured issue cards from specifications or architect task trees
sprint-planner sonnet Produces capacity-constrained sprint plans from prioritized issue lists
spec-writer opus Generates complete project specification from user input
spec-reviewer opus Reviews specification quality, completeness, and consistency
acceptance-gate sonnet Verifies acceptance criteria are fulfilled — maps each AC to code and test evidence
browser-agent sonnet Browser automation — --phase reproduce (pre-fix evidence) or --phase verify (post-fix check)
deployment-verifier sonnet Verifies a deployment is healthy — checks endpoints, logs, and key flows post-deploy

Agent details, inputs, outputs, and example output: Agents Reference

Configuration

Projects using this plugin need ## Automation Config in their CLAUDE.md. Use /agent-flow:onboard to generate it interactively.

Required Sections

Section Purpose
Issue Tracker Tracker type, instance, project, query, state transitions
Source Control Remote, base branch, branch naming pattern
PR Rules Labels for pull requests
PR Description Template Template for PR body
Build & Test Build and test commands

18 optional config sections cover retry limits, module docs, hooks, custom agents, notifications, worktrees, E2E testing, browser verification, local deployment, sprint planning, error handling, feature workflow, decomposition, pipeline profiles, metrics, agent overrides, and pause limits.

Minimal example:

## Automation Config

### Issue Tracker
| Key | Value |
|-----|-------|
| Type | github |
| Instance | github.com |
| Project | my-org/my-repo |
| Bug query | label:bug state:open |

### Source Control
| Key | Value |
|-----|-------|
| Remote | my-org/my-repo |
| Base branch | main |
| Branch naming | fix/{issue-id}-{slug} |

Full specification with examples: Automation Config Reference. Canonical contract definition: CLAUDE.md.

Documentation
Getting Started Step-by-step tutorial — install, configure, run your first pipeline
Architecture Design philosophy, model selection, pipeline architecture, data flow
Guides
Installation Detailed installation and platform notes
MCP Configuration MCP server setup for each tracker
Tokens API token generation for all 6 supported trackers
Cross-Platform Cross-platform verification checklist
Custom Agents How to write and integrate custom agents
Troubleshooting Common issues and solutions
Reference
Skills All 17 skills — syntax, flags, examples
Agents All 17 agents — role, model, inputs, outputs
Pipelines Pipeline diagrams, hooks, profiles, error handling
Automation Config Config specification with examples and validation rules
Trackers Tracker-specific query syntax, state transitions, validation rules

Roadmap

See the Roadmap for current priorities and future direction.

Contributing

See CONTRIBUTING.md for guidelines on writing custom agents, creating skills, submitting examples, and reporting issues.

Author & License

Filip Sabacky — MIT License

For security vulnerability reports, see SECURITY.md.

Built by Filip Sabacky · CEOS Data

About

Claude Code plugin - automates bug-fix, feature, and scaffold workflows using 17 specialized AI agents

Topics

plugin automation ai pipeline scaffolding agents bug-fix claude-code

Resources

Readme

License

MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

9 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 2

v1.0.1 — CI flake fix + marketplace license restore Latest
May 15, 2026
+ 1 release

Packages

 
 
 

Contributors

Languages