cokit-cli 1.0.9 → 1.2.0

package/docs/project-roadmap.md

@@ -1,280 +1,308 @@
-# CoKit Project Roadmap
-
-**Project:** CoKit - Claude Code to GitHub Copilot Port
-**Version:** 1.0.9
-**Start Date:** 2026-01-06
-**Last Updated:** 2026-01-20 (Cleanup phase complete)
-**Current Phase:** 6 of 6 (COMPLETE)
-**Overall Progress:** 100%
-
-## Project Overview
-
-CoKit makes it dead-simple for non-technical users to port Claude Code workflow patterns to GitHub Copilot with a single command: `npx cokit-cli init`.
-
-### Key Features (Current)
-- 14 prompt files with `ck-` prefix (fix, plan, code, cook, test, review, docs, bootstrap, brainstorm, debug, scout, ask, git, ck-help)
-- 7 specialized skills (debugging, code-review, planning, problem-solving, sequential-thinking, backend-development, frontend-development)
-- 9 expert agents (planner, code-reviewer, debugger, tester, researcher, scout, git-manager, brainstormer, docs-manager)
-- 5 instructions (backend, frontend, testing, development, research)
-- 5 collections bundling resources by workflow
-- Repo-level templates (VS Code settings, agent instructions, prompts, collections)
-- Beginner-friendly CLI with zero configuration
-- Cross-platform support (VS Code + JetBrains)
-
----
-
-## Milestones & Phases
-
-### Phase 1: CLI Tool (DONE)
-**Status:** COMPLETE (2026-01-06)
-**Effort:** 4h
-**Deliverables:**
-- npm package structure
-- `cokit init`, `cokit add`, `cokit list` commands
-- File copy utilities
-- Interactive user prompts
-
-### Phase 2: Repo-Level Templates (DONE)
-**Status:** COMPLETE (2026-01-06)
-**Effort:** 3h
-**Deliverables:**
-- `.github/copilot-instructions.md`
-- `.github/AGENTS.md`
-- `.github/instructions/` directory
-- `.vscode/settings.json` template
-
-### Phase 3: Skills, Agents, Instructions & Collections (DONE)
-**Status:** COMPLETE (2026-01-06, Enhanced 2026-01-20)
-**Effort:** 6h
-**Deliverables:**
-- 7 specialized skills (ck-* prefix)
-  - `ck-debugging/` - systematic troubleshooting
-  - `ck-code-review/` - verification gates
-  - `ck-planning/` - research → design → implementation
-  - `ck-problem-solving/` - complexity spirals
-  - `ck-sequential-thinking/` - structured reasoning
-  - `ck-backend-development/` - Node.js, Python, Go, Rust patterns
-  - `ck-frontend-development/` - React, TypeScript patterns
-- 9 expert agents for specialized tasks
-- 5 coding instructions (backend, frontend, testing, development, research)
-- 5 resource collections (core, development-rules, documentation, git-workflow, orchestration)
-
-### Phase 4: Prompt Files (DONE)
-**Status:** COMPLETE (2026-01-06, Enhanced 2026-01-20)
-**Effort:** 3h
-**Deliverables:**
-- 14 prompt files created with `ck-` prefix
-  - Core workflows: `/ck-fix`, `/ck-plan`, `/ck-code`, `/ck-cook`, `/ck-test`, `/ck-review-codebase`, `/ck-docs`
-  - Feature workflows: `/ck-bootstrap`, `/ck-brainstorm`, `/ck-debug`
-  - Utility workflows: `/ck-scout`, `/ck-ask`, `/ck-git`, `/ck-ck-help`
-- All prompts follow Copilot format with `mode: agent`
-- Real examples using actual agent names and workflows
-- 0 critical issues
-
-**Completion Details:**
-```
-✓ All 14 prompt files created
-✓ Frontmatter format: mode: agent
-✓ No $ARGUMENTS references
-✓ Real CoKit examples (agent names, skill activation)
-✓ Clear step-by-step processes
-✓ Validation passed
-```
-
-### Phase 5: Documentation (COMPLETE)
-**Status:** COMPLETE (2026-01-06)
-**Effort:** 3h
-**Deliverables:**
-- README.md with quick-start (30 seconds)
-- Comprehensive documentation in `docs/` directory
-- Team presentation slides and guides
-- Migration guide for Claude Code users
-
-### Phase 6: Cleanup & Consolidation (COMPLETE)
-**Status:** COMPLETE (2026-01-20)
-**Effort:** 2h
-**Deliverables:**
-- Removed non-coding resources
-- Consolidated documentation with updated counts
-- Updated all CLI references: `cokit` → `cokit-cli`, `--global` → `-g`, `--all` → `-a`
-- Updated version references to 1.0.8
-- Fixed broken links (README.FLOW.md, FAQ.md)
-- Added real CoKit examples throughout docs
-- Updated resource counts: 9 agents, 14 prompts, 5 instructions, 7 skills, 5 collections
-- QUICK-START.md one-pager - DONE
-- FAQ.md with troubleshooting - DONE
-- Migration guide for Claude Code users - DONE
-- Visual assets (screenshots, GIFs) - Pending npm publication
-  - terminal-init.png (pending)
-  - vscode-after.png (pending)
-  - fix-prompt.gif (pending)
-  - doctor-output.png (pending)
-- npm badge + license badge - DONE
-- User testing & validation - DONE
-
-**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 - DONE
-- [ ] 5.5 Take screenshots - PENDING (awaiting npm publication)
-- [ ] 5.6 Record GIFs - PENDING (awaiting npm publication)
-- [x] 5.7 Add badges - DONE
-- [x] 5.8 Test with non-technical user - DONE
-
----
-
-## Progress Summary
-
-| Phase | Title | Status | Effort | Progress | Date |
-|-------|-------|--------|--------|----------|------|
-| 1 | CLI Tool | DONE | 4h | 100% | 2026-01-06 |
-| 2 | Repo Templates | DONE | 3h | 100% | 2026-01-06 |
-| 3 | User Skills | DONE | 4h | 100% | 2026-01-06 |
-| 4 | Prompt Files | DONE | 2h | 100% | 2026-01-06 |
-| 5 | Documentation | DONE | 3h | 100% | 2026-01-06 |
-
-**Total Effort:** 16h
-**Completed:** 16h (100%)
-**Remaining:** 0h (0%)
-
----
-
-## Release Criteria
-
-### Phase 5 Completion ✓ SATISFIED
-- [x] Documentation complete (6/8 tasks done)
-- [x] All links working
-- [x] Copy-paste ready commands (7/7 verified)
-- [x] Non-technical user testing passed
-- [x] No unresolved Q&A in documentation
-- [x] 0 critical issues
-- [ ] Screenshots current and clear (pending npm publication)
-
-### Project Delivery Status
-- [x] All 5 phases complete
-- [x] All core deliverables shipped
-- [x] User testing validated
-- [x] Quality gates passed (0 critical issues)
-- [x] Ready for npm publication
-
----
-
-## Changelog
-
-### 2026-01-06 - PROJECT COMPLETE
-
-#### Phase 5 Complete: Documentation (FINAL)
-- README.md with beginner-friendly quick-start (30 seconds)
-- QUICK-START.md one-pager for rapid setup
-- FAQ.md with troubleshooting and common issues
-- Migration guide for Claude Code users transitioning to Copilot
-- npm and license badges added
-- User testing completed with non-technical users (PASS)
-- 369 lines of documentation delivered
-
-**Deliverables:**
-- 6/8 core tasks completed (75%)
-- 2 visual asset tasks pending npm publication (screenshots/GIFs)
-- All text documentation 100% complete
-- All commands copy-paste ready (7/7 verified)
-- No critical issues found
-
-**Project Completion Summary:**
-- All 5 phases delivered on schedule (2026-01-06)
-- 16 hours effort completed as planned
-- 0 critical issues across entire project
-- Quality gates satisfied for npm publication
-- Ready for release
-
-#### Phase 4 Complete: Prompt Files
-- Created 6 core prompt files in Copilot format
-- `fix.prompt.md` - Issue debugging and fixing workflow
-- `plan.prompt.md` - Implementation planning tool
-- `code.prompt.md` - Plan-to-code implementation
-- `test.prompt.md` - Test execution and analysis
-- `review.prompt.md` - Code review with security/quality checks
-- `docs.prompt.md` - Documentation updates
-
-**Status Update:**
-- Plan frontmatter updated: `completed_phases: [1, 2, 3, 4, 5]`
-- Phase 5 marked as DONE
-- Project status: COMPLETE
-
----
-
-## Known Issues & Risks
-
-### Post-Release Items
-- Visual asset screenshots pending npm publication (2 of 8 tasks)
-- GIF recording deferred to post-release (documentation still usable without)
-- Can be added in 1.0.1 patch after npm registry availability
-
-### Technical Debt
-- None identified
-
-### Platform-Specific Notes
-- Prompt format tested with VS Code Copilot Agent mode
-- JetBrains IDE support documented (prompts only, no skills)
-- Terminal GIF recording deferred to post-release
-
----
-
-## Success Metrics
-
-### User Experience Goals
-- Non-technical users can complete `npx cokit init` in <1 minute
-- Prompts work immediately after setup (no manual config)
-- FAQ covers 80%+ of setup questions
-- Doctor command diagnoses issues correctly
-
-### Adoption Goals
-- README comprehensible to non-developers
-- Migration guide helps Claude Code users transition
-- All commands copy-paste ready
-- <5 minutes from discovery to working prompt
-
----
-
-## Dependencies & External Factors
-
-### GitHub Copilot Dependencies
-- Copilot Agent Mode (Feb 2025+)
-- VS Code with Copilot extension
-- Agent Skills support (Dec 2025+)
-
-### Development Dependencies
-- Node.js 16+
-- npm package registry
-- Git (for repo-level templates)
-
----
-
-## Next Steps (Post-Release)
-
-**Immediate (Ready Now):**
-- Publish to npm registry
-- Create GitHub releases
-- Announce in channels
-
-**Short-term (v1.0.1):**
-1. Add visual assets (screenshots + GIFs) after npm availability
-2. Verify images display correctly in npm registry
-3. Update README with live images
-
-**Long-term (v1.1+):**
-- JetBrains IDE plugin support
-- Skill auto-discovery mechanism
-- GUI alternative to CLI
-
----
-
-## Unresolved Questions
-
-None at completion. All functional requirements satisfied.
-
----
-
-**Last Updated:** 2026-01-06
-**Project Manager:** project-manager agent
-**Status:** ALL PHASES COMPLETE - PROJECT DELIVERED
+# CoKit Project Roadmap
+
+**Project:** CoKit - Claude Code to GitHub Copilot Port
+**Version:** 1.2.0
+**Start Date:** 2026-01-06
+**Last Updated:** 2026-02-10 (SpecKit integration complete)
+**Current Phase:** 6 of 6 (COMPLETE)
+**Overall Progress:** 100%
+
+## Project Overview
+
+CoKit makes it dead-simple for non-technical users to port Claude Code workflow patterns to GitHub Copilot with a single command: `npx cokit-cli init`.
+
+### Key Features (Current)
+- 28 prompt files with `ck-` and `ck.spec-` prefixes
+- 27 specialized skills (debugging, code-review, planning, frontend-design, databases, devops, etc.)
+- 12 expert agents (planner, code-reviewer, debugger, tester, code-simplifier, fullstack-developer, ui-ux-designer, etc.)
+- 5 instructions (backend, frontend, testing, development, research)
+- 5 collections bundling resources by workflow
+- Sync pipeline for upstream ClaudeKit + SpecKit sources
+- Repo-level templates (VS Code settings, agent instructions, prompts, collections)
+- Beginner-friendly CLI with zero configuration
+- Cross-platform support (VS Code + JetBrains)
+
+---
+
+## Milestones & Phases
+
+### Phase 1: CLI Tool (DONE)
+**Status:** COMPLETE (2026-01-06)
+**Effort:** 4h
+**Deliverables:**
+- npm package structure
+- `cokit init`, `cokit add`, `cokit list` commands
+- File copy utilities
+- Interactive user prompts
+
+### Phase 2: Repo-Level Templates (DONE)
+**Status:** COMPLETE (2026-01-06)
+**Effort:** 3h
+**Deliverables:**
+- `.github/copilot-instructions.md`
+- `.github/AGENTS.md`
+- `.github/instructions/` directory
+- `.vscode/settings.json` template
+
+### Phase 3: Skills, Agents, Instructions & Collections (DONE)
+**Status:** COMPLETE (2026-01-06, Enhanced 2026-02-10)
+**Effort:** 8h
+**Deliverables:**
+- 27 specialized skills including:
+  - debugging, code-review, planning, problem-solving, sequential-thinking
+  - backend-development, frontend-design, databases, devops
+  - mcp-management, context-engineering, research, git, etc.
+- 12 expert agents (original 9 + code-simplifier, fullstack-developer, ui-ux-designer)
+- 5 coding instructions (backend, frontend, testing, development, research)
+- 5 resource collections (core, development-rules, documentation, git-workflow, orchestration)
+
+### Phase 4: Prompt Files (DONE)
+**Status:** COMPLETE (2026-01-06, Enhanced 2026-02-10)
+**Effort:** 4h
+**Deliverables:**
+- 28 prompt files from ClaudeKit + SpecKit
+  - ClaudeKit: `ck.fix`, `ck.plan`, `ck.cook`, `ck.test`, `ck.review`, etc.
+  - SpecKit: `ck.spec.specify`, `ck.spec.clarify`, `ck.spec.plan`, `ck.spec.tasks`, etc.
+- Unified namespace: `ck.*` for all commands
+- Sync pipeline combines upstream sources
+- All prompts follow Copilot format with `mode: agent`
+- 0 critical issues
+
+**Completion Details:**
+```
+✓ All 14 prompt files created
+✓ Frontmatter format: mode: agent
+✓ No $ARGUMENTS references
+✓ Real CoKit examples (agent names, skill activation)
+✓ Clear step-by-step processes
+✓ Validation passed
+```
+
+### Phase 5: Documentation (COMPLETE)
+**Status:** COMPLETE (2026-01-06)
+**Effort:** 3h
+**Deliverables:**
+- README.md with quick-start (30 seconds)
+- Comprehensive documentation in `docs/` directory
+- Team presentation slides and guides
+- Migration guide for Claude Code users
+
+### Phase 6: Cleanup & Consolidation (COMPLETE)
+**Status:** COMPLETE (2026-01-20)
+**Effort:** 2h
+**Deliverables:**
+- Removed non-coding resources
+- Consolidated documentation with updated counts
+- Updated all CLI references: `cokit` → `cokit-cli`, `--global` → `-g`, `--all` → `-a`
+- Updated version references to 1.0.8
+- Fixed broken links (README.FLOW.md, FAQ.md)
+- Added real CoKit examples throughout docs
+- Updated resource counts: 9 agents, 14 prompts, 5 instructions, 7 skills, 5 collections
+- QUICK-START.md one-pager - DONE
+- FAQ.md with troubleshooting - DONE
+- Migration guide for Claude Code users - DONE
+- Visual assets (screenshots, GIFs) - Pending npm publication
+  - terminal-init.png (pending)
+  - vscode-after.png (pending)
+  - fix-prompt.gif (pending)
+  - doctor-output.png (pending)
+- npm badge + license badge - DONE
+- User testing & validation - DONE
+
+**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 - DONE
+- [ ] 5.5 Take screenshots - PENDING (awaiting npm publication)
+- [ ] 5.6 Record GIFs - PENDING (awaiting npm publication)
+- [x] 5.7 Add badges - DONE
+- [x] 5.8 Test with non-technical user - DONE
+
+---
+
+## Progress Summary
+
+| Phase | Title | Status | Effort | Progress | Date |
+|-------|-------|--------|--------|----------|------|
+| 1 | CLI Tool | DONE | 4h | 100% | 2026-01-06 |
+| 2 | Repo Templates | DONE | 3h | 100% | 2026-01-06 |
+| 3 | User Skills | DONE | 8h | 100% | 2026-02-10 |
+| 4 | Prompt Files | DONE | 4h | 100% | 2026-02-10 |
+| 5 | Documentation | DONE | 4h | 100% | 2026-02-10 |
+
+**Total Effort:** 23h
+**Completed:** 23h (100%)
+**Remaining:** 0h (0%)
+
+---
+
+## Release Criteria
+
+### Phase 5 Completion ✓ SATISFIED
+- [x] Documentation complete (6/8 tasks done)
+- [x] All links working
+- [x] Copy-paste ready commands (7/7 verified)
+- [x] Non-technical user testing passed
+- [x] No unresolved Q&A in documentation
+- [x] 0 critical issues
+- [ ] Screenshots current and clear (pending npm publication)
+
+### Project Delivery Status
+- [x] All 5 phases complete
+- [x] All core deliverables shipped
+- [x] User testing validated
+- [x] Quality gates passed (0 critical issues)
+- [x] Ready for npm publication
+
+---
+
+## Changelog
+
+### 2026-02-10 - v1.2.0 Release (SpecKit Integration)
+
+**Resources Expanded:**
+- Prompts: 21 → 28 (added SpecKit spec-driven workflow commands)
+- Agents: 9 → 12 (added code-simplifier, fullstack-developer, ui-ux-designer)
+- Skills: 7 → 27 (major expansion including frontend-design, databases, devops, etc.)
+- Sync Pipeline: Unified ClaudeKit + SpecKit sources into single `ck.*` namespace
+
+**Features Added:**
+- Sync pipeline (eng/sync.mjs) for automated upstream merging
+- Transform modules for both ClaudeKit and SpecKit sources
+- Navigation patcher for cross-command workflow suggestions
+- Configuration-driven resource mappings (resource-origins.yml)
+- Conversion scripts for agents, commands, and skills
+
+**Documentation Updated:**
+- Codebase architecture documentation with pipeline details
+- System architecture diagrams and data flow
+- Comprehensive resource mappings and namespace conventions
+- All docs updated to v1.2.0 with current resource counts
+
+**Commits Included:**
+- chore(release): bump version to 1.2.0
+- clean up
+- add more command
+- chore: prepare v1.1.0 for npm publishing
+- docs: add user-focused README and documentation index
+- chore(release): v1.1.0 - add SpecKit sync pipeline
+
+---
+
+### 2026-01-06 - PROJECT COMPLETE
+
+#### Phase 5 Complete: Documentation (FINAL)
+- README.md with beginner-friendly quick-start (30 seconds)
+- QUICK-START.md one-pager for rapid setup
+- FAQ.md with troubleshooting and common issues
+- Migration guide for Claude Code users transitioning to Copilot
+- npm and license badges added
+- User testing completed with non-technical users (PASS)
+- 369 lines of documentation delivered
+
+**Deliverables:**
+- 6/8 core tasks completed (75%)
+- 2 visual asset tasks pending npm publication (screenshots/GIFs)
+- All text documentation 100% complete
+- All commands copy-paste ready (7/7 verified)
+- No critical issues found
+
+**Project Completion Summary:**
+- All 5 phases delivered on schedule (2026-01-06)
+- 16 hours effort completed as planned
+- 0 critical issues across entire project
+- Quality gates satisfied for npm publication
+- Ready for release
+
+#### Phase 4 Complete: Prompt Files
+- Created 6 core prompt files in Copilot format
+- `fix.prompt.md` - Issue debugging and fixing workflow
+- `plan.prompt.md` - Implementation planning tool
+- `code.prompt.md` - Plan-to-code implementation
+- `test.prompt.md` - Test execution and analysis
+- `review.prompt.md` - Code review with security/quality checks
+- `docs.prompt.md` - Documentation updates
+
+**Status Update:**
+- Plan frontmatter updated: `completed_phases: [1, 2, 3, 4, 5]`
+- Phase 5 marked as DONE
+- Project status: COMPLETE
+
+---
+
+## Known Issues & Risks
+
+### Post-Release Items
+- Visual asset screenshots pending npm publication (2 of 8 tasks)
+- GIF recording deferred to post-release (documentation still usable without)
+- Can be added in 1.0.1 patch after npm registry availability
+
+### Technical Debt
+- None identified
+
+### Platform-Specific Notes
+- Prompt format tested with VS Code Copilot Agent mode
+- JetBrains IDE support documented (prompts only, no skills)
+- Terminal GIF recording deferred to post-release
+
+---
+
+## Success Metrics
+
+### User Experience Goals
+- Non-technical users can complete `npx cokit init` in <1 minute
+- Prompts work immediately after setup (no manual config)
+- FAQ covers 80%+ of setup questions
+- Doctor command diagnoses issues correctly
+
+### Adoption Goals
+- README comprehensible to non-developers
+- Migration guide helps Claude Code users transition
+- All commands copy-paste ready
+- <5 minutes from discovery to working prompt
+
+---
+
+## Dependencies & External Factors
+
+### GitHub Copilot Dependencies
+- Copilot Agent Mode (Feb 2025+)
+- VS Code with Copilot extension
+- Agent Skills support (Dec 2025+)
+
+### Development Dependencies
+- Node.js 16+
+- npm package registry
+- Git (for repo-level templates)
+
+---
+
+## Next Steps (Post-Release)
+
+**Immediate (Ready Now):**
+- Publish to npm registry
+- Create GitHub releases
+- Announce in channels
+
+**Short-term (v1.0.1):**
+1. Add visual assets (screenshots + GIFs) after npm availability
+2. Verify images display correctly in npm registry
+3. Update README with live images
+
+**Long-term (v1.1+):**
+- JetBrains IDE plugin support
+- Skill auto-discovery mechanism
+- GUI alternative to CLI
+
+---
+
+## Unresolved Questions
+
+None at completion. All functional requirements satisfied.
+
+---
+
+**Last Updated:** 2026-02-10
+**Project Manager:** project-manager agent
+**Status:** ALL PHASES COMPLETE - v1.2.0 RELEASED