asysta-act/agent-flow

v1.0.0— 최초 공개 릴리스. GitHub에서 보기

버그 처리부터 수정, 검토, 테스트, 배포에 이르는 전체 개발 수명 주기를 자동화하는 Claude Code 플러그인입니다. 17개의 전문 AI 에이전트, 17개의 오케스트레이션 스킬, 17개의 핵심 계약(core contracts)을 가지며 의존성이 없습니다.

graph LR
User["User<br/><code>/fix-bugs</code> · <code>/implement-feature</code> · <code>/scaffold</code>"]
subgraph Plugin["agent-flow Plugin"]
...

버그 수정 파이프라인(Bug-fix pipeline)— 이슈 추적기에서 쿼리하여 분류(Triage), 분석, 수정, 검토, 테스트 및 배포까지 완전히 자동화됩니다. 특징 구현 파이프라인(Feature pipeline)— 명세 추출, 아키텍처 설계, 작업 분해, 구현, 검토, 테스트 및 배포 과정을 거칩니다. 프로젝트 스캐폴딩(Project scaffolding)— 자연어로 프로젝트를 설명하면 명세서, 빌드 가능한 골격(skeleton), 그리고 테스트가 포함된 완전히 구현된 기능들을 얻을 수 있습니다. 전체 자동화를 위해 --yolo를 사용하거나 단계별 디버깅을 위해 --step-mode를 사용할 수 있습니다.

17개의 전문 에이전트— 각 에이전트는 정의된 역할, 모델 할당(opus/sonnet/haiku), 그리고 제약 조건을 가집니다. 읽기 전용 분석가(Read-only analysts)는 코드에 접근하지 않으며, 실행 에이전트(execution agents)만 변경을 수행합니다. 의존성 없음— 순수한 마크다운 정의로 이루어져 있습니다. 빌드 시스템, 런타임, 패키지 매니저가 필요 없습니다. macOS, Linux, Windows에서 작동하며 (Windows에서는 Git Bash 필수).

# 1. 마켓플레이스 추가
/plugin marketplace add asysta-act/agent-flow
# 2. 플러그인 설치
...

/onboard 위자드는 이슈 추적기, 소스 제어(source control), PR 규칙, 빌드 명령어 설정 과정을 안내합니다. 수동으로 복사-붙여넣기가 필요 없습니다.

agent-flow가 처음이신가요? 전체 워크스루를 보려면 Getting Started 튜토리얼을 확인하세요.

flowchart TD
Query["Issue Tracker Query"] --> Triage
Triage["Analyst (--phase triage)<br/><i>sonnet</i>"]
...

flowchart TD
Query["Issue Tracker Query"] --> Spec["Spec Analyst<br/><i>sonnet</i>"]
Spec --> Arch["Architect<br/><i>opus</i>"]
...

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>"]
...

--no-implement 사용 시

: 인프라 선언 (Infrastructure Declaration) → 스캐폴더 (Scaffolder, 스택 플래그 포함) → 검증 (Validate) → Git 초기화 및 푸시 (Git Init + Push) (스켈레톤만 생성, 구현 제외).

훅 통합 지점 (Hook integration points: pre-fix, post-fix, pre-publish, post-publish) 및 파이프라인 프로필 (pipeline profiles)을 지원합니다. 자세한 내용은 파이프라인 참조 (Pipeline Reference)를 확인하세요.

