ai-ops-cli 0.2.6 → 1.0.1

package/data/context-layer/docs/agent/rules/stop-rules.md

@@ -0,0 +1,20 @@
+---
+status: Active
+layer: agent
+owner: ai-ops
+read_when:
+  - before_destructive_action
+  - before_external_side_effect
+update_when:
+  - safety_policy_changes
+---
+# Stop Rules
+
+## 멈추고 확인할 때
+
+- 삭제, reset, 강제 overwrite처럼 복구가 어려운 작업이 필요한 경우
+- credential, 개인 정보, 운영 데이터가 노출될 수 있는 경우
+- 계획 문서와 실제 코드 구조가 충돌해 임의 판단이 위험한 경우
+- 검증 실패 원인이 환경 문제인지 구현 문제인지 구분되지 않는 경우
+
+확인이 필요한 지점은 짧게 설명하고, 안전한 대안이 있으면 함께 제시한다.

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

@@ -0,0 +1,25 @@
+---
+status: Active
+layer: agent
+owner: ai-ops
+read_when:
+  - before_task
+update_when:
+  - workflow_changes
+---
+# Workflow
+
+## 기본 흐름
+
+1. 요청 범위와 현재 작업 디렉터리를 확인한다.
+2. 관련 문서의 `status`를 확인하고 `Active` 문서만 판단 근거로 사용한다.
+3. 코드 변경 전 현재 diff를 확인한다.
+4. 변경은 가능한 작은 단위로 적용한다.
+5. 변경 범위에 맞는 검증을 실행한다.
+6. 결과, 검증, 남은 리스크를 짧게 보고한다.
+
+## 보존 원칙
+
+- 사용자 변경으로 보이는 diff는 되돌리지 않는다.
+- project-owned 문서는 CLI update가 덮어쓰지 않는다.
+- global skills와 subagents는 project operating layer uninstall 대상이 아니다.

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

@@ -0,0 +1,16 @@
+---
+status: Reserved
+layer: business
+owner: project
+read_when:
+  - business_rule_check
+update_when:
+  - business_rule_changes
+---
+# Business Rules
+
+이 문서는 Reserved 상태입니다. 프로젝트가 실제 규칙을 보강하기 전까지 현재 판단 근거로 사용하지 마세요.
+
+## 규칙
+
+- TBD

package/data/context-layer/docs/docs-status.md

@@ -0,0 +1,14 @@
+---
+status: Active
+layer: status
+owner: project
+read_when:
+  - before_task
+update_when:
+  - document_status_changes
+---
+# Docs Status
+
+| path | status | owner |
+| --- | --- | --- |
+{{documents_table}}

package/data/packs/pack-registry.json

@@ -0,0 +1,8 @@
+{
+  "packs": [
+    {
+      "id": "spec-lifecycle",
+      "source_path": "spec-lifecycle"
+    }
+  ]
+}

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

@@ -0,0 +1,26 @@
+---
+status: Reserved
+layer: spec
+owner: project
+read_when:
+  - spec_lifecycle
+update_when:
+  - spec_lifecycle_changes
+---
+# Specs
+
+이 문서는 Reserved 상태입니다. 프로젝트가 실제 spec lifecycle 문서를 보강하기 전까지 현재 판단 근거로 사용하지 마세요.
+
+## 디렉토리 구조
+
+```text
+docs/specs/
+├── baseline/
+└── initial-build/
+```
+
+## 기준
+
+- `baseline/`은 승인된 제품/기술/UI 기준 문서를 둡니다.
+- `initial-build/`는 초기 구현 work packet과 관련 산출물을 둡니다.
+- 실제 판단 근거로 쓰기 전에 각 문서의 frontmatter와 `docs/docs-status.md` 상태를 갱신합니다.

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

@@ -0,0 +1,26 @@
+---
+status: Reserved
+layer: spec
+owner: project
+read_when:
+  - spec_lifecycle
+update_when:
+  - spec_lifecycle_changes
+---
+# Specs
+
+This document is Reserved. Do not use this document as current decision-making evidence until the project fills in real spec lifecycle documents.
+
+## Directory Structure
+
+```text
+docs/specs/
+├── baseline/
+└── initial-build/
+```
+
+## Rules
+
+- `baseline/` contains approved product, technical, and UI baseline documents.
+- `initial-build/` contains initial implementation work packets and related artifacts.
+- Before using any document as decision-making evidence, update its frontmatter and its status in `docs/docs-status.md`.

package/data/packs/spec-lifecycle/docs/specs/baseline/.gitkeep

@@ -0,0 +1 @@
+

