문서

처음이라면 '시작하기'의 문서를 순서대로 읽으세요. 이미 쓰고 있다면 '사용하기'에서 필요한 안내를 고릅니다. 파일 형식과 정확한 동작 규칙, Jaekit 개발 자료는 뒤에 따로 모았습니다. 모든 페이지는 저장소의 Markdown 파일에서 그대로 만들어집니다.

시작하기

Jaekit이 어떤 문제를 푸는지 이해하고, 설치한 뒤 첫 목표를 맡깁니다.

Jaekit 이해하기Jaekit은 Claude Code·Codex에 맡긴 작업이 정말 끝났는지 기록으로 확인하게 해 주는 도구입니다. 에이전트에 더해 쓰는 플러그인 Spec·Seal·Spar와 터미널 프로그램 ha·spar로 이루어집니다. 일을 맡기기 전에 무엇을 하면 끝인지 문서로 정해 두고, 끝났는지는 에이전트의 말이 아니라 검사를…guides/OVERVIEW.md설치 안내Jaekit을 처음 설치하거나, 새 버전으로 업데이트하거나, 제거할 때 읽습니다. Jaekit은 터미널 프로그램 ha·spar와 에이전트 플러그인 Spec·Seal·Spar로 이루어집니다. 프로그램은 brew나 Release 파일로, 플러그인은 Codex나 Claude Code의 플러그인 명령으로 설치하며, 둘 다…guides/INSTALL.mdWSL2 준비 안내Windows에서 Jaekit을 쓰려면 이 문서를 읽습니다. Windows에서 WSL2의 Ubuntu 24.04 LTS amd64(x64) 안에 Jaekit을 설치하는 경로입니다. 실제 WSL2 설치·실행과 에이전트의 Skill 사용은 아직 확인하지 않았습니다. 이 문서는 사용 경로의 준비 상태를 설명하며, WSL2…guides/WSL.md

사용하기

목표를 고치거나 이어 가고, 멈춘 작업과 완료 보고를 읽고, 독립 검토를 준비할 때 찾아봅니다.

사용 안내목표를 고치거나, 대화가 끊긴 뒤 이어 가거나, Seal이 묻는 것에 답하거나, 완료 보고를 읽을 때 찾아보는 문서입니다. 처음이라면 Jaekit 이해하기와 README의 첫 작업 맡기기를 먼저 읽으세요. 앞쪽 여섯 절은 목표 하나를 맡기고 끝까지 가는 순서대로 명령 보내기, 목표를 고치거나 이어 가기, Seal이…guides/USAGE.md작업 상태와 완료 보고 읽기작업이 멈춘 이유를 알고 싶거나, 완료 보고가 무엇을 근거로 하는지 자세히 확인하고 싶을 때 읽습니다. 시작 전 점검, 수정 전 실패가 뜻하는 것, 완료 보고의 근거, 사용자 확인이 필요한 상태(needs_user), 막힘과 예산, 보증 정책을 다룹니다. 처음 쓰는 사람을 위한 호출·재개·문제 해결은 사용 안내에 있…guides/OPERATIONS.mdSpar 독립 검토 안내standard·strict 목표를 처음 맡기기 전에, 또는 리뷰어 설정을 바꾸거나 검토 기록을 읽을 때 읽습니다. Spar는 작업한 에이전트가 놓친 문제를 그 대화 밖의 리뷰어들이 찾게 하는 독립 검토 도구입니다. 리뷰어는 요구사항을 바꾸지 못하고, 찾은 것은 defect, requirement-question,…guides/SPAR.md

파일·기록 형식과 동작 규칙

Jaekit이 읽고 쓰는 목표 문서, 작업 파일, 검사·검토 기록의 형식과, 그 기록으로 상태와 완료를 판단하는 규칙을 정확히 적은 문서입니다. 에이전트에게 일을 맡겨 쓰는 데는 읽지 않아도 됩니다. 기록을 읽는 도구를 만들거나 어떤 동작의 정확한 조건을 확인할 때 찾아봅니다. 저장소의 contracts/ 폴더에 있으며, 문서 제목의 '계약'은 프로그램과 도구가 지키는 이 형식과 규칙을 뜻합니다. 한국어가 원문이고 영어 번역이 함께 있으며, 둘이 다르면 원문을 따릅니다.

