solmate-skills 2.0.2 → 2.0.4

package/README.md

@@ -2,6 +2,17 @@
 
 Curated skills for Solmate projects. Easily share and install AI tool skills across your team.
 
+## What's New in 2.0.3
+
+`solmate-skills@2.0.3` adds **Backlog Context Lock**, a documentation rule that prevents implementation work from drifting away from the dense project documents already written in the 5-Layer structure.
+
+Key changes:
+
+- Every backlog task must link to related Concept, UI, Technical Spec, and QA documents.
+- `/rules-workflow` now treats linked backlog documents as implementation inputs before coding starts.
+- `/verify-docs` fails backlog items that omit required related-document fields.
+- Local Codex settings under `.codex/` are excluded from the npm package.
+
 ## Installation
 
 You don't need to install this package globally. Simply use `npx`:
@@ -133,8 +144,52 @@ docs/
 1. /docs-plan    → Write VISION_CORE.md, LEAN_CANVAS.md, PRODUCT_SPECS.md
 2. /docs-plan    → Write SCREEN_FLOW.md, UI_DESIGN.md
 3. /docs-dev     → Write DEVELOPMENT_PRINCIPLES.md, DB_SCHEMA.md, API_SPECS.md
-4. /docs-dev     → Write ROADMAP.md, BACKLOG.md
-5. /verify-docs  → Audit all docs for structure and metadata compliance
+4. /docs-dev     → Write ROADMAP.md, BACKLOG.md with mandatory related document links
+5. /rules-workflow → Implement each backlog item only after reading linked docs
+6. /verify-docs  → Audit structure, metadata, and Backlog Context Lock compliance
+```
+
+Backlog items are intentionally document-linked. Each task in `docs/04_Logic_Progress/00_BACKLOG.md` must include related Concept, UI, Technical Spec, and QA documents, plus implementation preconditions, acceptance criteria, and a document sync check. If a related document does not exist, the item must say `N/A - 사유`; implementation should pause when the missing document is required for a safe decision.
+
+### Backlog Context Lock
+
+Backlog Context Lock makes `docs/04_Logic_Progress/00_BACKLOG.md` act as a bridge between planning documents and implementation. A backlog item is not considered ready for coding until it names the documents that define why the task exists, how the UI should behave, what technical constraints apply, and how the work will be verified.
+
+Required fields for every backlog item:
+
+- `Related Concept Docs`
+- `Related UI Docs`
+- `Related Technical Docs`
+- `Related QA Docs`
+- `Implementation Preconditions`
+- `Acceptance Criteria`
+- `Document Sync Check`
+
+If a related document does not exist, write `N/A - 사유`. Do not leave the field blank. If the missing document is required to make a safe implementation decision, pause implementation and write or update the document first.
+
+**Backlog item template:**
+
+```markdown
+### [ ] TASK-000: Implement feature name
+
+- Status: ToDo
+- Related Concept Docs:
+  - [Product Specs](../01_Concept_Design/03_PRODUCT_SPECS.md) - feature purpose and user value
+- Related UI Docs:
+  - [Screen Flow](../02_UI_Screens/00_SCREEN_FLOW.md) - target screen and interaction flow
+- Related Technical Docs:
+  - [API Specs](../03_Technical_Specs/02_API_SPECS.md) - endpoint and data contract
+- Related QA Docs:
+  - [QA Checklist](../05_QA_Validation/02_QA_CHECKLIST.md) - acceptance and release criteria
+- Implementation Preconditions:
+  - [ ] Read all related documents before coding
+  - [ ] Confirm implementation scope does not conflict with documented intent
+- Acceptance Criteria:
+  - [ ] Feature behavior matches linked Concept/UI/Technical docs
+  - [ ] QA criteria are testable and satisfied
+- Document Sync Check:
+  - [ ] No mismatch between implementation and linked documents
+  - [ ] Update related documents if implementation changes the agreed behavior
 ```
 
 ---

package/docs-dev/SKILL.md

@@ -58,6 +58,32 @@ This skill manages **Layer 3 (Technical_Specs)**, **Layer 4 (Logic_Progress)**,
 
 **중요 규칙**: 실무 문서(`00_BACKLOG.md`, `00_ROADMAP.md`, `01_EXECUTION_PLAN.md`) 작성 시, 모든 작업은 반드시 체크박스`[ ]`를 사용하여 원자적 단위(Atomic Task)로 최대한 상세히 나누어 기록해야 한다. "추상적인 작업" 대신 "실제로 실행 및 검증 가능한 단계"로 분할한다.
 
+**Backlog 문서 참조 강제 규칙**: `00_BACKLOG.md`의 모든 작업 항목은 관련 문서를 읽은 뒤 작성해야 하며, 구현자는 코드 작성 전에 해당 문서를 다시 확인해야 한다. 백로그는 단순 ToDo 목록이 아니라 Concept, UI, Technical Spec, QA 기준을 구현으로 연결하는 실행 티켓이어야 한다.
+
+Backlog 항목 작성 전 필수 확인 대상:
+- `docs/01_Concept_Design/`: 기능 목적, 사용자 가치, 제품 방향
+- `docs/02_UI_Screens/`: 화면 흐름, UI 상태, 인터랙션
+- `docs/03_Technical_Specs/`: API, DB, 데이터 구조, 기술 제약
+- `docs/05_QA_Validation/`: 테스트 기준, 수용 조건, 검증 시나리오
+
+각 Backlog 항목은 다음 필드를 반드시 포함한다:
+- `Related Concept Docs`: 관련 기획/디자인 문서
+- `Related UI Docs`: 관련 화면/플로우 문서
+- `Related Technical Docs`: 관련 기술 명세 문서
+- `Related QA Docs`: 관련 검증 문서
+- `Implementation Preconditions`: 구현 전 반드시 확인할 조건
+- `Acceptance Criteria`: 완료 판단 기준
+- `Document Sync Check`: 구현 후 문서와 코드의 일치 여부
+
+관련 문서가 아직 없거나 해당하지 않는 경우에도 비워둘 수 없다. 반드시 `N/A - 사유`를 적고, 구현 판단에 필요한 문서가 없으면 구현 전에 문서 작성 또는 보완을 사용자에게 확인한다.
+
+구현 시작 전 체크:
+- 관련 문서를 실제로 읽었는가?
+- 문서의 요구사항이 Backlog 항목에 반영되어 있는가?
+- 구현 범위가 관련 문서의 의도와 충돌하지 않는가?
+- 관련 QA 기준이 `Acceptance Criteria`에 반영되어 있는가?
+- 누락된 문서가 있다면 `N/A - 사유`가 타당한가?
+
 1. **Project Initialization**: CLI 프리셋 vs 수동 설정?
 2. **UI Theme Strategy**: 사전 정의된 테마 vs 커스텀 브랜드 색상? 폰트 선택?
 3. **Folder Structure**: Feature 기반 vs Type 기반?
@@ -143,6 +169,31 @@ This skill manages **Layer 3 (Technical_Specs)**, **Layer 4 (Logic_Progress)**,
 - **QA_Validation**: [Test Scenarios](../05_QA_Validation/01_TEST_SCENARIOS.md) - 관련 테스트 케이스
 ```
 
