knowzcode 0.3.7 → 0.5.2

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official KnowzCode plugin marketplace - Platform-agnostic AI development methodology",
-    "version": "0.3.7"
+    "version": "0.5.2"
   },
   "plugins": [
     {
       "name": "kc",
       "source": "./",
       "description": "KnowzCode - Platform-agnostic AI development methodology with TDD, quality gates, and structured workflows",
-      "version": "0.3.7",
+      "version": "0.5.2",
       "author": {
         "name": "Alex Headscarf"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "kc",
   "description": "KnowzCode - Platform-agnostic AI development methodology with TDD, quality gates, and structured workflows",
-  "version": "0.3.7",
+  "version": "0.5.2",
   "author": {
     "name": "Alex Headscarf"
   }

package/README.md

@@ -6,7 +6,7 @@
 
 [![License: MIT + Commons Clause](https://img.shields.io/badge/License-MIT_+_Commons_Clause-yellow.svg)](LICENSE)
 [![Claude Code Plugin](https://img.shields.io/badge/Claude_Code-Plugin-purple)](https://github.com/knowz-io/knowzcode)
-[![Version](https://img.shields.io/badge/version-0.3.7-blue)](https://github.com/knowz-io/knowzcode/releases)
+[![Version](https://img.shields.io/badge/version-0.5.2-blue)](https://github.com/knowz-io/knowzcode/releases)
 
 [Installation](#installation) · [Quick Start](#quick-start) · [When to Use It](#when-to-use-knowzcode) · [How It Works](#how-it-works) · [Commands](#commands) · [Docs](#documentation)
 
@@ -31,7 +31,7 @@ KnowzCode is a **platform-agnostic development methodology** that lives in your
 - **Living Documentation** — Architecture diagrams and specs auto-update as code changes
 - **Session Memory** — WorkGroups track complete context so nothing is lost between sessions
 - **Interruption Recovery** — Say "continue" to resume exactly where you left off
-- **Multi-Platform** — Works with Claude Code, Codex, Gemini, Cursor, Copilot, and Windsurf
+- **Multi-Platform** — First-class support for Claude Code, OpenAI Codex, and Gemini CLI, with adapters for Cursor, Copilot, and Windsurf
 
 ## When to Use KnowzCode
 
@@ -91,7 +91,7 @@ cd your-project/
 
 ```bash
 npx knowzcode                                    # Interactive setup
-npx knowzcode install --platforms claude,cursor   # Specific platforms
+npx knowzcode install --platforms claude,gemini   # Specific platforms
 npx knowzcode install --platforms all             # All 6 platforms
 ```
 
@@ -99,28 +99,37 @@ Commands available as `/work`, `/plan`, `/fix` (without `kc:` prefix).
 For `/kc:` prefix, also run: `/plugin install kc@knowzcode`.
 
 <details>
-<summary><strong>Supported Platforms (6)</strong></summary>
+<summary><strong>Supported Platforms</strong></summary>
 
-| Platform | Instruction File | Support Level |
-|----------|-----------------|---------------|
-| Claude Code | `CLAUDE.md` | Full support (plugin + agents + commands) |
-| Gemini CLI | `GEMINI.md` + `.gemini/commands/kc/*.toml` | Native `/kc:` commands + instruction file |
-| OpenAI Codex | `AGENTS.md` | Instruction file + SKILL.md format |
-| Cursor | `.cursor/rules/*.mdc` + `.cursor/commands/*.md` | Rules + commands (beta) |
-| GitHub Copilot | `.github/copilot-instructions.md` + `.github/prompts/kc-*.prompt.md` | Full support (instructions + 9 prompt files + MCP) |
-| Windsurf | `.windsurf/rules/*.md` + `.windsurf/workflows/*.md` | Rules + workflows |
+**Primary (full support):**
+
+| Platform | Generated Files | Support Level |
+|----------|----------------|---------------|
+| Claude Code | `CLAUDE.md` + `.claude/{agents,commands,skills}/` | Plugin + 14 agents + 11 commands |
+| OpenAI Codex | `AGENTS.md` + `.agents/skills/kc-*/SKILL.md` (12 skills) | Instruction file + discoverable skill files |
+| Gemini CLI | `GEMINI.md` + `.gemini/commands/kc/*.toml` (12 commands) + `.gemini/skills/kc-*/SKILL.md` (12 skills) + `.gemini/agents/kc-*.md` (14 subagents, experimental) | Native commands + skills + subagents + instruction file |
+
+**Experimental (functional, under refinement):**
+
+| Platform | Generated Files | Support Level |
+|----------|----------------|---------------|
+| GitHub Copilot | `.github/copilot-instructions.md` + `.github/prompts/kc-*.prompt.md` (9 prompts) + `.vscode/mcp.json` | Instruction file + prompt files + MCP |
+| Cursor | `.cursor/rules/knowzcode.mdc` | Rules file (commands via `.cursor/commands/` beta) |
+| Windsurf | `.windsurf/rules/knowzcode.md` | Rules file (workflows via `.windsurf/workflows/`) |
 
 </details>
 
-### Manual (No Node.js)
+### Manual (Repo Clone)
 
 ```bash
 git clone https://github.com/knowz-io/knowzcode.git
 cd KnowzCode
-./install.sh --target /path/to/your/project       # Linux/macOS
-.\install.ps1 -Target C:\path\to\your\project     # Windows
+./install.sh install --target /path/to/your/project   # Linux/macOS
+.\install.ps1 install --target C:\path\to\your\project # Windows
 ```
 
+`install.sh` and `install.ps1` are thin wrappers that delegate to the Node.js installer (`bin/knowzcode.mjs`). Node.js 18+ is required.
+
 ### Cloud Features (Optional)
 
 Connect to KnowzCode Cloud for vector-powered semantic search, AI Q&A, and learning capture via MCP. See the [Getting Started Guide](./docs/knowzcode_getting_started.md#mcp-integration-cloud-features) for setup.
@@ -184,8 +193,7 @@ Layer 1: Core Methodology (platform-agnostic, the actual product)
 ```
 
 The real product is Layer 1 — the `knowzcode/` directory. Everything else enhances it.
-On Claude Code, Layer 4 provides 14 specialized agents (11 core + 3 opt-in specialists) with parallel orchestration.
-On other platforms, the AI follows the same methodology directly.
+On Claude Code, Layer 4 provides 14 specialized agents with parallel orchestration. Codex and Gemini get discoverable skills and native commands. Other platforms follow the same methodology via adapter instruction files.
 See [Understanding KnowzCode](./docs/understanding-knowzcode.md) for a deep dive.
 
 ## Execution Modes
@@ -251,7 +259,53 @@ Specialists communicate directly with builders (max 2 DMs each) and report findi
 
 See the [Workflow Reference](./docs/workflow-reference.md) for detailed orchestration flows.
 
-### GitHub Copilot
+### OpenAI Codex
+
+Codex users get discoverable skills via `.agents/skills/kc-*/`:
+
+```bash
+/kc:work "Build user authentication"  # Start feature workflow
+/kc:plan "how is auth implemented?"   # Research first
+/kc:fix "Fix login bug"               # Quick fix
+/kc:audit                             # Quality audit
+```
+
+Generated by `npx knowzcode install --platforms codex` into `.agents/skills/`.
+
+For cross-project availability, install skills globally:
+```bash
+npx knowzcode install --platforms codex --global   # Skills → ~/.agents/skills/kc-*/
+```
+
+### Gemini CLI
+
+Gemini users get native `/kc:` commands via TOML files, discoverable skills, and optional subagents:
+
+```bash
+/kc:work "Build JWT authentication"   # Start feature workflow
+/kc:plan "how is auth implemented?"   # Research first
+/kc:fix "Fix login redirect bug"      # Quick fix
+/kc:audit                             # Quality audit
+/kc:continue                          # Resume where you left off
+/kc:connect-mcp <api-key>            # Configure MCP
+/kc:telemetry "500 errors in prod"   # Investigate telemetry
+```
+
+Generated by `npx knowzcode install --platforms gemini` into `.gemini/commands/kc/`, `.gemini/skills/kc-*/`, and `.gemini/agents/kc-*.md`.
+
+For cross-project availability, install skills globally:
+```bash
+npx knowzcode install --platforms gemini --global   # Skills → ~/.gemini/skills/kc-*/
+```
+
+Subagents (experimental) require `experimental.enableAgents: true` in Gemini `settings.json`.
+
+### Other Platforms (Experimental)
+
+Adapters for Cursor, GitHub Copilot, and Windsurf are functional but under active refinement. The AI follows the same methodology phases sequentially — reading prompt templates from `knowzcode/prompts/` and following the same quality gates.
+
+<details>
+<summary><strong>GitHub Copilot</strong></summary>
 
 Copilot users invoke phases via prompt files in VS Code Copilot Chat:
 
@@ -266,9 +320,14 @@ Copilot users invoke phases via prompt files in VS Code Copilot Chat:
 
 Generated by `/kc:init` into `.github/prompts/`. See `knowzcode/copilot_execution.md` for details.
 
-### Other Platforms
+</details>
 
-Gemini, Cursor, Codex, and Windsurf follow the same methodology phases sequentially — the AI reads prompt templates from `knowzcode/prompts/` and follows the same quality gates. No agent orchestration is needed.
+<details>
+<summary><strong>Cursor & Windsurf</strong></summary>
+
+Cursor generates a `.cursor/rules/knowzcode.mdc` rules file. Windsurf generates `.windsurf/rules/knowzcode.md`. Both follow methodology phases via prompt templates with no agent orchestration needed.
+
+</details>
 
 ## Project Structure