code-ai-installer 2.5.0 → 4.0.0

package/domains/development/.agents/skills/handoff/SKILL.md

@@ -1,8 +1,60 @@
 ---
 name: handoff
-description: Формирование Context Pack и постановка задачи агенту — цели, ограничения, артефакты, решения, вопросы, Definition of Done. Требует стандартного формата ответа.
+description: "Формирование Context Pack и постановка задачи агенту — цели, ограничения, артефакты, решения, вопросы, Definition of Done. Требует стандартного формата ответа."
+type: mandatory
+domain: development
+owners:
+  - conductor
+gates:
+  - PM
+  - UX
+  - ARCH
+  - DEV
+  - REV
+  - OPS
+  - TEST
+  - RG
+tech: []
+topic:
+  - orchestration
+triggers:
+  - передать задачу
+  - Context Pack
+  - постановка агенту
+  - handoff формат
+  - цели и ограничения
+  - Definition of Done
+  - задача для агента
+related:
+  - ux-discovery
+  - ux-spec
+  - ui-inventory
+  - a11y-baseline
+  - architecture-doc
+  - adr-log
+  - api-contracts
+  - data-model
+  - tdd-workflow
+  - testing-strategy-js
+  - code-review-checklist
+  - security-review
+  - performance-review-baseline
+  - deployment-ci-plan
+  - deployment-ci-plan-reference
+  - qa-test-plan
+  - qa-manual-run
+  - qa-api-contract-tests
+  - qa-security-smoke-tests
+  - release-gate
+  - release-gate-checklist-template
+  - gates
+  - board
+  - memory
+budget_lines: 280
+schema_version: 1
 ---
 
+
 # Skill: Context Pack Handoff
 
 Передача задач между гейтами с полным контекстом.