+### Template D-1 — Backlog Item
+
+```
+### [ ] TASK-000: [작업명]
+
+- Status: ToDo | In Progress | Done
+- Related Concept Docs:
+  - [문서명](../01_Concept_Design/XX_DOCUMENT.md) - 기능 목적/사용자 가치 근거
+- Related UI Docs:
+  - [문서명](../02_UI_Screens/XX_DOCUMENT.md) - 화면 흐름/상태/인터랙션 근거
+- Related Technical Docs:
+  - [문서명](../03_Technical_Specs/XX_DOCUMENT.md) - API/DB/데이터 구조 근거
+- Related QA Docs:
+  - [문서명](../05_QA_Validation/XX_DOCUMENT.md) - 테스트 기준/수용 조건 근거
+- Implementation Preconditions:
+  - [ ] 관련 문서 전체 확인 완료
+  - [ ] 구현 범위와 문서 요구사항 충돌 없음
+- Acceptance Criteria:
+  - [ ] QA 기준이 구현 완료 판단에 반영됨
+  - [ ] 핵심 사용자 흐름이 검증됨
+- Document Sync Check:
+  - [ ] 구현 후 코드와 관련 문서 불일치 없음
+  - [ ] 불일치가 있으면 관련 문서 또는 백로그 항목 업데이트
+```
+
 ### Template E — QA_Validation
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solmate-skills",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Curated skills for Solmate projects",
   "main": "bin/cli.js",
   "bin": {
@@ -28,4 +28,4 @@
   "engines": {
     "node": ">=14.0.0"
   }
-}
+}

package/rules-docs/SKILL.md

