cokit-cli 1.2.7 → 1.4.0

package/docs/cokit-slides.md

@@ -1,210 +0,0 @@
-# CoKit - Slide Deck
-
----
-
-## Slide 1: Title
-
-# CoKit
-
-**Make GitHub Copilot Smarter in 30 Seconds**
-
-`npx cokit init`
-
----
-
-## Slide 2: The Problem
-
-### Copilot Without CoKit
-
-- ❌ Inconsistent debugging (random fixes)
-- ❌ No code review standards
-- ❌ No planning framework
-- ❌ Each dev gets different AI behavior
-
----
-
-## Slide 3: The Solution
-
-### Copilot With CoKit
-
-- ✅ Structured debugging methodology
-- ✅ Consistent code review process
-- ✅ Planning before coding
-- ✅ Team-wide AI behavior via git
-
----
-
-## Slide 4: One Command
-
-```bash
-npx cokit-cli init
-```
-
-That's it. No install. No config. No account.
-
----
-
-## Slide 5: How It Works
-
-```
-Developer publishes    →    npm Registry    →    User runs npx
-         ↓                                            ↓
-npm publish                               Downloads cokit-cli
-                                                    ↓
-                                          Creates files in project
-                                          (.github/, skills)
-                                                    ↓
-                                          Ready to use in VS Code
-```
-
----
-
-## Slide 6: What Users Get
-
-### 25 Prompts (ClaudeKit + SpecKit)
-
-**Development workflows (ck-*):**
-- `/ck-fix`, `/ck-plan`, `/ck-cook`, `/ck-test`, `/ck-review`, `/ck-bootstrap`, `/ck-brainstorm`, etc.
-
-**Spec-driven workflows (ck-spec-*):**
-- `/ck-spec-specify`, `/ck-spec-clarify`, `/ck-spec-plan`, `/ck-spec-tasks`, `/ck-spec-implement`, etc.
-
-All unified in single namespace with cross-navigation.
-
----
-
-## Slide 7: What Users Get (cont.)
-
-### 27 Skills + 12 Agents (Auto-Activate)
-
-**Skills (27 total):**
-- debugging, code-review, planning, problem-solving, sequential-thinking
-- backend-development, frontend-design, databases, devops, git, mcp-management
-- research, scout, and more specialized expertise
-
-**Agents (12 total):**
-- Original 9: planner, code-reviewer, debugger, tester, researcher, scout, git-manager, brainstormer, docs-manager
-- New 3: code-simplifier, fullstack-developer, ui-ux-designer
-
----
-
-## Slide 8: Two Installation Options
-
-| Option | Command | Location |
-|--------|---------|----------|
-| **Interactive** | `npx cokit-cli init` | Choose: project, global, or both |
-
----
-
-## Slide 9: CLI Commands
-
-```bash
-npx cokit-cli init      # Setup wizard
-npx cokit-cli doctor    # Troubleshoot
-npx cokit-cli list      # Show installed
-npx cokit-cli update    # Get latest
-```
-
----
-
-## Slide 10: User Experience
-
-```
-$ npx cokit-cli init
-
-🚀 CoKit Setup (v1.0.9)
-
-? What do you want to set up?
-  › Project templates (.github/)
-    Personal skills (~/.copilot/)
-    Both
-
-✓ Created .github/copilot-instructions.md
-✓ Created .github/AGENTS.md
-✓ Created .github/prompts/ (14 prompts)
-✓ Created .github/instructions/ (5 files)
-✓ Created .github/collections/ (5 bundles)
-
-🎉 Done! Try /ck-fix in Copilot Chat.
-```
-
----
-
-## Slide 11: Implementation Plan
-
-| Phase | What | Time |
-|-------|------|------|
-| 1 | CLI tool | 4h |
-| 2 | Project templates | 3h |
-| 3 | Skills (7), Agents (9), Instructions (5), Collections (5) | 6h |
-| 4 | Prompts (14) | 3h |
-| 5 | Documentation | 3h |
-| 6 | Cleanup phase | 2h |
-| **Total** | | **21h** |
-
----
-
-## Slide 12: Tech Stack
-
-```
-Node.js CLI
-├── commander    (CLI framework)
-├── prompts      (Interactive input)
-└── chalk        (Colors)
-```
-
-**Zero runtime dependencies for users**
-
----
-
-## Slide 13: Release Process
-
-```bash
-# We do once:
-npm publish (publishes cokit-cli to npmjs.com)
-
-# Users do:
-npx cokit-cli init    # Always gets latest version
-```
-
----
-
-## Slide 14: What's NOT Included
-
-| Feature | Status |
-|---------|--------|
-| Runtime hooks | ❌ No equivalent |
-| Multi-agent | ❌ Single agent only |
-| Session state | ❌ Stateless |
-
-**Workaround:** Manual prompt chaining
-
----
-
-## Slide 15: License
-
-### CC BY-NC 4.0
-
-✅ Personal / Educational / Non-profit
-
-❌ Commercial / Corporate
-
----
-
-## Slide 16: Summary
-
-1. **Problem:** Copilot is inconsistent
-2. **Solution:** CoKit adds structure (v1.0.9)
-3. **Install:** `npx cokit-cli init`
-4. **Resources:** 9 agents, 14 prompts, 7 skills, 5 instructions, 5 collections
-5. **Repo:** github.com/camping89/cokit
-
----
-
-## Slide 17: Questions?
-
-**Repository:** https://github.com/camping89/cokit
-
-**Full docs:** `docs/cokit-team-presentation.md`
-
-**Quick start:** `npx cokit-cli init`

