codeaholicguy/ai-devkit

AI DevKit – AI 코드 에이전트를 위한 제어 플레인

무엇인가요 – 로컬에서 실행되는 npm 패키지로, 단일 구성 파일, 터미널 UI, 그리고 재사용 가능한 "스킬"을 제공하여 Claude Code, Gemini CLI, Codex CLI, Cursor, GitHub Copilot 등 여러 AI 기반 코드 보조 도구를 조율합니다. 이는 기반 모델을 대체하지 않으며, 단지 여러 도구가 협업하는 엔지니어 팀처럼 행동하도록 만듭니다.

왜 중요한가요 – 개발자들이 동일한 리포지토리에서 여러 AI 에이전트를 사용하기 시작하면, 워크플로우는 빠르게 혼란스러워집니다: 각 도구마다 별도의 규칙 파일, 메모리, 터미널 창이 있습니다. AI DevKit은 다음과 같은 기능을 제공하는 얇은 "운영 체제" 계층을 추가합니다.

• 모든 에이전트 설정을 하나의 .ai-devkit.json 파일에 통합.
• 실시간 TUI(ai-devkit agent console)에서 모든 실행 중인 세션을 표시.
• 프롬프트, 로그, 또는 stdin을 특정 에이전트 또는 이름이 지정된 그룹으로 라우팅 가능(ai-devkit agent send).
• 로컬 SQLite 지식 기반(@ai-devkit/memory)을 제공하여 에이전트가 프롬프트에 모든 내용을 넣지 않고도 프로젝트 관례를 검색할 수 있게 합니다.
• 세니어 엔지니어 워크플로우를 강제하는 조합 가능한 스킬(dev‑lifecycle, verify, tdd, structured‑debug, security‑review 등)을 제공합니다.

핵심 개념

개념	기능
.ai-devkit.json	모든 에이전트, 그들의 MCP 엔드포인트, 그리고 사용하고자 하는 스킬 스택의 유일한 진실 소스.
에이전트 콘솔	다양한 제공자 간 실시간 에이전트를 목록, 검사, 상호작용할 수 있는 텍스트 기반 대시보드.
agent send	특정 에이전트 또는 이름이 지정된 그룹에 프롬프트, stdin, 또는 테스트 출력을 전송하는 CLI 명령어. 응답을 기다리는 옵션도 있음.
메모리 (@ai-devkit/memory)	결정사항, 관례, 재사용 가능한 수정 사항을 저장하는 로컬 SQLite 저장소. 에이전트는 필요 시 쿼리 가능.
스킬	체인 가능한 작은 플러그인. 주요 dev‑lifecycle는 에이전트를 요구사항 → 설계 → 계획 → 구현 → 테스트 → 리뷰의 흐름으로 안내합니다. 다른 스킬은 검증, 테스트 주도 개발, 디버깅, 보안 검사, 문서화, 코드 단순화를 추가합니다.

일반적인 워크플로우

1. npx ai-devkit@latest init 실행 – 마법사가 .ai-devkit.json과 각 에이전트 폴더(.claude/, .cursor/, …)를 생성하고, 생성된 규칙과 스킬 훅을 설정.
2. 에이전트 시작 (예: claude-code start …).
3. 콘솔 열기: ai-devkit agent console로 모든 세션 확인.
4. ai-devkit agent send "run the tests" --id my‑claude --wait로 에이전트에게 테스트를 실행하고 결과를 보고하도록 요청.
5. 프로젝트 관례 저장: ai-devkit memory store --title "API handlers return DTOs" ….
6. 새로운 기능이 필요할 때 dev‑lifecycle 스킬을 호출. 에이전트는 docs/ai/requirements, design, planning 등에 문서를 생성하고, 각 게이트(검증, 테스트, 리뷰)가 통과할 때까지 코드로 진행하지 않음.

누가 사용해야 하나요 – 하나 이상의 AI 코드 보조 도구에 의존하고 있으며 재현 가능하고 감사 가능한 프로세스를 원하는 팀에게 적합합니다:

• 세션 간 관례를 기억해야 하는 대규모 코드베이스.
• 테스트, 보안 리뷰, 문서화 등 엄격한 품질 게이트가 있는 프로젝트.
• 여러 에이전트를 다루며 통합된 UI와 메시징 계층이 필요한 개발자.

설치 및 빠른 시작

# 한 줄 명령어 – 설정을 생성하고 필요한 구성 요소를 설치
npx ai-devkit@latest init

마법사가 완료된 후 다음 명령어를 사용할 수 있습니다:

• ai-devkit agent list
• ai-devkit agent console
• ai-devkit agent send "review this branch" --group reviewers
• ai-devkit memory store …
• ai-devkit skill add <registry> <skill>로 공개 레지스트리에서 추가 스킬을 가져옵니다.

확장성 – 스킬은 Anthropic, Vercel, Supabase, Microsoft, Google 등 여러 기관에서 공개됩니다. ai-devkit skill add …로 새 스킬을 추가하거나 SDK 가이드라인에 따라 자체 스킬을 작성할 수 있습니다.

라이선스 – MIT, 태레메트리 없음, 완전히 로컬에서 실행.

---

모든 세부 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.