README
¶
Jaekit
AI에게 맡긴 일, 무엇을 확인하고 끝냈는지 보세요.
설치 · 사용 예시 · 사용 안내
한국어 · English
Jaekit은 Claude Code·Codex로 프로젝트 작업을 하는 사람을 위한 도구입니다. Spec은 요청을 목표와 완료 조건으로 정리합니다. Seal은 에이전트가 그 목표에 따라 구현·검사·수정을 이어 가도록 합니다. 결과와 확인 기록을 함께 받고, 대화가 끊겨도 저장된 진행 상황에서 이어 갈 수 있습니다.
현재 배포판은 v0.1.2, 실제 작업에 써 보며 다듬는 초기 개발 단계입니다.
사용 흐름
Spec이 쓴 목표를 읽고 고칠 것이 있으면 말합니다. 준비되면 별도의 시작 요청으로 Seal에 맡깁니다. 매 작업마다 승인할 필요는 없으며, 결과를 바꾸는 결정이 필요할 때 답하면 됩니다. 대화가 끊겼다면 같은 목표를 지정해 이어 갑니다.
완료는 필수 완료 조건을 검사 기록과 필요한 사용자 확인으로 충족했다는 뜻입니다. 자동 검사는 에이전트가 작성하므로 결과 전체의 무결함이나 제3자의 보증을 뜻하지는 않습니다. 완료 보고와 실제 결과를 함께 확인합니다(완료 보고 읽기).
가상 사용 예시
요청 예시: “로그인 화면에 비밀번호 찾기 링크를 추가해줘.” 비밀번호 재설정 페이지는 이미 있는 가상의 프로젝트를 생각해 봅니다.
Spec은 새 링크가 기존 재설정 페이지로 연결되고, 로그인은 이전처럼 동작한다는 목표를 정리한 뒤 멈춥니다. 내용을 확인하고 Seal을 따로 시작하면, 에이전트가 링크를 추가하고 이 두 조건을 검사합니다.
위 그림은 사용법을 설명하기 위해 만든 가상 화면입니다. 실행 결과나 검증을 마친 사례가 아닙니다. 실제 작업에서는 완료 보고의 조건별 검사 결과를 읽고, 링크와 로그인을 직접 확인합니다. 그림 설명과 수정 방법
시작하기
설치
macOS에서 Claude Code로 시작하는 순서입니다. 먼저 Homebrew(프로그램 설치 도구), Git(파일 변경 이력 관리 도구), Claude Code가 필요합니다. 작업할 프로젝트도 Git으로 관리하는 폴더여야 합니다. 터미널은 명령을 입력해 프로그램을 실행하는 앱입니다.
Codex 사용자는 Codex 설치로, Linux 또는 Homebrew 없이 설치하려면 설치 안내로 갑니다. Jaekit 저장소를 복사해 올 필요는 없습니다.
Windows에서는 기록 도구 ha(Seal Core)가 지원되지 않아 Seal을 쓸 수 없습니다. Spec은 ha가 필요 없지만, Windows에서의 설치와 동작은 아직 확인하지 않았습니다.
-
터미널에서 기록 도구
ha를 설치합니다. 블록을 하나씩 실행하고 끝날 때까지 기다립니다.brew install jgoneit/tap/jaekit설치가 끝나면 버전을 확인합니다.
ha --versionha 0.1.2이 나와야 합니다. 다르게 나오거나 명령을 못 찾으면 버전 확인을 봅니다. -
같은 터미널에서 Claude Code에 두 플러그인을 설치합니다. 플러그인은 에이전트에 기능을 더하는 구성입니다.
claude plugin marketplace add jgoneit/jaekit#v0.1.2 claude plugin install spec@jaekit claude plugin install seal@jaekit#v0.1.2은 사용할 버전을 고정합니다. Claude Code를 새로 열면/spec과/seal을 쓸 수 있습니다. 기존 설치가 있다면 업데이트나 이전 로컬 설치에서 전환을 먼저 봅니다.
첫 작업 맡기기
작업할 프로젝트 폴더에서 Claude Code를 열고 에이전트 대화에 보냅니다. 다음은 터미널 명령이 아닙니다.
/spec 로그인 화면에 "비밀번호 찾기" 링크를 추가해줘
Spec이 알려 준 목표 문서를 읽고, 질문에 답하거나 고칠 것을 말합니다. 그다음 별도의 메시지로 시작합니다. 아래 <goal>은 그대로 입력하는 글자가 아니라 Spec이 알려 준 목표 폴더 이름으로 바꿀 자리입니다.
/seal docs/specs/<goal>
Codex에서는 대화에 $를 입력해 spec:spec 또는 seal:seal을 고릅니다. 호출 방법과 이어 가기에 두 도구의 명령과 재개 방법이 있습니다.
자세히 알아보기
- 쓰다가 막혔을 때: 사용 안내와 문제 해결
- 다른 환경이나 기존 설치: 설치 안내 · 업데이트 · 제거
- 결과와 기록을 살펴볼 때: 완료 보고·저장되는 파일 · 자세한 운영 규칙
- 명령과 기록 형식이 필요할 때: 실행 기록 계약
- 써 본 경험을 남길 때: 사용 보고 또는 설치·버그 issue
issue는 공개됩니다. 맡긴 일과 결과, 막힌 점을 요약하고 회사 코드·내부 이름·비밀 값·로그 원문은 제외해 주세요.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
ha
command
Command ha is Seal Core: it runs verification commands without a shell, appends the run record, computes goal state deterministically, and records completion.
|
Command ha is Seal Core: it runs verification commands without a shell, appends the run record, computes goal state deterministically, and records completion. |
|
internal
|
|
|
bundle
Package bundle reads the execution bundle (contracts/bundle.md) of a goal directory and lints it against the goal documents.
|
Package bundle reads the execution bundle (contracts/bundle.md) of a goal directory and lints it against the goal documents. |
|
diag
Package diag holds the lint problem type shared by the goal document and execution bundle parsers.
|
Package diag holds the lint problem type shared by the goal document and execution bundle parsers. |
|
gitx
Package gitx calls the user's git CLI with explicit argv.
|
Package gitx calls the user's git CLI with explicit argv. |
|
goaldocs
Package goaldocs reads goal documents (contracts/goal-docs.md) as a reader: SPEC.md, the auxiliary documents it links inside the goal directory, the criterion IDs, and the optional work breakdown proposal.
|
Package goaldocs reads goal documents (contracts/goal-docs.md) as a reader: SPEC.md, the auxiliary documents it links inside the goal directory, the criterion IDs, and the optional work breakdown proposal. |
|
markdown
Package markdown reads the small Markdown subset that the Jaekit contracts rely on: headings, pipe tables, list items, inline code spans, and relative links.
|
Package markdown reads the small Markdown subset that the Jaekit contracts rely on: headings, pipe tables, list items, inline code spans, and relative links. |
|
record
Package record reads and appends the run record `runs.jsonl` (contracts/run-record.md, schema run/v1).
|
Package record reads and appends the run record `runs.jsonl` (contracts/run-record.md, schema run/v1). |
|
run
Package run executes a verification command as argv, without a shell, and keeps its combined output in a local log file.
|
Package run executes a verification command as argv, without a shell, and keeps its combined output in a local log file. |
|
status
Package status computes the state of a goal from the run record, the execution bundle, and git (contracts/run-record.md §3–§5).
|
Package status computes the state of a goal from the run record, the execution bundle, and git (contracts/run-record.md §3–§5). |