anatomia-dev/anatomia

Anatomia는 Claude Code 및 Codex를 위한 CLI 및 에이전트 하네스 (harness)입니다. 이 도구는 코드베이스를 스캔하여 스택, 컨벤션 (conventions), 패턴을 탐지한 다음, 모든 변경 사항을 범위 (scope), 명세 (spec), 계약 (contract), 빌드 보고서 (build report), 독립적 검증 (independent verification)이라는 다섯 가지 에이전트 파이프라인 (pipeline)을 통해 실행하며 모든 아티팩트 (artifact)를 저장합니다. 다른 하네스들이 프롬프트 라이브러리 (prompt libraries)라면, 이것은 엔진 (engine)을 갖추고 있습니다.

npx anatomia-cli scan .

설치 불필요. 단 하나의 명령어로 실행 가능합니다. 더 많은 예시 보기 →

ana 명령어를 직접 사용하려면 전역 (globally)으로 설치하세요:

npm install -g anatomia-cli

Node.js 22+ 버전이 필요합니다. 업데이트하려면: npm update -g anatomia-cli

ana init # 컨텍스트 (context) + 에이전트 (agents) 생성
ana init commit # git에 영구 저장 (팀원들도 공유 가능)
ana doctor # 설치 상태가 정상인지 확인
...

Ana에게 무엇을 만들고 싶은지 말하세요. Ana는 코드베이스를 조사하고, 트레이드오프 (tradeoffs)를 드러내며, 접근 방식에 문제가 있다면 반대 의견을 제시할 것입니다. 범위 (scope)가 적절해지면 Plan, Build, Verify 단계로 넘깁니다.

init

자동으로 스캔 (scan)을 실행하며 단독으로 작동합니다. 파이프라인 (pipeline)과 설정은 Claude Code 또는 Codex를 통해 실행되며, 스캔 출력물은 마크다운 (markdown) 인식 기능이 있는 모든 AI 도구와 함께 사용할 수 있습니다.

init commit

아티팩트 브랜치 (artifact branch)인 staging, develop, 또는 존재하는 경우 프리 프로덕션 (pre-production) 브랜치에 커밋합니다. 존재하지 않으면 main에 커밋합니다. 첫 번째 커밋을 하기 전에 ana config get artifactBranch로 확인하세요. CLI를 업데이트한 후에는 ana init을 다시 실행하여 스캔 데이터와 스킬 탐지 (skill detection)를 새로고침하세요. 사용자의 규칙 (rules), 컨텍스트 (context), 증명 체인 (proof chain)은 보존됩니다.

ana scan

프로젝트를 읽고 프레임워크 (framework), 데이터베이스 (database), 인증 (auth), 테스트 (testing), 서비스 (services), 컨벤션 (conventions) 및 패턴 (patterns)을 탐지합니다. 모노레포 (monorepos) 환경에서 스캔은 각 서피스 (surface, 패키지 또는 앱)를 식별하고 서피스별 명령어를 탐지합니다. ana init을 다시 실행하면 기존 편집 내용을 덮어쓰지 않고 스캔 데이터를 새로고침합니다.

ana init은 에이전트가 읽을 수 있는 파일에 해당 지능을 기록합니다:

ana.json — 프로젝트 설정: 빌드/테스트/린트 (build/test/lint) 명령어, 서피스 (surfaces), 아티팩트 브랜치 (artifact branch), 브랜치 접두사 (branch prefix). 모든 에이전트와 CLI 명령어는 이 파일을 읽습니다.
scan.json — 에이전트 소비를 위한 전체 구조화된 스캔 데이터
CLAUDE.md

and AGENTS.md

— 도구 간 프로젝트 컨텍스트 (cross-tool project context)

• 스캔 기반의 감지된 섹션 (Detected sections)이 포함된 5개의 핵심 + 3개의 조건부 스킬 템플릿
• 복합 트리거 (compound triggers)가 포함된 16개의 스택별 주의사항 (stack-specific gotchas)

설정 (ana run setup)은 스캔이 감지한 내용과 팀이 알고 있는 내용 사이의 간극을 메워줍니다. 코드베이스를 조사하고, 2~3개의 질문을 던지며, 풍부한 컨텍스트를 작성하는 약 10분 정도의 세션입니다. 설정을 마치면 에이전트는 단순히 스택(stack)뿐만 아니라, 귀하의 제품과 의사결정 사항까지 이해하게 됩니다.

