cokit-cli 1.0.8 → 1.2.0

package/docs/cokit-team-presentation.md

@@ -1,8 +1,9 @@
 # CoKit: Team Presentation
 
-**Date:** January 6, 2026
+**Date:** February 10, 2026 (v1.2.0)
 **Presenter:** [Your Name]
 **Repository:** https://github.com/camping89/cokit
+**Version:** 1.2.0
 
 ---
 
@@ -17,8 +18,12 @@
 - Project-specific context
 
 **Solution:** CoKit ports proven Claude Code workflow patterns to GitHub Copilot via:
-- 6 pre-built prompts (`/fix`, `/plan`, `/code`, `/test`, `/review`, `/docs`) using `mode: agent`
-- 5 skills teaching Copilot best practices (debugging, code-review, planning, docs-seeker, sequential-thinking)
+- 28 prompts with unified `ck.*` namespace (ClaudeKit + SpecKit) using `mode: agent`
+- 27 skills teaching Copilot best practices (debugging, code-review, planning, frontend-design, databases, devops, etc.)
+- 12 specialized agents (including code-simplifier, fullstack-developer, ui-ux-designer)
+- 5 instructions (backend, frontend, testing, development, research)
+- 5 collections bundling related resources
+- Sync pipeline for upstream integration
 - Project templates for team consistency
 
 ---
@@ -36,7 +41,7 @@
 │   ┌─────────┐                  ┌─────────────┐                │
 │   │ cokit/  │  npm publish     │             │                │
 │   │ repo    │ ───────────────► │  npmjs.com  │                │
-│   └─────────┘                  │  /cokit     │                │
+│   └─────────┘                  │  /cokit-cli │                │
 │                                └─────────────┘                │
 │                                                                │
 └────────────────────────────────────────────────────────────────┘
@@ -49,7 +54,7 @@
 │                                                                │
 │   Step 1: User runs command                                    │
 │   ┌─────────────────────────────────────────────────────────┐ │
-│   │ $ npx cokit init                                        │ │
+│   │ $ npx cokit-cli init                                    │ │
 │   └─────────────────────────────────────────────────────────┘ │
 │                              │                                 │
 │                              ▼                                 │
@@ -70,23 +75,20 @@
 │   └─────────────────────────────────────────────────────────┘ │
 │                              │                                 │
 │                              ▼                                 │
-│   Step 4: Files created in user's project (Phase 4)            │
+│   Step 4: Files created in user's project                      │
 │   ┌─────────────────────────────────────────────────────────┐ │
 │   │ ✓ .github/copilot-instructions.md                       │ │
 │   │ ✓ .github/AGENTS.md                                     │ │
-│   │ ✓ .github/prompts/fix.prompt.md                         │ │
-│   │ ✓ .github/prompts/plan.prompt.md                        │ │
-│   │ ✓ .github/prompts/code.prompt.md                        │ │
-│   │ ✓ .github/prompts/test.prompt.md                        │ │
-│   │ ✓ .github/prompts/review.prompt.md                      │ │
-│   │ ✓ .github/prompts/docs.prompt.md                        │ │
+│   │ ✓ .github/prompts/ck-*.prompt.md (28 prompts)           │ │
+│   │ ✓ .github/instructions/ck-*.instructions.md (5 files)   │ │
+│   │ ✓ .github/collections/ck-*.collection.yml (5 bundles)   │ │
 │   │ ✓ .vscode/settings.json                                 │ │
 │   │                                                         │ │
-│   │ 🎉 Done! Try /fix in Copilot Chat.                      │ │
+│   │ 🎉 Done! Try /ck.fix in Copilot Chat.                   │ │
 │   └─────────────────────────────────────────────────────────┘ │
 │                              │                                 │
 │                              ▼                                 │
-│   Step 5: User opens VS Code, types /fix                       │
+│   Step 5: User opens VS Code, types /ck.fix or /ck.plan       │
 │   ┌─────────────────────────────────────────────────────────┐ │
 │   │ Copilot Chat: "I'll help you debug systematically..."   │ │
 │   └─────────────────────────────────────────────────────────┘ │
@@ -155,44 +157,45 @@ your-project/
 
 | Command | Description |
 |---------|-------------|
