code-ai-installer 1.1.11 → 1.3.0

package/locales/en/.agents/google_stitch_skill/resources/budget_planner.md

@@ -0,0 +1,23 @@
+# Stitch Generation Budget Planner
+
+## Monthly limits
+
+| Mode | Limit | Average spend per screen | Screens per month |
+|------|-------|--------------------------|-------------------|
+| Standard (Flash) | ~350 | 3–6 generations | ~60–115 screens |
+| Experimental (Pro) | ~50 | 3–5 generations | ~10–16 screens |
+
+## Recommended allocation for SCR
+
+| Task | Mode | Generations | Notes |
+|------|------|-------------|-------|
+| New popup template | Standard | ~5 | Initial pass + 2 iterations + 2 states |
+| Final popup version | Experimental | ~3 | With HTML reference as input |
+| Dashboard page | Standard | ~8 | More complex than a popup |
+| State coverage | Standard | ~8 | 4 × (generation + iteration) |
+
+## Cost-saving strategy
+1. Standard first, Experimental last
+2. Save prompts for predictable reruns
+3. Batch state generation per screen
+4. Reuse the same style block for consistency

package/locales/en/.agents/handoff/SKILL.md

@@ -1,52 +1,212 @@
 ---
 name: handoff
-description: Formation of the Context Pack and setting the task for the agent: goals, restrictions, artifacts, solutions, questions, Definition of Done. Requires a standard response format.
----
-
-# Skill: Context Pack Handoff (transferring tasks to agents)
-
-## Goal
-Provide agents with exactly the context they need to complete a task, without losing key decisions.
-
-## When to use
-Every time the conductor delegates work to any agent.
-
-## Context Pack (required fields)
-- **Goal**: what you need to get
-- **Scope**: what is included/not included
-- **Constraints**: stack/deployment/timing/integrations/security
-- **Inputs**: links to documents/files/inserts
-- **Decisions**: what has already been decided (and cannot be broken without agreement)
-- **Open Questions**: what is unknown
-- **Definition of Done**: “done” criterion
-- **Output Format**: in what form to return the result
-
-## Delegation algorithm
-1) Create a Context Pack (short but complete).
-2) Clearly formulate the task and the expected artifact.
-3) Set a “quality bar”: checks, criteria, response format.
-4) Ask to return the result strictly according to the report template.
-
-## Universal problem statement template
-**Context Pack**
-- Goal:
-- Scope:
-- Constraints:
-- Inputs:
-- Decisions:
-- Open Questions:
--DoD:
-- Output Format:
-
-**Task**
-- ID:
-- What to do:
-- Acceptance criteria:
-
-**Reply Format**
+description: Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done. Requires the standard response shape.
+---
+
+# Skill: Context Pack Handoff
+
+Handoff tasks between gates with full context.
+
+**Sections:**
+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. [Example: PM→UX Handoff](#6-example)
+
+---
+
+## 1. Workflow
+
+```
+1. The previous gate is complete (☑ in board)
+2. Conductor assembles the Context Pack (section 2)
+3. Conductor form HANDOFF Envelope (section 3)
+4. Conductor delegates to the next agent
+5. Agent receives envelope → reads own role .md → activates skills
+6. Agent returns response by Reply Format (section 4)
+7. Conductor checks DoD → ☑ or ⚠️ (return)
+```
+
+---
+
+## 2. Context Pack
+
+### Mandatory fields
+
+| Field | Description | Example |
+|-------|------------|---------|
+| **Goal** | What needed get | "Create UX Spec for Settings page" |
+| **Scope** | What belongs / not belongs | "In: Settings CRUD. Out: Analytics" |
+| **Constraints** | Stack, deploy, deadlines, integrations | "Wix iframe, WDS, desktop-only" |
+| **Inputs** | Links on documents/files | "PRD: docs/prd.md, UX Discovery: ..." |
+| **Decisions** | What already decided (cannot change without approval) | "ADR-001: MongoDB, ADR-002: WDS" |
+| **Open Questions** | What unknown | "Timer design not finalized" |
+| **DoD** | Criterion «ready» | "UX Spec covers all PRD flows + states" |
+| **Output Format** | In which form the result should be returned in | "Markdown file: docs/ux-spec.md" |
+
+---
+
+## 3. HANDOFF Envelope
+
+### Template (copy as-is)
+
+```markdown
+---
+## HANDOFF ENVELOPE
+
+**From:** <Gate/Agent> (e.g., PM Gate)
+**To:** <Gate/Agent> (e.g., UX/UI Designer)
+**Task ID:** <board task ID> (e.g., UX-01)
+**Date:** YYYY-MM-DD
+
+### Context Pack
+- **Goal:** <one sentence>
+- **Scope:** In: <list> | Out: <list>
+- **Constraints:** <stack, deploy, integrations>
+- **Inputs:**
+  - <file/link 1>
+  - <file/link 2>
+- **Decisions:** <key decisions that must not change>
+- **Open Questions:** <unresolved items>
+- **DoD:** <checkable criteria>
+- **Output Format:** <expected deliverable format>
+
+### Task
+- **What to do:** <concrete action>
+- **Skills to use:** $skill_1, $skill_2
+- **Acceptance criteria:**
+  - [ ] <criterion 1>
+  - [ ] <criterion 2>
+---
+```
+
+---
+
+## 4. Reply Format
+
+Every agent must return their deliverable in this structure:
+
+```markdown
 ### Summary
+<1-3 sentences: what was done>
+
 ### Deliverables
+<list of artifacts produced with paths/links>
+
 ###Decisions
-###Risks/Blockers
+<key decisions made during this gate>
+
+### Risks / Blockers
+<anything that may affect downstream gates>
+
 ### Open Questions
-### Next Actions (IDs)
+<unresolved items for user/conductor>
+
+### Next Actions
+<suggested next steps with IDs: UX-02, ARCH-01, etc.>
+```
+
+---
+
+## 5. Gate-Specific Variations
+
+### PM → UX
+
+| Field | Typical content |
+|-------|----------------|
+| Inputs | PRD, Interview Summary |
+| Skills | $ux_discovery, $ux_spec, $ui_inventory, $a11y_baseline |
+| DoD | UX Spec covers all flows + screens + states + validations |
+
+### UX → ARCH
+
+| Field | Typical content |
+|-------|----------------|
+| Inputs | PRD, UX Spec, UI Inventory |
+| Skills | $architecture_doc, $adr_log, $api_contracts, $data_model |
+| DoD | Architecture doc + API contracts + data model + ADRs |
+
+### ARCH → DEV
+
+| Field | Typical content |
+|-------|----------------|
+| Inputs | Architecture, API Contracts, UX Spec, Data Model |
+| Skills | $tdd_workflow, $testing_strategy_js, relevant best practices |
+| DoD | Code complete, tests pass, no P0 self-review issues |
+
+### DEV → REV
+
+| Field | Typical content |
+|-------|----------------|
+| Inputs | Code diff, test results, API contracts |
+| Skills | $code_review_checklist, $security_review, $performance_review_baseline |
+| DoD | Review report with 0 P0, P1 tracked |
+
+### REV → OPS
+
+| Field | Typical content |
+|-------|----------------|
+| Inputs | Approved code, Docker config |
+| Skills | $deployment_ci_plan, /auto-restart-containers |
+| DoD | Build success, containers healthy |
+
+### OPS → TEST
+
+| Field | Typical content |
+|-------|----------------|
+| Inputs | Deployed environment, UX Spec, API Contracts |
+| Skills | $qa_test_plan, $qa_manual_run, $qa_api_contract_tests, $qa_security_smoke_tests |
+| DoD | All P0 tests pass, 0 open P0 bugs |
+
+### TEST → RG
+
+| Field | Typical content |
+|-------|----------------|
+| Inputs | All gate reports (REV, TEST, CI) |
+| Skills | $release_gate, $release_gate_checklist_template |
+| DoD | Release checklist complete, GO decision |
+
+---
+
+## 6. Example: PM→UX Handoff
+
+```markdown
+---
+## HANDOFF ENVELOPE
+
+**From:** PM Gate (PM Agent)
+**To:** UX/UI Designer
+**Task ID:** UX-01
+**Date:** 2026-03-13
+
+### Context Pack
+- **Goal:** Create UX Spec for Smart Cart Rescue Dashboard
+- **Scope:** In: Settings, Coupons, Widget config | Out: Analytics, multi-lang
+- **Constraints:** Wix iframe, WDS components, desktop-only
+- **Inputs:**
+  - PRD: `docs/prd-smart-cart-rescue.md`
+  - Backlog: `docs/backlog.md`
+- **Decisions:** ADR-001: MongoDB for storage, ADR-002: WDS for UI
+- **Open Questions:** Timer design (countdown vs deadline)
+- **DoD:** UX Spec covers all 5 PRD user stories, all screens have 4 states
+- **Output Format:** `docs/ux-spec.md`
+
+### Task
+- **What to do:** Run $ux_discovery → $ux_spec → $ui_inventory → $a11y_baseline
+- **Skills to use:** $ux_discovery, $ux_spec, $ui_inventory, $a11y_baseline
+- **Acceptance criteria:**
+  - [ ] All PRD flows have screen specs
+  - [ ] States: loading/empty/error/success defined per screen
+  - [ ] UI Inventory maps to WDS components
+  - [ ] A11y baseline documented
+---
+```
+
+---
+
+## See also
+- `$gates` — gate definitions and DoD
+- `$board` — project board tracking
+- `$memory` — context preservation

package/locales/en/.agents/handoff/agents/claude.json

@@ -0,0 +1,16 @@
+{
+  "name": "handoff",
+  "display_name": "Context Pack Handoff",
+  "description": "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done. Requires the standard response shape.",
+  "default_prompt": "Use $handoff when the task matches the \"Context Pack Handoff\" skill.",
+  "triggers": [
+    "handoff",
+    "Context Pack Handoff",
+    "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done"
+  ],
+  "capabilities": [
+    "handoff"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/locales/en/.agents/handoff/agents/copilot.json

@@ -0,0 +1,16 @@
+{
+  "name": "handoff",
+  "display_name": "Context Pack Handoff",
+  "description": "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done. Requires the standard response shape.",
+  "default_prompt": "Use $handoff when the task matches the \"Context Pack Handoff\" skill.",
+  "triggers": [
+    "handoff",
+    "Context Pack Handoff",
+    "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done"
+  ],
+  "capabilities": [
+    "handoff"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/locales/en/.agents/handoff/agents/gemini.json

@@ -0,0 +1,16 @@
+{
+  "name": "handoff",
+  "display_name": "Context Pack Handoff",
+  "description": "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done. Requires the standard response shape.",
+  "default_prompt": "Use $handoff when the task matches the \"Context Pack Handoff\" skill.",
+  "triggers": [
+    "handoff",
+    "Context Pack Handoff",
+    "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done"
+  ],
+  "capabilities": [
+    "handoff"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/locales/en/.agents/handoff/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Context Pack Handoff"
+  short_description: "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions,…"
+  default_prompt: "Use $handoff when the task matches the \"Context Pack Handoff\" skill."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/locales/en/.agents/handoff/agents/qwen.json

@@ -0,0 +1,16 @@
+{
+  "name": "handoff",
+  "display_name": "Context Pack Handoff",
+  "description": "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done. Requires the standard response shape.",
+  "default_prompt": "Use $handoff when the task matches the \"Context Pack Handoff\" skill.",
+  "triggers": [
+    "handoff",
+    "Context Pack Handoff",
+    "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done"
+  ],
+  "capabilities": [
+    "handoff"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/locales/en/.agents/handoff/agents/skill.yaml

@@ -0,0 +1,20 @@
+version: 1
+name: "handoff"
+display_name: "Context Pack Handoff"
+description: "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done. Requires the standard response shape."
+default_prompt: "Use $handoff when the task matches the \"Context Pack Handoff\" skill."
+triggers:
+  - "handoff"
+  - "Context Pack Handoff"
+  - "Formation Context Pack and task setup for the agent — goals, constraints, artifacts, decisions, questions, Definition of Done"
+capabilities:
+  - "handoff"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "en"
+  available_locales:
+    - "ru"
+    - "en"