anatomia-dev/anatomia

anatomia은(는) 무엇을 하나요?

Claude Code 및 Codex를 위한 스펙 기반 에이전트 하네스 — 범위, 계획, 구축, 검증, 학습의 5단계 에이전트 파이프라인과 감사 가능한 증명 체인.

개요

Anatomia는 AI 코딩 에이전트(Claude Code, Codex)를 위한 스펙 중심 개발 프레임워크입니다. 자연어 스펙을 입력하면, 일련의 전문화된 에이전트들이 협력하여 코드를 계획하고, 구현하고, 검증하며, 학습 결과를 기록합니다.

주요 기능

• 스펙 기반 개발: 자연어로 요구사항을 정의하고 이를 기반으로 코드를 생성합니다.
• 5단계 파이프라인:
  1. 범위(Scope): 프로젝트 범위와 목표를 명확히 정의합니다.
  2. 계획(Plan): 구현 계획을 수립하고 아키텍처를 설계합니다.
  3. 구축(Build): 계획에 따라 코드를 생성합니다.
  4. 검증(Verify): 생성된 코드를 자동으로 테스트하고 검증합니다.
  5. 학습(Learn): 개발 과정에서 얻은 인사이트를 문서화합니다.
• 감사 가능한 증명 체인: 모든 단계의 결정과 결과가 기록되어 추적 가능합니다.
• 에이전트 간 협업: 각 단계는 전담 에이전트가 처리하며, 결과는 다음 단계로 전달됩니다.

사용 방법

1. 저장소를 클론합니다:

   git clone https://github.com/anatomia-dev/anatomia.git
   cd anatomia
   

2. 환경 변수를 설정합니다 (필요한 경우):

   export ANATOMIA_API_KEY=your_api_key_here
   

3. Claude Code 또는 Codex에서 스킬을 활성화합니다:

   • Claude Code: .claude/settings.json에 스킬 경로를 추가합니다.
   • Codex: Codex 설정에서 스킬을 import합니다.

4. 스펙 파일을 작성합니다 (spec.yaml 또는 spec.md 형식):

   project: my-awesome-app
   description: A web API for managing tasks
   features:
     - Create, read, update, delete tasks
     - User authentication
   

5. 파이프라인을 실행합니다:

   anatomia run spec.yaml
   

파이프라인 상세

1. 범위 (Scope) 에이전트

• 입력: 사용자 스펙
• 출력: 명확한 프로젝트 범위 문서
• 작업: 요구사항 분석, 모호성 해소, 범위 경계 설정

2. 계획 (Plan) 에이전트

• 입력: 범위 문서
• 출력: 상세 구현 계획 (파일 구조, API 설계, 데이터 모델 등)
• 작업: 아키텍처 설계, 작업 분할, 의존성 식별

3. 구축 (Build) 에이전트

• 입력: 구현 계획
• 출력: 실행 가능한 코드
• 작업: 코드 생성, 문서화, 테스트 작성

4. 검증 (Verify) 에이전트

• 입력: 생성된 코드
• 출력: 검증 보고서 (통과/실패 테스트, 코드 리뷰 결과)
• 작업: 테스트 실행, 정적 분석, 스펙 준수 확인

5. 학습 (Learn) 에이전트

• 입력: 전체 파이프라인 결과
• 출력: 학습 기록 (발견된 문제, 해결 방법, 개선 제안)
• 작업: 인사이트 수집, 지식 베이스 업데이트, 피드백 루프 생성

증명 체인 (Proof Chain)

모든 에이전트 단계의 입력, 출력, 결정은 불변의 증명 체인에 기록됩니다. 이 체인은 다음과 같은 정보를 포함합니다:

• 타임스탬프
• 에이전트 ID
• 입력 해시
• 출력 해시
• 결정 근거
• 승인 상태

이를 통해 전체 개발 과정의 감사 가능성과 재현성이 보장됩니다.

지원 플랫폼

• Claude Code: Claude Code의 에이전트 환경에서 완벽하게 동작합니다.
• Codex: OpenAI Codex 플랫폼과 통합 가능합니다.

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여

기여를 환영합니다! 버그 리포트, 기능 제안, 풀 리퀘스트는 GitHub 저장소를 통해 제출해 주세요.