iop/AGENTS.md

# 공통 규칙

- **최우선 방향은 검증 게이트 최소화다.** 새 게이트를 만들지 않는 것에 그치지 않고, 기존 게이트도 계속 제거·병합해 최소 개수로 유지한다.
- 차단형 검증 게이트는 보안·자격증명, 데이터 손상·비가역 외부 변경, 사용자가 명시한 실제 프로젝트 간 선행 의존성에만 허용한다. 그 밖의 테스트·문서·승인·정합성·evidence는 차단형 게이트로 만들지 않는다.
- 기존 구조를 우선하고 요청 범위 안에서 가장 작은 변경으로 구현한다.
- 과설계를 금지한다. 새 추상화·문서·상태·검증은 현재 요청에 반드시 필요할 때만 추가한다.
- 테스트·SDD·spec·plan·review·evidence는 필요에 따라 사용하는 산출물이며 서로의 선행 허가 조건으로 자동 연결하지 않는다.
- 코드 변경 전 변경 경로에 대응하는 `agent-ops/rules/project/domain/**/rules.md`만 읽는다.
- `agent-ops/rules/project/rules.md`는 프로젝트 구조나 도메인 매핑 확인이 필요할 때만 읽는다.
- `agent-ops/skills/common/router.md`는 사용자가 Agent-Ops 산출물이나 명시적인 skill workflow를 요청했을 때만 읽는다.
- `agent-ops/rules/common/**`와 `agent-ops/skills/common/**`은 사용자가 직접 지시한 경우에만 수정한다. 프로젝트별 변경은 대응하는 `project/**` 영역을 우선한다.
- 불확실한 제품 결정이 구현에 직접 필요하면 후보와 영향을 제시하고 사용자 결정을 기다린다. 관련 없는 작업까지 잠그지 않는다.
- 최종 답변은 한국어로 한다.

## 필요한 경우에만 읽는 문서

- 로드맵 생성·갱신·상태 확인: `agent-ops/rules/common/rules-roadmap.md`
- agent-spec 생성·갱신 또는 현재 구현 스펙 확인: `agent-ops/rules/common/rules-agent-spec.md`와 매칭되는 spec
- agent-ui 작업: `agent-ops/rules/common/rules-agent-ui.md`
- Agent-Ops 구조·책임 경계 변경: `agent-ops/rules/common/philosophy.md`
- API, wire, runtime call, event/config schema 계약 확인: `agent-contract/index.md`와 매칭되는 계약
- 환경 의존 live/full-cycle 검증을 사용자가 요청했거나 변경 위험상 필요한 경우: 해당 `agent-test/<env>/rules.md`

## 아카이브

- `agent-task/archive/**`, `agent-roadmap/archive/**`, `agent-spec/archive/**`, `agent-ui/**/archive/**`는 일반 작업에서 읽지 않는다.
- 사용자가 과거 작업 확인·복원·비교를 요청했거나 활성 문서가 정확한 evidence 경로를 가리킬 때만 필요한 파일 하나로 범위를 좁혀 읽는다.

## 프로젝트 간 의존성

- 사용자가 Milestone 간 선행 의존성을 명시한 경우에만 `update-roadmap`으로 기록한다.
- 관련성, 권장 순서, 문서 미비, 테스트 미실행은 프로젝트 간 잠금으로 만들지 않는다.

## 테스트

- 기본 검증은 변경한 패키지나 컴포넌트의 가장 작은 관련 테스트다.
- 전체 테스트, E2E, live provider, full-cycle, 외부 CLI 검증은 사용자가 요청했거나 변경이 그 경로를 직접 수정해 국소 테스트로 위험을 확인할 수 없을 때만 수행한다.
- 테스트를 실행할 수 없다는 이유만으로 구현이나 다른 독립 작업을 차단하지 않는다. 수행하지 못한 검증과 남은 위험만 보고한다.