문서 13개 보기

형식과 규칙 개요이 묶음의 문서와 각 문서가 다루는 것.contracts/README.md목표 문서 형식 (SPEC.md)Spec이 쓰고 Seal이 읽는 SPEC.md의 절과 완료 조건(AC-n)의 형식.contracts/goal-docs.md실행 묶음 형식 (PLAN·REVIEW·PROGRESS)Seal이 쓰는 PLAN.md·REVIEW.md·PROGRESS.md의 구성과 완료 보고의 형식.contracts/bundle.md실행 기록 형식과 완료 판정 (runs.jsonl)runs.jsonl의 줄 형식, ha 명령, 기록으로 상태와 완료를 계산하는 규칙.contracts/run-record.md검사 선언과 결과 형식change 조건의 검사가 무엇을 확인하는지 선언하고 위반과 통과를 알리는 형식.contracts/check-result.md실행자의 권한과 완료 선언 규칙Seal을 따르는 에이전트가 할 수 있는 일과 완료를 선언하는 규칙.contracts/role-card.md검토 라운드 기록 형식spar run이 남기는 라운드 기록, 지적의 분류와 처리.contracts/review-round.md검토 gate 형식spar gate가 검토가 끝났는지 판단해 쓰는 gate 파일.contracts/review-gate.mdSpar 설정 형식 (spar.toml)리뷰어와 검토 설정을 정하는 spar.toml.contracts/spar-config.mdSpar 입력 형식spar가 받는 입력의 형식과, 형식 밖 입력의 결과.contracts/spar-input.mdha 지원 기능과 호환 확인설치된 ha가 지원하는 기능을 ha capabilities로 확인하는 방법.contracts/core-capabilities.md판단 이력 형식 (선택 기능)ha history로 남기는 관측·원인·결정 같은 판단 이력의 형식.contracts/decision-history.md완료 뒤 발견 기록 형식완료 뒤에 발견한 문제를 원래 완료와 따로 남기는 기록.contracts/findings.md

Jaekit 개발

Jaekit 자체를 빌드하고 고치고 검증할 때 읽습니다. Jaekit을 쓰는 데는 필요 없습니다.

문서 5개 보기

소스 빌드와 개발 등록Jaekit 자체를 고치거나 시험할 때 읽는 문서입니다. Jaekit을 쓰는 데는 필요 없습니다. 쓰려면 설치 안내를 따릅니다.guides/DEVELOPMENT.mdCI 결과 읽기Jaekit 저장소에 변경을 올리거나 그 CI 결과를 해석할 때 읽는 문서입니다. Jaekit을 쓰는 데는 필요 없습니다. CI 워크플로는 PR과 main push에서 실행됩니다. 공통 검사는 Ubuntu에 두고, Ubuntu·macOS·Windows Server에서 필요한 네이티브 검사를 실행합니다. 특정 커밋과…guides/CI.md공통 규칙과 회귀 검사 연결Jaekit의 공통 규칙과 그것을 지키는 회귀 검사의 연결.contracts/regressions.ko.md저장소 검사 도구의 관측 범위Jaekit 저장소의 검사 도구가 무엇을 관측하는지.contracts/repository-producers.mdWindows 네이티브 후보 설치 안내Jaekit 개발에 참여해 Windows 네이티브 후보를 시험할 때 읽는 문서입니다. Windows에서 Jaekit을 쓰려면 WSL2 준비 안내를 봅니다. 이 안내는 Windows 11 x64, Windows PowerShell 5.1·PowerShell 7을 대상으로 두 경로를 다룹니다. 하나는 Windows 파일…guides/WINDOWS.md