code-ai-installer 3.0.0 → 4.0.0

package/domains/development/locales/en/.agents/skills/board/SKILL.md

@@ -1,129 +1,298 @@
 ---
 name: board
-description: Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message.
+description: "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message."
+type: mandatory
+domain: development
+owners:
+  - conductor
+gates:
+  - PM
+  - UX
+  - ARCH
+  - DEV
+  - REV
+  - OPS
+  - TEST
+  - RG
+tech: []
+topic:
+  - orchestration
+triggers:
+  - update board
+  - task status
+  - Project Board
+  - task checklist
+  - task ID
+  - progress board
+  - task statuses
+related:
+  - pm-backlog
+  - handoff
+  - gates
+  - release-gate
+budget_lines: 300
+schema_version: 1
 ---
 
-# Skill: Board & Task Management
 
-How the Conductor (Main Agent) manages the task board and tracks progress.
+# Skill: Project Board (Conductor's checklist)
+
+Transparent progress control.
 
 **Sections:**
-1. [Core Principles](#1-principles)
-2. [Task Statuses](#2-statuses)
-3. [Board Structure](#3-structure)
-4. [Updating the Board](#4-updating)
-5. [Conductor's Message Format](#5-message-format)
-6. [Anti-patterns](#6-anti-patterns)
+1. [Workflow](#1-workflow)
+2. [Task Format](#2-format)
+3. [Status Rules](#3-statuses)
+4. [Board Template](#4-template)
+5. [Progress Summary](#5-summary)
+6. [Blocker Escalation](#6-blockers)
+7. [Example](#7-example)
+8. [Output Template](#8-output)
+9. [Anti-patterns](#9-anti-patterns)
 
 ---
 
-## 1. Core Principles
+## 1. Workflow
+
+```
+1. Kickoff → build Board from Backlog ($pm-backlog)
+   └── 1-3 tasks per role for the current iteration
+
+2. At every pipeline step:
+   a. Update task statuses
+   b. Add new tasks (if they appeared)
+   c. Mark blockers
+   d. Output the Board at the start of the message
 
-- **Visibility:** The board MUST be visible in every message from the Conductor.
-- **Traceability:** Every task has a unique ID (e.g., `T-01`, `BUG-42`).
-- **Granularity:** Tasks should be small enough to complete in 1-2 agent interactions.
-- **Single Source of Truth:** If it's not on the board, it doesn't exist.
-- **Handoff Linking:** When handing off to an agent, reference the Task ID.
+3. On blocker → escalation (section 6)
+
+4. On iteration end → Progress Summary (section 5)
+```
 
 ---
 
-## 2. Task Statuses
+## 2. Task Format
 
-Use exactly these symbols for quick visual parsing:
+### ID Convention
 
-| Symbol | Status | Meaning |
-|:---:|---|---|
-| `☐` | **TODO** | Task identified, not started yet. |
-| `⏳` | **IN PROGRESS** | Agent is currently working on it. |
-| `☑` | **DONE** | Validated and completed (DoD met). |
-| `⚠️` | **BLOCKED** | Needs user input, clarification, or depends on another blocked task. |
-| `❌` | **CANCELED** | Won't do, out of scope, or obsolete. |
+| Prefix | Owner | Example |
+|--------|-------|---------|
+| `PM-xx` | Product Manager | PM-01: Write PRD |
+| `UX-xx` | UX/UI Designer | UX-01: Create UX Spec |
+| `ARCH-xx` | Architect | ARCH-01: System design |
+| `DEV-xx` | Senior Full Stack | DEV-01: Implement settings API |
+| `REV-xx` | Reviewer | REV-01: Security review |
+| `OPS-xx` | DevOps | OPS-01: Docker setup |
+| `TEST-xx` | Tester | TEST-01: Test plan |
+| `RG-xx` | Release Gate | RG-01: Release checklist |
+| `BUG-xx` | Any role (bug) | BUG-01: Fix login regression |
 
----
+### Task line format
 
-## 3. Board Structure
+```
+- [status] (ID) Description — Owner: XX — Deps: YY — Notes: ZZ
+```
+
+### Rules
 
-The board is a markdown checklist grouped by Epic or Phase.
+| Rule | Explanation |
+|------|------------|
+| One task = one checkable result | Artifact, check, or decision |
+| Max 3 tasks per role per iteration | Keep focus |
+| New scope → new task (never modify existing scope) | Traceability |
+| Dependencies explicit | List what blocks and what's blocked |
 
-### Typical Layout
+### Subtask spawning
+
+If a task turns out to be complex — break it down into hierarchical subtasks (do not spawn "mega-tasks"):
 
 ```markdown
-## 📋 Project Board
-
-### Phase 1: Planning & Design (Gate 1 & 2)
-- ☑ [T-01] Gather Requirements (PM)
-- ☑ [T-02] Draft PRD (PM)
-- ⏳ [T-03] Create UX Spec (UX Designer) - *Waiting for review*
-- ☐ [T-04] Architecture Document (Architect)
-- ☐ [T-05] API Contracts (Architect)
-
-### Phase 2: Implementation (Gate 3)
-- ☐ [T-06] DB Schema Setup (Senior Full Stack)
-- ☐ [T-07] Build Login Flow (Senior Full Stack)
-...
+- ⏳ (DEV-06) Build Login Flow — Owner: DEV
+  - ☑ (DEV-06.1) Setup JWT middleware
+  - ⏳ (DEV-06.2) Create `/login` endpoint
+  - ☐ (DEV-06.3) Frontend Login form
 ```
 
+A subtask inherits the parent's Owner and Gate; the parent's status stays `⏳` while at least one subtask is `⏳`/`☐`/`⚠️`, and transitions to `☑` only when **all** subtasks are `☑`/`❌`.
+
 ---
 
-## 4. Updating the Board
+## 3. Status Rules
+
+| Status | Meaning | When to set |
+|--------|---------|-------------|
+| `☐` | Not started | Task created, not yet in progress |
+| `⏳` | In progress | Agent started working on this |
+| `☑` | Done | Artifact delivered + accepted by user |
+| `❌` | Canceled | Won't do — out of scope / obsolete / superseded |
+| `⚠️` | Blocked | Cannot proceed — with explicit reason + owner |
 
-### When to update
+### Transition rules
 
-1. **New Request:** Parse user request into `T-xx` items. Add them as `☐`.
-2. **Before Handoff:** Change target task to `⏳`.
-3. **After Handoff (Success):** Change task to `☑`.
-4. **After Handoff (Failure/Bug):** Change to `⚠️` or spawn a new `[BUG-xx]` item.
-5. **Phase Complete:** Collapse completed phases or summarize them if the board gets too long.
+```
+☐ → ⏳   Agent starts working
+⏳ → ☑   Artifact delivered + user approved
+⏳ → ⚠️  Blocker discovered
+⚠️ → ⏳  Blocker resolved
+☐/⏳/⚠️ → ❌  Task canceled (record reason)
+☑ → ☐    Requirement changed → new task (don't revert ☑)
+```
 
-### Spawning subtasks
+### Status never goes backward
 
-If a task `T-06 (Build Login Flow)` turns out to be complex, break it down:
+- `☑ → ⏳` is **forbidden** — if rework is needed, create a new task
+- `☑ → ☐` is **forbidden** — done is done
+- `❌ → *` is **forbidden** — canceled is final (if you need to revisit — create a new task with deps on the canceled one)
+
+---
+
+## 4. Board Template
 
 ```markdown
-- ⏳ [T-06] Build Login Flow
-  - ☑ [T-06.1] Setup JWT middleware
-  - ⏳ [T-06.2] Create `/login` endpoint
-  - ☐ [T-06.3] Frontend Login form
+## 📋 Project Board — Iteration N
+
+### PM Gate
+- [☑] (PM-01) PRD v1.0 — Owner: PM
+- [☑] (PM-02) Backlog decomposition — Owner: PM
+
+### UX Gate
+- [⏳] (UX-01) UX Discovery — Owner: UX
+- [☐] (UX-02) UX Spec — Owner: UX — Deps: UX-01
+
+### ARCH Gate
+- [☐] (ARCH-01) Architecture doc — Owner: ARCH — Deps: UX-02
+- [☐] (ARCH-02) API contracts — Owner: ARCH — Deps: ARCH-01
+
+### DEV Gate
+- [☐] (DEV-01) Settings API — Owner: DEV — Deps: ARCH-02
+- [☐] (DEV-02) Settings UI — Owner: DEV — Deps: DEV-01, UX-02
+
+### REV Gate
+- [☐] (REV-01) Code review — Owner: REV — Deps: DEV-01, DEV-02
+- [☐] (REV-02) Security review — Owner: REV — Deps: DEV-01
+
+### OPS Gate
+- [☐] (OPS-01) Docker setup — Owner: OPS — Deps: DEV-01
+
+### TEST Gate
+- [☐] (TEST-01) Test plan — Owner: TEST — Deps: UX-02
+- [☐] (TEST-02) Manual test run — Owner: TEST — Deps: DEV-02
+
+### Release Gate
+- [☐] (RG-01) Release checklist — Owner: Conductor — Deps: ALL
 ```
 
 ---
 
-## 5. Conductor's Message Format
+## 5. Progress Summary
 
-Every response from the Conductor to the User MUST follow this structure:
+Add to every board update:
 
 ```markdown
-# 🎭 Conductor
+## 📊 Progress
+| Gate | Total | Done | In Progress | Blocked | Canceled |
+|------|:-----:|:----:|:-----------:|:-------:|:--------:|
+| PM | 2 | 2 | 0 | 0 | 0 |
+| UX | 2 | 0 | 1 | 0 | 0 |
+| ARCH | 2 | 0 | 0 | 0 | 0 |
+| DEV | 2 | 0 | 0 | 0 | 0 |
+| REV | 2 | 0 | 0 | 0 | 0 |
+| OPS | 1 | 0 | 0 | 0 | 0 |
+| TEST | 2 | 0 | 0 | 0 | 0 |
+| RG | 1 | 0 | 0 | 0 | 0 |
+| **Total** | **14** | **2** | **1** | **0** | **0** |
+
+**Progress: 2/14 (14%) — On Track / At Risk / Blocked**
+```
+
+---
+
+## 6. Blocker Escalation
 
-**Status Update:** <1-2 sentences summarizing what just happened>
+When `⚠️` appears:
+
+```markdown
+### ⚠️ Blocker Report
+| Task | Blocked by | Owner of resolution | Impact | ETA |
+|------|-----------|:-------------------:|--------|-----|
+| DEV-01 | ARCH-02 not ready | ARCH | P0: all DEV work blocked | Today |
+| TEST-02 | Staging env down | OPS | P1: testing delayed | Tomorrow |
+```
 
-<Answer to user / Recommendations / Next Steps>
+### Escalation rules
+
+| Severity | When | Action |
+|----------|------|--------|
+| 🔴 **Critical** | P0 task blocked, blocks others | Immediately notify user |
+| 🟠 **High** | P1 task blocked | Report in next board update |
+| 🟡 **Low** | P2 task blocked | Track, resolve when possible |
 
 ---
-## 📋 Current Board
-- ☑ [T-01] Initial setup
-- ⏳ [T-02] Implementing Feature X (Full Stack doing this now)
-- ☐ [T-03] Testing
-- ⚠️ [T-04] Clarify API rate limits (need User input)
 
-**Next action:** Handoff T-02 to Senior Full Stack. Do you approve?
+## 7. Example
+
+```markdown
+## 📋 Project Board — Iteration 1 (MVP Foundation)
+
+### PM Gate
+- [☑] (PM-01) PRD: SaaS Admin Panel v1.0 — Owner: PM
+- [☑] (PM-02) Backlog: 3 epics, 20 tasks — Owner: PM
+
+### UX Gate
+- [☑] (UX-01) UX Discovery completed — Owner: UX
+- [⏳] (UX-02) UX Spec: Settings + Products screens — Owner: UX
+
+### ARCH Gate
+- [☐] (ARCH-01) Architecture Doc — Owner: ARCH — Deps: UX-02
+- [☐] (ARCH-02) API Contracts (Settings, Products, Content) — Owner: ARCH
+
+### DEV Gate
+- [☐] (DEV-01) Settings API (CRUD + validation) — Owner: DEV — Deps: ARCH-02
+- [⏳] (DEV-02) Settings Dashboard UI — Owner: DEV — Deps: DEV-01, UX-02
+  - [☑] (DEV-02.1) Basic layout — Owner: DEV
+  - [⏳] (DEV-02.2) State + API wiring — Owner: DEV
+  - [☐] (DEV-02.3) Loading/empty/error states — Owner: DEV
+- [❌] (DEV-03) Drag-and-drop reorder — Canceled: moved to next iteration backlog
+
+### 📊 Progress: 3/8 (38%) — On Track
+```
+
+---
+
+## 8. Output Template
+
+```markdown
+## 📋 Project Board — Iteration <N>
+
+<section 4 format — all tasks with statuses>
+
+## 📊 Progress
+<section 5 format>
+
+## ⚠️ Blockers
+<section 6 format — or "None">
+
+## 🔜 Next Steps
+1. <What happens next>
+2. <Next agent to activate>
 ```
 
 ---
 
-## 6. Anti-patterns
+## 9. Anti-patterns
 
 | ❌ Anti-pattern | ✅ Solution |
-|----------------|-----------|
-| **Forgetting the board** | Conductor replies with just text. The user loses context. ALWAYS include the board. |
-| **Tasks without IDs** | "Fix login bug". Hard to reference. Use `[BUG-01] Fix login bug`. |
-| **Vague statuses** | Using "Pending" or mixed symbols. Stick to `☐, ⏳, ☑, ⚠️, ❌`. |
-| **Silent updates** | Changing a task from `⏳` to `☑` without explaining *how* it was validated. |
-| **Mega-tasks** | `☐ [T-01] Build the entire app`. Break it down. |
+|----------------|------------|
+| **Forgetting the board** — conductor replies with text only; the user loses context | ALWAYS include the Board at the start of the conductor's message |
+| **Tasks without IDs** — "Fix login bug" cannot be referenced | Use `(BUG-01) Fix login bug` with a role-prefixed ID |
+| **Vague statuses** — "Pending", "Sort of done", mixed symbols | Only `☐ / ⏳ / ☑ / ❌ / ⚠️` — nothing else |
+| **Silent updates** — `⏳ → ☑` without explaining how it was validated | Every `☑` is accompanied by evidence (artifact / handoff envelope / user approval) |
+| **Mega-tasks** — `☐ (DEV-01) Build the entire app` | Break it down via Subtask spawning (section 2) — max 3 tasks per role per iteration |
 
 ---
 
 ## See also
-- `$handoff` — How to pass a task to another agent.
-- `$gates` — How phases map to pipeline gates.
-- `$pm-backlog` — How the PM originally creates the list of tasks.
+- `$pm-backlog` — backlog (source of tasks)
+- `$handoff` — gate transitions between agents
+- `$gates` — pipeline gate definitions
+- `$release-gate` — final release checklist

package/domains/development/locales/en/.agents/skills/board/agents/claude.json

@@ -1,16 +1,16 @@
-{
-  "name": "board",
-  "display_name": "Project Board",
-  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message.",
-  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
-  "triggers": [
-    "board",
-    "Project Board",
-    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message"
-  ],
-  "capabilities": [
-    "board"
-  ],
-  "tools": [],
-  "implicit_invocation": true
-}
+{
+  "name": "board",
+  "display_name": "Project Board",
+  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message.",
+  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
+  "triggers": [
+    "board",
+    "Project Board",
+    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message"
+  ],
+  "capabilities": [
+    "board"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/locales/en/.agents/skills/board/agents/copilot.json

@@ -1,16 +1,16 @@
-{
-  "name": "board",
-  "display_name": "Project Board",
-  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message.",
-  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
-  "triggers": [
-    "board",
-    "Project Board",
-    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message"
-  ],
-  "capabilities": [
-    "board"
-  ],
-  "tools": [],
-  "implicit_invocation": true
-}
+{
+  "name": "board",
+  "display_name": "Project Board",
+  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message.",
+  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
+  "triggers": [
+    "board",
+    "Project Board",
+    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message"
+  ],
+  "capabilities": [
+    "board"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/locales/en/.agents/skills/board/agents/gemini.json

@@ -1,16 +1,16 @@
-{
-  "name": "board",
-  "display_name": "Project Board",
-  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message.",
-  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
-  "triggers": [
-    "board",
-    "Project Board",
-    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message"
-  ],
-  "capabilities": [
-    "board"
-  ],
-  "tools": [],
-  "implicit_invocation": true
-}
+{
+  "name": "board",
+  "display_name": "Project Board",
+  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message.",
+  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
+  "triggers": [
+    "board",
+    "Project Board",
+    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message"
+  ],
+  "capabilities": [
+    "board"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/locales/en/.agents/skills/board/agents/kimi.yaml

@@ -1,11 +1,11 @@
 name: "board"
 display_name: "Project Board"
-description: "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message."
+description: "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message."
 default_prompt: "Use $board when the task matches the \"Project Board\" skill."
 triggers:
   - "board"
   - "Project Board"
-  - "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message"
+  - "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message"
 capabilities:
   - "board"
 tools: []

package/domains/development/locales/en/.agents/skills/board/agents/openai.yaml

@@ -1,8 +1,8 @@
-interface:
-  display_name: "Project Board"
-  short_description: "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each st…"
-  default_prompt: "Use $board when the task matches the \"Project Board\" skill."
-dependencies:
-  tools: []
-policy:
-  allow_implicit_invocation: true
+interface:
+  display_name: "Project Board"
+  short_description: "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each st…"
+  default_prompt: "Use $board when the task matches the \"Project Board\" skill."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/domains/development/locales/en/.agents/skills/board/agents/qwen.json

@@ -1,16 +1,16 @@
-{
-  "name": "board",
-  "display_name": "Project Board",
-  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message.",
-  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
-  "triggers": [
-    "board",
-    "Project Board",
-    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message"
-  ],
-  "capabilities": [
-    "board"
-  ],
-  "tools": [],
-  "implicit_invocation": true
-}
+{
+  "name": "board",
+  "display_name": "Project Board",
+  "description": "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message.",
+  "default_prompt": "Use $board when the task matches the \"Project Board\" skill.",
+  "triggers": [
+    "board",
+    "Project Board",
+    "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message"
+  ],
+  "capabilities": [
+    "board"
+  ],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/development/locales/en/.agents/skills/board/agents/skill.yaml

@@ -1,20 +1,20 @@
-version: 1
-name: "board"
-display_name: "Project Board"
-description: "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message."
-default_prompt: "Use $board when the task matches the \"Project Board\" skill."
-triggers:
-  - "board"
-  - "Project Board"
-  - "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/⚠️, updates after each step, visible checklist in every Conductor's message"
-capabilities:
-  - "board"
-tools: []
-invocation:
-  explicit: true
-  implicit: true
-localization:
-  default_locale: "en"
-  available_locales:
-    - "ru"
-    - "en"
+version: 1
+name: "board"
+display_name: "Project Board"
+description: "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message."
+default_prompt: "Use $board when the task matches the \"Project Board\" skill."
+triggers:
+  - "board"
+  - "Project Board"
+  - "Project Board Management — creation of tasks with IDs, statuses ☐/⏳/☑/❌/⚠️, updates after each step, visible checklist in every Conductor's message"
+capabilities:
+  - "board"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "en"
+  available_locales:
+    - "ru"
+    - "en"