nexo/agent-ops/rules/common/_templates/test-env-rules-template.md

test_env	last_rule_updated_at
<env>	<YYYY-MM-DD>

테스트 규칙

현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.

공통 규칙

• 테스트/검증은 이 파일을 기준으로 판단한다.
• 작업 완료 검증은 변경 범위 기준으로 선택한다.
• 필수 검증을 실행하지 못하면 차단 사유로 보고한다.
• 최종 보고에는 실행 명령, 결과, 생략 사유, 남은 위험을 남긴다.
• 환경값, secret, 개인 endpoint는 tracked docs/roadmap에 쓰지 않는다.

기본 환경

• host:
• repo root:
• sync 기준:
• runtime:
• package manager:
• external service:
• credential:

프리플라이트

• plan 작성 시 필수 검증이 현재 checkout을 벗어나 원격 runner, 외부 서비스, Docker/code-server, emulator/device, 공유 장기 runtime을 사용하면 먼저 테스트 환경 프리플라이트를 계획에 기록한다.
• 테스트 환경 프리플라이트에는 runner, repo root/workdir, branch/HEAD/dirty 상태, local 변경과 원격 source 동기화 여부, binary/artifact 경로와 필요한 help/version 출력, config path, runtime identity, port/process 상태, 외부 host, OS/arch 가정을 포함한다.
• 프리플라이트에서 dirty/divergent checkout, stale artifact, 잘못된 identity, missing command, closed port, host OS 불일치, source 미동기화가 확인되면 plan은 먼저 setup/sync/rebuild 단계를 만들거나 blocker로 보고한다.

라우팅

• <domain 또는 project-wide> / / <scope 요약>: agent-test/<env>/<test-profile>.md

라우팅 규칙

• 여러 항목이 맞으면 모두 읽는다.
• 도메인 매핑이나 domain rule이 있으면 각 도메인의 <domain>-smoke 문서를 기본 baseline으로 둔다.
• 도메인이 아직 없을 때만 project-smoke를 fallback baseline으로 둔다.
• 도메인/검증 시나리오별 문서는 다른 테스트 문서로 라우팅하지 않는다.