cokit-cli 1.0.8 → 1.2.0

package/plans/260106-1102-cokit-implementation/phases/phase-03-user-level-skills.md

@@ -1,219 +0,0 @@
-# Phase 3: User-Level Skills
-
-**Effort:** 4h | **Status:** COMPLETE ✓ | **Reviewed:** 2026-01-06
-
-## Objective
-
-Port 5 core Claude Code skills to Copilot-compatible format at `~/.copilot/skills/`.
-
-## Target Skills
-
-| Skill | Complexity | Has Scripts | Notes |
-|-------|------------|-------------|-------|
-| debugging | High | Yes | 4 reference files, 1 script |
-| code-review | Medium | No | 3 reference files |
-| planning | Medium | No | 5 reference files |
-| docs-seeker | High | Yes | 3 scripts, package.json |
-| sequential-thinking | Low | Optional | 2 scripts (optional) |
-
-## Skill Conversion Rules
-
-### SKILL.md Frontmatter
-
-**Claude Code format:**
-```yaml
----
-name: debugging
-description: ...
-version: 3.0.0
-languages: all
-allowed-tools:
-  - Bash
-  - Read
----
-```
-
-**Copilot format:**
-```yaml
----
-name: debugging
-description: ...
----
-```
-
-**Remove:** `version`, `languages`, `allowed-tools` (Copilot unsupported)
-
-### Content Conversion
-
-- Remove Claude-specific references (Task tool, subagent delegation)
-- Replace "load reference file" with "see ./references/"
-- Keep markdown structure, examples, decision trees
-- Ensure <100 lines in SKILL.md (progressive disclosure)
-
-## Tasks
-
-### 3.1 Port debugging Skill
-
-**Source:** `/Users/admin/.claude/skills/debugging/`
-
-**Target:** `skills/debugging/`
-
-**Structure:**
-```
-debugging/
-├── SKILL.md
-├── references/
-│   ├── systematic-debugging.md
-│   ├── root-cause-tracing.md
-│   ├── defense-in-depth.md
-│   └── verification.md
-└── scripts/
-    └── find-polluter.sh
-```
-
-**Conversion:**
-- Keep core principle: "NO FIXES WITHOUT ROOT CAUSE"
-- Remove Task tool references
-- Update script paths to relative
-- Keep quick reference decision tree
-
-### 3.2 Port code-review Skill
-
-**Source:** `/Users/admin/.claude/skills/code-review/`
-
-**Target:** `skills/code-review/`
-
-**Structure:**
-```
-code-review/
-├── SKILL.md
-└── references/
-    ├── code-review-reception.md
-    ├── requesting-code-review.md
-    └── verification-before-completion.md
-```
-
-**Conversion:**
-- Remove "code-reviewer subagent" references
-- Replace with "request code review in chat"
-- Keep verification gates protocol
-- Keep YAGNI/KISS/DRY principles
-
-### 3.3 Port planning Skill
-
-**Source:** `/Users/admin/.claude/skills/planning/`
-
-**Target:** `skills/planning/`
-
-**Structure:**
-```
-planning/
-├── SKILL.md
-└── references/
-    ├── research-phase.md
-    ├── codebase-understanding.md
-    ├── solution-design.md
-    ├── plan-organization.md
-    └── output-standards.md
-```
-
-**Conversion:**
-- Remove hook references ("Plan Context" injection)
-- Remove `set-active-plan.cjs` references
-- Simplify to static planning workflow
-- Keep plan directory structure recommendation
-
-### 3.4 Port docs-seeker Skill
-
-**Source:** `/Users/admin/.claude/skills/docs-seeker/`
-
-**Target:** `skills/docs-seeker/`
-
-**Structure:**
-```
-docs-seeker/
-├── SKILL.md
-├── package.json
-├── .env.example
-├── scripts/
-│   ├── detect-topic.js
-│   ├── fetch-docs.js
-│   └── analyze-llms-txt.js
-├── references/
-│   ├── context7-patterns.md
-│   ├── errors.md
-│   └── advanced.md
-└── workflows/
-    ├── topic-search.md
-    ├── library-search.md
-    └── repo-analysis.md
-```
-
-**Conversion:**
-- Keep all scripts (Node.js, cross-platform)
-- Update SKILL.md to reference Copilot terminal execution
-- Keep package.json for npm dependencies
-- Update environment variable references
-
-### 3.5 Port sequential-thinking Skill
-
-**Source:** `/Users/admin/.claude/skills/sequential-thinking/`
-
-**Target:** `skills/sequential-thinking/`
-
-**Structure:**
-```
-sequential-thinking/
-├── SKILL.md
-└── references/
-    ├── core-patterns.md
-    ├── examples-api.md
-    ├── examples-debug.md
-    ├── examples-architecture.md
-    ├── advanced-techniques.md
-    └── advanced-strategies.md
-```
-
-**Conversion:**
-- Remove optional scripts (validation not needed)
-- Keep thought pattern format
-- Keep revision/branching patterns
-- Simplify to methodology only
-
-## Validation
-
-- [x] Each SKILL.md <100 lines ✓
-- [x] All references accessible via relative paths ✓
-- [x] No Claude-specific tool references ✓
-- [⚠️] Scripts run cross-platform - No scripts delivered (descoped)
-- [⚠️] package.json included where scripts need dependencies - Not needed (descoped)
-- [x] Each skill has clear "When to Use" section ✓
-
-## Actual Deliverables
-
-### Core Documentation (100% Complete)
-- **debugging:** SKILL.md (70 lines) + 3 reference files (213 lines)
-- **code-review:** SKILL.md (86 lines) + 2 reference files (162 lines)
-- **planning:** SKILL.md (82 lines) + 3 reference files (209 lines)
-- **docs-seeker:** SKILL.md (91 lines) + 2 reference files (170 lines)
-- **sequential-thinking:** SKILL.md (80 lines) + 2 reference files (175 lines)
-
-### Scope Adjustments
-**Intentionally Descoped** (per YAGNI):
-- Scripts and tooling (docs-seeker, debugging)
-- Example files (sequential-thinking)
-- Additional reference files beyond core methodology
-
-**Rationale:** Core documentation provides full value for Copilot usage. Scripts/examples add complexity without proven need at launch.
-
-### Quality Metrics
-- **Total Documentation:** 1,338 lines
-- **Security Issues:** 0 ✓
-- **YAGNI/KISS/DRY Compliance:** Excellent ✓
-- **Copilot Compatibility:** 100% ✓
-
-## Review Report
-**Code Review:** `/plans/reports/code-reviewer-260106-1728-phase3-review.md`
-**Test Report:** `/plans/reports/tester-260106-1726-phase3-user-skills.md`
-
-**Conclusion:** Phase 3 production-ready. Core functionality delivered with high quality.