단계 (Stage)	명령어 (Command)	역할 (Role)	생성물 (Produces)
Think	ana run	사고 파트너 (Thinking partner) — 범위 설정, 조사, 조언, 이의 제기	scope.md
Plan	ana run plan	설계자 (Architect) — 설계 + 봉인된 계약 (sealed contract)	spec.md + contract.yaml + plan.md
Build	ana run build	빌더 (Builder) — 명세(spec) 구현, 작동 증명	코드 + 테스트 + build_report.md
Verify	ana run verify	결함 탐지기 (Fault-finder) — 명세와 코드를 읽고, Build의 보고서는 건너뜀	verify_report.md
Learn	ana run learn	증명 분석가 (Proof analyst) — 사이클 사이에 실행	더 강력한 스킬 및 시스템 개선

모든 파이프라인 실행은 증명 체인(proof chain) 항목을 작성합니다. 여기 그 예시가 있습니다:

각 항목은 증명 체인에 추가됩니다. ana proof health는 실행 전반에 걸친 궤적을 추적합니다 — 초도 검증률 (first-pass verification rate), 실행당 리스크, 발견 사항이 집중되는 핫스팟 (hot spots), 그리고 다음에 수정해야 할 사항 등을 포함합니다. 패턴이 반복되면, proof promote는 이를 다음 빌드까지 도달하는 스킬 규칙 (skill rules)으로 변환합니다. proof audit은 활성 발견 사항을 파일별로 그룹화합니다. proof stale은 발견 이후 파일이 변경된 항목을 플래그(flag) 처리합니다.

다음은 직접 실행하게 될 명령어들입니다:

ana scan [path] # 스택, 컨벤션, 패턴 감지
ana init # 컨텍스트 + 에이전트 정의 생성
ana init commit # 인프라를 git에 영구 저장
...

파이프라인 에이전트는 약 20개의 추가적인 CLI 명령어 — 즉, 툴벨트 (toolbelt)를 호출합니다. 에이전트가 아티팩트 (artifact)를 저장할 때, CLI는 그 구조를 검증하고, 콘텐츠 해시 (content hash)를 계산하며, 형식이 잘못된 출력은 거부합니다. 에이전트는 체크 과정을 건너뛸 수 없습니다. 전체 CLI 참조 →

Claude Code 및 Codex를 위한 네이티브 파이프라인 지원.

스캔 출력물 (AGENTS.md, CLAUDE.md)은 마크다운 (Markdown)을 읽는 모든 AI 도구와 함께 작동합니다.

git clone https://github.com/anatomia-dev/anatomia.git
cd anatomia && pnpm install && pnpm build
cd packages/cli && pnpm vitest run

확장 가이드는 CONTRIBUTING.md를, 모듈 맵 (module map)은 ARCHITECTURE.md를 참조하세요.

이 프로젝트는 Anatomia로 구축되었습니다. .ana/ 디렉토리가 그 증거입니다. 모든 기능은 이 도구가 여러분을 위해 설치하는 것과 동일한 파이프라인을 통해 범위가 지정되고, 계획되고, 구축되며, 검증되었습니다.

rm -rf .ana # 모든 Anatomia 데이터
rm .claude/agents/ana*.md # Claude Code 파이프라인 에이전트 (설치된 경우)
rm -rf .codex/agents # Codex 에이전트 매니페스트 (설치된 경우)
...

init에 의해 생성된 스킬 (Skill) 디렉토리는 .ana/skills/ 아래에 위치합니다: coding-standards, testing-standards, git-workflow, deployment, troubleshooting, 그리고 조건에 따라 ai-patterns, api-patterns, data-access가 포함됩니다. init이 생성한 것들은 삭제하고, 직접 추가한 것들은 유지하세요.

만약 Anatomia가 CLAUDE.md를 생성했다면, 그것도 삭제하세요 (git blame CLAUDE.md로 확인 가능). 만약 ana init commit을 실행했다면, 되돌리세요: git revert <commit-hash>. 여러분의 소스 코드는 절대 수정되지 않습니다.

npm uninstall -g anatomia-cli # CLI 제거

MIT