git-subtree-dir: .vendor/myagent-kit git-subtree-split: 96defc92f92d617a80f7b0f54e998ce4c25f631b
35 lines
2.3 KiB
Markdown
35 lines
2.3 KiB
Markdown
---
|
|
description: "Use when: verify one or more REQ IDs are Approved and create or update the matching docs/technical specifications"
|
|
name: "Sync Technical Specs"
|
|
argument-hint: "Enter REQ IDs, e.g. REQ-011, REQ-007, REQ-012"
|
|
agent: "agent"
|
|
model: "GPT-5 (copilot)"
|
|
---
|
|
다음 입력으로 지정된 requirement ID 목록에 대해, 승인 상태를 확인하고 해당하는 `docs/technical/` 문서를 실제로 갱신한다.
|
|
|
|
입력:
|
|
${input}
|
|
|
|
작업 규칙:
|
|
- 입력에서 `REQ-XXX` 목록을 추출한다. 쉼표 또는 공백으로 구분된 여러 ID를 지원한다.
|
|
- 먼저 `docs/SRS/index.md`의 `Requirement Register`와 각 REQ 파일의 `Status`를 함께 확인한다.
|
|
- 두 곳 모두 `Approved`인 requirement만 기술명세 업데이트 대상으로 포함한다.
|
|
- 하나라도 `Approved`가 아니거나 파일을 찾지 못하면 해당 REQ는 blocker로 보고하고, 그 REQ에 대한 technical doc은 수정하지 않는다.
|
|
- `docs/technical/index.md`와 각 technical doc 상단의 `Related REQ`를 기준으로 기존 연결 문서를 찾는다.
|
|
- 연결 문서가 있으면 현재 승인된 requirement에 맞게 내용을 실제로 업데이트한다.
|
|
- 연결 문서가 없으면 `docs/technical/` 아래에 새 문서를 생성하고 `docs/technical/index.md`에 항목을 추가한다.
|
|
- 기술 문서는 SRS를 source of truth로 따르며, 외부 계약이나 acceptance criteria를 재정의하지 않는다. 대신 구현 상세(모듈 책임, 파일 위치, 설정/환경값, 런타임 흐름, validation notes, open implementation points)를 정리한다.
|
|
- 문서 상단에는 반드시 `- Related REQ: ...`를 유지하거나 추가한다.
|
|
- `REQ-011`, `REQ-007`, `REQ-012`는 다음 문서를 우선 후보로 사용한다:
|
|
- `REQ-011` → `docs/technical/project-structure-baseline.md`
|
|
- `REQ-007` → `docs/technical/python-runtime-and-packaging.md`
|
|
- `REQ-012` → `docs/technical/settings-and-env-loading.md`
|
|
- `docs/technical/index.md`의 문서 목록과 연관 REQ 표도 문서 생성/연결 변경 사항에 맞게 함께 갱신한다.
|
|
- 실제 파일 변경을 수행한 뒤, 변경된 파일과 각 REQ의 승인 확인 결과를 요약한다.
|
|
|
|
출력 형식:
|
|
1. Approval Check
|
|
2. Technical Spec Updates
|
|
3. Files Changed
|
|
4. Remaining Blockers or Notes
|