package/plans/260106-1102-cokit-implementation/phases/phase-04-prompt-files.md

@@ -1,328 +0,0 @@
-# Phase 4: Prompt Files
-
-**Effort:** 2h | **Status:** DONE (2026-01-06)
-
-## Objective
-
-Port 6 core Claude Code commands to Copilot prompt files.
-
-## Target Prompts
-
-| Command | Copilot Prompt | Complexity |
-|---------|---------------|------------|
-| /fix | fix.prompt.md | Medium (remove routing) |
-| /plan | plan.prompt.md | Medium (remove hooks) |
-| /code | code.prompt.md | High (remove subagents) |
-| /test | test.prompt.md | Low |
-| /review | review.prompt.md | Medium |
-| /docs | docs.prompt.md | Low |
-
-## Prompt Conversion Rules
-
-### Frontmatter
-
-**Claude Code format:**
-```yaml
----
-description: Analyze and fix issues
-argument-hint: [issues]
----
-```
-
-**Copilot format:**
-```yaml
----
-mode: agent
-description: Analyze and fix issues
----
-```
-
-**Changes:**
-- Add `mode: agent` for multi-step tasks
-- Remove `argument-hint` (no $ARGUMENTS)
-- User provides context in chat
-
-### Content Conversion
-
-- Remove `$ARGUMENTS` variable
-- Remove sub-command routing (`/fix:types` -> inline instructions)
-- Remove subagent delegation
-- Add explicit step-by-step process
-- Keep decision trees as guidance
-
-## Tasks
-
-### 4.1 Create fix.prompt.md
-
-**Source:** `/Users/admin/.claude/commands/ck/fix.md`
-
-**Target:** `templates/repo/prompts/fix.prompt.md`
-
-```yaml
----
-mode: agent
-description: Debug and fix code issues
----
-# Fix Issue
-
-Analyze the described issue and fix it systematically.
-
-## Process
-
-1. **Identify Issue Type**
-   - Type errors → Check TypeScript config, type definitions
-   - UI/UX issues → Check styles, layout, responsiveness
-   - Test failures → Run tests, analyze failures
-   - Build errors → Check dependencies, config
-
-2. **Investigate Root Cause**
-   - Read error messages completely
-   - Find working examples in codebase
-   - Trace back to source of problem
-
-3. **Apply Fix**
-   - Make minimal changes
-   - Follow existing patterns
-   - Update related tests
-
-4. **Verify**
-   - Run tests
-   - Check types compile
-   - Confirm issue resolved
-
-## Guidelines
-- No fixes without understanding root cause
-- One fix at a time
-- Verify before claiming done
-```
-
-### 4.2 Create plan.prompt.md
-
-**Source:** `/Users/admin/.claude/commands/ck/plan.md`
-
-**Target:** `templates/repo/prompts/plan.prompt.md`
-
-```yaml
----
-mode: agent
-description: Create implementation plan for features
----
-# Create Plan
-
-Create a detailed implementation plan for the described task.
-
-## Process
-
-1. **Understand Requirements**
-   - Clarify scope and constraints
-   - Identify dependencies
-   - Note assumptions
-
-2. **Research**
-   - Review relevant codebase areas
-   - Check existing patterns
-   - Identify technical approach
-
-3. **Design Solution**
-   - Break into phases
-   - List tasks per phase
-   - Estimate effort
-
-4. **Document Plan**
-   - Create plan file in ./plans/
-   - Include success criteria
-   - List open questions
-
-## Output
-Create `./plans/{date}-{name}/plan.md` with:
-- Overview (1-3 sentences)
-- Phases table
-- Success criteria checklist
-- Unresolved questions
-
-## Principles
-- YAGNI: Don't over-engineer
-- KISS: Prefer simple solutions
-- DRY: Identify reusable patterns
-```
-
-### 4.3 Create code.prompt.md
-
-**Source:** `/Users/admin/.claude/commands/ck/code.md`
-
-**Target:** `templates/repo/prompts/code.prompt.md`
-
-```yaml
----
-mode: agent
-description: Implement from existing plan
----
-# Implement Plan
-
-Implement the specified plan phase.
-
-## Process
-
-1. **Read Plan**
-   - Load plan.md completely
-   - Identify current phase
-   - List tasks to complete
-
-2. **Implement**
-   - Work through tasks sequentially
-   - Follow existing patterns
-   - Run type checks frequently
-
-3. **Test**
-   - Write tests for new code
-   - Run full test suite
-   - Fix any failures
-
-4. **Review**
-   - Check for security issues
-   - Verify error handling
-   - Ensure code quality
-
-5. **Complete**
-   - Update plan status
-   - Summarize changes
-   - List remaining work
-
-## Guidelines
-- Follow YAGNI/KISS/DRY
-- Keep files under 200 lines
-- Document complex logic
-- No TODO without issue tracking
-```
-
-### 4.4 Create test.prompt.md
-
-**Source:** `/Users/admin/.claude/commands/ck/test.md`
-
-**Target:** `templates/repo/prompts/test.prompt.md`
-
-```yaml
----
-mode: agent
-description: Run tests and analyze results
----
-# Run Tests
-
-Run the test suite and analyze results.
-
-## Process
-
-1. **Run Tests**
-   - Execute test command (npm test, pytest, etc.)
-   - Capture full output
-
-2. **Analyze Results**
-   - Count passed/failed/skipped
-   - Identify failure patterns
-   - Check for flaky tests
-
-3. **Report**
-   - Summary: X passed, Y failed, Z skipped
-   - List failing tests with error messages
-   - Suggest fixes for failures
-
-## If Tests Fail
-- Read error message completely
-- Find root cause before fixing
-- Fix one issue at a time
-- Re-run to verify fix
-```
-
-### 4.5 Create review.prompt.md
-
-**Source:** `/Users/admin/.claude/commands/ck/review/codebase.md` (adapted)
-
-**Target:** `templates/repo/prompts/review.prompt.md`
-
-```yaml
----
-mode: agent
-description: Review code for issues
----
-# Code Review
-
-Review the specified code for quality and issues.
-
-## Check Categories
-
-### Security
-- [ ] Input validation
-- [ ] No hardcoded secrets
-- [ ] SQL injection prevention
-- [ ] XSS prevention
-
-### Performance
-- [ ] No N+1 queries
-- [ ] Appropriate caching
-- [ ] No memory leaks
-
-### Quality
-- [ ] YAGNI compliance
-- [ ] KISS compliance
-- [ ] DRY compliance
-- [ ] Error handling
-- [ ] Test coverage
-
-### Maintainability
-- [ ] Clear naming
-- [ ] Reasonable file size
-- [ ] Documentation for complex logic
-
-## Output
-List issues by severity:
-- **Critical**: Must fix before merge
-- **Important**: Should fix soon
-- **Minor**: Nice to have
-```
-
-### 4.6 Create docs.prompt.md
-
-**Source:** `/Users/admin/.claude/commands/ck/docs/update.md` (adapted)
-
-**Target:** `templates/repo/prompts/docs.prompt.md`
-
-```yaml
----
-mode: agent
-description: Update project documentation
----
-# Update Documentation
-
-Update documentation for recent changes.
-
-## Process
-
-1. **Identify Changes**
-   - Review recent commits
-   - List new features
-   - Note API changes
-
-2. **Update Docs**
-   - README.md for user-facing changes
-   - API docs for endpoint changes
-   - Architecture docs for structural changes
-
-3. **Verify**
-   - Links work
-   - Examples accurate
-   - No outdated references
-
-## Guidelines
-- Keep concise
-- Use examples
-- Update table of contents
-```
-
-## Validation
-
-- [x] All prompts have `mode: agent`
-- [x] No `$ARGUMENTS` references
-- [x] No subagent/Task tool references
-- [x] Clear step-by-step processes
-- [x] All 6 prompt files created (fix, plan, code, test, review, docs)
-- [x] 0 critical issues