명령 (Command)	설명 (Description)
`/analyze-bug ISSUE-ID`	이슈 트래커(issue tracker)에서 버그 분석 (트리아지(triage) + 영향도 분석, 코드 변경 없음)
`/fix-bugs <ISSUE-ID>` 또는 `/fix-bugs --batch <N>`	이슈 분석 및 수정 — 단일 티켓 (<ISSUE-ID>) 또는 배치 (--batch <N>)
`/implement-feature ISSUE-ID`	기능 파이프라인 (Feature pipeline) — 명세(spec), 설계(design), 수정(fix), 리뷰(review), 테스트(test), 게시(publish)
`/scaffold`	처음부터 새로운 프로젝트 생성; 기존 프로젝트를 확장하려면 'add <component>' 사용
`/publish`	PR 생성 및 이슈 트래커 상태 업데이트 (브랜치 이름을 통해 PR 전용인지 전체 게시인지 자동 감지)
`/check-setup`	자동화 설정 (Automation Config), MCP 서버, 토큰 검증
`/onboard`	자동화 설정 (Automation Config) 생성을 위한 대화형 위저드 (Interactive wizard)
`/changelog`	병합된 PR로부터 변경 로그 (changelog) 생성
`/version-check`	설치된 플러그인 버전을 최신 버전과 비교
`/metrics`	파이프라인 분석 보고서 — 성공률, 에이전트별 효과성
`/prioritize`	AI 백로그 우선순위 지정 — 영향도, 리스크, 노력 점수 산정
`/create-backlog`	명세(specification)로부터 이슈 트래커에 백로그 에픽(backlog epics) 생성
`/sprint-plan`	역량 제약(capacity constraints) 및 우선순위 순위를 고려한 스프린트 계획
`/setup-mcp`	개발 환경 설정 — MCP 서버, 토큰, 권한
`/discuss`	멀티 에이전트 토론 (Multi-agent discussion) — 2~3개의 에이전트가 각자의 전문 지식으로 응답 후 종합(synthesis)
`/setup-agents`	프로젝트 스캐너 — 모든 에이전트를 위한 스마트 TOML 커스텀 기본값 생성
`/autopilot`

cron / batch / CI를 위한 헤드리스 디스패처 (Headless dispatcher) — Bug/Feature 쿼리를 읽고, fix-bugs / implement-feature를 실행합니다.

모든 스킬은 네임스페이스(namespaced) 처리됩니다: /agent-flow:<skill>

대부분의 스킬은 추가 플래그 (--dry-run, --profile <name>, --decompose)를 지원합니다.

전체 구문, 플래그 및 예시: Skills Reference

팁: Claude Code의 내장 명령과 충돌을 피하기 위해 항상 네임스페이스 형태인 /agent-flow:<skill>를 사용하세요.

에이전트 (Agent)	모델 (Model)	역할 (Role)
analyst	sonnet	분류(Triage) 및 영향 분석(impact analysis) — `--phase triage` (심각도, AC) 또는 `--phase impact` (영향을 받는 파일, 콜 그래프)
...

에이전트 상세 정보, 입력, 출력 및 출력 예시: Agents Reference

이 플러그인을 사용하는 프로젝트는 CLAUDE.md 파일에 ## Automation Config 섹션이 필요합니다. /agent-flow:onboard를 사용하여 대화형으로 이를 생성할 수 있습니다.

섹션 (Section)	목적 (Purpose)
Issue Tracker	트래커 유형, 인스턴스, 프로젝트, 쿼리, 상태 전환
...

18개의 선택적 설정 섹션은 재시도 제한(retry limits), 모듈 문서(module docs), 훅(hooks), 커스텀 에이전트(custom agents), 알림(notifications), 워크트리(worktrees), E2E 테스트(E2E testing), 브라우저 검증(browser verification), 로컬 배포(local deployment), 스프린트 계획(sprint planning), 에러 처리(error handling), 기능 워크플로(feature workflow), 분해(decomposition), 파이프라인 프로필(pipeline profiles), 메트릭(metrics), 에이전트 재정의(agent overrides), 일시 중지 제한(pause limits)을 다룹니다.

최소 예시:

## Automation Config
### Issue Tracker
| Key | Value |
...

예시를 포함한 전체 사양: Automation Config Reference. 표준 계약 정의(Canonical contract definition): CLAUDE.md.

커스텀 에이전트 작성, 기술 생성, 예시 제출 및 이슈 보고에 관한 가이드라인은 CONTRIBUTING.md를 참조하세요.

Filip Sabacky — MIT License

보안 취약점 보고는 SECURITY.md를 참조하세요.

Built by Filip Sabacky · CEOS Data

asysta-act/agent-flow

요약

핵심 포인트

댓글