package/data/packs/spec-lifecycle/docs/specs/initial-build/.gitkeep

@@ -0,0 +1 @@
+

package/data/skills/README.ko.md

@@ -0,0 +1,182 @@
+# Skill 작성 가이드
+
+이 디렉터리는 설치 가능한 agent skill의 source of truth입니다.
+
+## 용어
+
+### Reference Skill
+
+`reference skill`은 lazy-load되는 지식 pack입니다.
+
+- 정식 상세 내용은 `references/reference.md`에 둡니다.
+- `SKILL.md`는 얇게 유지하고, agent가 언제 skill을 써야 하는지와 무엇을 먼저 읽어야 하는지만 안내합니다.
+- 표준, stack 가이드, 큰 도메인 reference에 사용합니다.
+
+### Task Skill
+
+`task skill`은 절차형 workflow입니다.
+
+- 정식 절차는 `SKILL.md`에 둡니다.
+- `references/`는 선택적인 보조 자료입니다.
+- 반복 가능한 점검, 작업, guided workflow에 사용합니다.
+
+### Task Skill 사용
+
+반복되는 운영 절차는 task skill로 둡니다. 예를 들어 `doc-impact-reviewer`는 변경 완료 또는 커밋 직전에 diff를 확인하고, 갱신 후보 문서를 `required / recommended / not needed`로 제안한 뒤 사용자 승인 후 승인된 문서만 수정합니다.
+
+승인이 필요한 task skill은 자동 호출을 막습니다.
+
+- Codex: `agents/openai.yaml`에 `policy.allow_implicit_invocation: false`를 둡니다.
+- Claude Code: `SKILL.md` frontmatter에 `disable-model-invocation: true`를 둡니다.
+- Gemini CLI: skill-level explicit-only flag가 없으므로 본문에 명시 호출 전용 규칙을 적습니다.
+
+설치 예시:
+
+```bash
+ai-ops skill install doc-impact-reviewer --tool codex
+```
+
+## 디렉터리 구조
+
+```text
+apps/cli/data/skills/
+  README.md
+  README.ko.md
+  skill-registry.json
+  reference-skills/
+    <skill-name>/
+      SKILL.md
+      agents/       # optional
+      references/   # required for reference skills
+      assets/       # optional
+      scripts/      # optional
+  task-skills/
+    <skill-name>/
+      SKILL.md
+      references/   # optional
+      assets/       # optional
+      scripts/      # optional
+```
+
+## 작성 규칙
+
+1. 디렉터리 이름은 frontmatter `name`과 정확히 일치해야 합니다.
+2. `SKILL.md`는 YAML frontmatter로 시작해야 합니다.
+3. `kind`, `supported_tools`, preset 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/`에 중복하지 않습니다.
+7. 도구별 metadata는 skill source 안에 직접 작성하고 CLI가 그대로 복사합니다.
+8. Codex와 Gemini는 `.agents/skills/<skill-name>`에 설치합니다. Claude는 `.claude/skills/<skill-name>`에 설치합니다.
+9. CLI는 skill 디렉터리 트리 전체를 그대로 복사하므로 `agents/`, `references/`, `assets/`, `scripts/` 아래 파일은 변경 없이 설치됩니다.
+
+## Frontmatter 필드
+
+`SKILL.md` frontmatter는 이제 agent-facing 용도입니다. CLI는 아래 필수 필드를 검증하고, 추가 도구별 frontmatter 필드는 무시합니다.
+
+| 필드 | 필수 | 예시 | 의미 |
+| --- | --- | --- | --- |
+| `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가 있는 상대 디렉터리 |
+
+## Content 배치
+
+### Reference Skill
+
+- `SKILL.md`: 짧은 routing note
+- `references/reference.md`: 전체 상세 내용
+
+### Task Skill
+
+- `SKILL.md`: 실행 가능한 전체 절차
+- `references/`: 선택적인 배경 자료
+- `scripts/`: 선택적인 실행 helper
+
+## 도구별 호출 제어
+
+skill을 explicit-only로 만들어야 하면 skill 작성자가 도구별 metadata를 직접 추가해야 합니다.
+
+### Codex
+
+`agents/openai.yaml`을 직접 만듭니다.
+
+```yaml
+allow_implicit_invocation: false
+```
+
+- Codex가 description만 보고 skill을 자동 호출하면 안 될 때 사용합니다.
+- CLI가 전체 디렉터리 트리를 복사하므로 `agents/openai.yaml`은 그대로 설치됩니다.
+
+### Claude Code
+
+`SKILL.md` frontmatter에 `disable-model-invocation: true`를 직접 추가합니다.
+
+```yaml
+---
+name: deploy-script
+description: Runs the deployment workflow.
+disable-model-invocation: true
+---
+```
+
+- Claude가 명시적인 `/skill-name` 호출로만 skill을 로드해야 할 때 사용합니다.
+- CLI는 이 추가 frontmatter 필드를 보존하고 자동 생성하지 않습니다.
+
+### Gemini CLI
+
+Gemini CLI는 현재 implicit invocation 비활성화를 위한 skill-level frontmatter flag를 제공하지 않습니다.
+
+- Gemini에서 explicit-only 동작이 필요하면 custom command를 사용합니다.
+- 가짜 Gemini 전용 필드를 `SKILL.md`에 추가하지 마세요. Gemini가 해석하지 않습니다.
+
+## 예시
+
+### Reference Skill Skeleton
+
+```text
+reference-skills/graphql-contract/
+  SKILL.md
+  agents/
+    openai.yaml      # optional
+  references/
+    reference.md
+```
+
+### Task Skill Skeleton
+
+```text
+task-skills/skill-load-check/
+  SKILL.md
+  scripts/
+    loaded.js
+```
+
+## 임시 검증 Skill
+
+`skill-load-check`는 임시 검증 skill 예시입니다.
+
+- description은 좁고 test-focused하게 유지합니다.
+- 본문은 짧고 절차형으로 유지합니다.
+- install/load workflow가 검증된 뒤에는 나중에 삭제해도 됩니다.
+
+## 운영 Task Skill
+
+`doc-impact-reviewer`는 운영 문서 영향도를 수동으로 검토하는 task skill입니다.
+
+- git status, diff, 변경 파일, 관련 operating-layer 문서를 읽습니다.
+- 편집 전에 문서 후보와 리스크를 보고합니다.
+- 사용자 확인 전에는 편집하지 않습니다.
+- staging, commit, hook 설치를 직접 수행하지 않습니다.

