cokit-cli 1.2.7 → 1.3.0

package/docs/skills-and-orchestration-layer-vi.md

@@ -0,0 +1,404 @@
+# Skills & Orchestration Layer - Training Slides (Tiếng Việt)
+
+---
+
+## Slide 1: Vấn Đề — Tại Sao Chat-Style AI Coding Không Đủ
+
+### Level 0: Raw Prompting (Cách đa số dev đang làm)
+
+```
+Bạn:   "Thêm user authentication"
+AI:    Đây là basic auth... [code snippet hời hợt]
+Bạn:   "Không, tôi cần JWT tokens"
+AI:    Đây là JWT... [snippet khác, mất hết context trước đó]
+Bạn:   "Nó không hoạt động với User model của tôi"
+AI:    Bạn paste User model được không? [đã mất toàn bộ context]
+Bạn:   [paste 200 dòng] "Giờ fix middleware luôn"
+AI:    [hallucinate middleware không khớp codebase của bạn]
+...
+45 phút sau: code rời rạc, không tests, không docs, copy-paste thủ công
+```
+
+**Pain points:**
+- **Shallow work** — AI cho snippet chung chung, không phải production code
+- **Không biết codebase** — không biết files, patterns, conventions của bạn
+- **Context bay hơi** — mỗi message bắt đầu lại từ đầu
+- **Thủ công hết** — bạn tự copy-paste, test, review, commit
+- **Không quality gates** — không ai kiểm tra output của AI trước khi ship
+
+### Level 1: Skills (Tốt hơn, nhưng vẫn rời rạc)
+
+Skills cho AI **domain expertise** — cách viết backend, style UI, test đúng cách. Nhưng standalone skills bị cô lập. Mỗi cái làm tốt một việc trong chân không:
+
+```
+/skill-backend    → generate API code      ...nhưng ai plan?
+/skill-test       → viết test cases        ...nhưng ai chạy?
+/skill-review     → review code quality    ...nhưng ai fix issues?
+/skill-git        → commit changes         ...nhưng ai điều phối?
+```
+
+Skills không có orchestration = **hộp đồ nghề mà không có thợ xây**. Bạn vẫn phải tự chain thủ công.
+
+### Level 2: Orchestration (Tầng còn thiếu)
+
+Nếu 1 command có thể **plan, code, test, review, và ship** — tự động?
+
+```
+/ck-cook "Add user auth"
+  │
+  ├─ 1. Scout      → scout agent quét codebase, tìm file liên quan
+  ├─ 2. Research    → researcher agents thu thập thông tin (parallel)
+  ├─ 3. Plan        → planner agent lên kiến trúc và phân tích
+  ├─ 4. Implement   → fullstack-developer agent code (parallel mode)
+  ├─ 5. Simplify    → code-simplifier agent refine code
+  ├─ 6. Test        → tester agent chạy tests, debugger agent nếu fail
+  ├─ 7. Review      → code-reviewer agent đánh giá chất lượng
+  └─ 8. Finalize    → docs-manager cập nhật docs, git-manager commit
+```
+
+**10 agents** được orchestrate bởi **1 command**. Phần còn lại CoKit tự lo.
+
+### Con Đường Tiến Hoá
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────────────┐
+│  Level 0    │     │  Level 1    │     │  Level 2            │
+│  RAW CHAT   │ ──> │  SKILLS     │ ──> │  ORCHESTRATION      │
+│             │     │             │     │                     │
+│ • Hời hợt   │     │ • Sâu nhưng │     │ • Sâu VÀ            │
+│ • Mất context│    │   rời rạc   │     │   phối hợp          │
+│ • Thủ công  │     │ • Vẫn chain │     │ • Tự động           │
+│ • Không gate│     │   thủ công  │     │ • Quality gates     │
+│             │     │             │     │ • 10 agents, 1 cmd  │
+│ 45 phút/feat│     │ 20 phút/feat│     │ 5 phút/feat         │
+└─────────────┘     └─────────────┘     └─────────────────────┘
+```
+
+**CoKit hoạt động ở Level 2.** Đó là sự khác biệt.
+
+---
+
+## Slide 2: Orchestration Layer Là Gì?
+
+Hệ thống **phối hợp AI agents, prompts, và skills** để deliver workflow phát triển end-to-end.
+
+```
+┌──────────────────────────────────────────────────────┐
+│            USER: /ck-cook "Add user auth"            │
+└──────────────┬───────────────────────────────────────┘
+               ▼
+┌──────────────────────────────────────────────────────┐
+│       ORCHESTRATION LAYER (4 Tiers)                  │
+│                                                      │
+│  Tier 1 → Tier 2 → Tier 3 → Tier 4                  │
+│  (chỉ huy) (quản lý) (công cụ) (chuyên gia)        │
+│                                                      │
+└──────────────┬───────────────────────────────────────┘
+               ▼
+┌──────────────────────────────────────────────────────┐
+│            DELIVERED FEATURE                         │
+│    Code + Tests + Docs + Commit                      │
+└──────────────────────────────────────────────────────┘
+```
+
+Không có orchestration → bạn prompt từng bước một.
+Có orchestration → 1 command trigger cả pipeline.
+
+---
+
+## Slide 3: Tổng Quan Con Số
+
+| Resource | Số lượng | Mục đích |
+|----------|---------|----------|
+| **Tiers** | **4** | Kiến trúc hub-and-spoke phân tầng |
+| **Prompts** | **34** | Command templates (18 core + 10 variants + 6 spec) |
+| **Agents** | **12** | AI personas chuyên biệt |
+| **Skills** | **27** | Gói domain expertise |
+| **Instructions** | **5** | Rules tự động load theo file type |
+| **Collections** | **5** | Nhóm resources đóng gói |
+| **Rules** | **4** | File protocol orchestration |
+
+**Tổng cộng: 87 resources** hoạt động xuyên suốt 4 tiers.
+
+---
+
+## Slide 4: Kiến Trúc 4 Tầng
+
+```mermaid
+flowchart TB
+    subgraph T1["TIER 1: Orchestrators (2 prompts)"]
+        direction LR
+        cook["/ck-cook"]
+        boot["/ck-bootstrap"]
+    end
+
+    subgraph T2["TIER 2: Workflows (18 prompts + 12 agents)"]
+        direction LR
+        plan["/ck-plan\nplanner"]
+        fix["/ck-fix\ndebugger"]
+        test["/ck-test\ntester"]
+        review["/ck-review\nreviewer"]
+        scout["/ck-scout\nscout"]
+        git["/ck-git\ngit-mgr"]
+    end
+
+    subgraph T3["TIER 3: Utility Skills (8 core + 3 conditional)"]
+        direction LR
+        research["research"]
+        st["sequential\nthinking"]
+        ds["docs-seeker"]
+        ps["problem\nsolving"]
+    end
+
+    subgraph T4["TIER 4: Standalone Skills (7 core + 20 deferred)"]
+        direction LR
+        be["backend-dev"]
+        fe["frontend-design"]
+        db["databases"]
+        dv["devops"]
+    end
+
+    T1 -->|"references agents"| T2
+    T2 -->|"activates skills"| T3
+    T4 -.->|"context-activated theo file type"| T4
+
+    style T1 fill:#FF6B6B,color:#fff
+    style T2 fill:#4ECDC4,color:#fff
+    style T3 fill:#45B7D1,color:#fff
+    style T4 fill:#96CEB4,color:#fff
+```
+
+**Nguyên tắc:** Mỗi tier chỉ gọi XUỐNG. Không circular dependencies. Không gọi ngược lên.
+
+| Tier | Tên Việt | Vai trò | Trả lời câu hỏi |
+|------|----------|---------|-----------------|
+| 1 | Tầng Chỉ Huy | Điều phối workflow end-to-end | **LÀM GÌ** và theo thứ tự nào |
+| 2 | Tầng Quản Lý Trung Gian | Thực thi từng domain cụ thể | **LÀM NHƯ THẾ NÀO** cho mỗi bước |
+| 3 | Tầng Công Cụ Thuần Tuý | Cung cấp capability tái sử dụng | **BẰNG PHƯƠNG PHÁP GÌ** |
+| 4 | Tầng Chuyên Gia Độc Lập | Domain expert tự đủ | **VỀ LĨNH VỰC NÀO** |
+
+---
+
+## Slide 5: Tier 1 — Orchestrators (Tầng Chỉ Huy)
+
+**2 prompts** | Điều phối workflow end-to-end
+
+| Prompt | Chức năng | Agents sử dụng |
+|--------|----------|----------------|
+| `/ck-cook` | Full pipeline: Scout → Research → Plan → Implement → Simplify → Test → Review → Finalize | researcher, scout, planner, ui-ux-designer, fullstack-developer, code-simplifier, tester, debugger, code-reviewer, docs-manager, git-manager |
+| `/ck-bootstrap` | Khởi tạo project mới | researcher, planner |
+
+**Hình dung:** Giống project manager — biết tất cả các bước và delegate cho từng chuyên gia.
+
+Cook có **6 modes** dựa trên input detection:
+
+| Mode | Kích hoạt khi | Hành vi |
+|------|--------------|---------|
+| interactive | mặc định | User approve từng gate |
+| auto | "auto", "trust me" | Tự approve nếu score ≥ 9.5 |
+| fast | "fast", "quick" | Bỏ qua research phase |
+| parallel | "parallel", 3+ features | Multi-agent execution |
+| no-test | "no test", "skip test" | Bỏ qua testing |
+| code | path tới plan.md | Execute plan có sẵn |
+
+---
+
+## Slide 6: Tier 2 — Workflows (Tầng Quản Lý)
+
+**18 prompts + 12 agents** | Mỗi command = **Prompt** (workflow) + **Agent** (persona)
+
+| Nhóm | Commands | Agent | Skills kích hoạt |
+|------|----------|-------|-----------------|
+| Planning | `/ck-plan`, `-fast`, `-hard`, `-validate`, `-red-team` | `planner` | planning, research, docs-seeker |
+| Scouting | `/ck-scout` | `scout` | repomix (if available) |
+| Debugging | `/ck-debug` | `debugger` | debug methodology (4 phases) |
+| Fixing | `/ck-fix`, `-types`, `-test`, `-ci`, `-ui`, `-fast`, `-hard`, `-logs` | `debugger` | debug, problem-solving, sequential-thinking |
+| Testing | `/ck-test` | `tester` | web-testing |
+| Review | `/ck-review` | `code-reviewer` | sequential-thinking |
+| Brainstorm | `/ck-brainstorm` | `brainstormer` | research, docs-seeker |
+| Simplify | `/ck-simplify` | `code-simplifier` | — |
+| Git | `/ck-git` | `git-manager` | git |
+| Docs | `/ck-docs` | `docs-manager` | docs-seeker |
+| Q&A | `/ck-ask`, `/ck-watzup` | (không) | tuỳ context |
+
+**12 agents** phục vụ **18 prompts** — riêng `debugger` đã power 9 prompt variants.
+
+### Prompt Navigation (Không Phải Cross-Hub Orchestration)
+
+Các prompt Tier 2 liên kết nhau qua **"Suggested Next Steps"** ở cuối mỗi prompt:
+
+```
+/ck-fix → gợi ý → /ck-test, /ck-git
+/ck-test → gợi ý → /ck-fix, /ck-review, /ck-git
+/ck-brainstorm → gợi ý → /ck-plan (bước 8: "Tạo implementation plan?")
+/ck-review → gợi ý → /ck-fix, /ck-git
+```
+
+Đây là **sequential prompt chaining** (user chọn bước tiếp theo), KHÔNG phải automatic cross-hub orchestration. User quyết định có follow navigation hay không.
+
+---
+
+## Slide 7: Tier 3 — Utility Skills (Tầng Công Cụ)
+
+**8 core + 3 conditional** | Cung cấp capability tái sử dụng, stateless
+
+```
+                    ┌──────────────────┐
+    ┌──────────────>│  sequential-     │<──────────────┐
+    │               │  thinking        │               │
+    │               └──────────────────┘               │
+    │                      ▲                           │
+┌───┴────────┐      ┌──────┴──────────┐       ┌───────┴──┐
+│ debugger   │      │ code-reviewer   │       │ planner  │
+└────────────┘      └─────────────────┘       └──────────┘
+
+→ 1 skill phục vụ NHIỀU agents = DRY principle
+→ Leaf nodes: không bao giờ gọi skill khác
+→ Chỉ load khi context khớp = tiết kiệm token
+```
+
+| Skill | Khả năng | Được dùng bởi |
+|-------|---------|---------------|
+| **research** | Web search, tổng hợp tài liệu | planner, brainstormer |
+| **docs-seeker** | Tra cứu docs thư viện qua context7 | planner, brainstormer, docs-manager |
+| **sequential-thinking** | Suy luận từng bước có revision | debugger, planner, code-reviewer, brainstormer |
+| **problem-solving** | Kỹ thuật hệ thống khi bị stuck | debugger (fix skill) |
+| **agent-browser** | Browser automation CLI | debugger (fix-ui), tester |
+| **repomix** *(if available)* | Pack repo cho AI đọc | scout |
+| **context-engineering** | Tối ưu token consumption | mọi agent khi bị giới hạn context |
+| **mermaidjs-v11** | Syntax Mermaid diagram v11 | planner, visual generation |
+| **ui-ux-pro-max** *(if available)* | Design intelligence | ui-ux-designer |
+| **ai-multimodal** *(if available)* | Phân tích image/video (Gemini) | mọi agent cần vision |
+| **media-processing** *(if available)* | FFmpeg/ImageMagick | mọi agent cần xử lý media |
+
+---
+
+## Slide 8: Tier 4 — Standalone Skills (Tầng Chuyên Gia)
+
+**7 core + 20 deferred** | Domain expert tự đủ, không phụ thuộc CoKit core
+
+| Nhóm | Skills |
+|------|--------|
+| Backend | `backend-development`, `databases`, `devops` |
+| Frontend | `frontend-design`, `ui-styling` |
+| Testing | `web-testing` |
+| Git | `git` |
+| MCP | `mcp-management` |
+
+**Khác Tier 3 ở đâu:**
+- Tier 3: **Phương pháp luận** — cách suy nghĩ, research, debug
+- Tier 4: **Kiến thức chuyên môn** — cách build backend, style UI, deploy
+
+**Pluggable:** Thêm `skills/ck-new-skill/SKILL.md` → tự động được phát hiện bởi context. Không cần sửa gì khác.
+
+---
+
+## Slide 9: Luồng Giao Tiếp Đầy Đủ
+
+```mermaid
+sequenceDiagram
+    actor User
+    participant T1 as Tier 1: /ck-cook
+    participant T2a as Tier 2: scout
+    participant T2b as Tier 2: planner
+    participant T2c as Tier 2: tester
+    participant T2d as Tier 2: code-reviewer
+    participant T3 as Tier 3: Skills
+
+    User->>T1: /ck-cook "Add auth"
+
+    T1->>T2a: Quét codebase
+    T2a->>T3: repomix (if available)
+    T2a-->>T1: File map
+
+    T1->>T2b: Tạo plan
+    T2b->>T3: research + docs-seeker
+    T2b-->>T1: Plan.md
+
+    Note over T1: Implement code<br/>(fullstack-developer agent)
+    Note over T1: Simplify code<br/>(code-simplifier agent)
+
+    T1->>T2c: Chạy tests
+    T2c-->>T1: Kết quả
+
+    T1->>T2d: Code review
+    T2d->>T3: sequential-thinking
+    T2d-->>T1: Score + feedback
+
+    Note over T1: docs-manager → cập nhật docs
+    Note over T1: git-manager → commit & push
+    T1-->>User: Feature delivered
+```
+
+---
+
+## Slide 10: Nguyên Tắc Thiết Kế
+
+### 1. Hub-and-Spoke (Không Phải Mesh)
+Orchestrators (hub) delegate cho specialists (spokes). **Không có** giao tiếp ngang hàng giữa agents. Các prompt Tier 2 gợi ý bước tiếp theo, nhưng **user quyết định** — đó là navigation, không phải automatic orchestration.
+
+### 2. Separation of Concerns
+Mỗi resource làm MỘT việc tốt:
+- **Prompt** = định nghĩa workflow
+- **Agent** = định nghĩa expertise/persona
+- **Skill** = cung cấp knowledge/methodology
+
+### 3. DRY qua Shared Skills
+`sequential-thinking` viết 1 lần → dùng bởi debugger, planner, code-reviewer, brainstormer.
+
+### 4. Graceful Degradation
+External tools dùng `(if available)`. Không có repomix? Scout fallback về built-in search.
+
+### 5. Pluggable Architecture
+Skill mới = file SKILL.md mới. Không cần đăng ký. Không sửa prompt nào. Context-activated.
+
+---
+
+## Slide 11: Bảng Tóm Tắt
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│              COKIT ORCHESTRATION - TÓM TẮT                  │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  TIER 1 (2)    /ck-cook, /ck-bootstrap                     │
+│  ─────────     Điều phối workflow end-to-end                │
+│                                                             │
+│  TIER 2 (30)   18 prompts + 12 agents                      │
+│  ─────────     /ck-plan, /ck-fix, /ck-test, /ck-review...  │
+│                Thực thi từng domain cụ thể                  │
+│                                                             │
+│  TIER 3 (11)   8 core + 3 conditional skills               │
+│  ─────────     research, sequential-thinking, docs-seeker   │
+│                Cung cấp capability tái sử dụng              │
+│                                                             │
+│  TIER 4 (27)   7 core + 20 deferred skills                 │
+│  ─────────     backend-dev, databases, devops, ui-styling   │
+│                Domain expert tự đủ                           │
+│                                                             │
+│  TỔNG: 4 tiers │ 34 prompts │ 12 agents │ 27 skills        │
+│         5 instructions │ 5 collections │ 4 rules            │
+│                                                             │
+│  MỘT COMMAND ĐỂ ĐIỀU PHỐI TẤT CẢ: /ck-cook               │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Slide 12: Thử Ngay
+
+| Muốn... | Gõ |
+|---------|-----|
+| Build feature end-to-end | `/ck-cook "mô tả"` |
+| Lên plan trước khi code | `/ck-plan "mô tả"` |
+| Fix bug | `/ck-fix "mô tả lỗi"` |
+| Fix TypeScript errors | `/ck-fix-types` |
+| Chạy & phân tích tests | `/ck-test` |
+| Review code quality | `/ck-review` |
+| Tìm kiếm trong codebase | `/ck-scout "từ khoá"` |
+| Brainstorm giải pháp | `/ck-brainstorm "vấn đề"` |
+| Hỏi nhanh | `/ck-ask "câu hỏi"` |
+| Commit changes | `/ck-git` |
+
+**Mẹo:** Bắt đầu với `/ck-cook` — nó tự orchestrate mọi thứ phía sau.

package/docs/system-architecture.md

@@ -3,11 +3,11 @@
 ## Overview
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│                        SOURCES                               │
+│                        SOURCE                                │
 ├─────────────────────────────────────────────────────────────┤
-│  ClaudeKit (~/.claude/)      SpecKit (upstream/speckit/)    │
-│  ├── commands/               ├── templates/commands/         │
-│  ├── skills/                 └── (git subtree)               │
+│  Upstream Source                                             │
+│  ├── commands/                                               │
+│  ├── skills/                                                 │
 │  └── (local install)                                         │
 └─────────────────────────────────────────────────────────────┘
                               │
@@ -17,8 +17,7 @@
 ├─────────────────────────────────────────────────────────────┤
 │  eng/sync.mjs                                                │
 │  ├── Load resource-origins.yml (mappings + ignore list)     │
-│  ├── transform-claudekit.mjs → ck-* namespace               │
-│  ├── transform-speckit.mjs → ck-spec-* namespace            │
+│  ├── transform-upstream.mjs → ck-* namespace                │
 │  ├── patch-navigation.mjs → Add "Suggested Next Steps"      │
 │  └── Write to prompts/                                       │
 └─────────────────────────────────────────────────────────────┘
@@ -28,7 +27,7 @@
 │                       OUTPUT                                 │
 ├─────────────────────────────────────────────────────────────┤
 │  prompts/                                                    │
-│  ├── ck-*.prompt.md (27 total commands)                     │
+│  ├── ck-*.prompt.md (17 commands)                           │
 │  └── agents/, skills/, instructions/, collections/         │
 └─────────────────────────────────────────────────────────────┘
                               │
@@ -45,12 +44,11 @@
 
 ### Sync Pipeline
 ```