-| `npx cokit init` | Interactive setup wizard |
-| `npx cokit init --global` | Install personal skills only |
-| `npx cokit init --all` | Both project + personal |
-| `npx cokit add <skill>` | Add specific skill |
-| `npx cokit list` | Show installed components |
-| `npx cokit doctor` | Diagnose setup issues |
-| `npx cokit update` | Update to latest version |
+| `npx cokit-cli init` | Interactive setup wizard |
+| `npx cokit-cli init -g` | Install personal skills only |
+| `npx cokit-cli init -a` | Both project + personal |
+| `npx cokit-cli add <skill>` | Add specific skill |
+| `npx cokit-cli list` | Show installed components |
+| `npx cokit-cli doctor` | Diagnose setup issues |
+| `npx cokit-cli update` | Update to latest version |
 
 ---
 
-## 5. Prompts Included
+## 5. Prompts Included (28 total)
 
-| Prompt | What it does | Example usage |
-|--------|--------------|---------------|
-| `/fix` | Debug and fix issues | "The login is broken" |
-| `/plan` | Create implementation plan | "Add user authentication" |
-| `/code` | Implement from plan | "Implement step 1 from plan.md" |
-| `/test` | Write/run tests | "Test the auth module" |
-| `/review` | Code review | "Review my changes" |
-| `/docs` | Update documentation | "Document the API" |
+**ClaudeKit (ck.*):** Development workflow commands
+- `/ck.fix`, `/ck.plan`, `/ck.cook`, `/ck.test`, `/ck.review`, `/ck.debug`, `/ck.ask`, etc.
+
+**SpecKit (ck.spec.*):** Spec-driven workflow commands
+- `/ck.spec.specify`, `/ck.spec.clarify`, `/ck.spec.plan`, `/ck.spec.tasks`, `/ck.spec.implement`, etc.
+
+All 28 prompts unified in single namespace with cross-navigation support.
 
 ---
 
-## 6. User-Level Skills (Phase 3)
+## 6. Specialized Skills & Agents
+
+**27 skills** available at `~/.copilot/skills/*/` with supporting resources:
+
+Core: debugging, code-review, planning, problem-solving, sequential-thinking, backend-development, frontend-design, databases, devops, git, mcp-management, context-engineering, research, and more.
+
+## 7. Specialized Agents (12 total)
+
+Original 9: planner, code-reviewer, debugger, tester, researcher, scout, git-manager, brainstormer, docs-manager
 
-All 5 skills available at `~/.copilot/skills/` following Copilot Agent Skills format:
+New 3: code-simplifier, fullstack-developer, ui-ux-designer
 
-| Skill | What Copilot learns | Format |
-|-------|---------------------|--------|
-| **debugging** | Systematic root cause analysis, not random fixes | SKILL.md + 3 references |
-| **code-review** | Verification gates, technical rigor, feedback protocols | SKILL.md + 2 references |
-| **planning** | Research → design → implementation planning workflow | SKILL.md + 3 references |
-| **docs-seeker** | Documentation discovery, source validation, search patterns | SKILL.md + 2 references |
-| **sequential-thinking** | Structured multi-step problem solving with revision | SKILL.md + 2 references |
+Each agent provides specialized expertise for different development tasks.
 
 ---
 
-## 7. Technical Architecture
+## 8. Technical Architecture
 
 ```
 cokit/
@@ -211,14 +214,28 @@ cokit/
 │       ├── copy.js               # File operations
 │       ├── prompt.js             # Interactive prompts
 │       └── paths.js              # Cross-platform paths
+├── agents/                       # 9 specialized agents
+│   ├── planner.agent.md
+│   ├── code-reviewer.agent.md
+│   ├── tester.agent.md
+│   └── ...
+├── prompts/                      # 14 prompt templates
+│   ├── ck-fix.prompt.md
+│   ├── ck-plan.prompt.md
+│   └── ...
+├── instructions/                 # 5 coding standards
+│   ├── ck-backend.instructions.md
+│   ├── ck-frontend.instructions.md
+│   └── ...
+├── skills/                       # 7 capability packages
+│   ├── ck-debugging/
+│   ├── ck-code-review/
+│   └── ...
+├── collections/                  # 5 resource bundles
+│   ├── ck-core.collection.yml
+│   └── ...
 ├── templates/
 │   └── repo/                     # Project templates
-├── skills/                       # User-level skills (Phase 3)
-│   ├── debugging/                # + references/
-│   ├── code-review/              # + references/
-│   ├── planning/                 # + references/
-│   ├── docs-seeker/              # + references/
-│   └── sequential-thinking/      # + references/
 ├── README.md
 └── LICENSE                       # CC BY-NC 4.0
 ```
@@ -237,20 +254,21 @@ cokit/
 
 ---
 
