Personal-Agent-Harness

개인 개발 표준과 AI 에이전트 규칙을 프로젝트에 적용하는 하네스입니다.

기본 rules 설치에는 devcontainer와 git-workflow 규칙 도메인이 포함됩니다.

환경 요구사항

| 항목 | 필수 여부 | 용도 | |------|-----------|------| | Node.js 24 LTS | 권장 | npx로 CLI 실행 (최소 22) | | bash 3.2+ | 필수 | CLI 실행 | | jq | 권장 | enforcement hooks 설치 — 없으면 advisory 모드로 동작 | | Claude Code | 권장 | .claude/settings.json hooks 실행 |

jq 없을 때: rules는 정상 설치되고, hooks 설치는 건너뜁니다(WARNING: jq not found 출력). AI가 표준 문서를 자발적으로 읽는 advisory 방식으로만 동작합니다.

jq 설치: brew install jq (macOS) / apt-get install jq (Ubuntu/Debian)

사용법 (npm/npx — 권장)

대상 프로젝트 루트에서 실행합니다. 프로젝트 안에 harness 저장소가 생기지 않습니다.

첫 적용

npx personal-agent-harness init .

업데이트

npx personal-agent-harness@latest update .

검증·상태

npx personal-agent-harness verify .
npx personal-agent-harness status .

자주 쓰는 경우 (글로벌 설치)

npm install -g personal-agent-harness
pah init /path/to/my-project
pah update /path/to/my-project

자세한 내용은 docs/usage.md를 참고하세요.

문서

| 문서 | 내용 | |------|------| | docs/README.md | 전체 문서 목록 | | docs/usage.md | 상세 사용법·고급 옵션·커밋 가이드 | | docs/how-it-works.md | copy mode, managed block, 규칙 우선순위 | | docs/reference.md | pah CLI 레퍼런스, 설치 결과, verify 항목 | | docs/troubleshooting.md | 문제 해결, 백업 복구 |

하네스 개발·배포(git checkout, npm publish 포함)는 docs/development.md를 참고하세요.