@@ -10,10 +62,10 @@ description: Формирование Context Pack и постановка за
 **Разделы:**
 1. [Workflow](#1-workflow)
 2. [Context Pack](#2-context-pack)
-3. [HANDOFF Envelope](#3-envelope)
-4. [Reply Format](#4-reply)
-5. [Gate-Specific Variations](#5-variations)
-6. [Пример: PM→UX Handoff](#6-пример)
+3. [HANDOFF Envelope](#3-handoff-envelope)
+4. [Reply Format](#4-reply-format)
+5. [Gate-Specific Variations](#5-gate-specific-variations)
+6. [Пример: PM→UX Handoff](#6-пример-pmux-handoff)
 
 ---
 
@@ -206,6 +258,18 @@ Every agent must return their deliverable in this structure:
 
 ---
 
+## Общие правила handoff-документа (cross-domain)
+
+> Применяется к **любому** handoff-документу, передающему контекст сессии свежему агенту (session-handoff / conversation summary). Дополняет, не заменяет, разделы про inter-gate handoff выше.
+
+1. **Куда сохранять.** Файл — во временную директорию ОС (`%TEMP%` / `/tmp` / `os.tmpdir()`), **не** в рабочий репозиторий. Workspace остаётся чистым; путь к временному файлу цитируется в чате следующей сессии.
+2. **Секция «Suggested skills».** Обязательна секция со списком скиллов, которые свежему агенту имеет смысл подгрузить первым же действием (`$skill-1`, `$skill-2`, ...). Сокращает context-warm-up.
+3. **Не дублировать артефакты.** Если данные уже в PRD / plan / ADR / commit / diff / issue — давать **ссылку по пути или URL**, не копировать содержимое. Дубль создаёт drift между источниками.
+4. **Редакция чувствительных данных.** Перед сохранением — удалить API-ключи, пароли, токены, PII (email, телефон, реальные имена клиентов). Временная директория тоже потенциальный leak-вектор.
+5. **Аргументы юзера = фокус следующей сессии.** Если `/handoff` вызван с аргументом-строкой — трактовать её как описание задачи следующей сессии; адаптировать summary и suggested-skills под этот фокус.
+
+---
+
 ## См. также
 - `$gates` — gate definitions and DoD
 - `$board` — project board tracking

package/domains/development/.agents/skills/handoff/agents/kimi.yaml

@@ -1,12 +1,12 @@
-name: "handoff"
-display_name: "Передача контекста агентам"
-description: "Формирование Context Pack и постановка задачи агенту — цели, ограничения, артефакты, решения, вопросы, Definition of Done. Требует стандартного формата ответа."
-default_prompt: "Используй $handoff, когда задача относится к навыку \"Передача контекста агентам\"."
-triggers:
-  - "handoff"
-  - "Передача контекста агентам"
-  - "Формирование Context Pack и постановка задачи агенту — цели, ограничения, артефакты, решения, вопросы, Definition of Done"
-capabilities:
-  - "handoff"
-tools: []
-implicit_invocation: true
+name: "handoff"
+display_name: "Передача контекста агентам"
+description: "Формирование Context Pack и постановка задачи агенту — цели, ограничения, артефакты, решения, вопросы, Definition of Done. Требует стандартного формата ответа."
+default_prompt: "Используй $handoff, когда задача относится к навыку \"Передача контекста агентам\"."
+triggers:
+  - "handoff"
+  - "Передача контекста агентам"
+  - "Формирование Context Pack и постановка задачи агенту — цели, ограничения, артефакты, решения, вопросы, Definition of Done"
+capabilities:
+  - "handoff"
+tools: []
+implicit_invocation: true

package/domains/development/.agents/skills/k8s-manifests-conventions/SKILL.md

@@ -1,24 +1,57 @@
 ---
 name: k8s-manifests-conventions
 description: Конвенции Kubernetes манифестов — структура репо, Helm/Kustomize, overlays per env, naming/labels, secrets/config, policy, validation, GitOps.
+type: discretionary
+domain: development
+owners:
+  - architect
+  - devops
+gates:
+  - ARCH
+  - OPS
+tech:
+  - k8s
+topic:
+  - architecture
+  - ops
+triggers:
+  - Helm Kustomize
+  - overlays per env
+  - k8s labels
+  - naming манифестов
+  - GitOps
+  - secrets в k8s
+related:
+  - docker-kubernetes-architecture
+  - docker-kubernetes-architecture-reference
+  - deployment-ci-plan
+  - deployment-ci-plan-reference
+  - k8s-manifests-conventions-reference
+  - security-baseline-dev
+  - observability-plan
+  - threat-model-baseline
+  - architecture-doc-reference
+budget_lines: 350
+schema_version: 1
 ---
 
+
 # Skill: K8s Manifests Conventions
 
-Стандарты для Kubernetes манифестов: naming, structure, overlays, validation.
+Стандарты для Kubernetes манифестов: naming, structure, secrets policy, GitOps + Output Template. Полные шаблоны Kustomize/Helm/ConfigMap/Ingress/securityContext/CI → `$k8s-manifests-conventions-reference`.
 
 **Разделы:**
 1. [Tooling Decision](#1-tooling)
-2. [Repo Structure](#2-repo-structure)
-3. [Naming & Labels](#3-naming--labels)
-4. [Config & Secrets](#4-config--secrets)
-5. [Ingress & Gateway](#5-ingress)
-6. [Probes & Resources](#6-probes--resources)
-7. [Security Policy](#7-security)
-8. [CI Validation](#8-ci-validation)
-9. [GitOps](#9-gitops)
-10. [Red Flags](#10-red-flags)
-11. [Output Template](#11-output)
+2. [Naming & Labels](#2-naming--labels)
+3. [Config & Secrets](#3-config--secrets)
+4. [Ingress & Gateway](#4-ingress)
+5. [Probes & Resources](#5-probes--resources)
+6. [Security Policy](#6-security)
+7. [CI Validation](#7-ci-validation)
+8. [GitOps](#8-gitops)
+9. [Red Flags](#9-red-flags)
+10. [Output Template](#10-output)
+11. [DoD](#11-dod)
 
 ---
 
@@ -32,211 +65,11 @@ description: Конвенции Kubernetes манифестов — структ
 | **Helm** | Complex, many services, shared charts | Powerful templating, reusable charts | Template debugging, chart maintenance |
 | **Raw manifests** | Tiny projects (1-2 services) | No learning curve | Doesn't scale, env duplication |
 
----
-
-## 2. Repo Structure
-
-### Kustomize layout
-
-```
-k8s/
-├── base/
-│   ├── kustomization.yaml
-│   ├── namespace.yaml
-│   ├── deployment-api.yaml
-│   ├── deployment-dashboard.yaml
-│   ├── service-api.yaml
-│   ├── service-dashboard.yaml
-│   ├── ingress.yaml
-│   ├── configmap.yaml
-│   ├── hpa.yaml
-│   └── pdb.yaml
-└── overlays/
-    ├── dev/
-    │   ├── kustomization.yaml
-    │   ├── patch-deployment.yaml
-    │   └── patch-ingress.yaml
-    ├── staging/
-    │   ├── kustomization.yaml
-    │   └── patch-deployment.yaml
-    └── prod/
-        ├── kustomization.yaml
-        ├── patch-deployment.yaml
-        ├── patch-ingress.yaml
-        └── patch-hpa.yaml
-```
-
-### kustomization.yaml (base)
-
-```yaml
-apiVersion: kustomize.config.k8s.io/v1beta1
-kind: Kustomization
-
-namespace: smart-cart
-
-resources:
-  - namespace.yaml
-  - deployment-api.yaml
-  - deployment-dashboard.yaml
-  - service-api.yaml
-  - service-dashboard.yaml
-  - ingress.yaml
-  - configmap.yaml
-  - hpa.yaml
-  - pdb.yaml
-
-commonLabels:
-  app.kubernetes.io/part-of: smart-cart-rescue
-  app.kubernetes.io/managed-by: kustomize
-```
-
-### kustomization.yaml (overlay — prod)
-
-```yaml
-apiVersion: kustomize.config.k8s.io/v1beta1
-kind: Kustomization
-
-resources:
-  - ../../base
-
-namePrefix: prod-
-
-patches:
-  - path: patch-deployment.yaml
-    target:
-      kind: Deployment
-      name: api
-  - path: patch-ingress.yaml
-    target:
-      kind: Ingress
-      name: api-ingress
-  - path: patch-hpa.yaml
-    target:
-      kind: HorizontalPodAutoscaler
-      name: api-hpa
-
-configMapGenerator:
-  - name: api-config
-    behavior: merge
-    literals:
-      - NODE_ENV=production
-      - LOG_LEVEL=info
-```
-
-### patch-deployment.yaml (prod overlay)
-
-```yaml
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  name: api
-spec:
-  replicas: 3
-  template:
-    spec:
-      containers:
-        - name: api
-          resources:
-            requests:
-              cpu: 200m
-              memory: 256Mi
-            limits:
-              cpu: 1000m
-              memory: 1Gi
-```
+**Factors for choosing:** размер команды + опыт с Helm + количество сервисов + потребность в reusable charts. Маленькая команда без Helm-истории → Kustomize. Множество сервисов с shared logic → Helm. Repo-структура и kustomization.yaml / values.yaml шаблоны → `$k8s-manifests-conventions-reference` §1-§2.
 
 ---
 
-### Helm layout
-
-```
-k8s/
-├── charts/
-│   └── smart-cart/
-│       ├── Chart.yaml
-│       ├── values.yaml
-│       └── templates/
-│           ├── _helpers.tpl
-│           ├── deployment.yaml
-│           ├── service.yaml
-│           ├── ingress.yaml
-│           ├── configmap.yaml
-│           ├── hpa.yaml
-│           └── pdb.yaml
-└── env/
-    ├── dev.yaml
-    ├── staging.yaml
-    └── prod.yaml
-```
-
-### values.yaml (defaults)
-
-```yaml
-replicaCount: 2
-
-image:
-  repository: registry.example.com/smart-cart/api
-  tag: latest
-  pullPolicy: IfNotPresent
-
-service:
-  type: ClusterIP
-  port: 80
-  targetPort: 3000
-
-ingress:
-  enabled: true
-  className: nginx
-  host: api.example.com
-  tls: true
-
-resources:
-  requests:
-    cpu: 100m
-    memory: 128Mi
-  limits:
-    cpu: 500m
-    memory: 512Mi
-
-autoscaling:
-  enabled: true
-  minReplicas: 2
-  maxReplicas: 10
-  targetCPUUtilization: 70
-
-env:
-  NODE_ENV: production
-  LOG_LEVEL: info
-```
-
-### prod.yaml (override)
-
-```yaml
-replicaCount: 3
-
-image:
-  tag: "1.0.0"
-  pullPolicy: Always
-
-resources:
-  requests:
-    cpu: 200m
-    memory: 256Mi
-  limits:
-    cpu: 1000m
-    memory: 1Gi
-
-autoscaling:
-  minReplicas: 3
-  maxReplicas: 20
-
-ingress:
-  host: api.smart-cart.com
-```
-
----
-
-## 3. Naming & Labels
+## 2. Naming & Labels
 
 ### Recommended labels (K8s standard)
 
@@ -266,21 +99,7 @@ ingress:
 
 ---
 
-## 4. Config & Secrets
-
-### ConfigMap
-
-```yaml
-apiVersion: v1
-kind: ConfigMap
-metadata:
-  name: api-config
-  namespace: smart-cart
-data:
-  NODE_ENV: "production"
-  LOG_LEVEL: "info"
-  PORT: "3000"
-```
+## 3. Config & Secrets
 
 ### Secrets strategy
 
@@ -301,9 +120,13 @@ data:
 | RBAC restrict secret access | Let all pods read all secrets |
 | Mount as volume if file-based | Expose in container logs |
 
+**Rotation cadence:** prod secrets — каждые 90 дней (или при compromise); staging — каждые 180; dev — ad-hoc. Зафиксируй cadence в ADR.
+
+ConfigMap template → `$k8s-manifests-conventions-reference` §3.
+
 ---
 
-## 5. Ingress & Gateway
+## 4. Ingress & Gateway
 
 ### Convention
 
@@ -314,48 +137,11 @@ data:
 | Rate limiting | Enable on public endpoints |
 | Security headers | `X-Content-Type-Options`, `X-Frame-Options`, `Strict-Transport-Security` |
 
-### Ingress example
-
-```yaml
-apiVersion: networking.k8s.io/v1
-kind: Ingress
-metadata:
-  name: api-ingress
-  namespace: smart-cart
-  annotations:
-    cert-manager.io/cluster-issuer: letsencrypt-prod
-    nginx.ingress.kubernetes.io/rate-limit: "100"
-    nginx.ingress.kubernetes.io/rate-limit-window: "1m"
-    nginx.ingress.kubernetes.io/server-snippet: |
-      add_header X-Content-Type-Options "nosniff" always;
-      add_header X-Frame-Options "SAMEORIGIN" always;
-      add_header Strict-Transport-Security "max-age=31536000" always;
-spec:
-  ingressClassName: nginx
-  tls:
-    - hosts: [api.example.com]
-      secretName: api-tls
-  rules:
-    - host: api.example.com
-      http:
-        paths:
-          - path: /api
-            pathType: Prefix
-            backend:
-              service:
-                name: api
-                port: { number: 80 }
-          - path: /
-            pathType: Prefix
-            backend:
-              service:
-                name: dashboard
-                port: { number: 80 }
-```
+Полный пример Ingress с rate-limit и security headers → `$k8s-manifests-conventions-reference` §4.
 
 ---
 
-## 6. Probes & Resources
+## 5. Probes & Resources
 
 ### Probes convention
 
@@ -365,6 +151,8 @@ spec:
 | `livenessProbe` | `/health/live` | App is alive (not deadlocked) | initialDelay: 15s, period: 20s |
 | `startupProbe` | `/health/live` | Slow-starting apps | failureThreshold: 10, period: 5s |
 
+**Когда `startupProbe`:** приложение стартует > 30 секунд (heavy DB migrations on boot, model loading, warm cache). Без startupProbe — livenessProbe убьёт под до полного старта.
+
 ### Resources guideline
 
 | Env | requests.cpu | requests.memory | limits.cpu | limits.memory |
@@ -377,7 +165,7 @@ spec:
 
 ---
 
-## 7. Security Policy
+## 6. Security Policy
 
 ### Pod Security Standards
 
@@ -387,66 +175,11 @@ spec:
 | **Baseline** | No known privilege escalations | Staging |
 | **Privileged** | No restrictions | Never in production |
 
-### Security context template
-
-```yaml
-spec:
-  securityContext:
-    runAsNonRoot: true
-    runAsUser: 1001
-    runAsGroup: 1001
-    fsGroup: 1001
-    seccompProfile:
-      type: RuntimeDefault
-  containers:
-    - name: api
-      securityContext:
-        allowPrivilegeEscalation: false
-        readOnlyRootFilesystem: true
-        capabilities:
-          drop: [ALL]
-      volumeMounts:
-        - name: tmp
-          mountPath: /tmp
-  volumes:
-    - name: tmp
-      emptyDir: {}
-```
+Полный securityContext PSS-Restricted template (с volumes) → `$k8s-manifests-conventions-reference` §5.
 
 ---
 
-## 8. CI Validation
-
-### Pipeline checks
-
-```yaml
-# GitHub Actions example
-validate-k8s:
-  runs-on: ubuntu-latest
-  steps:
-    - uses: actions/checkout@v4
-
-    # Build manifests
-    - name: Kustomize build
-      run: kubectl kustomize k8s/overlays/prod > /tmp/manifests.yaml
-
-    # Schema validation
-    - name: Kubeconform
-      uses: yannh/kubeconform-action@v0.6
-      with:
-        files: /tmp/manifests.yaml
-        kubernetes-version: "1.29.0"
-
-    # Dry-run
-    - name: Dry run
-      run: kubectl apply --dry-run=server -f /tmp/manifests.yaml
-
-    # Policy check (optional)
-    - name: Conftest
-      run: conftest test /tmp/manifests.yaml -p policy/
-```
-
-### Validation checks summary
+## 7. CI Validation
 
 | Check | Tool | What it catches |
 |-------|------|-----------------|
@@ -456,9 +189,11 @@ validate-k8s:
 | Lint (Helm) | `helm lint` | Template errors, missing values |
 | Policy | `conftest` / `kyverno` / OPA | No root, resource limits, labels |
 
+Готовый GitHub Actions snippet с kubeconform + dry-run + conftest → `$k8s-manifests-conventions-reference` §6.
+
 ---
 
-## 9. GitOps
+## 8. GitOps
 
 ### Approach (if applicable)
 
@@ -481,7 +216,7 @@ Git branches:
 
 ---
 
-## 10. Red Flags
+## 9. Red Flags
 
 ### 🔴 P0
 
@@ -503,7 +238,7 @@ Git branches:
 
 ---
 
-## 11. Output Template
+## 10. Output Template
 
 ```markdown
 # K8s Manifests Conventions: <project-name>
@@ -512,28 +247,28 @@ Git branches:
 **Approach:** Kustomize / Helm / Raw (ADR-xxx)
 
 ## Repo Structure
-<section 2 tree>
+<tree from reference §1 or §2>
 
 ## Naming & Labels
-<section 3 tables>
+<section 2 tables>
 
 ## Config & Secrets Strategy
-<section 4 approach + rules>
+<section 3 approach + rotation cadence>
 
 ## Ingress
-<section 5 config>
+<section 4 config>
 
 ## Probes & Resources
-<section 6 tables>
+<section 5 tables>
 
 ## Security Policy
-<PSS level + security context>
+<PSS level + securityContext from reference §5>
 
 ## CI Validation
-<pipeline checks>
+<pipeline checks from reference §6>
 
 ## GitOps
-<promotion flow>
+<section 8 promotion flow>
 
 ## Risks
 <red flags>
@@ -541,8 +276,23 @@ Git branches:
 
 ---
 
+## 11. DoD
+
+- [ ] Tooling (Kustomize/Helm/Raw) выбран и зафиксирован в ADR
+- [ ] Все P0 Red Flags закрыты или зафиксированы в exception
+- [ ] Output Template заполнен; templates взяты из `$k8s-manifests-conventions-reference`
+- [ ] CI validation pipeline (kubeconform + dry-run) подключён
+- [ ] Secrets rotation cadence зафиксирован
+
+---
+
 ## См. также
+- `$k8s-manifests-conventions-reference` — все шаблоны Kustomize/Helm/ConfigMap/Ingress/securityContext/CI
 - `$docker-kubernetes-architecture` — containerization + K8s architecture
+- `$docker-kubernetes-architecture-reference` — Dockerfile + базовые K8s manifests
 - `$deployment-ci-plan` — CI pipeline, environments, rollback
+- `$deployment-ci-plan-reference` — Dockerfile/CI templates
 - `$security-baseline-dev` — secrets management patterns
 - `$observability-plan` — logging/metrics in K8s context
+- `$threat-model-baseline` — security requirements
+- `$architecture-doc-reference` — canonical разделы architecture doc

package/domains/development/.agents/skills/k8s-manifests-conventions/agents/kimi.yaml

@@ -1,15 +1,15 @@
-name: "k8s-manifests-conventions"
-display_name: "Конвенции Kubernetes-манифестов"
-description: "Конвенции Kubernetes манифестов — структура репо, Helm/Kustomize, overlays per env, naming/labels, secrets/config, policy, validation, GitOps."
-default_prompt: "Используй $k8s-manifests-conventions, когда задача относится к навыку \"Конвенции Kubernetes-манифестов\"."
-triggers:
-  - "k8s-manifests-conventions"
-  - "k8s manifests conventions"
-  - "Конвенции Kubernetes-манифестов"
-  - "Конвенции Kubernetes манифестов — структура репо, Helm/Kustomize, overlays per env, naming/labels, secrets/config, policy, validation, GitOps"
-capabilities:
-  - "k8s"
-  - "manifests"
-  - "conventions"
-tools: []
-implicit_invocation: true
+name: "k8s-manifests-conventions"
+display_name: "Конвенции Kubernetes-манифестов"
+description: "Конвенции Kubernetes манифестов — структура репо, Helm/Kustomize, overlays per env, naming/labels, secrets/config, policy, validation, GitOps."
+default_prompt: "Используй $k8s-manifests-conventions, когда задача относится к навыку \"Конвенции Kubernetes-манифестов\"."
+triggers:
+  - "k8s-manifests-conventions"
+  - "k8s manifests conventions"
+  - "Конвенции Kubernetes-манифестов"
+  - "Конвенции Kubernetes манифестов — структура репо, Helm/Kustomize, overlays per env, naming/labels, secrets/config, policy, validation, GitOps"
+capabilities:
+  - "k8s"
+  - "manifests"
+  - "conventions"
+tools: []
+implicit_invocation: true