ai-ops-cli 1.2.0 → 1.3.0

package/README.ko.md

@@ -48,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
@@ -71,7 +70,7 @@ 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 상태 파일입니다.
 

package/README.md

@@ -48,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
@@ -71,7 +70,7 @@ 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.
 

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/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/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,7 +166,6 @@
       "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"
     },
     {
@@ -197,7 +173,6 @@
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
       "groups": ["spec-lifecycle"],
-      "included_in_presets": [],
       "source_path": "task-skills/spec-shared-glossary-sync"
     },
     {
@@ -205,7 +180,6 @@
       "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 문서도 읽되, 전체 문서를 기계적으로 훑지 않는다.