@@ -66,6 +66,20 @@ description: Create and manage project documentation according to the 365 Princi
 - `00_ROADMAP.md`: 마일스톤 및 단계별 일정 (Phase별 큰 줄기와 세부 항목 분할)
 - `01_EXECUTION_PLAN.md`: 기술 실행 전략 및 타임라인 (구체적인 구현 스텝 및 체크박스 필수)
 
+### Backlog Context Lock (필수)
+
+`docs/04_Logic_Progress/00_BACKLOG.md`의 모든 작업 항목은 다른 레이어의 관련 문서를 구현 입력값으로 연결해야 한다. 백로그는 단독 ToDo가 아니며, 다음 필드를 통해 문서 기반 구현을 강제한다.
+
+- `Related Concept Docs`
+- `Related UI Docs`
+- `Related Technical Docs`
+- `Related QA Docs`
+- `Implementation Preconditions`
+- `Acceptance Criteria`
+- `Document Sync Check`
+
+각 Related 필드는 상대 경로 링크와 관계 설명을 포함해야 한다. 관련 문서가 없으면 빈칸으로 두지 않고 `N/A - 사유`를 명시한다. 단, 구현 판단에 필요한 Concept, UI, Technical Spec, QA 기준이 아직 문서화되지 않은 경우에는 백로그만으로 구현을 시작할 수 없으며, 먼저 문서 작성 또는 보완 여부를 사용자에게 확인한다.
+
 ### 메타데이터 (필수)
 
 모든 문서 최상단:
@@ -104,6 +118,8 @@ description: Create and manage project documentation according to the 365 Princi
 
 **Logic_Progress**: Concept_Design + UI_Screens + Technical_Specs (DB, API) + QA_Validation
 
+**Backlog Items**: 각 항목 단위로 Concept_Design + UI_Screens + Technical_Specs + QA_Validation 링크를 포함한다. 구현자는 항목 착수 전 링크된 문서를 읽고 `Implementation Preconditions`를 확인해야 한다.
+
 **QA_Validation**: 모든 상위 레이어 참조
 
 ## 6. 스킬 위임 테이블

package/rules-workflow/SKILL.md

@@ -13,8 +13,9 @@ Follow this workflow for feature implementation and significant code changes. Co
 
 ### Step 1. 계획 수립
 - 요구사항·목적을 문서 또는 이슈 기준으로 정리한다.
+- 백로그 항목이 있으면 `Related Concept Docs`, `Related UI Docs`, `Related Technical Docs`, `Related QA Docs`를 먼저 읽고 구현 입력값으로 요약한다.
 - 변경할 파일·추가할 컴포넌트·API·DB 영향 범위를 나열한다.
-- 체크: [ ] 목적이 명확한가? [ ] 영향 범위가 정리되었는가?
+- 체크: [ ] 목적이 명확한가? [ ] 관련 문서를 읽었는가? [ ] 영향 범위가 정리되었는가?
 
 ### Step 2. 계획 검토
 - 계획이 요구사항과 일치하는지, 누락된 시나리오는 없는지 검토한다.
@@ -34,7 +35,8 @@ Follow this workflow for feature implementation and significant code changes. Co
 
 ### Step 5. 구현
 - 승인된 계획대로 구현한다. AGENTS.md·프로젝트 컨벤션(커밋, Zod, Luxon 등)을 따른다.
-- 체크: [ ] 계획 대비 변경 사항이 일치하는가?
+- 코드 작성 전 백로그 항목의 `Implementation Preconditions`와 `Acceptance Criteria`를 확인한다. 관련 문서 링크가 비어 있거나 `N/A - 사유`가 부실하면 구현을 보류하고 문서 보완 필요 여부를 사용자에게 확인한다.
+- 체크: [ ] 계획 대비 변경 사항이 일치하는가? [ ] 백로그의 관련 문서 기준을 반영했는가?
 
 ---
 
@@ -90,7 +92,8 @@ Follow this workflow for feature implementation and significant code changes. Co
 
 ### Step 16. 관련 부분 반복 검토
 - 검토 중 발견된 이슈와 연관된 코드·설정·문서를 다시 점검한다. 관련된 부분을 놓치지 않도록 추가로 확인한다.
-- 체크: [ ] 발견 이슈의 연쇄 영향 [ ] 관련 모듈·설정까지 검토
+- 백로그 항목의 `Document Sync Check`를 기준으로 구현 결과와 관련 문서의 불일치 여부를 확인한다.
+- 체크: [ ] 발견 이슈의 연쇄 영향 [ ] 관련 모듈·설정까지 검토 [ ] 문서-구현 불일치 없음
 
 ### Step 17. 배포 가능 퀄리티 최종 검토
 - "이대로 배포해도 될 수준인가?"를 한 번 더 검토한다. 1–16단계에서 누락된 항목이 없는지 확인한다.

