sequenzia/agent-alchemy

Claude Code를 구조화된 개발 플랫폼으로 확장하는 플러그인 스위트이자 개발자 툴킷입니다. 사양(specs)부터 작업(tasks), 그리고 자율 실행까지 지원합니다.

Agent Alchemy는 Claude Code를 사용하는 AI 및 소프트웨어 엔지니어를 위한 오픈 소스 툴킷입니다. 이 툴킷은 여섯 개의 플러그인, 실시간 작업 관리자(task manager), 그리고 VS Code 확장 기능을 통해 Claude Code 위에 구조화된 개발 워크플로우를 추가하며, 이 모든 것이 통합 파이프라인으로 함께 작동하도록 설계되었습니다.

모든 것은 Claude Code를 위해 Claude Code로 구축되었습니다. 플러그인들은 일반 마크다운(plain markdown) 형식이며, 다른 코드와 마찬가지로 읽고, 편집하고, 버전 관리할 수 있습니다.

28개의 스킬과 16개의 에이전트를 제공하는 여섯 가지 플러그인 그룹:

Plugin	Description
SDD Tools	Spec-Driven Development — 아이디어를 사양으로, 사양을 작업으로, 작업을 자율 실행으로 변환합니다.
Dev Tools	기능 개발, 코드 리뷰, 아키텍처 패턴, 문서화 및 변경 로그 관리
Core Tools	코드베이스 분석, 다중 에이전트 팀을 통한 심층 탐색, 언어 패턴
TDD Tools	Test-Driven Development — RED-GREEN-REFACTOR 워크플로우, 테스트 생성 및 커버리지 분석
Git Tools	Conventional Commits 자동화
Plugin Tools	플러그인 포팅, 어댑터 검증, 포팅된 플러그인 유지보수 및 에코시스템 건전성 분석

자율 작업 실행을 모니터링하기 위한 Next.js 실시간 칸반 대시보드입니다. 파일 시스템 감지(filesystem watching)와 Server-Sent Events를 통해 작업이 실시간으로 업데이트됩니다.

아래에서 더 많은 스크린샷을 확인하세요

Claude Code 플러그인 개발을 위한 스키마 유효성 검사, YAML 프론트매터 자동 완성 및 호버(hover) 문서화 기능입니다.

• Claude Code CLI 설치 필요
• Node.js >= 18.0.0
• pnpm >= 8.0.0

# Claude Code 마켓플레이스에서 설치
claude plugins install agent-alchemy/agent-alchemy-sdd-tools
claude plugins install agent-alchemy/agent-alchemy-dev-tools
...

pnpm install
pnpm dev:task-manager
# http://localhost:3030 에서 열기

cd extensions/vscode
npm install
npm run build
...

플러그인 동작은 .claude/agent-alchemy.local.md를 통해 구성됩니다.

— key: value 형태의 중첩된 키-값 쌍을 사용하는 마크다운 파일 형식입니다.

이 파일은 버전 관리 시스템에 커밋되지 않습니다.

- deep-analysis:
- direct-invocation-approval: true
- invocation-by-skill-approval: false
...

설정 (Setting)	플러그인 (Plugin)	기본값 (Default)	설명 (Description)
deep-analysis.direct-invocation-approval	core-tools	true	/deep-analysis를 직접 호출할 때 팀 계획에 대한 사용자 승인을 요구합니다.
deep-analysis.invocation-by-skill-approval	core-tools	false	deep-analysis가 다른 스킬(예: /feature-dev, /codebase-analysis)에 의해 로드될 때 승인을 요구합니다.
execute-tasks.max_parallel	sdd-tools	5	웨이브당 최대 동시 작업 실행 에이전트 수입니다. CLI의 --max-parallel이 우선권을 가집니다. 순차적 실행을 원할 경우 1로 설정합니다.
author	sdd-tools	—	spec 기여 및 작업 메타데이터를 위한 작성자 이름입니다.
spec-output-path	sdd-tools	specs/	spec 파일 출력의 기본 디렉토리입니다.

설정은 다음 우선순위 순서(높음 → 낮음)를 따릅니다:

• CLI 인수 (예: --max-parallel)
• .claude/agent-alchemy.local.md
• 설정 (settings)
• 내장 기본값 (Built-in defaults)

Agent Alchemy는 마크다운-코드(markdown-as-code) 철학, 즉

Tier	Model	Use Case
Reasoning	Opus	Synthesis, architecture, review, implementation
...
Component	Technology
---	---
Plugins	Markdown + YAML frontmatter
...

claude/ # Plugins (markdown-as-code)
├── core-tools/ # Analysis & exploration
├── dev-tools/ # Development lifecycle
...

MIT