AI 코딩 에이전트에 스펙 기반 프로젝트 워크플로를 제공하는 Agent Skill로, PRD를 에픽과 GitHub Issues로 전환하고 Git worktree에서 병렬 실행을 지원합니다.
m0n0x41d/haft
AI 코딩 에이전트에 문제, 비교한 선택지, 사람의 결정, 근거와 최신성 정보를 오래 유지하는 프로젝트 메모리를 제공하는 로컬 거버넌스 계층입니다.
- 스타
- 1,395
- 포크
- 103
- 열린 이슈
- 14
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
Haft는 Claude Code와 Codex 같은 AI 코딩 에이전트를 위한 로컬 거버넌스 계층입니다. 프로젝트가 해결하려는 문제, 비교한 선택지, 사람이 내린 결정과 이를 뒷받침하는 근거를 저장합니다. 작고 되돌릴 수 있는 추론은 채팅에 남겨 두고, 이후 작업이 의존하는 결과는 로컬 .haft/ 아티팩트 그래프에 타입이 지정된 프로젝트 기록으로 저장할 수 있습니다.
Haft는 First Principles Framework(FPF)를 기반으로 만들어졌습니다. 버전이 지정된 FPF 소스를 에이전트의 작업 컨텍스트에 가져오고, 프로젝트 로컬 스킬, MCP 게이트, SQLite 기반 메모리를 추가합니다. 커널은 필수 필드와 패리티 간극을 서버 측에서 검증하며, 근거는 시간이 지나면서 효력이 낮아져 오래된 주장과 코드 드리프트를 검토 대상으로 드러냅니다. 에이전트는 기록의 초안을 만들고 비교하고 준비할 수 있지만, 구속력 있는 결정과 실행 위임은 반드시 사람 운영자가 해야 합니다.
이 도구는 스킬, CLI(haft artifact, haft decision, haft spec 등), MCP 서버(haft serve)를 통해 사용합니다. 안정적으로 지원하는 호스트로 Claude Code와 Codex용 init 통합을 제공하며, Cursor, Gemini CLI 등은 실험적 또는 레거시 어댑터로 분류되어 있습니다.
핵심 기능
- 01문제, 비교한 선택지, 결정, 근거를 타입이 지정된 프로젝트 기록으로 저장
- 02필수 필드, 패리티 간극, 누락된 근거를 커널 측에서 MCP로 검증
- 03오래된 주장과 드리프트를 검토 대상으로 표시하는 근거 최신성 저하 기능
- 04파일이나 심볼을 관장하는 결정을 보여 주는 코드 그래프 쿼리
- 05FPF 소스에 특화된 쿼리, 조회, 검사 명령
- 06관리형 지침 섹션을 포함한 Claude Code 및 Codex용 init 통합
활용 사례
- 나중 작업에서 참고할 수 있도록 아키텍처 선택의 이유를 기록
- 여러 가설을 병렬로 검토해 장애 원인을 파악하고 결과를 인계용으로 보존
- 과거의 기술적 결정이 현재 측정값에도 여전히 유효한지 확인
- AI 지원으로 공유 코드베이스를 변경할 때 명시적인 사람의 권한과 연결
빠른 시작
- 1
README에 있는 공식 설치 스크립트를 실행합니다
- 2
에이전트용으로 프로젝트를 초기화합니다(Claude Code 예시가 표시되어 있습니다. 다른 호스트는 README를 참조하세요)
haft init --claude - 3
코딩 에이전트를 다시 시작하거나 다시 연결한 다음 평소처럼 사용하고 필요할 때 /h-reason을 호출합니다
사용 전 알아둘 점
- 라이선스가 명확하게 확인되지 않았습니다(메타데이터에는 NOASSERTION으로 표시됨). 사용하기 전에 저장소의 라이선스를 확인하세요.
- 안정적으로 지원되는 호스트는 Claude Code와 Codex뿐입니다. 다른 에이전트 통합은 실험적이거나 레거시입니다.
- 선택 사항인 임베딩 사이드카는 메모리가 충분히 올라온 상태에서 약 1~2GB의 RAM을 사용할 수 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- haft은(는) 무엇인가요?
- AI 코딩 에이전트에 문제, 비교한 선택지, 사람의 결정, 근거와 최신성 정보를 오래 유지하는 프로젝트 메모리를 제공하는 로컬 거버넌스 계층입니다. Haft는 Claude Code와 Codex 같은 AI 코딩 에이전트를 위한 로컬 거버넌스 계층입니다. 프로젝트가 해결하려는 문제, 비교한 선택지, 사람이 내린 결정과 이를 뒷받침하는 근거를 저장합니다. 작고 되돌릴 수 있는 추론은 채팅에 남겨 두고, 이후 작업이 의존하는 결과는 로컬 .haft/ 아티팩트 그래프에 타입이 지정된 프로젝트 기록으로 저장할 수 있습니다.
- haft은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- haft은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- haft은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. haft의 마지막 커밋은 2026년 9월 28일입니다.
- haft은(는) 어디에 사용할 수 있나요?
- 나중 작업에서 참고할 수 있도록 아키텍처 선택의 이유를 기록 여러 가설을 병렬로 검토해 장애 원인을 파악하고 결과를 인계용으로 보존 과거의 기술적 결정이 현재 측정값에도 여전히 유효한지 확인 AI 지원으로 공유 코드베이스를 변경할 때 명시적인 사람의 권한과 연결
- haft는 어떻게 설치하나요?
- README에 있는 공식 설치 스크립트를 실행합니다 에이전트용으로 프로젝트를 초기화합니다(Claude Code 예시가 표시되어 있습니다. 다른 호스트는 README를 참조하세요): haft init --claude 코딩 에이전트를 다시 시작하거나 다시 연결한 다음 평소처럼 사용하고 필요할 때 /h-reason을 호출합니다
- haft은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/m0n0x41d/haft
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code, Codex, Cursor 같은 AI 코딩 에이전트에 요구사항, 설계, 작업, 자율 구현을 아우르는 명세 기반 개발 워크플로를 Agent Skills로 설치합니다.
Claude Code, Cursor, OpenCode, Codex 같은 AI 코딩 에이전트에 지속 메모리, 공통 워크플로, 스킬, MCP 서버를 설정합니다.
Claude Code와 Codex 코딩 에이전트 세션 여러 개를 나란히 실행하고, 실시간 상태와 사이드바 내 승인 기능을 제공하는 macOS 네이티브 터미널 앱입니다.
검토 후 프로젝트에 로컬 하네스를 설치하는 CLI로, 18개 AI 코딩 어시스턴트용 스킬, 규칙, 훅, 지식 문서를 제공합니다.
Claude Code, Codex 및 기타 코딩 에이전트에서 에이전트, 스킬, 훅, 메모리와 보안 검사를 공유하는 플러그인 기반 하네스입니다.