gangjaeyu/harness-loop-fullstack-kor

요구·기술 결정·현재 코드를 연결해 docs/ARCHITECTURE/overview.md에 구성·경계·핵심 흐름·필요한 데이터와 API 계약을 설계하거나 갱신한다.

신고된 결함의 기대 동작과 실패를 재현하고 회귀 검사·최소 수정·영향 검증을 수행한다. 문서나 루프 유무와 관계없이 필요한 범위로 진행하며 BUG 기록과 미검증·재개 근거를 남긴다. 사용자가 'xx가 안 돼', '예전엔 됐는데 이상해', '이 버그 고쳐줘'처럼 제품 동작 결함 수정을 요청하면 코드를 고치기 전에 사용한다. 하네스·루프 실행 문제는 harness-update·loop-update가 다룬다.

기존 코드와 실행 근거를 읽어 사용자가 선택한 현행 요약, PRD·TRD, Architecture 또는 전체 체계 연결 범위를 문서화한다. 기존 문서도 부분 갱신하며 구현과 루프 실행은 요청 범위에 따른다.

기존 프로젝트의 기능 추가·요구 변경을 영향 범위만 계획하고 반영한다. 기존 ID와 완료 이력을 보존하며 실행 요청이면 구현·검증까지 완료한다.

프로젝트의 수용 기준에 맞는 검증 하네스와 로컬 실행 환경을 harness_setup/에 준비한다. 하네스·테스트 파이프라인·로컬 환경을 처음 세팅할 때 사용하며 기존 하네스 갱신은 harness-update로 다룬다.

기존 harness_setup/의 검사·로컬 환경을 현재 코드와 진행 상태에 맞춰 갱신하고 실제 실행으로 확인한다. 검증 수단 누락·낡은 명령·환경 실패·흔들리는 테스트를 다룰 때 사용한다.

모호한 제품 아이디어를 사용자와 질문·선택지로 주고받으며 문제·사용자·가치·범위를 구체화해 docs/IDEA.md에 남긴다. 이미 정한 내용은 다시 묻지 않으며, 무엇을 만들지 이미 명확하면 결과를 보고하고 요구 정의 단계(prd-generator)로 이어 갈지 확인한다.

합의된 목표·권한·예산을 이어받아 loop_setup/LOOP.md에 개발 루프를 준비한다. 루프 세팅 요청을 다루며 Loop 시작이 승인되면 질문 없이 구현·검증·복구·최종 보고까지 이어 간다. 기존 운영 조정은 loop-update로 다룬다. '루프로 완성해줘', '구현까지 진행해줘'처럼 실행을 요청하면 제품 Loop 계약(네 게이트·별도 세션 검증)을 위해 직접 구현하기 전에 사용한다.

기존 loop_setup/LOOP.md를 실제 실행 환경·진행 상태·복구 이력에 맞춰 부분 갱신한다. 실행 수단·병렬 운용·재개 방식·반복 정체를 조정할 때 사용하며 기존 합의와 잔여 예산을 이어받는다.

요구·설계·현재 상태를 기능 단위 태스크와 작은 phase로 나눠 plan_setup/에 계획·상태·기록을 만들거나 갱신한다. 기존 ID와 완료·진행 이력을 보존한다.

아이디어·사용자 설명·기존 프로젝트를 바탕으로 docs/PRD.md에 요구 ID와 관찰 가능한 수용 기준, 자율운영 합의를 작성하거나 필요한 부분을 갱신한다.

동작을 보존하는 코드 정리·의존성 갱신·스택 전환의 범위와 검증을 계획한다. 영향 문서와 필요한 작업만 보완하고 실행 요청이면 구현·검증까지 이어 수행한다.

요구와 기존 환경을 조사해 중요한 기술 선택·근거·검증 수단을 docs/TRD.md에 작성하거나 갱신한다. 상세 모듈·데이터·API 계약은 아키텍처로 연결한다. PRD는 있고 TRD가 없거나 기술 결정이 비어 있는 프로젝트를 '이 플러그인 흐름대로 만들어줘', '설계·계획·루프까지 진행해줘'처럼 구현 준비·완성까지 요청하면 작은 프로젝트도 직접 대신 쓰지 말고 이 스킬부터 사용한다. 기존 TRD의 기술 결정을 바꾸자는 요청('저장 방식을 바꾸자' 등)에도 사용한다.