package/data/skills/README.md

@@ -20,11 +20,28 @@ A `task skill` is a procedural workflow.
 - `references/` is optional supporting material only
 - Use it for repeatable checks, actions, and guided workflows
 
+### Task Skill Usage
+
+Keep repeatable operating procedures as task skills. For example, `doc-impact-reviewer` checks the diff when work is finished or just before commit, classifies document update candidates as `required / recommended / not needed`, and edits only the documents the user approves.
+
+Disable automatic invocation for task skills that require explicit approval.
+
+- Codex: add `policy.allow_implicit_invocation: false` to `agents/openai.yaml`.
+- Claude Code: add `disable-model-invocation: true` to the `SKILL.md` frontmatter.
+- Gemini CLI: there is no skill-level explicit-only flag, so write the explicit-invocation rule in the skill body.
+
+Install example:
+
+```bash
+ai-ops skill install doc-impact-reviewer --tool codex
+```
+
 ## Directory Shape
 
 ```text
 apps/cli/data/skills/
   README.md
+  README.ko.md
   skill-registry.json
   reference-skills/
     <skill-name>/
@@ -45,7 +62,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`, `install_scopes`, preset grouping, and `source_path` live in `skill-registry.json`.
+3. `kind`, `supported_tools`, preset 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/`.
@@ -71,7 +88,6 @@ apps/cli/data/skills/
 | `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                  |
