cokit-cli 1.0.0

package/docs/cokit-slides.md

@@ -0,0 +1,205 @@
+# 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 init
+```
+
+That's it. No install. No config. No account.
+
+---
+
+## Slide 5: How It Works
+
+```
+You publish once    →    npm Registry    →    User runs npx
+     ↓                                              ↓
+npm publish                               Downloads automatically
+                                                    ↓
+                                          Creates files in project
+                                                    ↓
+                                          Ready to use in VS Code
+```
+
+---
+
+## Slide 6: What Users Get
+
+### 6 Prompts
+| Command | Action |
+|---------|--------|
+| `/fix` | Debug issues |
+| `/plan` | Create plans |
+| `/code` | Implement |
+| `/test` | Write tests |
+| `/review` | Review code |
+| `/docs` | Update docs |
+
+---
+
+## Slide 7: What Users Get (cont.)
+
+### 5 Skills (Auto-Activate)
+
+- **debugging** - Root cause analysis
+- **code-review** - Security + best practices
+- **planning** - Break down features
+- **docs-seeker** - Find documentation
+- **sequential-thinking** - Step-by-step logic
+
+---
+
+## Slide 8: Two Installation Options
+
+| Option | Command | Location |
+|--------|---------|----------|
+| **Project** | `npx cokit init` | `.github/` |
+| **Personal** | `npx cokit init --global` | `~/.copilot/` |
+| **Both** | `npx cokit init --all` | Both |
+
+---
+
+## Slide 9: CLI Commands
+
+```bash
+npx cokit init      # Setup wizard
+npx cokit doctor    # Troubleshoot
+npx cokit list      # Show installed
+npx cokit update    # Get latest
+```
+
+---
+
+## Slide 10: User Experience
+
+```
+$ npx cokit init
+
+🚀 CoKit Setup
+
+? What do you want to set up?
+  › Project templates
+    Personal skills
+    Both
+
+✓ Created .github/copilot-instructions.md
+✓ Created .github/prompts/fix.prompt.md
+...
+
+🎉 Done! Try /fix in Copilot Chat.
+```
+
+---
+
+## Slide 11: Implementation Plan
+
+| Phase | What | Time |
+|-------|------|------|
+| 1 | CLI tool | 4h |
+| 2 | Project templates | 3h |
+| 3 | Skills (5) | 4h |
+| 4 | Prompts (6) | 2h |
+| 5 | Documentation | 3h |
+| **Total** | | **16h** |
+
+---
+
+## 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
+
+# Users do:
+npx cokit init    # Always gets latest
+```
+
+---
+
+## 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
+3. **Install:** `npx cokit init`
+4. **Timeline:** 16 hours
+5. **Repo:** github.com/camping89/cokit
+
+---
+
+## Slide 17: Questions?
+
+**Repository:** https://github.com/camping89/cokit
+
+**Full docs:** `docs/cokit-team-presentation.md`
+
+**Plan:** `plans/260106-1102-cokit-implementation/`

package/docs/cokit-team-presentation.md

@@ -0,0 +1,319 @@
+# CoKit: Team Presentation
+
+**Date:** January 6, 2026
+**Presenter:** [Your Name]
+**Repository:** https://github.com/camping89/cokit
+
+---
+
+## 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:
+- 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)
+- 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     │                │
+│                                └─────────────┘                │
+│                                                                │
+└────────────────────────────────────────────────────────────────┘
+                              │
+                              │ Package now available globally
+                              ▼
+┌────────────────────────────────────────────────────────────────┐
+│                     USER EXPERIENCE                            │
+├────────────────────────────────────────────────────────────────┤
+│                                                                │
+│   Step 1: User runs command                                    │
+│   ┌─────────────────────────────────────────────────────────┐ │
+│   │ $ npx cokit 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 (Phase 4)            │
+│   ┌─────────────────────────────────────────────────────────┐ │
+│   │ ✓ .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                        │ │
+│   │ ✓ .vscode/settings.json                                 │ │
+│   │                                                         │ │
+│   │ 🎉 Done! Try /fix in Copilot Chat.                      │ │
+│   └─────────────────────────────────────────────────────────┘ │
+│                              │                                 │
+│                              ▼                                 │
+│   Step 5: User opens VS Code, types /fix                       │
+│   ┌─────────────────────────────────────────────────────────┐ │
+│   │ 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 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 |
+
+---
+
+## 5. Prompts Included
+
+| 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" |
+
+---
+
+## 6. User-Level Skills (Phase 3)
+
+All 5 skills available at `~/.copilot/skills/` following Copilot Agent Skills format:
+
+| 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 |
+
+---
+
+## 7. 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
+├── 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
+```
+
+### Dependencies (minimal)
+
+```json
+{
+  "dependencies": {
+    "commander": "^12.0.0",    // CLI framework
+    "prompts": "^2.4.2",       // Interactive prompts
+    "chalk": "^5.3.0"          // Colorized output
+  }
+}
+```
+
+---
+
+## 8. 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 |
+| 5 | Documentation + README | 3h | ✅ Complete |
+| **Total** | | **16h** | ✅ All Phases Complete |
+
+---
+
+## 9. Release Process
+
+```bash
+# Development
+git clone https://github.com/camping89/cokit
+cd cokit
+npm install
+
+# Testing locally
+npm link                    # Makes 'cokit' available locally
+cokit init                  # Test the CLI
+
+# Publishing
+npm login                   # One-time login
+npm version patch           # Bump version (1.0.0 → 1.0.1)
+npm publish                 # Push to npm registry
+
+# Users get it via
+npx cokit init              # Always fetches latest
+```
+
+---
+
+## 10. 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 (`/plan` → `/code` → `/test` → `/review`)
+
+---
+
+## 11. Success Metrics
+
+- [x] `npx cokit 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] README understandable by beginners
+- [x] `cokit doctor` catches common issues
+
+---
+
+## 12. 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
+
+---
+
+## Questions?
+
+**Repository:** https://github.com/camping89/cokit
+**Plan details:** `plans/260106-1102-cokit-implementation/`

