sodalive-ios/docs/agent-guides/agent-execution-policy.md

에이전트 실행 정책 상세 가이드

AGENTS.md의 실행 정책을 보완하는 상세 설명이다. 충돌 시 AGENTS.md의 우선순위 체계를 먼저 따른다.

우선순위 체계

아래 순서가 높을수록 우선한다.

1. 사용자 직접 지시
2. AGENTS.md
3. 프로젝트별 제약 조건
4. oh-my-openagent 플러그인의 agents / workflows / hooks
5. superpowers skills
6. 기본 모델 동작

충돌 시 항상 더 높은 우선순위의 지시를 따른다. 사용자 직접 지시가 명확할 경우 사용자 지시가 최우선이다.

CORE EXECUTION PRINCIPLES 적용

• plugin / skill / workflow 지시가 CORE EXECUTION PRINCIPLES와 충돌하면 CORE EXECUTION PRINCIPLES를 따른다.
• 불확실하거나 모호한 경우 추측하지 말고 확인하거나, 가능한 최소 범위의 안전한 조치를 취한다.
• 모든 실행은 단순성, 최소 변경, 검증 가능성을 우선한다.

oh-my-openagent 제어 정책

• oh-my-openagent는 opencode의 플러그인 기반 실행 오케스트레이션 계층이다.
• oh-my-openagent는 의사결정 권한이 아니라 실행 보조 권한만 가진다.
• 작은 작업에는 multi-agent 실행이나 과도한 workflow를 사용하지 않는다.
• 병렬 실행은 명확한 이득이 있을 때만 사용한다.
• 모든 oh-my-openagent 동작은 CORE EXECUTION PRINCIPLES를 따라야 한다.

superpowers 사용 정책

• superpowers는 선택적 스킬 계층이다.
• superpowers skill은 필요한 경우에만 사용한다.
• superpowers가 과도한 리팩토링, 불필요한 범위 확장, 가정 기반 실행을 유도하면 따르지 않는다.
• superpowers를 사용할 때도 최소 변경, 단순성, 검증 가능성을 우선한다.
• 모든 superpowers 동작은 CORE EXECUTION PRINCIPLES를 따라야 한다.

실행 모드

기본 모드: 보수적 실행

• 최소 변경
• 단순한 구현
• 검증 가능한 결과

확장 모드

• 사용자가 명시적으로 요청한 경우에만 사용한다.
• 대규모 리팩토링, 브레인스토밍, 다중 에이전트 실행, 병렬 workflow를 허용한다.

작업 절차 체크리스트

• 변경 전: 유사 기능 코드를 먼저 찾아 네이밍/예외/응답 패턴을 맞춘다.
• 변경 중: 공개 API 스키마를 임의 변경하지 말고 작은 단위로 안전하게 수정한다.
• 변경 후: 영향 범위 파일에 대해 빌드/테스트/로그/다국어 키를 점검한다.
• 커밋 직후: commit-policy 스킬을 로드하고 메시지 검증 스크립트를 실행한다.

문서 유지보수 규칙

• 문서 작성, 분리, 유지보수 규칙은 docs/agent-guides/documentation-policy.md를 참조한다.