ai-ops-cli 1.1.1 → 1.3.0

package/README.ko.md

@@ -2,9 +2,9 @@
 
 [English](./README.md)
 
-`ai-ops-cli`는 프로젝트에 AI agent operating layer를 설치하고, 사용자 환경에 agent skills/subagents를 설치하는 CLI입니다.
+`ai-ops-cli`는 프로젝트/에이전트 작업에 필요한 operating layer와 global runtime integration을 설치하고 관리하는 CLI입니다.
 
-이 문서는 현재 구현된 breaking model을 설명합니다. old rules + skills scaffolder 모델은 deprecated 문맥으로만 남깁니다.
+이 문서는 현재 구현된 breaking model을 설명합니다. 현재 CLI는 bundled user/global runtime workflow를 위한 `integration` 명령을 제공하고, skill, subagent, Codex hook, user-local receipt를 다루는 low-level component 명령도 계속 제공합니다. old rules + skills scaffolder 모델은 deprecated 문맥으로만 남깁니다.
 
 ## Current Breaking Model
 
@@ -16,19 +16,23 @@ flowchart TD
   layer --> docs["docs/agent/* / docs/business/*"]
   layer --> state[".ai-ops/manifest.json / context-layer.json"]
 
-  skill["ai-ops skill ..."] --> globalSkills["Global skills only"]
-  subagent["ai-ops subagent ..."] --> globalSubagents["Global subagents only"]
+  skill["ai-ops skill ..."] --> skillComponent["Skill components"]
+  subagent["ai-ops subagent ..."] --> subagentComponent["Subagent components"]
+  integration["ai-ops integration ..."] --> integrationComponent["Runtime integration bundles"]
+  hook["ai-ops codex-hook ..."] --> hookComponent["Codex hook components"]
+  receipt["ai-ops context-promotion ..."] --> receiptComponent["User-local receipts"]
   pack["ai-ops pack ..."] --> docsSpecs["optional docs/specs/ pack"]
 ```
 
 핵심 경계:
 
 - project scope는 operating layer 문서만 관리합니다.
-- global scope는 skills/subagents만 관리합니다.
+- integration scope는 user/global runtime workflow만 관리합니다.
+- skill, subagent, Codex hook, user-local receipt/config는 integration component입니다.
 - `AGENTS.md`가 canonical entrypoint입니다.
 - `GEMINI.md`와 `CLAUDE.md`는 `AGENTS.md`를 기준으로 삼게 하는 adapter입니다.
 - `docs/specs/`는 optional pack 위치입니다.
-- global asset 명령은 `AI_OPS_HOME` 또는 `HOME`이 없으면 cwd fallback 없이 실패합니다.
+- integration component 명령은 `AI_OPS_HOME` 또는 `HOME`이 없으면 cwd fallback 없이 실패합니다.
 
 ## 설치 대상
 
@@ -44,7 +48,6 @@ 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/business-rules.md
 docs/docs-status.md
@@ -54,18 +57,20 @@ docs/docs-status.md
 
 `docs/agent/rules/00-agent-baseline.md`는 기존 `role-persona`, `communication`, `code-philosophy`, `naming-convention`, `plan-mode`의 기본 의도를 새 operating layer 문서로 이관한 Active 규칙입니다. `AGENTS.md` 직후 먼저 읽습니다.
 
-Global tool home:
+User/global runtime component home:
 
 ```text
 skills/*
 subagents/*
+hooks/*
+receipts/config/*
 ```
 
 ## 수정 FAQ
 
 ### `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 상태 파일입니다.
 
@@ -92,15 +97,32 @@ Commands:
   update     Re-apply the project operating layer
   audit      Check frontmatter, docs-status, manifest, and context-layer consistency
   uninstall  Remove project-managed operating layer files
-  skill      Manage global agent skills
-  subagent   Manage global agent subagents
+  skill      Manage skill components
+  subagent   Manage subagent components
   pack       Manage optional project operating layer packs
+  integration Manage user/global runtime integrations
   context-promotion Manage context promotion review receipts
-  codex-hook Manage Codex hook integration
+  codex-hook Manage Codex hook components
 ```
 
 `--tool`은 유지합니다. Codex, Claude Code, Gemini CLI가 서로 다른 discovery 위치와 adapter 파일을 사용하기 때문입니다.
 
+Integration lifecycle 명령:
+
+```bash
+ai-ops integration list
+ai-ops integration install context-promotion
+ai-ops integration install pc
+ai-ops integration status pc
+ai-ops integration uninstall pc
+```
+
+`context-promotion`은 `context-promotion-review` Codex skill, Codex `PostToolUse` hook, user-local receipt workflow를 묶습니다.
+
+`pc`는 `pc` Codex skill과 Codex `PostToolUse` hook runner를 묶습니다. 성공적인 `git commit` 이후 `~/.personal-project-contexts/`에 matching workspace, active workstream, current repo scope가 이미 준비된 경우에만 Codex가 `$pc:done`으로 이어가게 합니다.
+
+Integration 소유권은 user/global runtime home의 `.ai-ops/integrations-manifest.json`에 기록합니다. Uninstall은 owned component만 제거하고 기존 수동 설치는 보존합니다.
+
 Skill lifecycle 명령:
 
 ```bash
@@ -115,7 +137,9 @@ ai-ops skill uninstall skill-load-check
 
 `doc-impact-reviewer`는 변경 완료 또는 커밋 직전에 운영 문서 영향도를 확인하는 수동 task skill입니다. `$doc-impact-reviewer`로 호출하면 git status/diff를 보고 `required / recommended / not needed` 문서 후보와 미갱신 리스크를 제안합니다. 사용자 승인 전에는 문서를 수정하지 않고, 직접 staging/commit도 하지 않습니다.
 
-`context-promotion-review`는 방금 만든 작업 커밋에서 core, project-local, global로 승격할 반복 운영 지식이 생겼는지 확인하는 Codex 전용 task skill입니다. Codex hook은 `git commit` 이후에 동작하며 작업 커밋을 막지 않습니다. hook 설치 시 Codex skill도 global 위치에 함께 설치합니다. 승인된 승격 수정은 사용자 검사를 위해 커밋하지 않은 상태로 남기고, 최종 결정은 `ai-ops context-promotion resolve`로 receipt에 기록합니다.
+`context-promotion-review`는 방금 만든 작업 커밋에서 core, project-local, global로 승격할 반복 운영 지식이 생겼는지 확인하는 Codex 전용 task skill입니다. Codex hook은 `git commit` 이후에 동작하며 작업 커밋을 막지 않습니다. hook 설치 시 Codex skill도 user/global runtime 위치에 함께 설치합니다. 승인된 승격 수정은 사용자 검사를 위해 커밋하지 않은 상태로 남기고, 최종 결정은 `ai-ops context-promotion resolve`로 receipt에 기록합니다.
+
+Low-level component 명령도 직접 skill, hook, receipt를 관리할 때 계속 사용할 수 있습니다.
 
 Context promotion과 Codex hook 명령:
 
@@ -139,7 +163,7 @@ ai-ops subagent update
 ai-ops subagent uninstall security-gate
 ```
 
-Subagent는 항상 global tool home에 설치됩니다. Codex는 `.codex/agents/<id>.toml`, Claude Code는 `.claude/agents/<id>.md`, Gemini CLI는 `.gemini/agents/<id>.md`를 사용하고, 상태는 `.ai-ops/subagents-manifest.json`에만 기록합니다.
+Subagent는 항상 user/global runtime home에 설치됩니다. Codex는 `.codex/agents/<id>.toml`, Claude Code는 `.claude/agents/<id>.md`, Gemini CLI는 `.gemini/agents/<id>.md`를 사용하고, 상태는 `.ai-ops/subagents-manifest.json`에만 기록합니다.
 
 Pack lifecycle 명령:
 

package/README.md

@@ -2,9 +2,9 @@
 
 [Korean](./README.ko.md)
 
-`ai-ops-cli` installs an AI agent operating layer into a project and installs reusable agent skills/subagents into the user's global tool environment.
+`ai-ops-cli` installs and manages the operating layer and global runtime integrations needed for project/agent work.
 
-This document describes the currently implemented breaking model. The old rules + skills scaffolder model remains only as deprecated context.
+This document describes the currently implemented breaking model. The current CLI exposes `integration` commands for bundled user/global runtime workflows and keeps low-level component commands for skills, subagents, Codex hooks, and user-local receipts. The old rules + skills scaffolder model remains only as deprecated context.
 
 ## Current Breaking Model
 
@@ -16,19 +16,23 @@ flowchart TD
   layer --> docs["docs/agent/* / docs/business/*"]
   layer --> state[".ai-ops/manifest.json / context-layer.json"]
 
-  skill["ai-ops skill ..."] --> globalSkills["Global skills only"]
-  subagent["ai-ops subagent ..."] --> globalSubagents["Global subagents only"]
+  skill["ai-ops skill ..."] --> skillComponent["Skill components"]
+  subagent["ai-ops subagent ..."] --> subagentComponent["Subagent components"]
+  integration["ai-ops integration ..."] --> integrationComponent["Runtime integration bundles"]
+  hook["ai-ops codex-hook ..."] --> hookComponent["Codex hook components"]
+  receipt["ai-ops context-promotion ..."] --> receiptComponent["User-local receipts"]
   pack["ai-ops pack ..."] --> docsSpecs["optional docs/specs/ pack"]
 ```
 
 Core boundaries:
 
 - Project scope manages only operating-layer documents.
-- Global scope manages only skills/subagents.
+- Integration scope manages only user/global runtime workflow.
+- Skills, subagents, Codex hooks, and user-local receipts/config are integration components.
 - `AGENTS.md` is the canonical entrypoint.
 - `GEMINI.md` and `CLAUDE.md` are adapters that point tools back to `AGENTS.md`.
 - `docs/specs/` is the optional pack location.
-- Global asset commands require `AI_OPS_HOME` or `HOME`; they fail closed without cwd fallback when neither exists.
+- Integration component commands require `AI_OPS_HOME` or `HOME`; they fail closed without cwd fallback when neither exists.
 
 ## Install Targets
 
@@ -44,7 +48,6 @@ 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/business-rules.md
 docs/docs-status.md
@@ -54,18 +57,20 @@ docs/docs-status.md
 
 `docs/agent/rules/00-agent-baseline.md` is the Active rule that carries the original intent of the old `role-persona`, `communication`, `code-philosophy`, `naming-convention`, and `plan-mode` rules into the new operating layer. It is read immediately after `AGENTS.md`.
 
-Global tool home:
+User/global runtime component home:
 
 ```text
 skills/*
 subagents/*
+hooks/*
+receipts/config/*
 ```
 
 ## Editing FAQ
 
 ### 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.
 
@@ -92,15 +97,32 @@ Commands:
   update     Re-apply the project operating layer
   audit      Check frontmatter, docs-status, manifest, and context-layer consistency
   uninstall  Remove project-managed operating layer files
-  skill      Manage global agent skills
-  subagent   Manage global agent subagents
+  skill      Manage skill components
+  subagent   Manage subagent components
   pack       Manage optional project operating layer packs
+  integration Manage user/global runtime integrations
   context-promotion Manage context promotion review receipts
-  codex-hook Manage Codex hook integration
+  codex-hook Manage Codex hook components
 ```
 
 `--tool` remains because Codex, Claude Code, and Gemini CLI use different discovery locations and adapter files.
 
+Integration lifecycle commands:
+
+```bash
+ai-ops integration list
+ai-ops integration install context-promotion
+ai-ops integration install pc
+ai-ops integration status pc
+ai-ops integration uninstall pc
+```
+
+`context-promotion` bundles the `context-promotion-review` Codex skill, a Codex `PostToolUse` hook, and user-local receipt workflow.
+
+`pc` bundles the `pc` Codex skill and a Codex `PostToolUse` hook runner. It prompts Codex to run `$pc:done` after a successful `git commit` only when `~/.personal-project-contexts/` already has a matching workspace, active workstream, and current repo scope.
+
+Integration ownership is tracked in `.ai-ops/integrations-manifest.json` under the user/global runtime home. Uninstall removes only owned components and preserves pre-existing manual installs.
+
 Skill lifecycle commands:
 
 ```bash
@@ -115,7 +137,9 @@ ai-ops skill uninstall skill-load-check
 
 `doc-impact-reviewer` is a manual task skill for checking operating-document impact near the end of work or before commit. Invoking `$doc-impact-reviewer` reads git status/diff and reports document update candidates as `required / recommended / not needed`. It does not edit documents, stage files, or commit before user approval.
 
-`context-promotion-review` is a Codex-only task skill for checking whether the just-created work commit produced reusable operating knowledge that should be promoted to core, project-local, or global context. The Codex hook runs after `git commit`, never blocks the work commit, and any approved promotion edits stay uncommitted until the user reviews them. Installing the hook also installs the Codex skill globally. It records the final decision with `ai-ops context-promotion resolve`.
+`context-promotion-review` is a Codex-only task skill for checking whether the just-created work commit produced reusable operating knowledge that should be promoted to core, project-local, or global context. The Codex hook runs after `git commit`, never blocks the work commit, and any approved promotion edits stay uncommitted until the user reviews them. Installing the hook also installs the Codex skill into the user/global runtime location. It records the final decision with `ai-ops context-promotion resolve`.
+
+Low-level component commands remain available for direct skill, hook, and receipt management.
 
 Context promotion and Codex hook commands:
 
@@ -139,7 +163,7 @@ ai-ops subagent update
 ai-ops subagent uninstall security-gate
 ```
 
-Subagents are always installed into the global tool home. Codex uses `.codex/agents/<id>.toml`, Claude Code uses `.claude/agents/<id>.md`, Gemini CLI uses `.gemini/agents/<id>.md`, and state is recorded only in `.ai-ops/subagents-manifest.json`.
+Subagents are always installed into the user/global runtime home. Codex uses `.codex/agents/<id>.toml`, Claude Code uses `.claude/agents/<id>.md`, Gemini CLI uses `.gemini/agents/<id>.md`, and state is recorded only in `.ai-ops/subagents-manifest.json`.
 
 Pack lifecycle commands:
 

package/data/context-layer/AGENTS.md

@@ -17,7 +17,7 @@ update_when:
 2. `docs/agent/rules/00-agent-baseline.md`
 3. `docs/agent/workflow.md`
 4. 나머지 `docs/agent/rules/*.md`
-5. 작업 성격에 맞는 `docs/agent/checks/*.md`
+5. 변경 영향 확인이 필요하면 `docs/agent/checks/impact-checklist.md`
 6. `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/rules/routing-rules.md

@@ -19,4 +19,5 @@ update_when:
 ## 범위
 
 - project scope: `AGENTS.md`, `GEMINI.md`, `CLAUDE.md`, `docs/agent/*`, `docs/business/*`, `docs/docs-status.md`, `.ai-ops/*`
-- global scope: skills, subagents, tool-specific reusable assets
+- integration scope: user/global runtime integrations and their components
+- component scope: skills, subagents, Codex hooks, hook runners, user-local receipts/config

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

@@ -7,19 +7,33 @@ 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를 함께 확인한다.
 
 ## 보존 원칙
 
 - 사용자 변경으로 보이는 diff는 되돌리지 않는다.
 - project-owned 문서는 CLI update가 덮어쓰지 않는다.
-- global skills와 subagents는 project operating layer uninstall 대상이 아니다.
+- user/global integrations와 그 component는 project operating layer uninstall 대상이 아니다.

package/data/integrations/integration-registry.json

@@ -0,0 +1,44 @@
+{
+  "integrations": [
+    {
+      "id": "context-promotion",
+      "description": "Codex git-commit 후 context promotion review receipt를 요구하는 integration",
+      "components": [
+        {
+          "type": "skill",
+          "id": "context-promotion-review",
+          "tools": ["codex"]
+        },
+        {
+          "type": "codex-hook",
+          "id": "context-promotion"
+        },
+        {
+          "type": "receipt-config",
+          "id": "context-promotion-receipts",
+          "storage_path": ".ai-ops/context-promotion/projects/*/receipts-index.json"
+        }
+      ]
+    },
+    {
+      "id": "pc",
+      "description": "Codex git-commit 후 $pc:done handoff를 요구하는 personal context integration",
+      "components": [
+        {
+          "type": "skill",
+          "id": "pc",
+          "tools": ["codex"]
+        },
+        {
+          "type": "codex-hook",
+          "id": "pc"
+        },
+        {
+          "type": "receipt-config",
+          "id": "personal-project-contexts",
+          "storage_path": "~/.personal-project-contexts"
+        }
+      ]
+    }
+  ]
+}

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