code-ai-installer 1.5.6 → 2.0.1

package/README.md

@@ -1,106 +1,139 @@
-# code-ai installer
+<div align="center">
+  <h1>🤖 Code-AI Installer</h1>
+  <p><b>The ultimate CLI tool to orchestrate AI Agents, Skills, and Workflows across multiple AI Coding Assistants.</b></p>
+  
+  [![npm version](https://img.shields.io/npm/v/code-ai-installer.svg)](https://www.npmjs.com/package/code-ai-installer)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+  [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20-green.svg)](https://nodejs.org)
+</div>
 
-CLI for installing your `agents/`, `.agents/skills/`, and `.agents/workflows/` assets into AI-specific layouts.
-The global package contains bundled templates, so `code-ai` works from any directory.
+<br/>
 
-## Supported targets
-- `vscode-copilot`
-- `gpt-codex`
+**Code-AI Installer** (`code-ai`) is a powerful, production-ready CLI that injects your `.agents/`, `.agents/skills/`, and `.agents/workflows/` directly into the specific environment layouts required by different AI tools. Write your agentic pipelines once, and deploy them universally to Copilot, Codex, Claude, Qwen, or Google Antigravity.
+
+---
+
+## ✨ Features
+
+- 🚀 **Interactive Wizard**: Out-of-the-box interactive CLI to easily pick targets, agents, and skills.
+- 🌍 **Multi-AI Support**: Automatically adapts instructions, reasoning hints, and files for Copilot, GPT Codex, Claude, Qwen 3.5, and Google Antigravity.
+- 📦 **Standalone & Global**: Bundled with base templates—run it from anywhere on your machine!
+- 🛡️ **Bulletproof Safety**: Default `dry-run` mode, automatic backups to `.code-ai-installer/backups/`, and built-in rollbacks.
+- 🧠 **Smart Transformation**: Normalizes markdown content. Automatically translates target-native AI hints (e.g., mapping `codex reasoning` to `claude thinking` or `gemini reasoning`).
+- 🌐 **Localization**: First-class support for English (`en`) and Russian (`ru`).
+
+---
+
+## 🏛️ Domain Architecture
+
+Code-AI Installer comes pre-bundled with dedicated professional systems separated by **Domains** to cleanly isolate workflows based on your project needs. You can choose which domain to deploy during installation:
+
+- 💻 **Software Development Domain** (`development`): An 8-gate robust agentic pipeline tailored for end-to-end web app development. Includes roles like Product Manager, UX/UI Designer, Architect, Senior Full Stack Developer, Reviewer, DevOps, and QA Tester.
+- 📝 **Content Production Domain** (`content`): A creative pipeline dedicated to producing digital content (social media, blogs, visuals). Orchestrates roles such as Content Strategist, Copywriter, Researcher, and Visual Concept Designer.
+
+*(You can select your target domain during the interactive installation process!)*
+
+---
+
+## 🎯 Supported AI Targets
+
+- `vscode-copilot` / `copilot`
+- `gpt-codex` / `codex`
 - `claude`
-- `qwen-3.5`
-- `google-antugravity`
+- `qwen-3.5` / `qwen`
+- `google-antigravity` / `antigravity`
 
-## Install
-```bash
-npm install
-npm run build
-```
+---
+
+## 🔧 Installation
+
+### 1. Global Installation (Recommended)
+
+Install the CLI globally to run it in any of your projects:
 
-## Global install
 ```bash
-# from npm registry
+# via npm
 npm install -g code-ai-installer
-# or
+
+# via pnpm, yarn, or bun
 pnpm add -g code-ai-installer
-# or
 yarn global add code-ai-installer
-# or
 bun add -g code-ai-installer
+```
 
-# verify binary in system terminal
+Verify the installation:
+```bash
 code-ai --help
 ```
 
+### 2. Local Installation (For Development)
+
+If you are cloning this repository to build or contribute:
 ```bash
-# install globally from local repository
+git clone https://github.com/denish12/codex-ai-agent-and-skills.git
+cd codex-ai-agent-and-skills
+npm install
+npm run build
 npm install -g .
-code-ai --help
 ```
 
-## Usage
+---
+
+## 🚀 Usage
+
+### The Interactive Wizard
+Just run `code-ai` inside your project directory to trigger the fully interactive guide:
 ```bash
-# interactive wizard (recommended)
 code-ai
+```
 
-# list targets
+### CLI Commands & Flags
+
+```bash
+# List all supported targets
 code-ai targets
 
-# list available agents and skills from current repository
+# List available agents and skills (from local repo or global fallback)
 code-ai list
 code-ai list --lang en
 
-# health checks
+# Check system health and compatibility for a specific target
 code-ai doctor --target claude
-code-ai doctor --target claude --lang en
 
-# dry-run install (default)
-code-ai install --target claude --agents conductor,reviewer --skills board,security_review
-code-ai install --target claude --lang en --agents conductor,reviewer --skills board,security_review
+# Run a safe Dry-Run installation preview (Default)
+code-ai install --target claude --agents conductor,reviewer --skills board
 
-# install into a newly created folder under current directory
-code-ai install --target gpt-codex --create-dir my-new-project --agents all --skills all --apply
+# Apply Installation (actually write files)
+code-ai install --target gpt-codex --agents all --skills all --apply
 
-# apply install with overwrite
+# Overwrite existing files securely
 code-ai install --target claude --agents all --skills all --overwrite --apply
 
-# strict mode: require explicit target hints in agent/skill files
+# Strict Mode (Enforces explicit target hints in agent files)
 code-ai install --target claude --agents all --skills all --strict-hints --apply
 
-# uninstall preview
-code-ai uninstall --target claude
-
-# uninstall apply
+# Uninstall / Clean up AI assets securely
 code-ai uninstall --target claude --apply
 ```
 
-## What gets generated
-- Root orchestration mirror: `AGENTS.md`
-- Target instruction file:
-  - Copilot: `.github/copilot-instructions.md`
-  - GPT Codex: `CODEX.md`
-  - Claude: `CLAUDE.md`
-  - Qwen: `QWEN.md`
-  - Google Antugravity: `AGENTS.md` (`GEMINI.md` is also installed for compatibility)
-- Agent files copied to target-specific agents directory.
-- Skill files copied to target-specific skills directory.
-- For `gpt-codex`, assets are installed to `agents/`, `.agents/skills/`, and `.agents/workflows/` for native Codex discovery.
-- For `google-antugravity`, root instructions are provided via `AGENTS.md`, and a mirrored `GEMINI.md` is installed for backward compatibility. Assets are installed in antugravity-friendly structure:
-  - agents: `.gemini/agents/<agent>/prompt.md` and `.gemini/agents/<agent>/config.json`
-  - skills: `.gemini/skills/<skill>.md` and `.gemini/skills/<skill>.py`
-- For `qwen-3.5`, installer also generates `.qwen/settings.json` with model/context defaults.
-- Markdown content is normalized per target (model-specific hint comments like `codex:` are transformed).
-  - `codex reasoning` is mapped to target-native hints (`copilot reasoning`, `claude thinking`, `qwen reasoning_effort`, `gemini reasoning`).
-
-## Safety model
-- Default mode is `dry-run`.
-- Backup is created before writes under `.code-ai-installer/backups/<target>/<timestamp>/`.
-- State is tracked in `.code-ai-installer/state/<target>.json` for uninstall.
-- Rollback restores previous files on install failure.
-- Optional strict adaptation mode: `--strict-hints` enforces target-hint emission and auto-fills missing hints with target defaults.
-
-## Notes
-- Target aliases are accepted: `copilot`, `codex`, `claude`, `qwen`, `google`, `antigravity`.
-- If your AI tool requires a custom location, pass `--destination <path>`.
-- Source templates are resolved automatically: current directory first, bundled package templates second.
-- Template language is selectable via `--lang ru|en` (default: `ru`).
-
+---
+
+## 🏗️ What Gets Generated?
+
+Depending on the chosen `--target`, `code-ai` restructures your environment intelligently:
+
+1. **Root Orchestration Rules**: Generates `AGENTS.md` (and alias files like `CLAUDE.md`, `CODEX.md`, `GEMINI.md`, etc.).
+2. **Agents**: Copies roles to target-specific directories (e.g., `.gemini/agents/<agent>/prompt.md`, `.github/copilot-instructions.md`).
+3. **Skills & Workflows**: Deploys the necessary execution skillsets and custom workflows specific to the target AI.
+4. **Configuration**: Generates workspace settings (e.g., `.qwen/settings.json`).
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!  
+Feel free to check out the [issues page](https://github.com/denish12/codex-ai-agent-and-skills/issues).
+
+## 📄 License
+
+This project is [MIT](https://opensource.org/licenses/MIT) licensed.

package/agents/architect.md

@@ -37,7 +37,7 @@
 ## Design Patterns & Principles (must)
 Архитектор обязан учитывать эти паттерны при проектировании и фиксировать выбранные в ADR.
 
-> Полные DO/DON'T примеры с псевдокодом → **$design_patterns_reference**
+> Полные DO/DON'T примеры с псевдокодом → **$design-patterns-reference**
 
 ### SOLID
 | Принцип | Суть |
@@ -273,23 +273,23 @@
 ---
 
 ## Используемые skills (вызовы)
-- $current_state_analysis
-- $system_design_checklist
-- $architecture_doc
-- $architecture_compliance_review
-- $design_patterns_reference
-- $adr_log
-- $api_contracts
-- $data_model
-- $threat_model_baseline
-- $observability_plan
-- $deployment_ci_plan
-- $docker_kubernetes_architecture
-- $k8s_manifests_conventions
-- $n8n_pinecone_qdrant_supabase
-- $wix_self_hosted_embedded_script
-- (условно) $wix_iframe_sdk
-- (условно) $react_15_3_wix_iframe
+- $current-state-analysis
+- $system-design-checklist
+- $architecture-doc
+- $architecture-compliance-review
+- $design-patterns-reference
+- $adr-log
+- $api-contracts
+- $data-model
+- $threat-model-baseline
+- $observability-plan
+- $deployment-ci-plan
+- $docker-kubernetes-architecture
+- $k8s-manifests-conventions
+- $n8n-pinecone-qdrant-supabase
+- $wix-self-hosted-embedded-script
+- (условно) $wix-iframe-sdk
+- (условно) $react-15-3-wix-iframe
 
 ---
 

package/agents/conductor.md

@@ -174,7 +174,7 @@
 ### 7) Release Gate
 1. Сгенерировать "Release Gate Checklist" (`RG-01…RG-xx`).
 2. Собрать все Handoff Envelopes + отчёты REV + QA + CI.
-3. Выполнить `$release_gate` → GO / NO-GO / GO-with-conditions.
+3. Выполнить `$release-gate` → GO / NO-GO / GO-with-conditions.
 4. Опубликовать Release Report (Evidence + DoD + Decision + Risks).
 5. **Обновить `docs/tasks-backlog.md`** (обязательно при каждом RG).
 
@@ -279,8 +279,8 @@
 - $handoff
 - $memory
 - $gates
-- $release_gate_checklist_template
-- $release_gate
+- $release-gate-checklist-template
+- $release-gate
 
 ---
 

package/agents/devops.md

@@ -193,12 +193,12 @@ lint → typecheck → unit tests → integration tests → build → deploy (st
 ---
 
 ## Используемые skills (вызовы)
-- $deployment_ci_plan
-- $docker_kubernetes_architecture
-- $k8s_manifests_conventions
-- $cloud_infrastructure_security
-- $observability_logging
-- $security_baseline_dev
+- $deployment-ci-plan
+- $docker-kubernetes-architecture
+- $k8s-manifests-conventions
+- $cloud-infrastructure-security
+- $observability-logging
+- $security-baseline-dev
 
 ---
 

package/agents/orchestrator.claude.json

@@ -14,77 +14,77 @@
     "ux_ui_designer"
   ],
   "skills": [
-    "a11y_baseline",
-    "adr_log",
-    "api_contract_compliance_review",
-    "api_contracts",
-    "architecture_compliance_review",
-    "architecture_doc",
+    "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_patterns_reference",
-    "design_systems",
-    "dev_reference_snippets",
-    "docker_kubernetes_architecture",
-    "es2025_beast_practices",
+    "cloud-infrastructure-security",
+    "code-review-checklist",
+    "current-state-analysis",
+    "data-model",
+    "dependency-supply-chain-review",
+    "deployment-ci-plan",
+    "design-intake",
+    "design-parity-review",
+    "design-patterns-reference",
+    "design-systems",
+    "dev-reference-snippets",
+    "docker-kubernetes-architecture",
+    "es2025-beast-practices",
     "gates",
-    "go_beast_practices",
-    "golden_canon_grid",
-    "google_stitch_skill",
+    "go-beast-practices",
+    "golden-canon-grid",
+    "google-stitch-skill",
     "handoff",
-    "k8s_manifests_conventions",
+    "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_regression_baseline",
-    "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",
-    "tailwind_beast_practices",
-    "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"
+    "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-regression-baseline",
+    "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",
+    "tailwind-beast-practices",
+    "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)",

package/agents/orchestrator.copilot.json

@@ -14,77 +14,77 @@
     "ux_ui_designer"
   ],
   "skills": [
-    "a11y_baseline",
-    "adr_log",
-    "api_contract_compliance_review",
-    "api_contracts",
-    "architecture_compliance_review",
-    "architecture_doc",
+    "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_patterns_reference",
-    "design_systems",
-    "dev_reference_snippets",
-    "docker_kubernetes_architecture",
-    "es2025_beast_practices",
+    "cloud-infrastructure-security",
+    "code-review-checklist",
+    "current-state-analysis",
+    "data-model",
+    "dependency-supply-chain-review",
+    "deployment-ci-plan",
+    "design-intake",
+    "design-parity-review",
+    "design-patterns-reference",
+    "design-systems",
+    "dev-reference-snippets",
+    "docker-kubernetes-architecture",
+    "es2025-beast-practices",
     "gates",
-    "go_beast_practices",
-    "golden_canon_grid",
-    "google_stitch_skill",
+    "go-beast-practices",
+    "golden-canon-grid",
+    "google-stitch-skill",
     "handoff",
-    "k8s_manifests_conventions",
+    "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_regression_baseline",
-    "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",
-    "tailwind_beast_practices",
-    "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"
+    "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-regression-baseline",
+    "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",
+    "tailwind-beast-practices",
+    "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)",