iop/agent-ops/rules/common/rules.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 검증은 사용자가 요청했거나 변경이 그 경로를 직접 수정해 국소 테스트로 위험을 확인할 수 없을 때만 수행한다.
• 테스트를 실행할 수 없다는 이유만으로 구현이나 다른 독립 작업을 차단하지 않는다. 수행하지 못한 검증과 남은 위험만 보고한다.