create-harness-vibe-coding 0.1.2 → 0.1.3

package/README.md

@@ -0,0 +1,169 @@
+<p align="center">
+  <img src="https://img.shields.io/npm/v/create-harness-vibe-coding?color=blue" alt="npm version">
+  <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="node">
+  <img src="https://img.shields.io/npm/l/create-harness-vibe-coding" alt="license">
+  <img src="https://img.shields.io/github/stars/zingspark/create-harness-vibe-coding?style=social" alt="stars">
+</p>
+
+<h1 align="center">⚡ create-harness-vibe-coding</h1>
+<p align="center">
+  <b>4 seconds from zero to a production-grade agentic harness.</b><br>
+  <sub>CLAUDE.md → docs/ → .claude/ → tests/ — ECC-ready, Superpowers-compatible.</sub>
+</p>
+
+---
+
+## 🎯 One Command
+
+```bash
+npx create-harness-vibe-coding@latest my-project
+```
+
+| What You Get | Count |
+|-------------|-------|
+| Architecture docs (layers, data flow, state machines, port contracts) | 9 docs |
+| Agent definitions (code-reviewer, risk-auditor, etc.) | ECC-ready skeleton |
+| Workflow skills (TDD, backtest, data pipeline) | ECC-ready skeleton |
+| Coding rules (universal + language-specific) | common.md included |
+| Settings & hooks (permissions, automation) | pre-configured |
+| **Total files provisioned** | **17 docs + configs** |
+
+---
+
+## 🚀 Why This Exists
+
+Every Claude Code project has the same cold-start problem:
+
+| Without Harness | With `create-harness-vibe-coding` |
+|---|---|
+| ❌ Agents skip docs, hallucinate behavior | ✅ CLAUDE.md routes agents to exact docs by role |
+| ❌ No TDD enforcement — agents ship untested code | ✅ agent-workflow.md enforces RED-GREEN-REFACTOR |
+| ❌ Architecture boundaries blur over time | ✅ domain/ports.md locks layer contracts |
+| ❌ State machines live in someone's head | ✅ state-machines.md documents every transition |
+| ❌ Cross-session memory lost | ✅ MEMORY.md + self-learning system |
+| ❌ 2+ hours to set up project structure | ✅ **4 seconds** |
+
+---
+
+## 🧠 How It Works
+
+```mermaid
+graph LR
+    A[npx scaffold] --> B[CLAUDE.md + docs/ + .claude/]
+    B --> C[Start Claude Code]
+    C --> D[Claude reads SETUP.md]
+    D --> E[Pulls agents/skills/rules from ECC]
+    E --> F[Project ready — TDD loop active]
+```
+
+### What happens after `npx`:
+
+1. **CLAUDE.md** — Agent reads this first. Role-based routing table sends each agent to the right docs.
+2. **docs/architecture.md** — Clean architecture layers. Harness runs the shell; domain defines the business.
+3. **docs/agent-workflow.md** — TDD loop, subagent roles, write set rules, conflict resolution.
+4. **docs/data-flow.md** — Every event's normal path + failure branches — the #1 doc AI fabricates without.
+5. **docs/state-machines.md** — Every stateful component. Transition table. Illegal transitions explicitly denied.
+6. **.claude/settings.json** — Permissions pre-configured (allow git/npm/pytest, deny rm/sudo/curl). Hooks ready.
+7. **SETUP.md** — Temporary guide. Claude reads it, pulls agents/skills/rules from [ECC](https://github.com/affaan-m/ECC). User deletes it after.
+
+---
+
+## 📦 What's Inside
+
+```
+my-project/
+├── CLAUDE.md              ← Role-based doc navigation + memory/self-learning
+├── AGENTS.md              ← Coding agent entry
+├── MEMORY.md              ← Cross-session resource index
+├── SETUP.md               ← Temporary init guide (delete after setup)
+├── .gitignore
+├── docs/
+│   ├── README.md          ← Project doc entry point
+│   ├── harness/
+│   │   ├── architecture.md       ← Layer rules, components, ADRs
+│   │   ├── agent-workflow.md     ← TDD loop, subagent roles, write sets
+│   │   ├── data-flow.md          ← Event lifecycle: normal + failure paths
+│   │   └── state-machines.md     ← State enums, transition tables, guards
+│   ├── domain/
+│   │   └── ports.md              ← Port contracts: pre/postconditions, errors
+│   ├── features/
+│   │   └── _template.md          ← Kiro-lite feature doc template
+│   └── research/
+│       ├── PRD.md                ← MVP scope & acceptance template
+│       └── scaffolds.md          ← Tech research & decision record
+├── .claude/
+│   ├── settings.json     ← Permissions + hooks
+│   ├── agents/           ← Pull from ECC
+│   ├── skills/           ← Pull from ECC
+│   ├── hooks/            ← Configure as needed
+│   └── rules/ecc/
+│       └── common.md     ← Universal coding rules (always active)
+└── tests/                ← Your test suite goes here
+```
+
+---
+
+## 🌐 Ecosystem Compatibility
+
+| Platform | Status |
+|----------|--------|
+| [ECC](https://github.com/affaan-m/ECC) (206K+ ★) | ✅ Agents, skills, rules auto-pull |
+| [Superpowers](https://github.com/obra/superpowers) (185K+ ★) | ✅ `/plugin install superpowers` |
+| [awesome-claude-code-config](https://github.com/Mizoreww/awesome-claude-code-config) | ✅ Rules & self-learning configs |
+| [claude-toolbox](https://github.com/serpro69/claude-toolbox) | ✅ Multi-language skills |
+| Claude Code | ✅ Native settings.json + hooks |
+| Codex / Cursor / Gemini CLI | ✅ Compatible (docs-only pattern) |
+
+---
+
+## 🔧 Usage
+
+```bash
+# Interactive mode
+npx create-harness-vibe-coding@latest
+
+# Non-interactive (CI/CD)
+npx create-harness-vibe-coding@latest my-app ./dist/my-app
+
+# Always get the latest version
+npx create-harness-vibe-coding@latest my-project
+```
+
+### After scaffolding, tell Claude:
+
+```
+"Read SETUP.md. This is a Python quant project. Pull agents, skills, and rules from ECC."
+"Read SETUP.md. This is a React TypeScript app. I need TDD workflow and code review."
+"Read SETUP.md. This is a Go microservice. Set up matching agents and testing skills."
+```
+
+---
+
+## 📊 Performance
+
+| Metric | Value |
+|--------|-------|
+| Cold install + scaffold | < 4s |
+| Package size | 19.9 kB |
+| Unpacked | 49.4 kB |
+| Dependencies | 2 (@clack/prompts, picocolors) |
+| Node requirement | ≥ 18 |
+| Zero runtime deps after scaffold | ✅ |
+
+---
+
+## 👥 Contributing
+
+PRs welcome. The template docs live in `templates/common/` — edit them to change what gets scaffolded.
+
+---
+
+## 📄 License
+
+MIT © [zingspark](https://github.com/zingspark)
+
+---
+
+<p align="center">
+  <sub>Built for the vibe-coding era. Scaffold fast, build faster.</sub>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-harness-vibe-coding",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Scaffold a vibe-coding agentic harness — CLAUDE.md, docs/, .claude skeleton ready for ECC agents/skills/rules",
   "type": "module",
   "bin": {
@@ -23,8 +23,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/LiWeny16/q-profit.git",
-    "directory": "create-harness-vibe-coding"
+    "url": "https://github.com/zingspark/create-harness-vibe-coding.git"
   },
   "keywords": [
     "claude-code",