-1. git subtree pull (SpecKit)
-2. Read ~/.claude/commands/ (ClaudeKit)
-3. Transform: rename, replace $ARGUMENTS, remove model field
-4. Patch: inject navigation footer
-5. Write: prompts/*.prompt.md
-6. Update: resource-origins.yml (timestamps)
+1. Read upstream commands source
+2. Transform: rename, replace $ARGUMENTS, remove model field
+3. Patch: inject navigation footer
+4. Write: prompts/*.prompt.md
+5. Update: resource-origins.yml (timestamps)
 ```
 
 ### CLI Install
@@ -66,8 +64,7 @@
 | Component | File | Purpose |
 |-----------|------|---------|
 | Orchestrator | eng/sync.mjs | Runs full sync pipeline |
-| ClaudeKit Transform | eng/transform-claudekit.mjs | Transform ~/.claude/ commands |
-| SpecKit Transform | eng/transform-speckit.mjs | Transform upstream/speckit/ |
+| Upstream Transform | eng/transform-upstream.mjs | Transform upstream commands |
 | Navigation Patch | eng/patch-navigation.mjs | Add cross-command navigation |
 | Config | eng/resource-origins.yml | Mappings, ignore list, navigation |
 
@@ -75,5 +72,4 @@
 
 | Prefix | Source | Example |
 |--------|--------|---------|
-| `ck-*` | ClaudeKit | ck-plan, ck-fix, ck-test |
-| `ck-spec-*` | SpecKit | ck-spec-specify, ck-spec-plan |
+| `ck-*` | Upstream | ck-plan, ck-fix, ck-test |

package/docs/{claudekit-porting-rules.md → upstream-porting-rules.md}

@@ -1,6 +1,6 @@
-# ClaudeKit → CoKit Porting Rules
+# Upstream → CoKit Porting Rules
 
-**Purpose:** Definitive reference for porting ClaudeKit (Claude Code) content to CoKit (GitHub Copilot).
+**Purpose:** Definitive reference for porting upstream content to CoKit (GitHub Copilot).
 **Audience:** AI agents and developers performing sync/port operations.
 **Last Updated:** 2026-02-25
 
@@ -8,15 +8,15 @@
 
 ## 0. Porting Workflow
 
-**IMPORTANT:** Always follow this order when porting from ClaudeKit.
+**IMPORTANT:** Always follow this order when porting from upstream.
 
 ### Step 1: Inventory CoKit
 Map what CoKit already has — prompts, agents, skills, instructions. This is the source of truth.
 
-### Step 2: Diff against ClaudeKit
-Compare ClaudeKit's commands/agents/skills with CoKit inventory. Identify:
+### Step 2: Diff against upstream
+Compare upstream commands/agents/skills with CoKit inventory. Identify:
 - **Updates** — existing CoKit files that need content sync
-- **New variants** — ClaudeKit has a new sub-command (e.g., `/plan:red-team`) → create as `/ck-plan-red-team` variant
+- **New variants** — upstream has a new sub-command (e.g., `/plan:red-team`) → create as `/ck-plan-red-team` variant
 - **New top-level** — entirely new prompt/agent/skill → create in CoKit
 
 ### Step 3: Verify Copilot compatibility
@@ -40,8 +40,8 @@ Key things to re-check periodically:
 
 ## 1. Syntax Conversions
 
-| ClaudeKit | CoKit | Notes |
-|-----------|-------|-------|
+| Upstream | CoKit | Notes |
+|----------|-------|-------|
 | `$ARGUMENTS` | `${input}` | Copilot prompt variable |
 | `@agent-name` | `` `agent-name` agent `` | No `@` prefix in Copilot |
 | `.claude/` paths | `$HOME/.copilot/` | Global config directory |
@@ -50,7 +50,7 @@ Key things to re-check periodically:
 
 ## 2. Command References
 
-| ClaudeKit | CoKit | Notes |
+| Upstream | CoKit | Notes |
 |-----------|-------|-------|
 | `/fix:types` | `/ck-fix-types` | Colon → hyphen |
 | `/fix:tests` | `/ck-fix-test` | Colon → hyphen |
@@ -59,12 +59,12 @@ Key things to re-check periodically:
 | `/plan --fast` | `/ck-plan-fast` | Flag → separate command |
 | `SlashCommand(/scout)` | `/ck-scout` | Remove `SlashCommand()` wrapper |
 
-**New variant?** If ClaudeKit adds a new sub-command (e.g., `/plan:red-team`), create it as a variant prompt file in CoKit (`ck-plan-red-team.prompt.md`). Variants don't count toward prompt total.
+**New variant?** If upstream adds a new sub-command (e.g., `/plan:red-team`), create it as a variant prompt file in CoKit (`ck-plan-red-team.prompt.md`). Variants don't count toward prompt total.
 
 ## 3. Tool/API Conversions
 
-| ClaudeKit | CoKit | Notes |
-|-----------|-------|-------|
+| Upstream | CoKit | Notes |
+|----------|-------|-------|
 | `AskUserQuestion` | Natural conversation | Just ask the user directly |
 | `Task(subagent_type="X")` | Natural language delegation | Describe what agent should do |
 | `TaskCreate/TaskUpdate/TaskList` | Checklist/todo tracking | No task management API |
@@ -96,8 +96,8 @@ Key things to re-check periodically:
 ### CoKit agents (12)
 `brainstormer`, `code-reviewer`, `code-simplifier`, `debugger`, `docs-manager`, `fullstack-developer`, `git-manager`, `planner`, `researcher`, `scout`, `tester`, `ui-ux-designer`
 
-### ClaudeKit agents that DON'T exist in CoKit
-| ClaudeKit Agent | CoKit Replacement |
+### Upstream agents that DON'T exist in CoKit
+| Upstream Agent | CoKit Replacement |
 |-----------------|-------------------|
 | `project-manager` | Direct action (describe what to do) |
 | `journal-writer` | Remove or convert to manual journaling |
@@ -147,7 +147,6 @@ New variant → update flowchart + Deep Dive in `index.html`, do NOT bump prompt
 - [ ] `docs/cokit-comprehensive-mapping-guide.md`
 - [ ] `docs/cokit-team-presentation.md`
 - [ ] `docs/cokit-sync-and-maintenance-guide.md`
-- [ ] `docs/guide-next-steps-speckit-cokit-implementation.md`
 - [ ] `docs/project-overview-pdr.md`
 
 ### If new commands added
@@ -164,7 +163,7 @@ grep -r "@\w+-\w+" agents/ skills/ prompts/          # @agent-name syntax
 grep -r "project-manager" agents/ skills/ prompts/    # Non-existent agent
 grep -r "subagent" agents/                            # Wrong terminology
 grep -r "\.claude/" agents/ skills/ prompts/          # Wrong path
-grep -r "AskUserQuestion\|SlashCommand" agents/ skills/ prompts/  # Claude Code APIs
+grep -r "AskUserQuestion\|SlashCommand" agents/ skills/ prompts/  # Upstream-only APIs
 grep -r "chrome-devtools" agents/                     # Renamed tool
 grep -r "\$ARGUMENTS" agents/ prompts/                # Wrong variable
 grep -r "^name:\|^model:\|^memory:" agents/ prompts/  # Invalid frontmatter

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cokit-cli",
-  "version": "1.2.7",
+  "version": "1.3.0",
   "description": "Make GitHub Copilot smarter in 30 seconds",
   "main": "src/index.js",
   "bin": {
@@ -30,8 +30,7 @@
     "test": "node --test",
     "lint": "echo 'No linter configured'",
     "build": "echo 'Build complete'",
-    "sync": "npm run sync:pull && npm run sync:transform",
-    "sync:pull": "git subtree pull --prefix=upstream/speckit speckit main --squash",
+    "sync": "node eng/sync.mjs",
     "sync:transform": "node eng/sync.mjs",
     "sync:dry-run": "node eng/sync.mjs --dry-run",
     "convert:agents": "node eng/convert-agents.mjs",
@@ -39,7 +38,7 @@
     "convert:skills": "node eng/convert-skills.mjs",
     "convert:all": "npm run convert:agents && npm run convert:commands && npm run convert:skills && npm run rewrite && npm run clean",
     "rewrite": "node eng/rewrite-single-agent.mjs",
-    "clean": "node eng/clean-claude-references.mjs"
+    "clean": "node eng/clean-references.mjs"
   },
   "keywords": [
     "copilot",

package/prompts/ck-ask.prompt.md

@@ -64,4 +64,3 @@ This command focuses on architectural consultation and strategic guidance. Do no
 |---------|-------------|
 | `/ck-brainstorm` | Explore ideas |
 | `/ck-plan` | Create plan |
-| `/ck-spec-specify` | Write detailed feature spec |

package/prompts/ck-bootstrap.prompt.md

@@ -48,8 +48,6 @@ Follow strictly these following steps:
 * Ask 1 question at a time, wait for the user to answer before moving to the next question.
 * If you don't have any questions, start the next step.
 
-**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
-
 ### Research
 
 * Use multiple `researcher` agents in parallel to explore the user's request, idea validation, challenges, and find the best possible solutions.
@@ -138,4 +136,3 @@ Follow strictly these following steps:
 |---------|-------------|
 | `/ck-brainstorm` | Explore ideas |
 | `/ck-plan` | Create plan |
-| `/ck-spec-specify` | Write detailed feature spec |

package/prompts/ck-brainstorm.prompt.md

@@ -84,4 +84,3 @@ When brainstorming concludes with agreement, create a detailed markdown summary
 |---------|-------------|
 | `/ck-plan` | Create implementation plan |
 | `/ck-ask` | Answer technical questions |
-| `/ck-spec-specify` | Write detailed feature spec |

package/prompts/ck-cook.prompt.md

@@ -93,4 +93,3 @@ Human review required at these checkpoints (skipped with `--auto`):
 | `/ck-test` | Run tests |
 | `/ck-review` | Code review |
 | `/ck-git` | Commit changes |
-| `/ck-spec-implement` | Spec-driven implementation instead |

package/prompts/ck-debug.prompt.md

@@ -112,4 +112,3 @@ Stop and follow process if thinking:
 | `/ck-test` | Run tests to verify |
 | `/ck-fix` | Apply fix |
 | `/ck-git` | Commit fix |
-| `/ck-spec-analyze` | Analyze spec consistency |

package/prompts/ck-deploy.prompt.md

@@ -0,0 +1,22 @@
+---
+agent: 'agent'
+description: 'Deploy to any platform with auto-detection'
+argument-hint: '[platform] [environment]'
+---
+
+## Context
+Deploy target:
+<target>${input}</target>
+
+Auto-detects deployment target from config files. Supports Vercel, Netlify, Cloudflare, Railway, Fly.io, Render, Docker, AWS, GCP, and more.
+
+**IMPORTANT**: Verify deployment target before executing.
+
+---
+
+## Suggested Next Steps
+
+| Command | Description |
+|---------|-------------|
+| `/ck-test` | Run tests before deploy |
+| `/ck-fix` | Fix deployment issues |

package/prompts/ck-docs.prompt.md

@@ -99,4 +99,3 @@ Search and retrieve up-to-date documentation for libraries, frameworks, and pack
 | `/ck-ask` | Ask technical questions |
 | `/ck-plan` | Create implementation plan |
 | `/ck-cook` | Implement feature |
-| `/ck-spec-specify` | Write detailed feature spec |