개발 컨벤션 인덱스

이 문서는 Context-Action 저장소에서 implementation-playbook 계열 개발 컨벤션을 굳히기 위해 가장 먼저 봐야 할 중심 인덱스입니다. 문서가 많아졌기 때문에, 어떤 문서가 “원칙”, 어떤 문서가 “예제”, 어떤 문서가 “검증”인지 한 번에 묶어보는 용도로 씁니다.

가장 짧은 추천 순서

1. Implementation Convention
2. Canonical Order Form 예제
3. Playbook 시나리오 라이브러리
4. 명시적 상태 머신
5. 안정성 테스트 사이클

이 다섯 개만 봐도

• 폴더 구조
• 상태 전이 원칙
• 도메인별 확장 방식
• 테스트 기준 을 빠르게 공유할 수 있습니다.

문서 역할별 분류

1. 표준을 고정하는 문서

• Implementation Convention
  • implementation-playbook 계열 개발의 표준 규칙
• 폴더 구조
  • contexts / business / handlers / actions / hooks / views 책임 구분
• 핸들러 레지스트리
  • handler 등록과 분리 기준

2. 상태 전이와 로직 분리를 설명하는 문서

• 명시적 상태 머신
  • 복잡한 async 흐름을 상태 + 이벤트 + 전이로 고정하는 방법
• Context-Layered 개요
  • 전체 구조를 상위 개념에서 설명
• 마이그레이션 가이드
  • 기존 코드에서 이 구조로 옮기는 기준

3. 실제 구현을 보여주는 문서

• Canonical Order Form 예제
  • base canonical example
• Access Request Playbook 예제
  • approval/review workflow 예제
• Incident Escalation Playbook 예제
  • incident/escalation workflow 예제
• Renewal Risk Review Playbook 예제
  • renewal/customer-success workflow 예제
• Playbook 시나리오 라이브러리
  • 아직 full demo가 아니어도 같은 skill로 확장할 시나리오 모음

4. 검증 기준을 고정하는 문서

• 안정성 테스트 사이클
  • 설계 계약, 구현 패턴, 시나리오, 스트레스 테스트를 어떻게 나누는지

팀 컨벤션으로 굳힐 때 읽는 순서

아키텍처 합의용

1. Implementation Convention
2. 명시적 상태 머신
3. 안정성 테스트 사이클

구현자 온보딩용

1. Canonical Order Form 예제
2. Access Request Playbook 예제
3. Incident Escalation Playbook 예제
4. Renewal Risk Review Playbook 예제

새 시나리오 설계용

1. Playbook 시나리오 라이브러리
2. Implementation Convention
3. repo-local skill: skills/context-action-implementation-playbook/SKILL.md

코드와 같이 볼 때

문서만 보지 말고 예제 앱도 같이 보는 것이 가장 좋습니다.

• /patterns/implementation-playbook
• /patterns/implementation-playbook/access-request
• /patterns/implementation-playbook/incident-escalation
• /patterns/implementation-playbook/renewal-risk-review

한 줄 요약

팀 컨벤션으로 굳힐 때는 Implementation Convention -> Explicit State Machine -> Canonical Example -> Scenario Demos -> Stability Test Cycle 순서로 보면 됩니다.