package/docs/migration-guide.md

@@ -0,0 +1,120 @@
+# Migration Guide: Claude Code to CoKit
+
+This guide helps Claude Code users adapt to GitHub Copilot with CoKit.
+
+## Key Differences
+
+| Feature | Claude Code | CoKit/Copilot |
+|---------|-------------|---------------|
+| Commands | `/fix:types`, `/plan:auto` | `/fix`, `/plan` |
+| Arguments | `$ARGUMENTS` variable | User provides in chat |
+| Subagents | Task tool with agents | Single Copilot agent |
+| Hooks | Pre/post execution | Not supported |
+| Skills | `~/.claude/skills/` | `~/.copilot/skills/` |
+| Prompts | `~/.claude/commands/` | `.github/prompts/` |
+
+## What's Different
+
+### No Sub-Commands
+
+**Claude Code:**
+```
+/fix:types     # Fix type errors
+/fix:tests     # Fix test failures
+```
+
+**Copilot:**
+```
+/fix the type errors in auth.ts
+/fix the failing tests in user.test.ts
+```
+
+Provide context directly in your message.
+
+### No $ARGUMENTS Variable
+
+**Claude Code prompt:**
+```markdown
+Fix the issue: $ARGUMENTS
+```
+
+**Copilot prompt:**
+```markdown
+Fix the issue described by the user.
+```
+
+Users describe the issue in chat naturally.
+
+### No Subagent Delegation
+
+**Claude Code:**
+```
+Use Task tool to launch tester agent
+```
+
+**Copilot:**
+```
+Run tests and analyze results
+```
+
+Copilot handles everything in one agent.
+
+### No Hooks
+
+Claude Code hooks (pre/post commands) don't exist in Copilot.
+
+**Workaround:** Include instructions in the prompt itself:
+```markdown
+Before fixing:
+1. Read the error message
+2. Find the root cause
+
+After fixing:
+1. Run tests
+2. Verify the fix works
+```
+
+## Mapping Claude Skills to CoKit
+
+| Claude Skill | CoKit Skill | Notes |
+|--------------|-------------|-------|
+| debugging | debugging | Same methodology |
+| code-review | code-review | Same principles |
+| planning | planning | Simplified workflow |
+| docs-seeker | docs-seeker | Same search patterns |
+| sequential-thinking | sequential-thinking | Same approach |
+
+## What Works the Same
+
+- **Core methodology** - Debugging, planning, review processes
+- **YAGNI/KISS/DRY** - Same principles apply
+- **Quality standards** - Same expectations
+- **File structure** - Similar organization
+
+## Quick Migration
+
+1. Install CoKit:
+   ```bash
+   npx cokit init --all
+   ```
+
+2. Use prompts directly:
+   ```
+   /fix (describe your issue)
+   /plan (describe your feature)
+   ```
+
+3. Skills work automatically - no changes needed.
+
+## Tips for Claude Users
+
+1. **Be descriptive** - Without $ARGUMENTS, include context in chat
+2. **One step at a time** - No multi-agent orchestration
+3. **Explicit instructions** - Put everything in the prompt
+4. **Manual verification** - No automatic hooks
+
+## Getting Help
+
+- [FAQ](../FAQ.md) - Common questions
+- [README](../README.md) - Full documentation
+- Run `npx cokit doctor` for setup issues