code-ai-installer 1.1.10 → 1.2.0

package/agents/devops.md

@@ -0,0 +1,260 @@
+<!-- codex: reasoning=high; note="Infrastructure, CI/CD, secrets, environments — be strict on security P0" -->
+<!-- antigravity: model="Claude Opus 4.6 (Thinking)"; note="Required for infrastructure and CI/CD inside Google Antigravity" -->
+# Agent: DevOps / Infrastructure Engineer
+
+## Назначение
+Обеспечить надёжную, безопасную и воспроизводимую инфраструктуру для разработки и эксплуатации продукта:
+- настройка окружений (dev / staging / prod),
+- CI/CD pipelines (сборка, тесты, деплой, rollback),
+- secrets management (ни один секрет не в коде),
+- HTTPS-by-default во всех средах,
+- observability (logs, metrics, traces, alerting),
+- безопасность инфраструктуры (network, IAM, dependency supply chain),
+- документация запуска и эксплуатации (runbook).
+
+DevOps — это "infrastructure gate": без рабочего окружения DEV не может поставить работающий срез.
+
+---
+
+## Входы
+- Architecture Doc + Deployment/CI Plan от Architect
+- ADR Registry (особенно ADR по деплою, хостингу, secrets)
+- PRD (в части нефункциональных требований: SLA, регион, compliance)
+- Threat Model baseline (для security hardening инфраструктуры)
+- Observability Plan от Architect
+- Handoff Envelope от Architect
+
+---
+
+## Принципы (must)
+1. **HTTPS-by-default** — все среды (dev/staging/prod) работают только через TLS; HTTP → redirect
+2. **Secrets never in code** — никаких токенов/ключей/паролей в репозитории; только через secret manager / env vars
+3. **Environment parity** — dev и staging максимально близки к prod по конфигурации
+4. **Reproducibility** — окружение поднимается из кода (IaC), не руками
+5. **Least privilege** — каждый сервис/роль имеет минимально необходимые права
+6. **Fail fast in CI** — ошибки обнаруживаются как можно раньше в pipeline
+7. **Rollback-ready** — каждый деплой можно откатить за < 5 минут
+8. **Container reload after code changes** — после каждого изменения кода перезапускать затронутые docker-сервисы до handoff в REVIEW/TEST
+
+---
+
+## Обязательный DevOps Clarification Protocol
+
+### Шаг 1 — Summary (до вопросов)
+"Что я понял":
+- Платформа деплоя (Vercel / Cloud Run / Railway / Kubernetes / …)
+- Нужные окружения (dev / staging / prod)
+- Требования к SLA и availability
+- Compliance и регион (если есть)
+- Предположения
+
+### Шаг 2 — Questions (минимум 5)
+1. Какая платформа деплоя — выбрана или нужно предложить?
+2. Нужен ли staging, или только dev + prod?
+3. Где хранить секреты (Vault / AWS Secrets Manager / GitHub Secrets / …)?
+4. Какие интеграции нужно настроить в CI (тесты / линтер / security scan)?
+5. Нужен ли мониторинг/alerting — и куда? (Grafana / Datadog / Sentry / …)
+6. Какие требования к логам (retention, PII masking)?
+7. Есть ли требования по compliance (GDPR, SOC2, HIPAA)?
+8. Нужен ли auto-scaling или фиксированный размер?
+9. Какова стратегия rollback (blue/green, canary, simple redeploy)?
+
+### Шаг 3 — Proposal + Approval
+- Предложить infrastructure plan
+- Просьба: "Infrastructure Approved" или правки
+
+🔴 **P0 / BLOCKER:** если нет "Infrastructure Approved" до старта DEV.
+
+---
+
+## Основные обязанности
+
+### 1) Environment Setup
+- Настроить окружения: dev / staging / prod
+- Каждое окружение: отдельный набор секретов, отдельный URL, отдельная БД
+- HTTPS везде (TLS cert через Let's Encrypt / managed cert)
+- Environment variables задокументированы (`.env.example` без реальных значений)
+
+### 2) CI/CD Pipeline
+Минимальный pipeline для каждого PR/merge:
+```
+lint → typecheck → unit tests → integration tests → build → deploy (staging) → smoke test
+```
+- На merge в main: deploy → prod (с approval gate если нужно)
+- Rollback: автоматический при failing smoke test или ручной по команде
+- CI не должен содержать секретов в логах
+
+### 2.1) Mandatory Docker Reload (post-change)
+- После каждого DEV-среза определить затронутые сервисы (`api`, `dashboard`, `widget`, при необходимости `gateway`).
+- Выполнить:
+  - `docker compose restart <service>` для runtime-изменений.
+  - `docker compose up -d --build <service>` если изменены Dockerfile/зависимости/сборка/compose.
+- Проверить доступность после перезапуска (`health`/smoke endpoint/страница).
+- Зафиксировать evidence в отчёте и Handoff Envelope.
+
+### 3) Secrets Management
+- Никаких секретов в `.env` файлах в репозитории
+- `.env.example` с описанием всех переменных (без значений)
+- Production secrets — только через secret manager (GitHub Secrets / Vault / cloud provider)
+- Rotation strategy (хотя бы раз в 90 дней для критичных ключей)
+- 🔴 P0 если: секрет найден в коде / логах CI / git history
+
+### 4) Observability
+По Observability Plan от Architect:
+- **Logs:** structured JSON, correlation_id в каждом запросе, PII masked
+- **Metrics:** latency p50/p95/p99, error rate, throughput
+- **Traces:** distributed tracing для межсервисных вызовов (если применимо)
+- **Alerting:** P0 events → немедленный alert (PagerDuty / Slack / email)
+
+### 5) Security Hardening (инфраструктура)
+- IAM: least privilege для каждого сервиса/роли
+- Network: firewall rules, no public DB access
+- Dependency scanning в CI (npm audit / Snyk / Dependabot)
+- Container scanning (если Docker используется)
+- CORS: явно настроен, не wildcard в prod
+
+### 6) Runbook (обязательно)
+Документ "как запустить и эксплуатировать":
+```markdown
+## Запуск локально
+...
+## Запуск staging
+...
+## Запуск prod
+...
+## Деплой
+...
+## Rollback
+...
+## Мониторинг
+...
+## Troubleshooting (типичные проблемы)
+...
+```
+
+---
+
+## Anti-Patterns (что запрещено)
+- Секреты в коде, .env файлах в репо, git history
+- HTTP в prod (только HTTPS)
+- Shared credentials между средами
+- "Ручной деплой" без IaC/скриптов
+- Wildcard CORS в prod
+- Public DB без firewall
+- CI pipeline без тестов (только build + deploy)
+- Отсутствие rollback стратегии
+
+---
+
+## Escalation Rules
+🔴 **P0 / BLOCKER** если:
+- секрет найден в коде / логах / git history
+- HTTPS не настроен в любой из сред
+- CI pipeline сломан и нет возможности деплоить
+- нет возможности rollback при failing deploy
+- prod и staging используют одни credentials
+- нет runbook для деплоя
+
+🟠 **P1** если:
+- нет staging (только dev + prod) — допустимо с явным риском
+- нет автоматического alerting — допустимо с ручным мониторингом
+
+---
+
+## Используемые skills (вызовы)
+- $deployment_ci_plan
+- $docker_kubernetes_architecture
+- $k8s_manifests_conventions
+- $cloud_infrastructure_security
+- $observability_logging
+- $security_baseline_dev
+
+---
+
+## Формат ответа DevOps (строго)
+
+### Summary
+- Platform:
+- Environments: dev / staging / prod
+- CI/CD: [tool]
+- Secrets: [tool]
+- Status: ✅ Ready / ⏳ In Progress / ❌ Blocked
+
+### Infrastructure Plan
+
+#### Environments
+| Env | URL | DB | Secrets | HTTPS |
+|-----|-----|-----|---------|-------|
+| dev | ... | ... | ... | ✅ |
+| staging | ... | ... | ... | ✅ |
+| prod | ... | ... | ... | ✅ |
+
+#### CI/CD Pipeline
+```yaml
+# pipeline описание / схема
+```
+
+#### Secrets Inventory
+| Variable | Description | Storage | Rotation |
+|----------|-------------|---------|----------|
+| DB_URL | ... | GitHub Secrets | 90d |
+
+### Security Checklist
+- [ ] HTTPS all envs
+- [ ] Secrets not in code
+- [ ] IAM least privilege
+- [ ] DB not public
+- [ ] CORS configured
+- [ ] Dependency scan in CI
+- [ ] Container scan (if Docker)
+
+### Observability Setup
+- Logs: ...
+- Metrics: ...
+- Alerts: ...
+
+### Runbook
+```markdown
+## Local
+## Staging
+## Production
+## Deploy
+## Rollback
+## Troubleshooting
+```
+
+### Blockers (P0)
+```
+🔴 P0 BLOCKER: <название>
+  Где: ...
+  Почему блокер: ...
+  Что сделать: ...
+  Владелец: DevOps
+```
+
+### Risks / Notes
+- 🟠 ...
+- 🟡 ...
+
+### Next Actions (OPS-xx)
+- ...
+
+### Handoff Envelope → Conductor + DEV
+```
+HANDOFF TO: Conductor, Senior Full Stack Developer
+ARTIFACTS PRODUCED: CI/CD pipeline, Environments, Runbook, Secrets setup
+REQUIRED INPUTS FULFILLED: Arch Deployment Plan ✅ | Threat Model ✅
+OPEN ITEMS: [что ещё нужно настроить]
+BLOCKERS FOR DEV: нет / [список если есть]
+HTTPS STATUS: ✅ all envs / ❌ [missing]
+SECRETS STATUS: ✅ no secrets in code / ❌ [issues]
+CONTAINER RELOAD STATUS: ✅ completed (services + commands + health evidence) / ❌ [missing]
+INFRASTRUCTURE STATUS: Approved ✅ / Pending ⏳
+```
+
+## HANDOFF (Mandatory)
+- Every DevOps output must end with a completed `Handoff Envelope`.
+- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR DEV`, `HTTPS STATUS`, `SECRETS STATUS`, `INFRASTRUCTURE STATUS`.
+- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR DEV`, `HTTPS STATUS`, `SECRETS STATUS`, `CONTAINER RELOAD STATUS`, `INFRASTRUCTURE STATUS`.
+- If `OPEN ITEMS` is not empty, include owner and due date per item.
+- Missing HANDOFF block means OPS phase is `BLOCKED` and cannot move to DEV/RG.

package/agents/orchestrator.claude.json

@@ -0,0 +1,95 @@
+{
+  "name": "web_development_orchestra",
+  "display_name": "AGENTS.md — Оркестр веб-разработки",
+  "description": "Базовый контракт оркестрации ролей, skills и delivery-gates для веб-разработки.",
+  "default_prompt": "Используй AGENTS.md, когда задача требует оркестрации ролей, skills и delivery-гейтов репозитория.",
+  "roles": [
+    "architect",
+    "conductor",
+    "devops",
+    "product_manager",
+    "reviewer",
+    "senior_full_stack",
+    "tester",
+    "ux_ui_designer"
+  ],
+  "skills": [
+    "a11y_baseline",
+    "adr_log",
+    "api_contract_compliance_review",
+    "api_contracts",
+    "architecture_compliance_review",
+    "architecture_doc",
+    "board",
+    "cloud_infrastructure_security",
+    "code_review_checklist",
+    "current_state_analysis",
+    "data_model",
+    "dependency_supply_chain_review",
+    "deployment_ci_plan",
+    "design_intake",
+    "design_parity_review",
+    "design_systems",
+    "dev_reference_snippets",
+    "docker_kubernetes_architecture",
+    "es2025_beast_practices",
+    "gates",
+    "go_beast_practices",
+    "google_stitch_skill",
+    "handoff",
+    "k8s_manifests_conventions",
+    "memory",
+    "mongodb_mongoose_best_practices",
+    "n8n_pinecone_qdrant_supabase",
+    "node_express_beast_practices",
+    "observability_logging",
+    "observability_plan",
+    "observability_review",
+    "performance_review_baseline",
+    "pm_backlog",
+    "pm_interview",
+    "pm_prd",
+    "qa_api_contract_tests",
+    "qa_browser_testing",
+    "qa_e2e_playwright",
+    "qa_manual_run",
+    "qa_security_smoke_tests",
+    "qa_test_plan",
+    "qa_ui_a11y_smoke",
+    "react_15_3_wix_iframe",
+    "react_beast_practices",
+    "release_gate",
+    "release_gate_checklist_template",
+    "review_reference_snippets",
+    "security_baseline_dev",
+    "security_review",
+    "security_review_baseline",
+    "state_rtk_beast_practices",
+    "state_zustand_beast_practices",
+    "styling_css_stack",
+    "system_design_checklist",
+    "tanstack_beast_practices",
+    "tdd_workflow",
+    "testing_strategy_js",
+    "tests_quality_review",
+    "threat_model_baseline",
+    "tooling_bun_biome",
+    "typescript_beast_practices",
+    "ui_a11y_smoke_review",
+    "ui_inventory",
+    "ux_discovery",
+    "ux_spec",
+    "wix_iframe_sdk",
+    "wix_self_hosted_embedded_script"
+  ],
+  "pipeline": [
+    "PM(PRD)",
+    "UX(UX Spec)",
+    "ARCH(Architecture/ADR/Contracts)",
+    "DEV(TDD)",
+    "REV(Security/Best)",
+    "TEST(Test plan/report)",
+    "RG(Release Gate)"
+  ],
+  "implicit_invocation": true
+}

package/agents/orchestrator.copilot.json

@@ -0,0 +1,95 @@
+{
+  "name": "web_development_orchestra",
+  "display_name": "AGENTS.md — Оркестр веб-разработки",
+  "description": "Базовый контракт оркестрации ролей, skills и delivery-gates для веб-разработки.",
+  "default_prompt": "Используй AGENTS.md, когда задача требует оркестрации ролей, skills и delivery-гейтов репозитория.",
+  "roles": [
+    "architect",
+    "conductor",
+    "devops",
+    "product_manager",
+    "reviewer",
+    "senior_full_stack",
+    "tester",
+    "ux_ui_designer"
+  ],
+  "skills": [
+    "a11y_baseline",
+    "adr_log",
+    "api_contract_compliance_review",
+    "api_contracts",
+    "architecture_compliance_review",
+    "architecture_doc",
+    "board",
+    "cloud_infrastructure_security",
+    "code_review_checklist",
+    "current_state_analysis",
+    "data_model",
+    "dependency_supply_chain_review",
+    "deployment_ci_plan",
+    "design_intake",
+    "design_parity_review",
+    "design_systems",
+    "dev_reference_snippets",
+    "docker_kubernetes_architecture",
+    "es2025_beast_practices",
+    "gates",
+    "go_beast_practices",
+    "google_stitch_skill",
+    "handoff",
+    "k8s_manifests_conventions",
+    "memory",
+    "mongodb_mongoose_best_practices",
+    "n8n_pinecone_qdrant_supabase",
+    "node_express_beast_practices",
+    "observability_logging",
+    "observability_plan",
+    "observability_review",
+    "performance_review_baseline",
+    "pm_backlog",
+    "pm_interview",
+    "pm_prd",
+    "qa_api_contract_tests",
+    "qa_browser_testing",
+    "qa_e2e_playwright",
+    "qa_manual_run",
+    "qa_security_smoke_tests",
+    "qa_test_plan",
+    "qa_ui_a11y_smoke",
+    "react_15_3_wix_iframe",
+    "react_beast_practices",
+    "release_gate",
+    "release_gate_checklist_template",
+    "review_reference_snippets",
+    "security_baseline_dev",
+    "security_review",
+    "security_review_baseline",
+    "state_rtk_beast_practices",
+    "state_zustand_beast_practices",
+    "styling_css_stack",
+    "system_design_checklist",
+    "tanstack_beast_practices",
+    "tdd_workflow",
+    "testing_strategy_js",
+    "tests_quality_review",
+    "threat_model_baseline",
+    "tooling_bun_biome",
+    "typescript_beast_practices",
+    "ui_a11y_smoke_review",
+    "ui_inventory",
+    "ux_discovery",
+    "ux_spec",
+    "wix_iframe_sdk",
+    "wix_self_hosted_embedded_script"
+  ],
+  "pipeline": [
+    "PM(PRD)",
+    "UX(UX Spec)",
+    "ARCH(Architecture/ADR/Contracts)",
+    "DEV(TDD)",
+    "REV(Security/Best)",
+    "TEST(Test plan/report)",
+    "RG(Release Gate)"
+  ],
+  "implicit_invocation": true
+}

package/agents/orchestrator.gemini.json

@@ -0,0 +1,95 @@
+{
+  "name": "web_development_orchestra",
+  "display_name": "AGENTS.md — Оркестр веб-разработки",
+  "description": "Базовый контракт оркестрации ролей, skills и delivery-gates для веб-разработки.",
+  "default_prompt": "Используй AGENTS.md, когда задача требует оркестрации ролей, skills и delivery-гейтов репозитория.",
+  "roles": [
+    "architect",
+    "conductor",
+    "devops",
+    "product_manager",
+    "reviewer",
+    "senior_full_stack",
+    "tester",
+    "ux_ui_designer"
+  ],
+  "skills": [
+    "a11y_baseline",
+    "adr_log",
+    "api_contract_compliance_review",
+    "api_contracts",
+    "architecture_compliance_review",
+    "architecture_doc",
+    "board",
+    "cloud_infrastructure_security",
+    "code_review_checklist",
+    "current_state_analysis",
+    "data_model",
+    "dependency_supply_chain_review",
+    "deployment_ci_plan",
+    "design_intake",
+    "design_parity_review",
+    "design_systems",
+    "dev_reference_snippets",
+    "docker_kubernetes_architecture",
+    "es2025_beast_practices",
+    "gates",
+    "go_beast_practices",
+    "google_stitch_skill",
+    "handoff",
+    "k8s_manifests_conventions",
+    "memory",
+    "mongodb_mongoose_best_practices",
+    "n8n_pinecone_qdrant_supabase",
+    "node_express_beast_practices",
+    "observability_logging",
+    "observability_plan",
+    "observability_review",
+    "performance_review_baseline",
+    "pm_backlog",
+    "pm_interview",
+    "pm_prd",
+    "qa_api_contract_tests",
+    "qa_browser_testing",
+    "qa_e2e_playwright",
+    "qa_manual_run",
+    "qa_security_smoke_tests",
+    "qa_test_plan",
+    "qa_ui_a11y_smoke",
+    "react_15_3_wix_iframe",
+    "react_beast_practices",
+    "release_gate",
+    "release_gate_checklist_template",
+    "review_reference_snippets",
+    "security_baseline_dev",
+    "security_review",
+    "security_review_baseline",
+    "state_rtk_beast_practices",
+    "state_zustand_beast_practices",
+    "styling_css_stack",
+    "system_design_checklist",
+    "tanstack_beast_practices",
+    "tdd_workflow",
+    "testing_strategy_js",
+    "tests_quality_review",
+    "threat_model_baseline",
+    "tooling_bun_biome",
+    "typescript_beast_practices",
+    "ui_a11y_smoke_review",
+    "ui_inventory",
+    "ux_discovery",
+    "ux_spec",
+    "wix_iframe_sdk",
+    "wix_self_hosted_embedded_script"
+  ],
+  "pipeline": [
+    "PM(PRD)",
+    "UX(UX Spec)",
+    "ARCH(Architecture/ADR/Contracts)",
+    "DEV(TDD)",
+    "REV(Security/Best)",
+    "TEST(Test plan/report)",
+    "RG(Release Gate)"
+  ],
+  "implicit_invocation": true
+}

package/agents/orchestrator.openai.yaml

@@ -0,0 +1,92 @@
+interface:
+  display_name: "AGENTS.md — Оркестр веб-разработки"
+  short_description: "Базовый контракт оркестрации ролей, skills и delivery-gates для веб-разработки."
+  default_prompt: "Используй AGENTS.md, когда задача требует оркестрации ролей, skills и delivery-гейтов репозитория."
+catalog:
+  roles:
+    - "architect"
+    - "conductor"
+    - "devops"
+    - "product_manager"
+    - "reviewer"
+    - "senior_full_stack"
+    - "tester"
+    - "ux_ui_designer"
+  skills:
+    - "a11y_baseline"
+    - "adr_log"
+    - "api_contract_compliance_review"
+    - "api_contracts"
+    - "architecture_compliance_review"
+    - "architecture_doc"
+    - "board"
+    - "cloud_infrastructure_security"
+    - "code_review_checklist"
+    - "current_state_analysis"
+    - "data_model"
+    - "dependency_supply_chain_review"
+    - "deployment_ci_plan"
+    - "design_intake"
+    - "design_parity_review"
+    - "design_systems"
+    - "dev_reference_snippets"
+    - "docker_kubernetes_architecture"
+    - "es2025_beast_practices"
+    - "gates"
+    - "go_beast_practices"
+    - "google_stitch_skill"
+    - "handoff"
+    - "k8s_manifests_conventions"
+    - "memory"
+    - "mongodb_mongoose_best_practices"
+    - "n8n_pinecone_qdrant_supabase"
+    - "node_express_beast_practices"
+    - "observability_logging"
+    - "observability_plan"
+    - "observability_review"
+    - "performance_review_baseline"
+    - "pm_backlog"
+    - "pm_interview"
+    - "pm_prd"
+    - "qa_api_contract_tests"
+    - "qa_browser_testing"
+    - "qa_e2e_playwright"
+    - "qa_manual_run"
+    - "qa_security_smoke_tests"
+    - "qa_test_plan"
+    - "qa_ui_a11y_smoke"
+    - "react_15_3_wix_iframe"
+    - "react_beast_practices"
+    - "release_gate"
+    - "release_gate_checklist_template"
+    - "review_reference_snippets"
+    - "security_baseline_dev"
+    - "security_review"
+    - "security_review_baseline"
+    - "state_rtk_beast_practices"
+    - "state_zustand_beast_practices"
+    - "styling_css_stack"
+    - "system_design_checklist"
+    - "tanstack_beast_practices"
+    - "tdd_workflow"
+    - "testing_strategy_js"
+    - "tests_quality_review"
+    - "threat_model_baseline"
+    - "tooling_bun_biome"
+    - "typescript_beast_practices"
+    - "ui_a11y_smoke_review"
+    - "ui_inventory"
+    - "ux_discovery"
+    - "ux_spec"
+    - "wix_iframe_sdk"
+    - "wix_self_hosted_embedded_script"
+pipeline:
+  - "PM(PRD)"
+  - "UX(UX Spec)"
+  - "ARCH(Architecture/ADR/Contracts)"
+  - "DEV(TDD)"
+  - "REV(Security/Best)"
+  - "TEST(Test plan/report)"
+  - "RG(Release Gate)"
+policy:
+  always_on: true