k-harness 0.8.1 → 0.8.3

package/README.md

@@ -1,5 +1,9 @@
 # K-Harness
 
+[![npm version](https://img.shields.io/npm/v/k-harness.svg)](https://www.npmjs.com/package/k-harness)
+[![npm downloads](https://img.shields.io/npm/dm/k-harness.svg)](https://www.npmjs.com/package/k-harness)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Project Direction Management Framework for LLM-Driven Development.
 
 ## What It Does
@@ -53,7 +57,7 @@ npx k-harness init --ide antigravity
 |-----|----------------------|--------|--------|
 | **VS Code Copilot** | `.github/copilot-instructions.md` | `.github/skills/*/SKILL.md` | `.github/agents/*.agent.md` |
 | **Claude Code** | `.claude/rules/core.md` | `.claude/skills/*/SKILL.md` | `.claude/skills/*/SKILL.md` |
-| **Cursor** | `.cursor/rules/core.mdc` | `.cursor/rules/*.mdc` | `.cursor/rules/*.mdc` |
+| **Cursor** | `.cursor/rules/core.mdc` | `.cursor/skills/*/SKILL.md` | `.cursor/skills/*/SKILL.md` |
 | **Codex** | `AGENTS.md` | `.agents/skills/*/SKILL.md` | (merged into AGENTS.md) |
 | **Windsurf** | `.windsurfrules` | (merged) | (merged) |
 | **Augment Code** | `.augment/rules/core.md` | `.augment/skills/*/SKILL.md` | `.augment/skills/*/SKILL.md` |
@@ -118,18 +122,18 @@ When goals, technology, or scope changes, run the `pivot` skill:
 
 See [docs/reference.md](docs/reference.md) for detailed descriptions of every skill, agent, rule, and state file.
 
-## Why Not BMAD or gstack?
-
-| | BMAD v6.2.2 | gstack v0.15.1 | K-Harness |
-|---|---|---|---|
-| Focus | Enterprise SDLC methodology | 1-person software factory | Project direction management |
-| Files | 200+ | ~40 | ~20 |
-| Dependencies | Node 20+ | Bun + Node + Playwright | Zero |
-| IDE support | 20+ (installer) | 5 (setup --host) | 7 (native format) |
-| Direction management | ❌ | ❌ | ✅ (Direction Guard + pivot + Decision Log) |
-| Cold start | ❌ | ❌ | ✅ (bootstrap) |
-| State file audit | ❌ | ❌ | ✅ (reviewer Step 8) |
-| Context per task | 4-6 files | 1 file | 2-3 files |
+## Why K-Harness?
+
+| | BMAD v6.2.2 | gstack v0.15.1 | GSD v1.33.0 | K-Harness |
+|---|---|---|---|---|
+| Focus | Enterprise SDLC methodology | 1-person software factory | Full lifecycle automation | Project direction management |
+| Files | 200+ | ~40 | Hundreds | ~20 |
+| Dependencies | Node 20+ | Bun + Node + Playwright | Node 18+ | Zero |
+| IDE support | 20+ (installer) | 5 (setup --host) | 13 (runtime select) | 7 (native format) |
+| Direction management | ❌ | ❌ | ❌ | ✅ (Direction Guard + pivot + Decision Log) |
+| Iron Laws (code quality rules) | ❌ | ❌ | ❌ | ✅ (6 laws embedded in skills) |
+| Cold start | ❌ | ❌ | `/gsd-new-project` | ✅ (`bootstrap` skill) |
+| Context per task | 4-6 files | 1 file | Fresh 200k per plan | 2-3 files (22-line dispatcher) |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "k-harness",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "LLM Development Harness — IDE-agnostic rules, skills, and agents that prevent common AI coding failures",
   "keywords": [
     "llm",

package/src/init.js

@@ -148,30 +148,18 @@ function generateClaude(targetDir, overwrite) {
 }
 
 function generateCursor(targetDir, overwrite) {
-  // .cursor/rules/core.mdc — dispatcher only
+  // .cursor/rules/core.mdc — dispatcher only (always active)
   const coreRules = readTemplate('core-rules.md');
   const coreMdc =
     '---\ndescription: K-Harness dispatcher — workflow guidance and state file references\nalwaysApply: true\n---\n\n' +
     coreRules;
   writeFile(targetDir, '.cursor/rules/core.mdc', coreMdc, overwrite);
 
-  // Skills as rules
-  for (const skill of SKILLS) {
-    const content = readTemplate(`skills/${skill.id}.md`);
-    const mdc =
-      `---\ndescription: Skill — ${skill.id}\nalwaysApply: false\n---\n\n` +
-      content;
-    writeFile(targetDir, `.cursor/rules/${skill.id}.mdc`, mdc, overwrite);
-  }
+  // Skills (.cursor/skills — invokable by mentioning skill name)
+  writeSkills(targetDir, '.cursor/skills', overwrite);
 
-  // Agents as rules
-  for (const agent of AGENTS) {
-    const content = readTemplate(agent.file);
-    const mdc =
-      `---\ndescription: Agent — ${agent.id}\nalwaysApply: false\n---\n\n` +
-      content;
-    writeFile(targetDir, `.cursor/rules/${agent.id}.mdc`, mdc, overwrite);
-  }
+  // Agents as skills
+  writeAgentsAsSkills(targetDir, '.cursor/skills', overwrite);
 
   // State files
   writeStateFiles(targetDir, overwrite);