cokit-cli 1.2.6 → 1.3.0

package/docs/codebase-summary.md

@@ -2,24 +2,22 @@
 
 ## Overview
 
-CoKit is a CLI tool that enhances GitHub Copilot with 25 prompts, 12 agents, 5 instructions, 27 skills, and 5 collections. The tool unifies two upstream sources (ClaudeKit and SpecKit) into a single ck-* namespace.
+CoKit is a CLI tool that enhances GitHub Copilot with 31 prompts, 13 agents, 5 instructions, 30 skills, and 5 collections. It transforms upstream commands into a unified ck-* namespace.
 
 **Repository:** https://github.com/camping89/cokit.git
-**Version:** 1.2.6
+**Version:** 1.3.0
 **License:** CC BY-NC 4.0
 **Node Requirements:** >= 18.0.0
-**Last Updated:** 2026-02-25
+**Last Updated:** 2026-03-30
 
 ## Architecture
 
-CoKit uses a **sync pipeline architecture** that transforms and merges upstream resources:
+CoKit uses a **sync pipeline architecture** that transforms upstream resources:
 
 ```
-Upstream Sources (ClaudeKit + SpecKit)
+Upstream Source
     ↓
-Transform Modules (Transform ClaudeKit & SpecKit)
-    ↓
-Merge Results
+Transform Module (transform-upstream.mjs)
     ↓
 Patch Navigation (Inject workflow footers)
     ↓
@@ -27,9 +25,8 @@ Output: Unified ck-* Prompts
 ```
 
 ### Sync Pipeline (eng/sync.mjs)
-- **Flow:** Load config → Transform sources → Merge → Patch navigation → Write output
+- **Flow:** Load config → Transform upstream → Patch navigation → Write output
 - **Configuration:** resource-origins.yml (mappings, navigation, ignore list)
-- **Parallel Processing:** ClaudeKit and SpecKit transformations run concurrently
 - **Dry-run Support:** Preview changes without writing files
 
 ## Source Code Structure
@@ -40,9 +37,8 @@ Output: Unified ck-* Prompts
 |------|------|---------|
 | `src/index.js` | 35 LOC | CLI entry point; registers commands (init, add, list, doctor, update) |
 | `bin/cokit.js` | 4 LOC | Binary wrapper; delegates to src/index.js |
-| `eng/sync.mjs` | 97 LOC | Main sync orchestrator; orchestrates transformation and merging |
-| `eng/transform-claudekit.mjs` | 220 LOC | ClaudeKit transformer; resolves files, applies transformations |
-| `eng/transform-speckit.mjs` | 175 LOC | SpecKit transformer; processes upstream/speckit/templates/commands |
+| `eng/sync.mjs` | 85 LOC | Main sync orchestrator; orchestrates transformation |
+| `eng/transform-upstream.mjs` | 220 LOC | Upstream transformer; resolves files, applies transformations |
 | `eng/patch-navigation.mjs` | 69 LOC | Navigation patcher; injects "Suggested Next Steps" footers |
 
 ### Directory Structure
@@ -63,8 +59,7 @@ cokit/
 │       └── update-checker.js        # Version checking
 ├── eng/
 │   ├── sync.mjs                    # Sync orchestrator
-│   ├── transform-claudekit.mjs      # ClaudeKit transformer
-│   ├── transform-speckit.mjs        # SpecKit transformer
+│   ├── transform-upstream.mjs      # Upstream transformer
 │   ├── patch-navigation.mjs         # Navigation footer injection
 │   └── resource-origins.yml         # Configuration (mappings, navigation)
 ├── prompts/                        # Output: Transformed prompts (33 files)
@@ -90,28 +85,26 @@ Registers 5 commands using Commander.js:
 ### 2. Sync Pipeline (eng/sync.mjs)
 **Flow:**
 1. Load resource-origins.yml configuration
-2. Transform ClaudeKit and SpecKit sources in parallel
-3. Merge results (total: 25 prompts)
-4. Apply navigation patches to all prompts
-5. Write output files or show dry-run preview
-6. Update sync timestamps
+2. Transform upstream sources
+3. Apply navigation patches to all prompts
+4. Write output files or show dry-run preview
+5. Update sync timestamps
 
 **Config Structure:**
 ```yaml
 version: '2.0'
 sources:
-  speckit: {repo, ref, path, last_sync}
-  claudekit: {path, last_sync}
+  upstream: {path, last_sync}
 ignore: []            # Commands to skip
-mappings: {}          # Command mappings (24 entries)
+mappings: {}          # Command mappings (16 entries)
 unknown_commands: []  # Tracking unknown sources
 navigation: {}        # Workflow navigation rules
 ```
 
 ### 3. Transform Modules
 
