콘텐츠로 이동

AGENTS

부트스트랩

  • 새 세션, 컨텍스트 유실 후 재진입, 독립 작업 위임 시 이 문서의 부트스트랩과 작업 계약을 먼저 읽는다.
  • 다른 정책은 모든 세션에 일괄 적용하지 않는다. 요청·위험·실행 단계에 해당하는 문서만 아래 라우팅으로 읽는다.
  • 첫 응답은 ACK: BOOT@YYYY-MM-DD로 시작한다. YYYY-MM-DD는 세션 날짜다.
  • ACK 전에는 이 문서 열람 외 명령 실행, 코드·문서 작성, 외부 상태 변경을 시작하지 않는다.
  • 요청 유형, 권한, 범위, 위험 또는 단일 SoT를 확정할 수 없으면 수정하지 않고 필요한 확인 범위를 보고한다.

작업 계약

요청 유형과 종료 조건

요청 유형 기본 동작 종료 조건
설명·상태 확인 근거를 read-only로 확인 범위, 근거, 결론 보고
진단 원인, 영향, 재현 경로 확인 원인과 근거 보고; 수정은 별도 요청
설계·계획 SoT와 대안 검토 포함·제외, 책임 경계, 검증·rollback, 계획 리뷰
변경·구현 요청 범위의 파일 수정 구현, 동기화, 마지막 변경 이후 리뷰·검증·최종 판정
리뷰 고정된 대상을 read-only로 평가 근거 있는 Finding 또는 No Findings; 요청 없이는 수정 금지
운영·관찰 승인된 운영 동작 또는 관찰 종료 조건, 결과, 잔여 위험 보고
  • 요청 유형, 권한, 범위, 실행 단계는 독립적으로 판정한다.
  • 설계·계획, 진단, 리뷰는 사용자가 변경까지 명시하지 않으면 파일 변경 권한을 포함하지 않는다.

범위와 권한

  • 범위는 사용자가 명시하거나 직전 요청에서 합의한 레포·ref·파일·변경으로 고정한다. 짧은 후속 요청은 직전 범위를 상속하며, 상속할 범위가 없으면 범위 밖 branch/worktree/PR을 탐색하기 전에 사용자에게 확인한다.
  • 관련 SoT는 판정 근거이지 자동으로 리뷰·변경 범위에 포함되지 않는다.

  • 새 branch/worktree/PR을 만들기 전에만 같은 범위의 기존 작업 후보를 확인한다. 후보가 있어도 자동 전환하거나 같은 범위의 활성 PR을 병렬 유지하지 않고 사용자 결정을 기다린다. | 권한 | 포함 조건 | | --- | --- | | workspace 파일 변경 | 변경·구현 요청 | | 외부 의존성 | 엔지니어링 사전 검토와 별도 명시 승인 | | branch/worktree | 별도 명시 요청 | | commit | 별도 명시 요청 또는 수정하고 PR 올려줘 | | push | 별도 명시 요청 또는 수정하고 PR 올려줘 | | PR | 별도 명시 요청 또는 수정하고 PR 올려줘 | | merge/main integration | 별도 명시 요청 | | reviewer | 개인 또는 팀을 지정한 별도 명시 승인 | | deploy | 별도 명시 요청 | | force push·삭제 | 대상과 동작의 별도 명시 승인 |

  • 권한은 서로 독립적이며 수정하고 PR 올려줘도 reviewer 변경·merge/main integration·deploy를 포함하지 않는다.

  • 외부 의존성은 엔지니어링 가드레일의 사전 검토를 먼저 적용한다.
  • 목표 단계가 권한 집합을 초과하면 첫 파일 변경이나 외부 작업 전에 완료 가능한 단계, 중지 지점과 필요한 권한을 보고하고 목표 단계와 권한을 확정한다.
  • 첫 파일 변경 또는 외부 작업 전에 다음 계약을 기록한다. ROUTE: 요청=<유형> | 레포=<대상> | 산출물=<종류> | 도메인=<범위> | 위험=<표면> | 목표단계=<검증 완료|외부 작업 완료|main 반영 완료|배포 완료> | 권한=<집합> | 필수문서=<경로> | 완료=<종료 조건>

문서 라우팅

  1. 요청과 대상에서 산출물·도메인·위험·실행 단계를 식별한다.
  2. 아래 표에서 일치하는 행의 문서를 합집합으로 읽는다.
  3. 문서 인덱스에서 가장 가까운 문서를 열고 충돌 시 우선 문서, 단일 SoT, 직접 연결된 관련 문서를 따라간다.
  4. 각 판정 책임이 하나의 SoT에 연결될 때까지 반복한다. 충돌·누락이 있으면 구현보다 규범을 먼저 확정한다.