-## 8. Implementation Plan
+## 9. Implementation Plan
 
 | Phase | Description | Effort | Status |
 |-------|-------------|--------|--------|
 | 1 | CLI tool (npm package) | 4h | ✅ Complete |
 | 2 | Repo templates (.github/) | 3h | ✅ Complete |
-| 3 | User skills (5 core + references) | 4h | ✅ Complete |
-| 4 | Prompt files (6 prompts) | 2h | ✅ Complete |
+| 3 | User skills (7 + agents, instructions, collections) | 6h | ✅ Complete |
+| 4 | Prompt files (14 prompts) | 3h | ✅ Complete |
 | 5 | Documentation + README | 3h | ✅ Complete |
-| **Total** | | **16h** | ✅ All Phases Complete |
+| 6 | Cleanup phase (remove non-coding resources) | 2h | ✅ Complete |
+| **Total** | | **21h** | ✅ All Phases Complete |
 
 ---
 
-## 9. Release Process
+## 10. Release Process
 
 ```bash
 # Development
@@ -259,21 +277,21 @@ cd cokit
 npm install
 
 # Testing locally
-npm link                    # Makes 'cokit' available locally
-cokit init                  # Test the CLI
+npm link                    # Makes 'cokit-cli' available locally
+cokit-cli init              # Test the CLI
 
 # Publishing
 npm login                   # One-time login
-npm version patch           # Bump version (1.0.0 → 1.0.1)
+npm version patch           # Bump version (1.0.8 → 1.0.9)
 npm publish                 # Push to npm registry
 
 # Users get it via
-npx cokit init              # Always fetches latest
+npx cokit-cli init          # Always fetches latest
 ```
 
 ---
 
-## 10. What's NOT Included (Limitations)
+## 11. What's NOT Included (Limitations)
 
 | Claude Code Feature | Status | Reason |
 |---------------------|--------|--------|
@@ -282,22 +300,23 @@ npx cokit init              # Always fetches latest
 | $ARGUMENTS variables | ❌ Skip | User provides context in chat |
 | Session state | ❌ Skip | Copilot is stateless |
 
-**Workaround:** Users manually chain prompts (`/plan` → `/code` → `/test` → `/review`)
+**Workaround:** Users manually chain prompts (`/ck.plan` → `/ck.code` → `/ck.test` → `/ck.review-codebase`)
 
 ---
 
-## 11. Success Metrics
+## 12. Success Metrics
 
-- [x] `npx cokit init` works without errors
+- [x] `npx cokit-cli init` works without errors
 - [x] Non-technical user can setup in < 2 minutes
-- [x] All 6 prompts functional in Copilot Chat
-- [x] Skills auto-activate based on context
+- [x] All 14 prompts functional in Copilot Chat
+- [x] All 7 skills auto-activate based on context
+- [x] All 9 agents available for delegation
 - [x] README understandable by beginners
-- [x] `cokit doctor` catches common issues
+- [x] `cokit-cli doctor` catches common issues
 
 ---
 
-## 12. License
+## 13. License
 
 **CC BY-NC 4.0** (Creative Commons Attribution-NonCommercial)
 
@@ -313,7 +332,25 @@ npx cokit init              # Always fetches latest
 
 ---
 
+## 14. Recent Updates
+
+**v1.0.9 (2026-01-20) - Documentation Update:**
+- Comprehensive documentation update (all 7 docs)
+- Fixed all broken links and references
+- Verified resource counts across all docs
+- Created changelogs folder structure
+
+**v1.0.8 (2026-01-20) - Cleanup Phase:**
+- Removed non-coding resources
+- Consolidated documentation
+- Updated all resource references
+- Enhanced agent capabilities
+- Added missing prompt and skill documentation
+
+---
+
 ## Questions?
 
 **Repository:** https://github.com/camping89/cokit
-**Plan details:** `plans/260106-1102-cokit-implementation/`
+**Documentation:** `docs/`
+**Installation:** `npx cokit-cli init`

package/docs/copilot-processing-flow.md

@@ -1,113 +1,184 @@
 # Copilot Processing Flow
 
-How Copilot processes user input through resources to produce output.
+How Copilot processes user input through CoKit resources to produce output.
 
-> **Flow diagrams:** See [README.FLOW.md](README.FLOW.md) for visual diagrams.
+> **CoKit Resources:** See [README.md](../README.md) for complete resource listing.
 
 ---
 
-## Resource Types Overview
+## CoKit Resource Types Overview
 
 | Resource | Trigger | Purpose | File |
 |----------|---------|---------|------|
