diff --git a/docs/ouroboros/50_tpm_control_protocol.md b/docs/ouroboros/50_tpm_control_protocol.md index 7d86da3..4e53fad 100644 --- a/docs/ouroboros/50_tpm_control_protocol.md +++ b/docs/ouroboros/50_tpm_control_protocol.md @@ -17,11 +17,16 @@ Updated: 2026-02-26 - Main Agent: 최종 취합/우선순위/승인 게이트 오너 - PM Agent: 시나리오/요구사항/티켓 관리 -- TPM Agent: PM-Dev-검증 간 구현 가능성/달성률 통제 +- TPM Agent: PM-Dev-검증 간 구현 가능성/달성률 통제, 티켓 등록 및 구현 우선순위 지정 오너 - Dev Agent: 구현 수행, 블로커 발생 시 재계획 요청 - Verifier Agent: 문서/코드/테스트 산출물 검증 - Runtime Verifier Agent: 실제 동작 모니터링, 이상 징후 이슈 발행, 수정 후 이슈 클로즈 판정 +Main Agent 아이디에이션 책임: +- 진행 중 신규 구현 아이디어를 별도 문서에 누적 기록한다. +- 기록 위치: [70_main_agent_ideation.md](./70_main_agent_ideation.md) +- 각 항목은 `IDEA-*` 식별자, 배경, 기대효과, 리스크, 후속 티켓 후보를 포함해야 한다. + ## Main Decision Checkpoints (Mandatory) - DCP-01 범위 확정: Phase 0 종료 전 Main Agent 승인 필수 @@ -140,6 +145,11 @@ Control checks: - Main Agent 승인 없는 재계획은 실행 금지 - 재계획 반영 시 문서(`REQ/TASK/TEST`) 동시 갱신 필수 +TPM 티켓 운영 규칙: +- TPM은 합의된 변경을 이슈로 등록하고 우선순위(`P0/P1/P2`)를 지정한다. +- PR 본문에는 TPM이 지정한 우선순위와 범위가 그대로 반영되어야 한다. +- 우선순위 변경은 TPM 제안 + Main Agent 승인으로만 가능하다. + ## Runtime Verification Protocol - Runtime Verifier는 테스트 통과 이후 실제 동작(스테이징/실운영)을 모니터링한다. @@ -150,6 +160,15 @@ Control checks: - Dev 수정 완료 + Verifier 재검증 통과 + Runtime Verifier 재관측 정상 - 최종 클로즈 승인자는 Main Agent +## Session Exception: No-Merge Flow (This Session Only) + +- 이번 세션에서는 절차상 `PR 머지` 단계만 제외한다. +- 허용 범위: + - 리뷰어 피드백 -> 개발 논의/수정 -> 검증 승인 코멘트 -> 서버 PR 반영 +- 금지 범위: + - 검증 승인 후 자동/수동 머지 실행 +- 머지 판단은 사용자 수동 검토 후 결정한다. + ## Acceptance Matrix (PM Scenario -> Dev Tasks -> Verifier Checks) | PM Scenario | Requirement Coverage | Dev Tasks (Primary) | Verifier Checks (Must Pass) | diff --git a/docs/ouroboros/60_repo_enforcement_checklist.md b/docs/ouroboros/60_repo_enforcement_checklist.md index e1a21c6..de47cef 100644 --- a/docs/ouroboros/60_repo_enforcement_checklist.md +++ b/docs/ouroboros/60_repo_enforcement_checklist.md @@ -86,3 +86,9 @@ Updated: 2026-02-26 - Dev가 `REPLAN-REQUEST` 발행 시 TPM 심사 없이는 스코프/일정 변경 금지 - `REPLAN-REQUEST`는 Main Agent 승인 전 \"제안\" 상태로 유지 - 승인된 재계획은 `REQ/TASK/TEST` 문서를 동시 갱신해야 유효 + +## 9) 세션 예외 규칙 (No-Merge Session) + +- 본 세션에서는 검증 승인 이후 `PR 머지`를 실행하지 않는다. +- 서버 반영은 `브랜치 푸시 + PR 코멘트(리뷰/논의/검증승인)`까지로 제한한다. +- 사용자 수동 승인 전 `tea pulls merge` 실행 금지. diff --git a/docs/ouroboros/70_main_agent_ideation.md b/docs/ouroboros/70_main_agent_ideation.md new file mode 100644 index 0000000..addd4e3 --- /dev/null +++ b/docs/ouroboros/70_main_agent_ideation.md @@ -0,0 +1,48 @@ + + +# 메인 에이전트 아이디에이션 백로그 + +목적: +- 구현 진행 중 떠오른 신규 구현 아이디어를 계획 반영 전 임시 저장한다. +- 본 문서는 사용자 검토 후 다음 계획 포함 여부를 결정하기 위한 검토 큐다. + +운영 규칙: +- 각 아이디어는 `IDEA-*` 식별자를 사용한다. +- 필수 필드: 배경, 기대효과, 리스크, 후속 티켓 후보. +- 상태는 `proposed`, `under-review`, `accepted`, `rejected` 중 하나를 사용한다. + +## 아이디어 목록 + +- `IDEA-001` (status: proposed) + - 제목: Kill-Switch 전역 상태를 프로세스 단일 전역에서 시장/세션 단위 상태로 분리 + - 배경: 현재는 전역 block 플래그 기반이라 시장별 분리 제어가 제한될 수 있음 + - 기대효과: KR/US 병행 운용 시 한 시장 장애가 다른 시장 주문을 불필요하게 막는 리스크 축소 + - 리스크: 상태 동기화 복잡도 증가, 테스트 케이스 확장 필요 + - 후속 티켓 후보: `TKT-P1-KS-SCOPE-SPLIT` + +- `IDEA-002` (status: proposed) + - 제목: Exit Engine 입력 계약(ATR/peak/model_prob/liquidity) 표준 DTO를 데이터 파이프라인에 고정 + - 배경: 현재 ATR/모델확률 일부가 fallback 기반이라 운영 일관성이 약함 + - 기대효과: 백테스트-실거래 입력 동형성 강화, 회귀 분석 용이 + - 리스크: 기존 스캐너/시나리오 엔진 연동 작업량 증가 + - 후속 티켓 후보: `TKT-P1-EXIT-CONTRACT` + +- `IDEA-003` (status: proposed) + - 제목: Runtime Verifier 자동 이슈 생성기(로그 패턴 -> 이슈 템플릿 자동화) + - 배경: 런타임 이상 리포트가 수동 작성 중심이라 누락 가능성 존재 + - 기대효과: 이상 탐지 후 이슈 등록 리드타임 단축, 증적 표준화 + - 리스크: 오탐 이슈 폭증 가능성, 필터링 룰 필요 + - 후속 티켓 후보: `TKT-P1-RUNTIME-AUTO-ISSUE` + +- `IDEA-004` (status: proposed) + - 제목: PR 코멘트 워크플로우 자동 점검(리뷰어->개발논의->검증승인 누락 차단) + - 배경: 현재 절차는 강력하지만 수행 확인이 수동 + - 기대효과: 절차 누락 방지, 감사 추적 자동화 + - 리스크: CLI/API 연동 유지보수 비용 + - 후속 티켓 후보: `TKT-P0-WORKFLOW-GUARD` diff --git a/docs/ouroboros/README.md b/docs/ouroboros/README.md index 2768016..f3a2c60 100644 --- a/docs/ouroboros/README.md +++ b/docs/ouroboros/README.md @@ -21,6 +21,7 @@ Updated: 2026-02-26 7. PM 시나리오/이슈 분류: [50_scenario_matrix_and_issue_taxonomy.md](./50_scenario_matrix_and_issue_taxonomy.md) 8. TPM 제어 프로토콜/수용 매트릭스: [50_tpm_control_protocol.md](./50_tpm_control_protocol.md) 9. 저장소 강제 설정 체크리스트: [60_repo_enforcement_checklist.md](./60_repo_enforcement_checklist.md) +10. 메인 에이전트 아이디에이션 백로그: [70_main_agent_ideation.md](./70_main_agent_ideation.md) ## 운영 규칙