package/docs/cokit-team-presentation.md

@@ -1,354 +0,0 @@
-# CoKit: Team Presentation
-
-**Date:** February 25, 2026 (v1.2.6)
-**Presenter:** [Your Name]
-**Repository:** https://github.com/camping89/cokit
-**Version:** 1.2.6
-
----
-
-## 1. What is CoKit?
-
-**One-liner:** Make GitHub Copilot smarter with one command.
-
-**Problem:** Developers using GitHub Copilot get inconsistent results because Copilot lacks:
-- Structured debugging approaches
-- Code review standards
-- Planning frameworks
-- Project-specific context
-
-**Solution:** CoKit ports proven Claude Code workflow patterns to GitHub Copilot via:
-- 25 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
-
----
-
-## 2. How Users Install It
-
-### The Complete Flow
-
-```
-┌────────────────────────────────────────────────────────────────┐
-│                     PUBLISHING (We do once)                    │
-├────────────────────────────────────────────────────────────────┤
-│                                                                │
-│   Developer                     npm Registry                   │
-│   ┌─────────┐                  ┌─────────────┐                │
-│   │ cokit/  │  npm publish     │             │                │
-│   │ repo    │ ───────────────► │  npmjs.com  │                │
-│   └─────────┘                  │  /cokit-cli │                │
-│                                └─────────────┘                │
-│                                                                │
-└────────────────────────────────────────────────────────────────┘
-                              │
-                              │ Package now available globally
-                              ▼
-┌────────────────────────────────────────────────────────────────┐
-│                     USER EXPERIENCE                            │
-├────────────────────────────────────────────────────────────────┤
-│                                                                │
-│   Step 1: User runs command                                    │
-│   ┌─────────────────────────────────────────────────────────┐ │
-│   │ $ npx cokit-cli init                                    │ │
-│   └─────────────────────────────────────────────────────────┘ │
-│                              │                                 │
-│                              ▼                                 │
-│   Step 2: npx downloads from npm (automatic, temporary)        │
-│   ┌─────────────────────────────────────────────────────────┐ │
-│   │ npm Registry ──► temp folder ──► executes ──► cleanup   │ │
-│   └─────────────────────────────────────────────────────────┘ │
-│                              │                                 │
-│                              ▼                                 │
-│   Step 3: Interactive CLI guides user                          │
-│   ┌─────────────────────────────────────────────────────────┐ │
-│   │ 🚀 CoKit Setup                                          │ │
-│   │                                                         │ │
-│   │ ? What do you want to set up?                           │ │
-│   │   › Project templates (.github/)                        │ │
-│   │     Personal skills (~/.copilot/)                       │ │
-│   │     Both                                                │ │
-│   └─────────────────────────────────────────────────────────┘ │
-│                              │                                 │
-│                              ▼                                 │
-│   Step 4: Files created in user's project                      │
-│   ┌─────────────────────────────────────────────────────────┐ │
-│   │ ✓ .github/copilot-instructions.md                       │ │
-│   │ ✓ .github/AGENTS.md                                     │ │
-│   │ ✓ .github/prompts/ck-*.prompt.md (25 prompts)           │ │
-│   │ ✓ .github/instructions/ck-*.instructions.md (5 files)   │ │
-│   │ ✓ .github/collections/ck-*.collection.yml (5 bundles)   │ │
-│   │ ✓ .vscode/settings.json                                 │ │
-│   │                                                         │ │
-│   │ 🎉 Done! Try /ck-fix in Copilot Chat.                   │ │
-│   └─────────────────────────────────────────────────────────┘ │
-│                              │                                 │
-│                              ▼                                 │
-│   Step 5: User opens VS Code, types /ck-fix or /ck-plan       │
-│   ┌─────────────────────────────────────────────────────────┐ │
-│   │ Copilot Chat: "I'll help you debug systematically..."   │ │
-│   └─────────────────────────────────────────────────────────┘ │
-│                                                                │
-└────────────────────────────────────────────────────────────────┘
-```
-
-### Why npx (not npm install)?
-
-| Aspect | npm install -g | npx (our choice) |
-|--------|----------------|------------------|
-| Steps | 2 commands | 1 command |
-| Global clutter | Yes | No |
-| Always latest | Manual update | Automatic |
-| User complexity | Higher | Lower |
-
----
-
-## 3. What Gets Installed
-
-### Option A: Project Templates (`.github/`)
-
-```
-your-project/
-├── .github/
-│   ├── copilot-instructions.md    # Project-wide AI instructions
-│   ├── AGENTS.md                   # Agent behavior guidelines
-│   ├── instructions/
-│   │   ├── frontend.instructions.md
-│   │   ├── backend.instructions.md
-│   │   └── testing.instructions.md
-│   ├── prompts/
-│   │   ├── fix.prompt.md           # /fix command
-│   │   ├── plan.prompt.md          # /plan command
-│   │   ├── code.prompt.md          # /code command
-│   │   ├── test.prompt.md          # /test command
-│   │   ├── review.prompt.md        # /review command
-│   │   └── docs.prompt.md          # /docs command
-│   └── skills/
-│       └── (project-specific skills)
-└── .vscode/
-    └── settings.json               # Copilot settings
-```
-
-**Use case:** Team projects - everyone gets same AI behavior via git.
-
-### Option B: Personal Skills (`~/.copilot/`)
-
-```
-~/.copilot/
-└── skills/
-    ├── debugging/                  # Systematic debugging framework
-    ├── code-review/                # Code review & verification protocols
-    ├── planning/                   # Implementation planning & design
-    ├── docs-seeker/                # Documentation discovery & research
-    └── sequential-thinking/        # Structured problem decomposition
-```
-
-**Use case:** Personal productivity - works across all projects.
-
-**Availability:** All 5 skills follow Copilot Agent Skills format with SKILL.md + references/
-
----
-
-## 4. CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `npx cokit-cli init` | Interactive setup wizard |
-| `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 (27 total)
-
-**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 25 prompts unified in single namespace with cross-navigation support.
-
----
-
-## 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
-
-New 3: code-simplifier, fullstack-developer, ui-ux-designer
-
-Each agent provides specialized expertise for different development tasks.
-
----
-
-## 8. Technical Architecture
-
-```
-cokit/
-├── package.json                  # npm package config
-├── bin/
-│   └── cokit.js                  # CLI entry point
-├── src/
-│   ├── index.js                  # Command router
-│   ├── commands/
-│   │   ├── init.js               # Setup wizard
-│   │   ├── add.js                # Add skills
-│   │   ├── list.js               # Show installed
-│   │   ├── doctor.js             # Troubleshoot
-│   │   └── update.js             # Update version
-│   └── utils/
-│       ├── 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
-├── README.md
-└── LICENSE                       # CC BY-NC 4.0
-```
-
-### Dependencies (minimal)
-
-```json
-{
-  "dependencies": {
-    "commander": "^12.0.0",    // CLI framework
-    "prompts": "^2.4.2",       // Interactive prompts
-    "chalk": "^5.3.0"          // Colorized output
-  }
-}
-```
-
----
-
-## 9. Implementation Plan
-
-| Phase | Description | Effort | Status |
-|-------|-------------|--------|--------|
-| 1 | CLI tool (npm package) | 4h | ✅ Complete |
-| 2 | Repo templates (.github/) | 3h | ✅ Complete |
-| 3 | User skills (7 + agents, instructions, collections) | 6h | ✅ Complete |
-| 4 | Prompt files (14 prompts) | 3h | ✅ Complete |
-| 5 | Documentation + README | 3h | ✅ Complete |
-| 6 | Cleanup phase (remove non-coding resources) | 2h | ✅ Complete |
-| **Total** | | **21h** | ✅ All Phases Complete |
-
----
-
-## 10. Release Process
-
-```bash
-# Development
-git clone https://github.com/camping89/cokit
-cd cokit
-npm install
-
-# Testing locally
-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.8 → 1.0.9)
-npm publish                 # Push to npm registry
-
-# Users get it via
-npx cokit-cli init          # Always fetches latest
-```
-
----
-
-## 11. What's NOT Included (Limitations)
-
-| Claude Code Feature | Status | Reason |
-|---------------------|--------|--------|
-| Runtime hooks | ❌ Skip | Copilot has no equivalent |
-| Multi-agent delegation | ❌ Skip | Single agent only |
-| $ARGUMENTS variables | ❌ Skip | User provides context in chat |
-| Session state | ❌ Skip | Copilot is stateless |
-
-**Workaround:** Users manually chain prompts (`/ck-plan` → `/ck-code` → `/ck-test` → `/ck-review-codebase`)
-
----
-
-## 12. Success Metrics
-
-- [x] `npx cokit-cli init` works without errors
-- [x] Non-technical user can setup in < 2 minutes
-- [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-cli doctor` catches common issues
-
----
-
-## 13. License
-
-**CC BY-NC 4.0** (Creative Commons Attribution-NonCommercial)
-
-✅ Allowed:
-- Personal use
-- Educational use
-- Non-profit organizations
-
-❌ Not allowed:
-- Commercial products
-- Corporate internal use
-- Revenue-generating applications
-
----
-
-## 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
-**Documentation:** `docs/`
-**Installation:** `npx cokit-cli init`