package/verify-docs/SKILL.md

@@ -11,8 +11,9 @@ description: 프로젝트 문서가 5단계 구조(01~05)와 메타데이터 표
 1. 5-Layer 폴더 구조 및 파일 네이밍
 2. 메타데이터 표준 (Created / Last Updated)
 3. Related Documents 섹션
-4. Rubric-First Writing
-5. rules-product Gate Out 조건
+4. Backlog Context Lock
+5. Rubric-First Writing
+6. rules-product Gate Out 조건
 
 ## 실행 시점
 
@@ -53,17 +54,35 @@ AGENTS.md 또는 `docs/01_Concept_Design/00_COLLABORATION_GUIDE.md`를 읽어
 - [ ] 각 링크에 관계 설명이 포함되어 있는가?
 - [ ] 상위 또는 하위 레이어 문서가 최소 1개 이상 연결되어 있는가?
 
-### Step 4: Rubric-First Writing 검사
+### Step 4: Backlog Context Lock 검사
+
+`docs/04_Logic_Progress/00_BACKLOG.md`가 있으면 각 작업 항목을 확인한다.
+
+체크 항목:
+- [ ] 모든 Backlog 작업 항목이 체크박스`[ ]` 또는 `[x]`로 시작하는가?
+- [ ] 각 작업 항목에 `Related Concept Docs`가 있는가?
+- [ ] 각 작업 항목에 `Related UI Docs`가 있는가?
+- [ ] 각 작업 항목에 `Related Technical Docs`가 있는가?
+- [ ] 각 작업 항목에 `Related QA Docs`가 있는가?
+- [ ] 각 작업 항목에 `Implementation Preconditions`가 있는가?
+- [ ] 각 작업 항목에 `Acceptance Criteria`가 있는가?
+- [ ] 각 작업 항목에 `Document Sync Check`가 있는가?
+- [ ] Related 필드의 링크가 상대 경로이거나 `N/A - 사유` 형식인가?
+- [ ] `N/A`만 있고 사유가 없는 항목은 없는가?
+
+위 항목 중 하나라도 누락되면 Backlog Context Lock은 Fail로 처리한다.
+
+### Step 5: Rubric-First Writing 검사
 
 | 레이어 | 기준 |
 |:---|:---|
 | QA_Validation (Layer 5) | 6개 루브릭 전체 테이블 포함 (필수) |
-| Logic_Progress (Layer 4) | 실무 문서(BACKLOG, ROADMAP, EXECUTION_PLAN) 내 체크박스`[ ]` 활용 및 원자적 단위 분할 (필수) |
+| Logic_Progress (Layer 4) | 실무 문서(BACKLOG, ROADMAP, EXECUTION_PLAN) 내 체크박스`[ ]` 활용 및 원자적 단위 분할, Backlog Context Lock 준수 (필수) |
 | Concept_Design (Layer 1) | Novelty, Business Plan, Potential Impact 언급 (권장) |
 | Technical_Specs (Layer 3) | Functionality, UX (latency), Open-source 언급 (권장) |
 | Logic_Progress (Layer 4) | Functionality, UX 언급 (권장) |
 
-### Step 5: Gate Out 조건 검사
+### Step 6: Gate Out 조건 검사
 
 rules-product 기준으로 각 Phase의 필수 문서 존재 여부를 확인한다.
 
@@ -81,7 +100,7 @@ rules-product 기준으로 각 Phase의 필수 문서 존재 여부를 확인한
 - [ ] `docs/04_Logic_Progress/00_ROADMAP.md`
 - [ ] `docs/05_QA_Validation/02_QA_CHECKLIST.md`
 
-### Step 6: 검증 보고서 출력
+### Step 7: 검증 보고서 출력
 
 검사 완료 후 아래 형식으로 결과를 출력한다:
 
@@ -94,6 +113,7 @@ rules-product 기준으로 각 Phase의 필수 문서 존재 여부를 확인한
 | 파일 네이밍 | Pass / Fail | 위반 파일 목록 |
 | 메타데이터 | Pass / Fail | 누락 파일 목록 |
 | Related Documents | Pass / Fail | 미연결 파일 목록 |
+| Backlog Context Lock | Pass / Fail | 필수 필드 누락 작업 목록 |
 | Rubric-First | Pass / Fail | |
 | Gate Out 조건 | Pass / Fail | 미충족 파일 목록 |