36 lines
2.8 KiB
Text
36 lines
2.8 KiB
Text
# 공통 규칙
|
|
|
|
- 기존 구조로 요청 범위만 가장 작게 고친다.
|
|
- 문제를 검증·승인·상태 추가로 우회하지 않고 원인을 직접 고친다.
|
|
- 유효한 요청의 성공을 막는 추가 검증은 보안·자격증명, 데이터 손상·비가역 변경, 사용자가 명시한 외부 의존성을 보호할 때만 둔다.
|
|
- 코드 변경 전 변경 경로에 대응하는 `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 검증은 사용자가 요청했거나 변경이 그 경로를 직접 수정해 국소 테스트로 위험을 확인할 수 없을 때만 수행한다.
|
|
- 테스트를 실행할 수 없다는 이유만으로 구현이나 다른 독립 작업을 차단하지 않는다. 수행하지 못한 검증과 남은 위험만 보고한다.
|