ComposioHQ/notion-spec-to-implementation

명세에서 구현까지

Notion 명세를 연결된 구현 계획, 작업 및 진행 상태 업데이트로 변환합니다.

빠른 시작

1. Notion:notion-search로 명세를 찾은 뒤, Notion:notion-fetch로 가져옵니다.
2. reference/spec-parsing.md를 사용하여 요구사항과 모호성을 분석합니다.
3. Notion:notion-create-pages로 계획 페이지를 생성합니다 (템플릿 선택: quick vs. full).
4. 작업 데이터베이스를 찾고 스키마를 확인한 후, Notion:notion-create-pages로 작업을 생성합니다.
5. 명세 ↔ 계획 ↔ 작업을 연결하고 Notion:notion-update-page로 상태를 최신 상태로 유지합니다.

워크플로우

0) MCP 호출이 Notion MCP 미연결로 실패하면, 잠시 후 설정합니다:

1. Notion MCP 추가:
   • codex mcp add notion --url https://mcp.notion.com/mcp
2. 원격 MCP 클라이언트 활성화:
   • config.toml에서 [features].rmcp_client = true 설정 또는 codex --enable rmcp_client 실행
3. OAuth로 로그인:
   • codex mcp login notion

로그인 성공 후 사용자는 codex를 다시 시작해야 합니다. 답변을 마무리하고, 다음에 다시 시도할 때 1단계부터 계속할 수 있음을 알려주세요.

1) 명세 찾기 및 읽기

• 먼저 검색합니다 (Notion:notion-search); 결과가 여러 개면 사용자에게 선택을 요청합니다.
• 페이지를 가져와서 (Notion:notion-fetch) 요구사항, 수락 기준, 제약 사항, 우선순위를 스캔합니다. 추출 패턴은 reference/spec-parsing.md를 참조하세요.
• 진행 전에 공백/가정 사항을 clarifications 블록에 기록합니다.

2) 계획 수준 선택

• 간단한 변경 → reference/quick-implementation-plan.md 사용.
• 여러 단계의 기능/마이그레이션 → reference/standard-implementation-plan.md 사용.
• Notion:notion-create-pages로 계획을 생성하며, 다음을 포함합니다: 개요, 연결된 명세, 요구사항 요약, 단계, 의존성/리스크, 성공 기준. 명세에 다시 링크합니다.

3) 작업 생성

• 작업 데이터베이스를 찾습니다 (Notion:notion-search → Notion:notion-fetch로 데이터 소스와 필수 속성 확인). 패턴은 reference/task-creation.md를 참조하세요.
• 작업 크기는 1~2일로 조정합니다. 내용은 reference/task-creation-template.md를 사용합니다 (컨텍스트, 목표, 수락 기준, 의존성, 리소스).
• 속성 설정: 제목/동사, 상태, 우선순위, 명세+계획과의 관계, 기한/스토리 포인트/담당자 (제공된 경우).
• 데이터베이스의 data_source_id를 사용하여 Notion:notion-create-pages로 페이지를 생성합니다.

4) 아티팩트 연결

• 계획은 명세에 연결되고, 작업은 계획과 명세 모두에 연결됩니다.
• 선택적으로 Notion:notion-update-page를 사용하여 명세에 계획과 작업을 가리키는 짧은 "구현" 섹션을 추가합니다.

5) 진행 상황 추적

• reference/progress-tracking.md의 주기를 사용합니다.
• reference/progress-update-template.md로 업데이트를 게시하고, reference/milestone-summary-template.md로 단계를 마무리합니다.
• 계획/작업의 체크리스트와 상태 필드를 동기화하고, 차단 요소와 결정 사항을 기록합니다.

참조 및 예제

• reference/ — 파싱 패턴, 계획/작업 템플릿, 진행 주기 (예: spec-parsing.md, standard-implementation-plan.md, task-creation.md, progress-tracking.md).
• examples/ — 종단간 워크스루 (예: ui-component.md, api-feature.md, database-migration.md).