260806_01_ENH: Agent Harness 연동 추가

This commit is contained in:
2026-08-06 17:03:20 +09:00
parent 976dcbb06e
commit 1775417630
16 changed files with 632 additions and 6 deletions

View File

@@ -34,6 +34,17 @@ npx @kri/create-next-app survey-front --yes
주요 옵션은 `--help`로 확인합니다.
Agent Harness 관련 기본값과 옵션:
```text
--project-type <type> requested-project|internal-service|shared-service
--agent-project-id <id> 하네스 프로젝트 ID (기본: 프로젝트명 slug)
--harness-root <path> 중앙 Agent Harness 저장소 경로
--skip-agent-compose 하네스 자동 등록·합성·검증 생략
```
`--yes` 사용 시 프로젝트 유형은 `requested-project`입니다.
## 생성 과정
1. 표준 템플릿 복사
@@ -42,9 +53,22 @@ npx @kri/create-next-app survey-front --yes
4. KRI UI Registry 9개 항목 설치
5. TypeScript 검사
6. Next.js production build
7. Agent Harness 로컬 등록, `AGENTS.md`/`CLAUDE.md` 합성 및 검증
UI Registry: `https://ui-registry.kric.com/r`
## Agent Harness
생성 프로젝트에는 `.agent/profile.yml`, `.agent/project.md`, `.gitattributes`가 항상 포함됩니다.
중앙 하네스는 다음 순서로 탐색합니다.
1. `--harness-root`
2. `KRI_AGENT_HARNESS_ROOT` 환경변수
3. 생성 경로의 상위 디렉터리
하네스를 발견하면 프로젝트를 `workspace.local.yml`에 등록하고 `compose`, `verify`를 실행합니다. 하네스를 찾지 못해도 프로젝트 생성은 완료되며, 이 경우 `.agent` 원본을 중앙 하네스에서 나중에 등록·합성해야 합니다.
## 생성되는 환경 파일
`.env`, `.env.local`, `.env.development`, `.env.production`, `.env.example`을 생성합니다. `.env.local`과 `.env`는 기본적으로 Git에서 제외되며, `.env.development`와 `.env.production`은 Jenkins 빌드에 사용할 수 있도록 추적 가능합니다.