-| **Prompt** | User calls `/prompt-name` | Workflow/task template | `*.prompt.md` |
-| **Agent** | Referenced by prompt | Execute specific tasks | `*.agent.md` |
-| **Instruction** | Auto (by file pattern) | Coding rules/standards | `*.instructions.md` |
-| **Skill** | User/Agent activates | Specialized knowledge | `skills/*/SKILL.md` |
-| **Collection** | User selects | Bundle related resources | `*.collection.yml` |
+| **Prompt** | User calls `/ck-prompt-name` | Workflow/task template | `prompts/ck-*.prompt.md` |
+| **Agent** | Referenced by prompt | Execute specific tasks | `agents/*.agent.md` |
+| **Instruction** | Auto (by file pattern) | Coding rules/standards | `instructions/ck-*.instructions.md` |
+| **Skill** | Auto by context | Specialized knowledge | `skills/ck-*/SKILL.md` |
+| **Collection** | User selects | Bundle related resources | `collections/ck-*.collection.yml` |
+
+### CoKit Examples
+
+**Prompts (28 total):** ClaudeKit (ck.*) and SpecKit (ck.spec.*) namespaces with 28 unified commands
+
+**Agents (12 total):** planner, code-reviewer, debugger, tester, researcher, scout, git-manager, brainstormer, docs-manager, code-simplifier, fullstack-developer, ui-ux-designer
+
+**Skills (27 total):** debugging, code-review, planning, problem-solving, sequential-thinking, backend-development, frontend-design, databases, devops, git, mcp-management, and more
+
+**Instructions:** ck-backend, ck-frontend, ck-testing, ck-development, ck-research
+
+**Collections:** ck-core, ck-development-rules, ck-documentation, ck-git-workflow, ck-orchestration
 
 ---
 
 ## Component Details
 
-### 1. Prompt (`*.prompt.md`)
+### 1. Prompt (`prompts/ck-*.prompt.md`)
 
 **Role:** Entry point - Defines workflow/task
 
+**Example: ck-fix.prompt.md**
 ```yaml
 ---
-mode: agent                    # Mode: agent, ask, edit
-description: 'Task description'
-tools: ['search/codebase']     # Allowed tools
+mode: agent
+description: 'Debug and fix issues systematically'
 ---
 
-# Prompt content
-Your task is: ${input}
-Follow these steps...
+# Fix Issues
+
+You are debugging an issue. Follow systematic troubleshooting...
+
+1. Read the error message
+2. Search for root cause
+3. Implement fix
+4. Test the solution
 ```
 
-**When to use:** User wants to execute a specific task
+**CoKit Examples:**
+- `/ck.fix` - Debug and fix
+- `/ck.plan` - Create implementation plan
+- `/ck.cook` - Step-by-step feature implementation
+- `/ck.review-codebase` - Scan and analyze code
+
+**When to use:** User wants to execute a specific workflow
 
 ---
 
-### 2. Agent (`*.agent.md`)
+### 2. Agent (`agents/*.agent.md`)
 
-**Role:** Executor - Executes tasks per prompt
+**Role:** Executor - Specialized persona for specific tasks
 
+**Example: planner.agent.md**
 ```yaml
 ---
-description: 'Agent specialization'
-model: GPT-4.1
-tools: ['codebase', 'terminal']
+description: 'Research, analyze, and create implementation plans'
 ---
 
-# Agent persona & capabilities
-You are a code reviewer...
+# Planner Agent
+
+You are a research-first planner...
+- Conduct comprehensive research
+- Design system architecture
+- Create detailed implementation plans
 ```
 
-**When to use:** Referenced by prompt, not called directly
+**CoKit Agents (12 total):**
+- `planner` - Creates implementation plans
+- `code-reviewer` - Provides comprehensive code review
+- `debugger` - Investigates and diagnoses issues
+- `tester` - Writes and validates tests
+- `researcher` - Finds and synthesizes documentation
+- `scout` - Locates files in codebase
+- `git-manager` - Handles commits and workflows
+- `brainstormer` - Ideates solutions
+- `docs-manager` - Creates and updates documentation
+- `code-simplifier` - Refactors and simplifies code
+- `fullstack-developer` - Full-stack implementation
+- `ui-ux-designer` - UI/UX design and implementation
+
+**When to use:** Referenced by prompts to specialize execution
 
 ---
 
