LGES-OC5-PtoP-Welder/.claude/skills/ubisam-deliverables/references/00-harness.md

00 · 하네스 (호스트 프로젝트 맞물림 설계)

이 스킬이 이미 CLAUDE.md·.claude가 있는 임의의 소스 레포에 들어가 기존 에이전트와 충돌 없이 맞물려 동작하기 위한 계약. SKILL.md가 가장 먼저 참조한다.

비침습 계약 (절대 규칙)

• 읽기만: 호스트의 CLAUDE.md, .claude/, RULES.md, src/·소스코드는 입력으로만 읽는다.
• 쓰기 격리: 모든 생성/수정은 docs/[Ubisam산출물]/ 하위로 한정.
• 우선순위: 호스트 루트 RULES.md/CLAUDE.md > 본 산출물 규칙. 충돌 시 호스트 우선.
• 멱등: 폴더·파일은 "없으면 생성, 있으면 유지". 재실행이 기존 산출물을 덮어쓰지 않는다.

입력 (호스트에서 읽는 진실원)

입력	용도
루트 CLAUDE.md	설비·플랫폼·디바이스·시퀀스 등 프로젝트 사실
소스코드(src/,Machines/ 등)	PLC/모션/IO/Vision 구성, 메인 시퀀스 추출
README*, 설계 문서	보조 컨텍스트
git 원격/폴더명	프로젝트 코드·명 자동 추정

추출 사실 → 산출물 필드 매핑은 07-fill-mapping.md.

데이터 흐름 (호스트 에이전트와 맞물림)

[호스트 CLAUDE.md + 소스] ──읽기──▶ (분석) ──▶ 사실 추출
        │                                         │
        ▼                                         ▼
   docs/[Ubisam산출물]/ 트리 생성 ◀── 매핑(07) ── 산출물 필드 채움
        │
        ▼
   _task.md 진행률 갱신 + [작업일지] 기록

• 스킬은 온디맨드 호출(트리거 문구). 호스트 에이전트 루프를 가로채지 않는다.
• 분석/검색은 호스트 에이전트의 도구(Grep/Read)를 그대로 활용.

프로젝트 자동 인식

1. project_code: git 원격명·폴더명·CLAUDE.md에서 추정 → 실패 시 사용자에게 질문.
2. project_name: CLAUDE.md 제목/설비명에서 추정.
3. 추정값은 _meta/project.yaml에 기록하고 (추정) 표기. 확정 전까지 문서에 (제안) 유지.

트리거 문구

• 생성: "산출물 구조 만들어줘", "Ubisam 트리 스캐폴딩".
• 채움: "설계 산출물 채워줘", "IO 맵 정의서 생성", "프로젝트 분석해서 산출물 채움".
• 갱신: "2.설계 진행률 갱신", "양산 단계 산출물 추가".

안전장치

• 호스트 파일 수정 요청이 들어오면 거부하고 docs/ 내 대안 제시.
• 양식 엑셀은 원본 템플릿 복제 후 값만 덮어써 조건부 서식 보존(06-procedure.md).