-#### ClaudeKit Transformer (transform-claudekit.mjs)
-**Input:** ~/.claude/commands/ (user's local ClaudeKit)
+#### Upstream Transformer (transform-upstream.mjs)
+**Input:** Upstream commands source
 **Transformations:**
 - Rename: `/*` → `ck-*` namespace
 - Replace: `$ARGUMENTS` → `${input}`
@@ -120,25 +113,12 @@ navigation: {}        # Workflow navigation rules
 - Transform command references in content
 
 **Functions:**
-- `resolveClaudekitPath()` - Expand ~ paths
+- `resolveUpstreamPath()` - Expand ~ paths
 - `findCommandFile()` - Locate command files (handles variations)
 - `transformFile()` - Apply all transformations
 - `transformCommandReference()` - Update handoff commands
 - `transformContentReferences()` - Replace content references
 
-#### SpecKit Transformer (transform-speckit.mjs)
-**Input:** upstream/speckit/templates/commands/
-**Transformations:**
-- Rename: `/speckit-*` → `/ck-*`
-- Replace: `$ARGUMENTS` → `${input}`
-- Remove `model` field from frontmatter
-- Update handoff references to ck-* commands
-
-**Functions:**
-- `transformFile()` - Apply transformations
-- `transformCommandReference()` - Update handoffs (speckit-* → ck-*)
-- `transformContentReferences()` - Replace content references
-
 ### 4. Navigation Patcher (patch-navigation.mjs)
 Injects workflow navigation footers into transformed prompts.
 
@@ -149,10 +129,9 @@ Injects workflow navigation footers into transformed prompts.
 - All commands listed at footer
 
 **Default Patterns:**
-- `brainstorm` → suggest: specify, plan.fast
-- `specify/clarify` → suggest: plan, brainstorm
-- `plan` → suggest: cook, tasks
-- `cook/implement` → suggest: test, fix
+- `brainstorm` → suggest: plan, plan.fast
+- `plan` → suggest: cook, test
+- `cook` → suggest: test, fix
 - `test` → suggest: fix, review
 
 ### 5. Configuration (eng/resource-origins.yml)
@@ -161,20 +140,16 @@ Maintains mappings and sync metadata.
 **Key Sections:**
 - `version` - Config format version
 - `synced_at` - Last sync timestamp
-- `sources.speckit` - SpecKit repo location
-- `sources.claudekit` - ClaudeKit local path (~/.claude/commands)
+- `sources.upstream` - Upstream source path
 - `ignore` - Commands to skip
-- `mappings` - 24 command mappings with origins and descriptions
+- `mappings` - 16 command mappings with origins and descriptions
 - `navigation` - Workflow navigation rules
 - `unknown_commands` - Tracking array for unmapped sources
 
 ## Prompt Inventory
 
-### ClaudeKit Commands (16)
-16 prompts from ~/.claude/commands/ (plan, plan.hard, plan.fast, fix, test, ask, bootstrap, review, watzup, help, brainstorm, cook, scout, git, debug, docs)
-
-### SpecKit Commands (8)
-8 prompts from upstream/speckit (specify, clarify, constitution, plan, tasks, implement, analyze, checklist)
+### Upstream Commands (16)
+16 prompts from upstream source (plan, plan.hard, plan.fast, fix, test, ask, bootstrap, review, watzup, help, brainstorm, cook, scout, git, debug, docs)
 
 ## Dependencies
 
@@ -190,9 +165,8 @@ Maintains mappings and sync metadata.
 ## Scripts
 
 ```bash
-npm run sync              # Pull upstream + transform
-npm run sync:pull        # git subtree pull SpecKit
-npm run sync:transform   # Run transformations only
+npm run sync              # Transform and generate prompts
+npm run sync:transform   # Same as sync
 npm run sync:dry-run     # Preview changes without writing
 npm run test             # Run tests
 npm run build            # Update README
@@ -202,17 +176,14 @@ npm run build            # Update README
 
 ### Sync Operation
 1. **Config Load** - Read resource-origins.yml
-2. **Parallel Transform:**
-   - ClaudeKit: Glob ~/.claude/commands → Transform → Output ck-* prompts
-   - SpecKit: Glob upstream/speckit/templates/commands → Transform → Output ck-* prompts
-3. **Merge** - Combine results (21 total)
-4. **Patch Navigation** - Inject workflow footers
+2. **Transform** - Upstream: Glob source commands → Transform → Output ck-* prompts
+3. **Patch Navigation** - Inject workflow footers
 5. **Write Output** - Create prompt files (prompts/ directory)
 6. **Update Config** - Record sync timestamps
 
 ### File Transformation
 ```
-Input (ClaudeKit)
+Input (Upstream)
 ├── Frontmatter: {name: "plan", ...}
 ├── Content: "Run $ARGUMENTS using /fix command"
 ↓
@@ -230,8 +201,7 @@ Output (ck-*)
 
 ## Error Handling
 
-- **Missing ClaudeKit:** Warns if ~/.claude/commands not found, continues gracefully
-- **Missing SpecKit:** Warns if upstream/speckit not found, continues gracefully
+- **Missing Upstream:** Warns if upstream source not found, continues gracefully
 - **File Not Found:** Logs warning per missing file, adds to skipped array
 - **Transform Errors:** Logs errors per command, collects in results.errors
 - **Unknown Commands:** Tracks in config.unknown_commands for manual mapping
@@ -242,16 +212,15 @@ Output (ck-*)
 2. **Ignore List:** Skip commands via resource-origins.yml
 3. **Dry-run Mode:** Preview all changes before writing
 4. **Navigation Workflow:** Suggested next steps guide users through prompts
-5. **Parallel Processing:** Concurrent ClaudeKit + SpecKit transforms
-6. **Graceful Degradation:** Continues if sources unavailable
+5. **Graceful Degradation:** Continues if source unavailable
 7. **Frontmatter Management:** Preserves metadata, removes model field
 8. **Content Reference Updates:** Transforms all command references to ck-* namespace
 
 ## Version History
 
-- **v1.2.6** (Current) - 25 prompts, 12 agents, 27 skills
+- **v1.2.6** - 25 prompts (with SpecKit, now removed)
 - **v1.2.0** - Initial Copilot port with full resource set
-- **v1.1.0** - 21 prompts (12 ClaudeKit + 9 SpecKit), SpecKit sync pipeline
+- **v1.1.0** - 21 prompts, SpecKit sync pipeline (now removed)
 - **v1.0.9** - Comprehensive documentation update
 - **v1.0.8** - Initial release
 

package/docs/cokit-commands-usage-guide.md

@@ -6,31 +6,21 @@ When to use which command workflow.
 
 | Need | Command | Workflow |
 |------|---------|----------|
-| **Quick implementation** | `ck-plan-fast` | ClaudeKit |
-| **Deep research + plan** | `ck-plan-hard` | ClaudeKit |
-| **Formal spec from idea** | `ck-spec-specify` | SpecKit |
-| **Fix a bug** | `ck-fix` | ClaudeKit |
-| **Run tests** | `ck-test` | ClaudeKit |
+| **Quick implementation** | `ck-plan-fast` | CoKit |
+| **Deep research + plan** | `ck-plan-hard` | CoKit |
+| **Fix a bug** | `ck-fix` | CoKit |
+| **Run tests** | `ck-test` | CoKit |
 
 ---
 
-## Two Workflows
+## Commands
 
-### ClaudeKit (`ck-*`) - Flexible, Fast
-
-Best for: **Day-to-day development**, quick fixes, exploration.
+### CoKit (`ck-*`)
 
 ```
 ck-plan-fast → ck-test → ck-fix
 ```
 
-**When to use:**
-- Fixing bugs
-- Small features (< 1 day)
-- Prototyping
-- Exploratory coding
-- You know what to build
-
 **Commands:**
 | Command | Description |
 |---------|-------------|
@@ -42,34 +32,19 @@ ck-plan-fast → ck-test → ck-fix
 | `ck-ask` | Answer questions |
 | `ck-review` | Review codebase |
 | `ck-bootstrap` | Start new project |
-
----
-
-### SpecKit (`ck-spec-*`) - Structured, Rigorous
-
-Best for: **Complex features**, team collaboration, formal requirements.
-
-```
-ck-spec-specify → ck-spec-clarify → ck-spec-plan → ck-spec-tasks → ck-spec-implement
-```
-
-**When to use:**
-- Multi-day features
-- Requirements need formal spec
-- Multiple stakeholders
-- Need traceability
-- Compliance/audit needs
-
-**Commands:**
-| Command | Description |
-|---------|-------------|
-| `ck-spec-specify` | Create formal spec from idea |
-| `ck-spec-clarify` | Ask clarification questions |
-| `ck-spec-plan` | Generate plan from spec |
-| `ck-spec-tasks` | Break plan into tasks |
-| `ck-spec-implement` | Execute tasks |
-| `ck-spec-analyze` | Check consistency |
-| `ck-spec-checklist` | Validate requirements |
+| `ck-brainstorm` | Brainstorm solutions |
+| `ck-cook` | Implement step by step |
+| `ck-scout` | Fast codebase scouting |
+| `ck-git` | Git operations |
+| `ck-debug` | Systematic debugging |
+| `ck-docs` | Search library docs |
+| `ck-watzup` | Review recent changes |
+| `ck-help` | CoKit usage guide |
+| `ck-ship` | Release pipeline: test→review→commit→push→PR |
+| `ck-deploy` | Deploy to any platform |
+| `ck-security` | STRIDE + OWASP security audit |
+| `ck-project` | Track progress, manage tasks |
+| `ck-frontend` | Build React/TS frontends |
 
 ---
 
@@ -82,12 +57,12 @@ Is this a bug fix?
 Is this < 4 hours work?
   └─ Yes → ck-plan-fast
 
-Do you need formal requirements?
-  └─ Yes → ck-spec-specify → ck-spec-* flow
-  └─ No  → ck-plan-hard → ck-* flow
+Need deep research?
+  └─ Yes → ck-plan-hard
+  └─ No  → ck-plan-fast
 
 Are you exploring/prototyping?
-  └─ Yes → ck-plan-fast (skip spec)
+  └─ Yes → ck-brainstorm → ck-plan-fast
 ```
 
 ---
@@ -109,30 +84,9 @@ Single command. Done.
 
 ### Scenario 3: Payment Integration (Complex Feature)
 ```
-/ck-spec-specify "Integrate Stripe payments for subscriptions"
-/ck-spec-clarify  (answer questions about tiers, regions, etc.)
-/ck-spec-plan
-/ck-spec-tasks
-/ck-spec-implement
+/ck-brainstorm "Integrate Stripe payments for subscriptions"
+/ck-plan-hard "Stripe payment integration"
+→ implement phase by phase
 /ck-test
+/ck-review
 ```
-
----
-
-## Mixing Workflows
-
-You can mix them:
-- Start with `ck-spec-specify` for formal spec
-- Use `ck-fix` when bugs arise during implementation
-- Use `ck-test` regardless of workflow
-
----
-
-## Summary
-
-| Workflow | Best For | Time | Rigor |
-|----------|----------|------|-------|
-| **ClaudeKit** | Daily dev, fixes | Minutes-Hours | Low-Medium |
-| **SpecKit** | Big features, teams | Days-Weeks | High |
-
-**Rule of thumb:** If you can explain it in one sentence, use ClaudeKit. If you need a doc, use SpecKit.

package/docs/cokit-comprehensive-mapping-guide.md

@@ -23,7 +23,7 @@ Complete reference for CoKit GitHub Copilot resource toolkit.
 CoKit transforms GitHub Copilot from basic autocomplete to a structured AI development assistant with:
 
 - **12 Specialized Agents** - Planner, code-reviewer, debugger, tester, researcher, code-simplifier, fullstack-developer, ui-ux-designer, etc.
-- **25 Prompt Templates** - Reusable workflows with `ck-*` and `ck-spec-*` prefixes
+- **17 Prompt Templates** - Reusable workflows with `ck-*` prefix
 - **27 Skill Packages** - Deep expertise in debugging, code-review, planning, frontend-design, databases, devops, etc.
 - **5 Instructions** - Coding standards auto-applied by file pattern (backend, frontend, testing, development, research)
 - **5 Collections** - Bundled resource sets for specific workflows (core, development-rules, documentation, git-workflow, orchestration)
@@ -32,8 +32,6 @@ CoKit transforms GitHub Copilot from basic autocomplete to a structured AI devel
 
 ```bash
 npx cokit-cli init          # Interactive setup
-npx cokit-cli init -g       # Global resources only
-npx cokit-cli init -a       # Both project and global
 ```
 
 ---
@@ -56,13 +54,11 @@ description: 'Clear task description'
 Step-by-step instructions...
 ```
 
-**CoKit Prompts (27 total):**
+**CoKit Prompts (17 total):**
 
-**ClaudeKit (ck-* namespace):** Development workflows - fix, plan, cook, test, review, debug, ask, etc.
+**CoKit (ck-* namespace):** Development workflows - fix, plan, cook, test, review, debug, ask, brainstorm, scout, git, bootstrap, watzup, help, docs, etc.
 
-**SpecKit (ck-spec-* namespace):** Spec-driven workflows - specify, clarify, constitution, plan, tasks, implement, analyze, checklist, etc.
-
-All 25 prompts are unified in a single namespace for seamless workflow navigation.
+All 17 prompts are unified in a single namespace for seamless workflow navigation.
 
 **Usage Example:**
 ```
@@ -163,7 +159,7 @@ items:
 
 ```bash
 cd your-project
-npx cokit-cli init -a
+npx cokit-cli init
 ```
 
 You'll be prompted to choose:
@@ -201,8 +197,6 @@ You'll be prompted to choose:
 | Command | Description |
 |---------|-------------|
 | `npx cokit-cli init` | Interactive setup wizard |
-| `npx cokit-cli init -g` | Install personal skills only |
-| `npx cokit-cli init -a` | Install both project and personal |
 | `npx cokit-cli list` | Show installed components |
 | `npx cokit-cli doctor` | Diagnose setup issues |
 | `npx cokit-cli update` | Update to latest version |
@@ -211,13 +205,13 @@ You'll be prompted to choose:
 
 ## Feature Mapping
 
-### Claude Code → CoKit (Reference)
+### Feature Comparison (Reference)
 
-| Feature | Claude Code | CoKit/Copilot | Notes |
+| Feature | Other AI Tools | CoKit/Copilot | Notes |
 |---------|-------------|---|---|
 | **Commands** | `/fix:types`, `/plan:auto` | `/ck-fix`, `/ck-plan`, `/ck-cook`, etc. | 14 prompts vs sub-commands |
-| **Skills** | `~/.claude/skills/` | `~/.copilot/skills/ck-*/` | Identical structure |
-| **Instructions** | `.claude/instructions/` | `.github/instructions/ck-*.md` | Auto-applied by pattern |
+| **Skills** | Various | `~/.copilot/skills/ck-*/` | Identical structure |
+| **Instructions** | Various | `.github/instructions/ck-*.md` | Auto-applied by pattern |
 | **Agents** | Task delegation | Agent references in prompts | Different invocation model |
 | **Collections** | Not available | `.github/collections/` | NEW: Bundle resources |
 | **Variables** | `$ARGUMENTS`, `$HOME` | User provides context in chat | Manual parameter passing |

package/docs/cokit-slides.md

@@ -61,13 +61,10 @@ npm publish                               Downloads cokit-cli
 
 ## Slide 6: What Users Get
 
-### 25 Prompts (ClaudeKit + SpecKit)
+### 17 Prompts (CoKit)
 
 **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.
+- `/ck-fix`, `/ck-plan`, `/ck-cook`, `/ck-test`, `/ck-review`, `/ck-bootstrap`, `/ck-brainstorm`, `/ck-scout`, `/ck-git`, `/ck-debug`, `/ck-docs`, etc.
 
 All unified in single namespace with cross-navigation.
 
@@ -92,9 +89,7 @@ All unified in single namespace with cross-navigation.
 
 | Option | Command | Location |
 |--------|---------|----------|
-| **Project** | `npx cokit-cli init` | `.github/` |
-| **Personal** | `npx cokit-cli init -g` | `~/.copilot/` |
-| **Both** | `npx cokit-cli init -a` | Both |
+| **Interactive** | `npx cokit-cli init` | Choose: project, global, or both |
 
 ---
 
@@ -209,4 +204,4 @@ npx cokit-cli init    # Always gets latest version
 
 **Full docs:** `docs/cokit-team-presentation.md`
 
-**Quick start:** `npx cokit-cli init -g`
+**Quick start:** `npx cokit-cli init`