-### 3. Instruction (`*.instructions.md`)
+### 3. Instruction (`instructions/ck-*.instructions.md`)
 
 **Role:** Rules - Auto-applied coding standards
 
+**Example: ck-frontend.instructions.md**
 ```yaml
 ---
-applyTo: '**/*.tsx'            # Glob pattern
-description: 'React rules'
+applyTo: '**/*.tsx, **/*.jsx, components/**'
+description: 'Frontend component guidelines'
 ---
 
-# Rules for React files
+# Frontend Guidelines
+
+When editing React files:
 - Use functional components
 - Props interface required
+- Use hooks instead of class methods
 ```
 
-**When to use:** Auto-applied when editing files matching pattern
+**CoKit Instructions:**
+- `ck-backend` - Backend patterns (Node.js, Python, Go, Rust)
+- `ck-frontend` - Frontend patterns (React, TypeScript)
+- `ck-testing` - Testing standards and patterns
+- `ck-development` - YAGNI/KISS/DRY principles
+- `ck-research` - Research methodology guidelines
+
+**When to use:** Auto-applied based on file patterns while editing
 
 ---
 
-### 4. Skill (`skills/*/SKILL.md`)
+### 4. Skill (`skills/ck-*/SKILL.md`)
 
-**Role:** Knowledge - Deep specialized expertise
+**Role:** Knowledge - Deep specialized expertise with supporting resources
 
+**Example: ck-debugging/SKILL.md**
 ```
-skills/
-└── frontend-design/
-    ├── SKILL.md              # Main instructions
-    ├── templates/            # Code templates
-    └── examples/             # Reference examples
+skills/ck.debugging/
+├── SKILL.md                  # Main methodology
+├── references/               # Case studies, patterns
+└── examples/                 # Real debugging examples
 ```
 
-**When to use:** Activated when specific expertise needed
+**CoKit Skills:**
+- `ck-debugging` - Systematic root cause analysis
+- `ck-code-review` - Comprehensive review gates
+- `ck-planning` - Research → design → implementation
+- `ck-problem-solving` - Complexity spirals, innovation blocks
+- `ck-sequential-thinking` - Multi-step problem solving
+- `ck-backend-development` - Backend framework patterns
+- `ck-frontend-development` - Frontend framework patterns
+
+**When to use:** Activated automatically based on task context
 
 ---
 
-### 5. Collection (`*.collection.yml`)
+### 5. Collection (`collections/ck-*.collection.yml`)
 
-**Role:** Bundle - Groups related resources
+**Role:** Bundle - Groups related resources by workflow
 
+**Example: ck-core.collection.yml**
 ```yaml
-id: web-development
-name: Web Development Kit
+id: ck-core
+name: CoKit Core Workflows
+description: Essential agents, prompts, and skills
 items:
-  - path: agents/frontend.agent.md
-  - path: prompts/ck-design.prompt.md
-  - path: skills/react/
+  - path: agents/planner.agent.md
+  - path: agents/code-reviewer.agent.md
+  - path: prompts/ck.plan.prompt.md
+  - path: prompts/ck.code.prompt.md
+  - path: skills/ck.planning/
 ```
 
-**When to use:** Install/share resource bundles by topic
+**CoKit Collections:**
+- `ck-core` - Core workflows for full-stack development
+- `ck-development-rules` - YAGNI/KISS/DRY principles
+- `ck-documentation` - Documentation management workflows
+- `ck-git-workflow` - Git commit, push, merge workflows
+- `ck-orchestration` - Task delegation and workflow orchestration
+
+**When to use:** Install/share resource bundles for specific workflows
 
 ---
 
@@ -123,6 +194,22 @@ items:
 
 ---
 
+## CoKit Processing Example
+
+```
+User types: /ck.fix
+    ↓
+Prompt (ck-fix.prompt.md) activates
+    ↓
+Agent (debugger.agent.md) executes
+    ↓
+Instructions (ck-*.instructions.md) auto-apply by file pattern
+    ↓
+Skills (ck-debugging, etc.) activate by context
+    ↓
+Output: Systematic debugging solution
+```
+
 ## One-liner
 
-> User calls **Prompt** → Prompt uses **Agent** → Agent auto-receives **Instructions** by file pattern → Agent activates **Skills** when needed → All can be bundled in **Collection**.
+> User calls **Prompt** (e.g., `/ck.fix`) → Prompt references **Agent** (e.g., `debugger`) → Agent auto-receives **Instructions** by file pattern → Agent activates **Skills** when needed → All can be bundled in **Collection** (e.g., `ck-core`).