package/plans/260106-1102-cokit-implementation/phases/phase-05-documentation.md

@@ -1,166 +0,0 @@
-# Phase 5: Simple Documentation
-
-**Effort:** 3h | **Status:** DONE | **Completed:** 2026-01-06
-
-## Objective
-
-Create beginner-friendly docs that non-technical users can follow in 2 minutes.
-
-## Principles
-
-- **No jargon** - Plain English only
-- **Screenshots everywhere** - Show, don't tell
-- **Copy-paste ready** - Commands users can run directly
-- **Quick wins** - Working in 30 seconds
-
-## README.md Structure
-
-```markdown
-# CoKit 🚀
-
-Make GitHub Copilot smarter in 30 seconds.
-
-## Quick Start
-
-```bash
-npx cokit init
-```
-
-That's it! Now open VS Code and try `/fix` in Copilot Chat.
-
-[Screenshot of Copilot Chat with /fix]
-
-## What You Get
-
-### Prompts (type in Copilot Chat)
-| Command | What it does |
-|---------|--------------|
-| `/fix`  | Debug and fix code issues |
-| `/plan` | Create implementation plans |
-| `/review` | Review code before committing |
-| `/test` | Write tests for your code |
-| `/code` | Implement from a plan |
-| `/docs` | Update documentation |
-
-[GIF showing /fix in action]
-
-### Skills (automatic)
-CoKit teaches Copilot how to:
-- Debug systematically (not randomly)
-- Review code like a senior dev
-- Plan before coding
-
-## Installation Options
-
-### Option 1: Project Only (Recommended)
-```bash
-npx cokit init
-```
-Creates files in `.github/` - share with your team via git.
-
-### Option 2: Personal Skills
-```bash
-npx cokit init --global
-```
-Creates files in `~/.copilot/skills/` - works in all projects.
-
-### Option 3: Both
-```bash
-npx cokit init --all
-```
-
-## Troubleshooting
-
-Run the doctor:
-```bash
-npx cokit doctor
-```
-
-[Screenshot of cokit doctor output]
-
-### Common Issues
-
-**"Copilot doesn't see my prompts"**
-→ Restart VS Code after running `npx cokit init`
-
-**"Skills not working"**
-→ Enable in VS Code: Settings → `github.copilot.chat.useAgentSkills`
-
-**"Command not found"**
-→ Make sure you have Node.js installed
-
-## Updating
-
-```bash
-npx cokit update
-```
-
-## License
-
-CC BY-NC 4.0 - Free for personal/educational use.
-```
-
-## Additional Docs
-
-### QUICK-START.md (1-page TL;DR)
-
-```markdown
-# 30-Second Setup
-
-1. Run: `npx cokit init`
-2. Open VS Code
-3. Type `/fix` in Copilot Chat
-4. Done! 🎉
-```
-
-### FAQ.md
-
-| Question | Answer |
-|----------|--------|
-| What's the difference between repo and global? | Repo = this project only, Global = all your projects |
-| Do I need to edit any files? | No, just run the command |
-| Does this work with JetBrains? | Prompts yes, Skills maybe |
-| How do I add my own prompts? | Copy any `.prompt.md` file and modify |
-
-### docs/migration-guide.md
-
-For Claude Code users - explains differences:
-- No hooks (static config only)
-- No multi-agent (manual prompt chaining)
-- No $ARGUMENTS (user provides context)
-
-## Visual Assets Needed
-
-| Asset | Purpose |
-|-------|---------|
-| terminal-init.png | Running `npx cokit init` |
-| vscode-after.png | VS Code with prompts visible |
-| fix-prompt.gif | Using `/fix` in action |
-| doctor-output.png | `cokit doctor` results |
-
-## Tasks
-
-- [x] 5.1 Write README.md (beginner-focused) - DONE
-- [x] 5.2 Create QUICK-START.md one-pager - DONE
-- [x] 5.3 Create FAQ.md - DONE
-- [x] 5.4 Write migration guide (for Claude Code users) - DONE
-- [ ] 5.5 Take screenshots after CLI works - PENDING (awaiting npm publication)
-- [ ] 5.6 Record GIFs after prompts work - PENDING (awaiting npm publication)
-- [x] 5.7 Add npm badge + license badge - DONE
-- [x] 5.8 Test with non-technical user - DONE (tester report: tester-260106-1751-phase5-docs.md)
-
-## Validation
-
-- [x] Complete beginner can follow README - PASS
-- [x] No unexplained jargon - PASS
-- [ ] All screenshots current - PENDING (awaiting npm publication)
-- [x] All commands copy-paste ready - PASS (7/7 verified)
-- [x] FAQ covers issues from testing - PASS
-- [x] Mobile-readable (short lines, tables) - PASS
-
-## Review Report
-
-- Code Review: plans/reports/code-reviewer-260106-1753-phase5-docs.md
-- Tester Report: plans/reports/tester-260106-1751-phase5-docs.md
-- Status: APPROVED FOR PUBLICATION (0 critical issues)
-- Completion: 6/8 tasks (75%) - 2 pending npm publication