적용 신호·단계 추가 필수 문서
docs 작성·수정·삭제·리뷰 content/policy/document-governance-policy.md와 적용 템플릿
policy 추가·수정·삭제·리뷰 content/policy/document-governance-policy.md의 정책 Composition Gate
논리 데이터 모델 content/policy/logical-data-model-policy.md의 적용 절과 충실도 리뷰 판정
DB, migration, DB schema, DBM-GATE-* content/policy/db-migration-gate-policy.md
API 성공·실패 envelope content/policy/api-response-contract-policy.md
API ErrorData·error taxonomy content/policy/api-error-contract-policy.md
public DTO·계약 package content/policy/api-client-contract-package-policy.md
페이지/use-case 조회·동작 operation content/policy/api-operation-design-policy.md
인증·인가·관리자 권한·민감정보 content/policy/security-access-control-policy.md, content/policy/data-governance-policy.md
결제·환불·정산 content/policy/payment-ops-policy.md
매칭 상태·키·일정 content/policy/matching-ops-policy.md
회원 심사 content/policy/member-review-policy.md와 연결 architecture/FSM
푸시 타입·발송·장애 대응 content/policy/push-notification-policy.md
배포·릴리스·태그 content/policy/release-process.md, content/policy/release-tag-policy.md, 적용 runbook
코드·테스트·설정·DB 설계·변경·리뷰 content/policy/engineering-guardrails.md
변경 결과 리뷰·최종 판정·commit·push·PR·merge/main integration content/policy/code-review-policy.md
테스트 변경·검증·VERIFY content/policy/testing-strategy.md
기술부채 또는 도메인 완료 판정 content/technical-debt/technical-debt.md
  • 표에 없는 도메인은 비적용으로 추론하지 않고 문서 인덱스와 직접 연결 문서로 폐쇄 탐색한다.
  • 경로 링크만 확인하거나 이전 세션 요약으로 대체하지 않고, 적용 절과 Gate를 직접 읽는다.

실행과 완료

BOOT -> CLASSIFY -> ROUTE -> BASELINE -> PLAN -> EXECUTE -> REVIEW -> VERIFY -> EXTERNAL_ACTION -> REPORT

목표 단계 완료 조건 선택 조건
검증 완료 마지막 파일 변경 이후 독립 리뷰와 적용 품질 게이트가 통과한 상태 변경·구현의 기본 목표
외부 작업 완료 승인된 commit·push·PR·tag 등 main integration·deploy 전 외부 작업과 결과 확인이 끝난 상태 요청에 해당 외부 작업과 권한이 있음
main 반영 완료 승인된 merge 뒤 원격 main ref의 반영 결과가 검증된 최종 후보와 일치하는 상태 요청에 merge/main integration 권한이 있음
배포 완료 승인된 대상 ref 또는 산출물의 deploy와 postcheck가 끝난 상태 요청에 deploy 권한이 있음
  • 목표 단계는 순차 권한 등급이 아니며 해당 단계의 external action 권한을 자동으로 포함하지 않는다. 앞 단계 완료를 뒤 단계 완료로 확대하지 않는다.
  • cutover 완료는 완료=<종료 조건>에 cutover 대상과 Exit Gate를 고정하고 해당 목표 단계 완료 조건까지 충족했을 때만 사용한다. 그렇지 않으면 실제로 끝난 목표 단계만 보고한다.
  • 비적용 단계는 근거 있는 N/A로 판정한다. 기존 작업 확인은 BASELINE, 최종 판정은 REPORT에 포함한다.
  • 마지막 파일 변경 뒤 같은 범위의 독립 리뷰를 수행한다. 열린 Finding이 0건이면 열린 Finding 0건·검증 대기를 기록한 뒤 동일 후보를 검증한다.
  • Finding은 원인을 1회 수정하고 동일 범위를 1회 재리뷰한다. 열린 Finding이 남으면 추가 자동 반복 없이 Finding으로 보고한다.
  • 리뷰·검증 뒤 파일이 바뀌면 두 결과는 만료된다. 검증 실패는 No Findings로 판정하지 않는다.
  • commit 전에는 코드 리뷰·브랜치·커밋 정책, push·PR 전에는 코드 리뷰 정책의 Push Gate, merge/main integration 전에는 코드 리뷰 정책의 병합 전 체크리스트, deploy 전에는 릴리스 정책과 적용 runbook을 다시 읽는다.
  • 최종 보고에는 범위, 변경, 검증, 문서 동기화, 열린 Finding, 최종 판정, 잔여 위험을 포함한다.

문서 인덱스

Architecture

FSM

Technical Debt

Policy

Flows

Releases

Setup