-| `install_scopes`      | Yes      | `["project", "user"]`                | Allowed install scopes                            |
 | `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 |
@@ -155,3 +171,12 @@ task-skills/skill-load-check/
 - Keep the description narrow and test-focused
 - Keep the body short and procedural
 - It is acceptable to delete this skill later once the install/load workflow is proven
+
+## Operating Task Skills
+
+`doc-impact-reviewer` is a task skill for manually reviewing operating-document impact.
+
+- It reads git status, diffs, changed files, and related operating-layer documents.
+- It reports document candidates and risk before editing.
+- It does not edit before user confirmation.
+- It does not stage, commit, or install hooks by itself.

package/data/skills/skill-registry.json

@@ -4,7 +4,6 @@
       "id": "ai-llm-python-runtime",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-python"],
       "included_in_presets": [],
       "source_path": "reference-skills/ai-llm-python-runtime"
@@ -13,7 +12,6 @@
       "id": "backend-python-fastapi-runtime",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-python"],
       "included_in_presets": ["backend-python"],
       "source_path": "reference-skills/backend-python-fastapi-runtime"
@@ -22,7 +20,6 @@
       "id": "backend-service-standards",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-ts", "backend-python"],
       "included_in_presets": ["backend-ts", "backend-python"],
       "source_path": "reference-skills/backend-service-standards"
@@ -31,7 +28,6 @@
       "id": "backend-ts-nestjs-runtime",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-ts"],
       "included_in_presets": ["backend-ts"],
       "source_path": "reference-skills/backend-ts-nestjs-runtime"
@@ -40,7 +36,6 @@
       "id": "data-pipeline-python-performance",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-python"],
       "included_in_presets": [],
       "source_path": "reference-skills/data-pipeline-python-performance"
@@ -49,7 +44,6 @@
       "id": "db-prisma-postgresql",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-ts"],
       "included_in_presets": ["backend-ts"],
       "source_path": "reference-skills/db-prisma-postgresql"
@@ -58,7 +52,6 @@
       "id": "db-sqlalchemy-postgresql",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-python"],
       "included_in_presets": ["backend-python"],
       "source_path": "reference-skills/db-sqlalchemy-postgresql"
@@ -67,7 +60,6 @@
       "id": "frontend-app-flutter-runtime",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["frontend-app"],
       "included_in_presets": ["frontend-app"],
       "source_path": "reference-skills/frontend-app-flutter-runtime"
@@ -76,7 +68,6 @@
       "id": "frontend-web-react-next-runtime",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["frontend-web"],
       "included_in_presets": ["frontend-web"],
       "source_path": "reference-skills/frontend-web-react-next-runtime"
@@ -85,7 +76,6 @@
       "id": "frontend-web-shadcn-ui",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["frontend-web"],
       "included_in_presets": ["frontend-web"],
       "source_path": "reference-skills/frontend-web-shadcn-ui"
@@ -94,7 +84,6 @@
       "id": "graphql-client-integration",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["frontend-web", "frontend-app"],
       "included_in_presets": ["frontend-web", "frontend-app"],
       "source_path": "reference-skills/graphql-client-integration"
@@ -103,7 +92,6 @@
       "id": "graphql-contract",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["frontend-web", "frontend-app", "backend-ts"],
       "included_in_presets": ["frontend-web", "frontend-app", "backend-ts"],
       "source_path": "reference-skills/graphql-contract"
@@ -112,7 +100,6 @@
       "id": "graphql-server-runtime",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-ts"],
       "included_in_presets": ["backend-ts"],
       "source_path": "reference-skills/graphql-server-runtime"
@@ -121,25 +108,86 @@
       "id": "python-language",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["backend-python"],
       "included_in_presets": ["backend-python"],
       "source_path": "reference-skills/python-language"
     },
+    {
+      "id": "doc-impact-reviewer",
+      "kind": "task",
+      "supported_tools": ["claude-code", "codex", "gemini"],
+      "groups": ["agent-operating-layer"],
+      "included_in_presets": [],
+      "source_path": "task-skills/doc-impact-reviewer"
+    },
     {
       "id": "skill-load-check",
       "kind": "task",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": [],
       "included_in_presets": [],
       "source_path": "task-skills/skill-load-check"
     },
+    {
+      "id": "spec-baseline-sync",
+      "kind": "task",
+      "supported_tools": ["claude-code", "codex", "gemini"],
+      "groups": ["spec-lifecycle"],
+      "included_in_presets": [],
+      "source_path": "task-skills/spec-baseline-sync"
+    },
+    {
+      "id": "spec-product-01-idea-to-brief",
+      "kind": "task",
+      "supported_tools": ["claude-code", "codex", "gemini"],
+      "groups": ["spec-lifecycle"],
+      "included_in_presets": [],
+      "source_path": "task-skills/spec-product-01-idea-to-brief"
+    },
+    {
+      "id": "spec-product-02-brief-to-technical-context",
+      "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"
+    },
+    {
+      "id": "spec-product-03-brief-to-product-spec",
+      "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"
+    },
+    {
+      "id": "spec-product-04-product-spec-to-ui-spec",
+      "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"
+    },
+    {
+      "id": "spec-product-05-spec-to-work-packets",
+      "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",
+      "kind": "task",
+      "supported_tools": ["claude-code", "codex", "gemini"],
+      "groups": ["spec-lifecycle"],
+      "included_in_presets": [],
+      "source_path": "task-skills/spec-shared-glossary-sync"
+    },
     {
       "id": "typescript-language",
       "kind": "reference",
       "supported_tools": ["claude-code", "codex", "gemini"],
-      "install_scopes": ["project", "user"],
       "groups": ["frontend-web", "backend-ts"],
       "included_in_presets": ["frontend-web", "backend-ts"],
       "source_path": "reference-skills/typescript-language"