ai-ops-cli 1.2.0 → 1.3.1

package/README.ko.md

@@ -44,12 +44,13 @@ GEMINI.md
 CLAUDE.md
 docs/agent/rules/00-agent-baseline.md
 docs/agent/workflow.md
+docs/agent/terminology.md
 docs/agent/rules/routing-rules.md
 docs/agent/rules/doc-update-rules.md
 docs/agent/rules/stop-rules.md
 docs/agent/checks/impact-checklist.md
-docs/agent/checks/review-checklist.md
 docs/agent/maps/codebase-map.md
+docs/business/terminology.md
 docs/business/business-rules.md
 docs/docs-status.md
 .ai-ops/manifest.json
@@ -71,13 +72,13 @@ receipts/config/*
 
 ### `ai-ops update`가 덮어쓰는 파일은 무엇인가요?
 
-`AGENTS.md`, `GEMINI.md`, `CLAUDE.md`, `docs/agent/rules/*`, `docs/agent/checks/*`, `docs/agent/workflow.md`는 ai-ops managed 문서입니다. 이 파일의 `<!-- ai-ops:start -->`부터 `<!-- ai-ops:end -->`까지는 CLI 템플릿 영역이고, `ai-ops update` 때 현재 CLI 템플릿으로 다시 적용됩니다. 사용자가 이 영역을 직접 수정하면 다음 update에서 유지되지 않습니다.
+`AGENTS.md`, `GEMINI.md`, `CLAUDE.md`, `docs/agent/rules/*`, `docs/agent/checks/impact-checklist.md`, `docs/agent/workflow.md`는 ai-ops managed 문서입니다. 이 파일의 `<!-- ai-ops:start -->`부터 `<!-- ai-ops:end -->`까지는 CLI 템플릿 영역이고, `ai-ops update` 때 현재 CLI 템플릿으로 다시 적용됩니다. 사용자가 이 영역을 직접 수정하면 다음 update에서 유지되지 않습니다.
 
 `.ai-ops/manifest.json`과 `.ai-ops/context-layer.json`도 직접 편집 대상이 아닙니다. 각각 설치 상태와 문서 index를 기록하는 CLI 상태 파일입니다.
 
 ### 사용자가 직접 수정해야 하는 파일은 무엇인가요?
 
-프로젝트 지식은 project-owned 문서에 적습니다. 기본 project-owned 문서는 `docs/agent/maps/codebase-map.md`, `docs/business/business-rules.md`, `docs/docs-status.md`입니다. `docs/agent/maps/codebase-map.md`와 `docs/business/business-rules.md`는 처음에는 Reserved 템플릿이지만, 프로젝트가 실제 내용을 채운 뒤에는 update가 자동으로 덮어쓰지 않습니다.
+프로젝트 지식은 project-owned 문서에 적습니다. 기본 project-owned 문서는 `docs/agent/maps/codebase-map.md`, `docs/business/terminology.md`, `docs/business/business-rules.md`, `docs/docs-status.md`입니다. `docs/agent/maps/codebase-map.md`, `docs/business/terminology.md`, `docs/business/business-rules.md`는 처음에는 Reserved 템플릿이지만, 프로젝트가 실제 내용을 채운 뒤에는 update가 자동으로 덮어쓰지 않습니다.
 
 `docs/docs-status.md`는 project-owned 문서이지만 자유 메모장이 아니라 context-layer registry입니다. 문서 status/frontmatter를 바꿀 때 함께 맞추는 파일이며, update 과정에서 manifest와 실제 문서 frontmatter 기준으로 테이블이 정리될 수 있습니다.
 
@@ -177,7 +178,7 @@ ai-ops pack update spec-lifecycle
 ai-ops pack uninstall spec-lifecycle
 ```
 
-`spec-lifecycle` pack은 `docs/specs/README.md`, `docs/specs/README.ko.md`, `docs/specs/baseline/.gitkeep`, `docs/specs/initial-build/.gitkeep`를 설치합니다. Markdown 문서만 context-layer와 `docs/docs-status.md` 감사 대상이고, `.gitkeep`은 manifest의 일반 pack file로만 기록됩니다.
+`spec-lifecycle` pack은 `docs/specs/README.md`, `docs/specs/README.ko.md`, `docs/specs/baseline/.gitkeep`, `docs/specs/initial-build/.gitkeep`를 설치합니다. Markdown 문서만 context-layer와 `docs/docs-status.md` 감사 대상이고, `.gitkeep`은 manifest의 일반 pack file로만 기록됩니다. 프로젝트 용어는 계속 `docs/business/terminology.md`에서 중앙 관리합니다.
 
 ## Deprecated Old Model
 

package/README.md

@@ -44,12 +44,13 @@ GEMINI.md
 CLAUDE.md
 docs/agent/rules/00-agent-baseline.md
 docs/agent/workflow.md
+docs/agent/terminology.md
 docs/agent/rules/routing-rules.md
 docs/agent/rules/doc-update-rules.md
 docs/agent/rules/stop-rules.md
 docs/agent/checks/impact-checklist.md
-docs/agent/checks/review-checklist.md
 docs/agent/maps/codebase-map.md
+docs/business/terminology.md
 docs/business/business-rules.md
 docs/docs-status.md
 .ai-ops/manifest.json
@@ -71,13 +72,13 @@ receipts/config/*
 
 ### What does `ai-ops update` overwrite?
 
-`AGENTS.md`, `GEMINI.md`, `CLAUDE.md`, `docs/agent/rules/*`, `docs/agent/checks/*`, and `docs/agent/workflow.md` are ai-ops managed documents. In these files, the region from `<!-- ai-ops:start -->` through `<!-- ai-ops:end -->` is CLI template content. `ai-ops update` reapplies the current CLI template to that region. User edits inside that region are not preserved across update.
+`AGENTS.md`, `GEMINI.md`, `CLAUDE.md`, `docs/agent/rules/*`, `docs/agent/checks/impact-checklist.md`, and `docs/agent/workflow.md` are ai-ops managed documents. In these files, the region from `<!-- ai-ops:start -->` through `<!-- ai-ops:end -->` is CLI template content. `ai-ops update` reapplies the current CLI template to that region. User edits inside that region are not preserved across update.
 
 `.ai-ops/manifest.json` and `.ai-ops/context-layer.json` are also not direct-edit files. They are CLI state files for installation state and document indexing.
 
 ### Which files should users edit directly?
 
-Project knowledge belongs in project-owned documents. The default project-owned documents are `docs/agent/maps/codebase-map.md`, `docs/business/business-rules.md`, and `docs/docs-status.md`. `docs/agent/maps/codebase-map.md` and `docs/business/business-rules.md` start as Reserved templates, but once the project fills them with real content, update does not automatically overwrite them.
+Project knowledge belongs in project-owned documents. The default project-owned documents are `docs/agent/maps/codebase-map.md`, `docs/business/terminology.md`, `docs/business/business-rules.md`, and `docs/docs-status.md`. `docs/agent/maps/codebase-map.md`, `docs/business/terminology.md`, and `docs/business/business-rules.md` start as Reserved templates, but once the project fills them with real content, update does not automatically overwrite them.
 
 `docs/docs-status.md` is project-owned, but it is not a free-form notebook. It is the context-layer registry. Update it together with document status/frontmatter changes; the update flow may also normalize its table from the manifest and current document frontmatter.
 
@@ -177,7 +178,7 @@ ai-ops pack update spec-lifecycle
 ai-ops pack uninstall spec-lifecycle
 ```
 
-The `spec-lifecycle` pack installs `docs/specs/README.md`, `docs/specs/README.ko.md`, `docs/specs/baseline/.gitkeep`, and `docs/specs/initial-build/.gitkeep`. Only Markdown documents are audited by the context-layer and `docs/docs-status.md`; `.gitkeep` files are tracked only as regular pack files in the manifest.
+The `spec-lifecycle` pack installs `docs/specs/README.md`, `docs/specs/README.ko.md`, `docs/specs/baseline/.gitkeep`, and `docs/specs/initial-build/.gitkeep`. Only Markdown documents are audited by the context-layer and `docs/docs-status.md`; `.gitkeep` files are tracked only as regular pack files in the manifest. Project terminology remains centralized in `docs/business/terminology.md`.
 
 ## Deprecated Old Model
 

package/data/context-layer/AGENTS.md

@@ -16,9 +16,10 @@ update_when:
 1. `AGENTS.md`
 2. `docs/agent/rules/00-agent-baseline.md`
 3. `docs/agent/workflow.md`
-4. 나머지 `docs/agent/rules/*.md`
-5. 작업 성격에 맞는 `docs/agent/checks/*.md`
-6. `docs/docs-status.md`
+4. `docs/agent/terminology.md`
+5. 나머지 `docs/agent/rules/*.md`
+6. 변경 영향 확인이 필요하면 `docs/agent/checks/impact-checklist.md`
+7. `docs/docs-status.md`
 
 ## 문서 신뢰도
 

package/data/context-layer/docs/agent/checks/impact-checklist.md

@@ -3,14 +3,16 @@ status: Active
 layer: agent
 owner: ai-ops
 read_when:
+  - change_impact_analysis
   - before_finish
 update_when:
-  - checklist_changes
+  - impact_policy_changes
 ---
 # Impact Checklist
 
-- 공개 CLI 표면이 바뀌었는가?
-- 상태 파일 schema나 경로가 바뀌었는가?
-- 기존 사용자 파일 보존 정책에 영향이 있는가?
-- update/diff/uninstall 동작이 서로 같은 추적 기준을 쓰는가?
-- 실패 시 사용자가 복구할 수 있는 메시지를 받는가?
+- business rule, domain invariant, 상태 전이에 영향이 있는가?
+- DB schema, migration, seed, data backfill, analytics event에 영향이 있는가?
+- public API, GraphQL schema, CLI command, request/response, SDK contract가 바뀌는가?
+- auth, permission, privacy, billing, credential, audit log에 영향이 있는가?
+- external integration, webhook, cron, queue, cache, background job에 영향이 있는가?
+- project-owned 문서, specs, runbook, operator guide, `docs/docs-status.md`, context-layer 갱신이 필요한가?

package/data/context-layer/docs/agent/terminology.md

@@ -0,0 +1,39 @@
+---
+status: Active
+layer: agent
+owner: ai-ops
+read_when:
+  - before_task
+  - terminology_check
+update_when:
+  - operating_layer_changes
+  - terminology_changes
+---
+# Agent Terminology
+
+이 문서는 project operating layer를 해석하는 데 필요한 최소 용어만 정의한다. `ai-ops-cli`의 release, 내부 구현, phase history, integration catalog 구현 세부사항은 사용자 프로젝트의 기본 운영 문서에 포함하지 않는다.
+
+## 핵심 용어
+
+| 용어 | 정의 |
+| --- | --- |
+| agent operating layer | 프로젝트 안에서 에이전트가 읽고 따르는 운영 문서와 상태 파일의 묶음이다. |
+| context layer | operating layer 문서의 경로, 상태, 읽기 조건, 갱신 조건, content hash를 추적하는 문맥 index다. |
+| `docs/docs-status.md` | operating layer 문서의 status와 owner를 사람이 확인할 수 있게 기록하는 project-owned registry다. |
+| `.ai-ops/context-layer.json` | 에이전트와 CLI가 문서 계층을 빠르게 탐색하고 audit할 수 있게 생성하는 index 파일이다. |
+| `Active` | 현재 판단 근거로 사용할 수 있는 문서 상태다. |
+| `Reserved` | 자리만 만든 문서 상태다. 프로젝트가 실제 내용을 보강하기 전까지 판단 근거로 사용하지 않는다. |
+| `Draft` | 작성 중인 문서 상태다. 현재 판단 근거로 쓰기 전에 검토가 필요하다. |
+| `Archived` | 과거 기록 상태다. 현재 운영 판단에 사용하지 않는다. |
+| ai-ops managed | CLI 템플릿이 관리하는 문서 또는 문서 영역이다. update 시 현재 CLI 템플릿으로 다시 적용될 수 있다. |
+| project-owned | 프로젝트가 직접 채우고 유지하는 문서다. CLI update는 사용자 내용을 보존해야 한다. |
+| optional pack | 필요한 프로젝트에만 설치하는 추가 문서 묶음이다. 기본 operating layer와 별도의 lifecycle을 가진다. |
+| `read_when` | 에이전트가 이 문서를 읽어야 하는 상황을 나타내는 frontmatter 필드다. |
+| `update_when` | 문서를 갱신해야 하는 변경 상황을 나타내는 frontmatter 필드다. |
+
+## 범위 밖
+
+- `ai-ops-cli` release model
+- `ai-ops-cli` 내부 phase history
+- CLI 구현 파일이나 schema의 내부 구조
+- integration catalog의 구현 세부사항

package/data/context-layer/docs/agent/workflow.md

@@ -7,16 +7,30 @@ read_when:
 update_when:
   - workflow_changes
 ---
+
 # Workflow
 
-## 기본 흐름
+이 문서는 에이전트의 기본 구현/검증 루프를 대체하지 않는다. 프로젝트별 문맥을 언제 읽고, 변경 영향과 문서 갱신 필요성을 언제 판단할지 정한다.
+
+## 전역 guardrail
+
+모든 단계에서 `docs/agent/rules/stop-rules.md`를 적용한다. 삭제, reset, credential 노출, 운영 데이터 접근, 계획과 코드 구조 충돌처럼 위험하거나 모호한 지점은 진행 전에 멈추고 확인한다.
+
+## 판단 흐름
+
+1. Intent Routing: 요청이 구현, 리뷰, 조사, 문서, 운영작업 중 무엇인지 분류하고 `docs/agent/rules/routing-rules.md`를 확인한다.
+2. Context Loading: `AGENTS.md`, `docs/agent/rules/00-agent-baseline.md`, `docs/agent/workflow.md`, 관련 `Active` 문서, 실제 코드와 파일을 확인한다.
+3. Change Impact Analysis: 변경 전후에 `docs/agent/checks/impact-checklist.md`를 사용해 영향 범위를 찾는다.
+4. Native Agent Execution: 구현, 수정, 검증 선택은 에이전트(e.g. codex)의 기본 작업 루프와 repo의 기존 패턴을 따른다.
+5. Context Update: 변경 결과가 project-owned 문서, specs, `docs/docs-status.md`, `.ai-ops/context-layer.json`에 영향을 주는지 판단한다.
+6. Report: 결과, 실행한 검증, 갱신한 문서, 남은 리스크를 짧게 보고한다.
+
+## 문서 사용 원칙
 
-1. 요청 범위와 현재 작업 디렉터리를 확인한다.
-2. 관련 문서의 `status`를 확인하고 `Active` 문서만 판단 근거로 사용한다.
-3. 코드 변경 전 현재 diff를 확인한다.
-4. 변경은 가능한 작은 단위로 적용한다.
-5. 변경 범위에 맞는 검증을 실행한다.
-6. 결과, 검증, 남은 리스크를 짧게 보고한다.
+- `Active` 문서만 현재 판단 근거로 사용한다.
+- `Reserved` 문서는 자리만 만든 문서이므로 현재 사실로 인용하지 않는다.
+- project-owned 문서가 비어 있거나 stale하면 실제 코드, 설정, schema, runtime 파일을 우선한다.
+- 문서 상태가 애매하면 `docs/docs-status.md`와 각 문서 frontmatter를 함께 확인한다.
 
 ## 보존 원칙
 

package/data/context-layer/docs/business/terminology.md

@@ -0,0 +1,61 @@
+---
+status: Reserved
+layer: business
+owner: project
+read_when:
+  - terminology_check
+  - business_rule_check
+  - spec_lifecycle
+update_when:
+  - terminology_changes
+  - business_rule_changes
+  - spec_lifecycle_changes
+---
+# Terminology
+
+이 문서는 Reserved 상태입니다. 프로젝트가 실제 용어를 보강하기 전까지 현재 판단 근거로 사용하지 마세요.
+
+프로젝트의 비즈니스, spec, UI, work packet, plan 용어는 이 문서를 source of truth로 사용합니다. `docs/specs/`가 설치되어 있어도 별도 용어 문서를 두지 않고 이 문서를 읽고 갱신합니다.
+
+## 용어 표기 원칙
+
+- 사용자-facing 또는 domain 용어는 한국어를 우선합니다.
+- code-facing name, API field, library/service name, protocol, file path, 표준 technical term은 영어 원형이 더 명확하면 그대로 씁니다.
+- 같은 개념은 하나의 canonical term으로 통일합니다.
+- 불확실한 용어는 확정하지 말고 `검토 중인 용어`에 기록합니다.
+
+## 핵심 용어
+
+| 용어 | 영문 / 코드명 | 정의 | 사용 범위 | 허용 별칭 | 금지 표현 | 관련 문서 |
+| --- | --- | --- | --- | --- | --- | --- |
+| TBD | TBD | TBD | TBD | TBD | TBD | TBD |
+
+## 엔티티 용어
+
+| 용어 | 영문 / 코드명 | 정의 | 사용 범위 | 허용 별칭 | 금지 표현 | 관련 문서 |
+| --- | --- | --- | --- | --- | --- | --- |
+| TBD | TBD | TBD | TBD | TBD | TBD | TBD |
+
+## 상태 용어
+
+| 용어 | 영문 / 코드명 | 정의 | 사용 범위 | 허용 별칭 | 금지 표현 | 관련 문서 |
+| --- | --- | --- | --- | --- | --- | --- |
+| TBD | TBD | TBD | TBD | TBD | TBD | TBD |
+
+## UI 용어
+
+| 용어 | 영문 / 코드명 | 정의 | 사용 범위 | 허용 별칭 | 금지 표현 | 관련 문서 |
+| --- | --- | --- | --- | --- | --- | --- |
+| TBD | TBD | TBD | TBD | TBD | TBD | TBD |
+
+## 금지하거나 피할 표현
+
+| 표현 | 이유 | 대신 사용할 표현 |
+| --- | --- | --- |
+| TBD | TBD | TBD |
+
+## 검토 중인 용어
+
+| 항목 | 후보 표현 | 충돌 / 불확실성 | 판단 메모 | 관련 문서 |
+| --- | --- | --- | --- | --- |
+| TBD | TBD | TBD | TBD | TBD |

package/data/packs/spec-lifecycle/docs/specs/README.ko.md

@@ -25,4 +25,5 @@ docs/specs/
 
 - `baseline/`은 승인된 제품/기술/UI 기준 문서를 둡니다.
 - `initial-build/`는 초기 구현 work packet과 관련 산출물을 둡니다.
+- 프로젝트 용어는 `docs/business/terminology.md`를 기준으로 관리합니다. 이 optional spec pack은 별도 용어 source of truth를 만들지 않습니다.
 - 실제 판단 근거로 쓰기 전에 각 문서의 frontmatter와 `docs/docs-status.md` 상태를 갱신합니다.

package/data/packs/spec-lifecycle/docs/specs/README.md

@@ -25,4 +25,5 @@ docs/specs/
 
 - `baseline/` contains approved product, technical, and UI baseline documents.
 - `initial-build/` contains initial implementation work packets and related artifacts.
+- Project terminology is tracked in `docs/business/terminology.md`; this optional spec pack does not create a separate terminology source of truth.
 - Before using any document as decision-making evidence, update its frontmatter and its status in `docs/docs-status.md`.

package/data/skills/README.ko.md

@@ -65,7 +65,7 @@ apps/cli/data/skills/
 
 1. 디렉터리 이름은 frontmatter `name`과 정확히 일치해야 합니다.
 2. `SKILL.md`는 YAML frontmatter로 시작해야 합니다.
-3. `kind`, `supported_tools`, preset grouping, `source_path`는 `skill-registry.json`에 둡니다.
+3. `kind`, `supported_tools`, 표시/discovery grouping, `source_path`는 `skill-registry.json`에 둡니다.
 4. `reference` skill은 `reference-skills/` 아래에 두고 `references/reference.md`를 포함해야 합니다.
 5. `task` skill은 `task-skills/` 아래에 두고 실행 절차를 `SKILL.md`에 둡니다.
 6. 같은 상세 내용을 `SKILL.md`와 `references/`에 중복하지 않습니다.
@@ -77,23 +77,22 @@ apps/cli/data/skills/
 
 `SKILL.md` frontmatter는 이제 agent-facing 용도입니다. CLI는 아래 필수 필드를 검증하고, 추가 도구별 frontmatter 필드는 무시합니다.
 
-| 필드 | 필수 | 예시 | 의미 |
-| --- | --- | --- | --- |
-| `name` | 예 | `graphql-contract` | 고유 skill 이름과 설치 디렉터리 key |
-| `description` | 예 | `Use when changing GraphQL schema contracts.` | discovery/autotrigger 요약 |
+| 필드          | 필수 | 예시                                          | 의미                                |
+| ------------- | ---- | --------------------------------------------- | ----------------------------------- |
+| `name`        | 예   | `graphql-contract`                            | 고유 skill 이름과 설치 디렉터리 key |
+| `description` | 예   | `Use when changing GraphQL schema contracts.` | discovery/autotrigger 요약          |
 
 ## Registry 필드
 
 `skill-registry.json`은 install/catalog SSOT입니다.
 
-| 필드 | 필수 | 예시 | 의미 |
-| --- | --- | --- | --- |
-| `id` | 예 | `graphql-contract` | canonical skill id |
-| `kind` | 예 | `reference` / `task` | skill category |
-| `supported_tools` | 예 | `["claude-code", "codex", "gemini"]` | 설치 가능한 도구 |
-| `groups` | 예 | `["frontend-web"]` | 표시/discovery grouping |
-| `included_in_presets` | 예 | `["frontend-web", "backend-ts"]` | `ai-ops init`에서 이 skill을 노출하는 preset |
-| `source_path` | 예 | `reference-skills/graphql-contract` | skill source가 있는 상대 디렉터리 |
+| 필드              | 필수 | 예시                                 | 의미                              |
+| ----------------- | ---- | ------------------------------------ | --------------------------------- |
+| `id`              | 예   | `graphql-contract`                   | canonical skill id                |
+| `kind`            | 예   | `reference` / `task`                 | skill category                    |
+| `supported_tools` | 예   | `["claude-code", "codex", "gemini"]` | 설치 가능한 도구                  |
+| `groups`          | 예   | `["frontend-web"]`                   | 표시/discovery grouping           |
+| `source_path`     | 예   | `reference-skills/graphql-contract`  | skill source가 있는 상대 디렉터리 |
 
 ## Content 배치
 

package/data/skills/README.md

@@ -65,7 +65,7 @@ apps/cli/data/skills/
 
 1. Directory name must exactly match frontmatter `name`.
 2. `SKILL.md` must start with YAML frontmatter.
-3. `kind`, `supported_tools`, preset grouping, and `source_path` live in `skill-registry.json`.
+3. `kind`, `supported_tools`, display grouping, and `source_path` live in `skill-registry.json`.
 4. A `reference` skill must live under `reference-skills/` and include `references/reference.md`.
 5. A `task` skill must live under `task-skills/` and keep its executable procedure in `SKILL.md`.
 6. Do not duplicate the same detailed content across `SKILL.md` and `references/`.
@@ -86,14 +86,13 @@ apps/cli/data/skills/
 
 `skill-registry.json` is the install/catalog SSOT.
 
-| Field                 | Required | Example                              | Meaning                                           |
-| --------------------- | -------- | ------------------------------------ | ------------------------------------------------- |
-| `id`                  | Yes      | `graphql-contract`                   | Canonical skill id                                |
-| `kind`                | Yes      | `reference` / `task`                 | Skill category                                    |
-| `supported_tools`     | Yes      | `["claude-code", "codex", "gemini"]` | Where the skill may be installed                  |
-| `groups`              | Yes      | `["frontend-web"]`                   | Display/discovery grouping                        |
-| `included_in_presets` | Yes      | `["frontend-web", "backend-ts"]`     | Presets that surface this skill in `ai-ops init`  |
-| `source_path`         | Yes      | `reference-skills/graphql-contract`  | Relative directory that contains the skill source |
+| Field             | Required | Example                              | Meaning                                           |
+| ----------------- | -------- | ------------------------------------ | ------------------------------------------------- |
+| `id`              | Yes      | `graphql-contract`                   | Canonical skill id                                |
+| `kind`            | Yes      | `reference` / `task`                 | Skill category                                    |
+| `supported_tools` | Yes      | `["claude-code", "codex", "gemini"]` | Where the skill may be installed                  |
+| `groups`          | Yes      | `["frontend-web"]`                   | Display/discovery grouping                        |
+| `source_path`     | Yes      | `reference-skills/graphql-contract`  | Relative directory that contains the skill source |
 
 ## Content Placement
 

package/data/skills/skill-registry.json

@@ -5,7 +5,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-python"],
-      "included_in_presets": [],
       "source_path": "reference-skills/ai-llm-python-runtime"
     },
     {
@@ -13,7 +12,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-python"],
-      "included_in_presets": ["backend-python"],
       "source_path": "reference-skills/backend-python-fastapi-runtime"
     },
     {
@@ -21,7 +19,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-ts", "backend-python"],
-      "included_in_presets": ["backend-ts", "backend-python"],
       "source_path": "reference-skills/backend-service-standards"
     },
     {
@@ -29,7 +26,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-ts"],
-      "included_in_presets": ["backend-ts"],
       "source_path": "reference-skills/backend-ts-nestjs-runtime"
     },
     {
@@ -37,7 +33,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-python"],
-      "included_in_presets": [],
       "source_path": "reference-skills/data-pipeline-python-performance"
     },
     {
@@ -45,7 +40,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-ts"],
-      "included_in_presets": ["backend-ts"],
       "source_path": "reference-skills/db-prisma-postgresql"
     },
     {
@@ -53,7 +47,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-python"],
-      "included_in_presets": ["backend-python"],
       "source_path": "reference-skills/db-sqlalchemy-postgresql"
     },
     {
@@ -61,7 +54,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["frontend-app"],
-      "included_in_presets": ["frontend-app"],
       "source_path": "reference-skills/frontend-app-flutter-runtime"
     },
     {
@@ -69,7 +61,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["frontend-web"],
-      "included_in_presets": ["frontend-web"],
       "source_path": "reference-skills/frontend-web-react-next-runtime"
     },
     {
@@ -77,7 +68,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["frontend-web"],
-      "included_in_presets": ["frontend-web"],
       "source_path": "reference-skills/frontend-web-shadcn-ui"
     },
     {
@@ -85,7 +75,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["frontend-web", "frontend-app"],
-      "included_in_presets": ["frontend-web", "frontend-app"],
       "source_path": "reference-skills/graphql-client-integration"
     },
     {
@@ -93,7 +82,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["frontend-web", "frontend-app", "backend-ts"],
-      "included_in_presets": ["frontend-web", "frontend-app", "backend-ts"],
       "source_path": "reference-skills/graphql-contract"
     },
     {
@@ -101,7 +89,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-ts"],
-      "included_in_presets": ["backend-ts"],
       "source_path": "reference-skills/graphql-server-runtime"
     },
     {
@@ -109,7 +96,6 @@
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["backend-python"],
-      "included_in_presets": ["backend-python"],
       "source_path": "reference-skills/python-language"
     },
     {
@@ -117,7 +103,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["agent-operating-layer"],
-      "included_in_presets": [],
       "source_path": "task-skills/doc-impact-reviewer"
     },
     {
@@ -125,7 +110,6 @@
       "kind": "task",
       "supported_tools": ["codex"],
       "groups": ["agent-operating-layer"],
-      "included_in_presets": [],
       "source_path": "task-skills/context-promotion-review"
     },
     {
@@ -133,7 +117,6 @@
       "kind": "task",
       "supported_tools": ["codex"],
       "groups": ["agent-operating-layer"],
-      "included_in_presets": [],
       "source_path": "task-skills/pc"
     },
     {
@@ -141,7 +124,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": [],
-      "included_in_presets": [],
       "source_path": "task-skills/skill-load-check"
     },
     {
@@ -149,7 +131,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
       "source_path": "task-skills/spec-baseline-sync"
     },
     {
@@ -157,7 +138,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
       "source_path": "task-skills/spec-product-01-idea-to-brief"
     },
     {
@@ -165,7 +145,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
       "source_path": "task-skills/spec-product-02-brief-to-technical-context"
     },
     {
@@ -173,7 +152,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
       "source_path": "task-skills/spec-product-03-brief-to-product-spec"
     },
     {
@@ -181,7 +159,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
       "source_path": "task-skills/spec-product-04-product-spec-to-ui-spec"
     },
     {
@@ -189,23 +166,20 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
       "source_path": "task-skills/spec-product-05-spec-to-work-packets"
     },
     {
-      "id": "spec-shared-glossary-sync",
+      "id": "project-terminology-sync",
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
-      "source_path": "task-skills/spec-shared-glossary-sync"
+      "source_path": "task-skills/project-terminology-sync"
     },
     {
       "id": "typescript-language",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["frontend-web", "backend-ts"],
-      "included_in_presets": ["frontend-web", "backend-ts"],
       "source_path": "reference-skills/typescript-language"
     }
   ]

package/data/skills/task-skills/context-promotion-review/SKILL.md

@@ -34,7 +34,7 @@ hook이 전달한 Project root가 이 검토의 유일한 프로젝트 기준이
    - `docs/docs-status.md`
    - `.ai-ops/context-layer.json`
    - `docs/agent/rules/*`
-   - `docs/agent/checks/*`
+   - `docs/agent/checks/impact-checklist.md`
 5. context layer 파일이 없으면 absent로 기록하고, 다른 repo에서 대체 근거를 찾지 않는다.
 6. 이미 있는 규칙이면 `already-covered`로 보고하고 새 승격 후보로 만들지 않는다.
 7. 새 후보가 있으면 `core`, `project-local`, `global` 중 하나 이상으로 분류하고, 추천 위치를 제안한다.

package/data/skills/task-skills/doc-impact-reviewer/SKILL.md

@@ -41,7 +41,6 @@ staged 변경과 untracked 파일도 구현 영향에 포함한다.
 - `.ai-ops/context-layer.json`
 - `docs/agent/rules/doc-update-rules.md`
 - `docs/agent/checks/impact-checklist.md`
-- `docs/agent/checks/review-checklist.md`
 
 필요하면 변경 파일과 가까운 README, runbook, spec, API 문서도 읽되, 전체 문서를 기계적으로 훑지 않는다.