@skyf0xx/hedgehog 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Will
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -16,7 +16,7 @@ A complete development methodology combining:
 
 **Build faster, Save context**. Stay aligned. Ship software you can still understand six months later.
 
-![Hedgehog — build software the right way, one step at a time](docs/images/hero.png)
+![Hedgehog — build software the right way, one step at a time](https://raw.githubusercontent.com/skyf0xx/hedgehog/master/docs/images/hero.png)
 
 ## Hedgehog gives AI
 
@@ -31,7 +31,7 @@ A complete development methodology combining:
 - 🌳 **Self-documenting architecture:** the codebase carries the context, not the AI
 - 🔁 **Traceable evolution:** decisions are preserved through conventional commits
 
-![Just describe what you want](docs/images/curve.png)
+![Just describe what you want](https://raw.githubusercontent.com/skyf0xx/hedgehog/master/docs/images/curve.png)
 
 ## Why Hedgehog Exists
 
@@ -60,7 +60,7 @@ Backend comes first. Every module gets a working, typed API before any screen is
 
 The build order is not something you negotiate with the AI. It is encoded into the process.
 
-![Small steps, big leverage: small context loops, continuous verification, traceable evolution, sustainable velocity](docs/images/small-steps.png)
+![Small steps, big leverage: small context loops, continuous verification, traceable evolution, sustainable velocity](https://raw.githubusercontent.com/skyf0xx/hedgehog/master/docs/images/small-steps.png)
 
 ## The Hedgehog Loop
 
@@ -79,43 +79,21 @@ Repeat for the next module or the next step
 ```
 
 
-![Why Hedgehog works: a different way to build with AI, comparing traditional AI workflow to Hedgehog](docs/images/why.png)
+![Why Hedgehog works: a different way to build with AI, comparing traditional AI workflow to Hedgehog](https://raw.githubusercontent.com/skyf0xx/hedgehog/master/docs/images/why.png)
 
 ## Installation
 
-Hedgehog installs **into your repo**, not into your editor. The agents and
-skills land in `.claude/` and get committed alongside your code — because
-the discipline is only real if it travels with the project, versioned and
-visible to your team and CI.
-
-From the root of the repo you want to build with Hedgehog:
+From an empty project folder:
 
 ``` bash
 npx @skyf0xx/hedgehog init
 ```
 
-This copies:
-
-- `src/agents/*` → `.claude/agents/` — the `planner`, `ui-builder`, and
-  `reviewer` roles
-- `src/skills/*` → `.claude/skills/` — `hedgehog-bootstrap`,
-  `hedgehog-loop`, and `conventional-commits`
-- `CLAUDE.md` and `TODO.md` templates into the repo root
-
-If a target file already exists, `init` warns and stops without touching
-it. Re-run with `--force` to overwrite:
-
-``` bash
-npx @skyf0xx/hedgehog init --force
-```
-
-Then commit the `.claude/` payload, open Claude Code, and say:
+Then open Claude Code and say:
 
 > bootstrap this project
 
-That triggers the `hedgehog-bootstrap` skill, which scaffolds the stack and
-wires the enforcement config (Nx boundaries, lefthook, commitlint, phase
-gate). From there, `hedgehog-loop` takes over one module at a time.
+Or paste the repo URL to your Agent and have it install for you.
 
 ## For Builders
 

package/bin/cli.mjs

@@ -33,6 +33,9 @@ const PLAN = [
   { type: 'dir', from: 'src/skills', to: '.claude/skills' },
   { type: 'file', from: 'src/templates/CLAUDE.md', to: 'CLAUDE.md' },
   { type: 'file', from: 'src/templates/TODO.md', to: 'TODO.md' },
+  // A minimal root package.json so bootstrap's `nx init` scaffolds a real
+  // pnpm workspace rather than falling into standalone (.nx wrapper) mode.
+  { type: 'file', from: 'src/templates/package.json', to: 'package.json' },
 ];
 
 const exists = (p) =>
@@ -127,7 +130,7 @@ async function init({ force }) {
     )}\n`,
   );
   console.log('Next steps:');
-  console.log(`  1. ${bold('git add .claude CLAUDE.md TODO.md && git commit')}`);
+  console.log(`  1. ${bold('git add .claude CLAUDE.md TODO.md package.json && git commit')}`);
   console.log(`  2. Open Claude Code and say: ${bold('"bootstrap this project"')}\n`);
 }
 

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@skyf0xx/hedgehog",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Install the Hedgehog build discipline (agents + skills) into a repo.",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/skyf0xx/hedgehog.git"
+  },
   "publishConfig": {
     "access": "public"
   },

package/src/skills/hedgehog-bootstrap/SKILL.md

@@ -103,12 +103,34 @@ config step at its source, per `hedgehog-loop`), not a re-scaffold.
 
 ### 1. Nx workspace + `packages/config`
 
+The installer has already placed files at the repo root (`.claude/`, the
+`CLAUDE.md`/`TODO.md` templates, a minimal root `package.json`, and git).
+`create-nx-workspace` refuses a non-empty directory, so scaffold Nx *in
+place* instead — `nx init` tolerates the existing files and merges into
+them (appends to `.gitignore`, injects an Nx block into `CLAUDE.md` between
+marker comments, adds `nx` to the root `package.json`):
+
+```bash
+npx nx@latest init
+pnpm add -D @nx/js
+```
+
+`nx init` needs the root `package.json` the installer dropped — without
+one it falls into standalone (`.nx` wrapper) mode instead of a proper
+pnpm workspace.
+
+Then generate the first lib. The **first** `@nx/js:lib` call materializes
+the whole workspace shape (`tsconfig.base.json`, root `eslint.config.mjs`,
+`.prettierrc`, `vitest.workspace.ts`, the `packages/` layout, and the
+tsconfig `paths` mapping) — the same scaffolding the `ts` preset would
+have produced, generated lazily on first use:
+
 ```bash
-npx create-nx-workspace@latest . --preset=ts --pm=pnpm --nxCloud=skip
+npx nx g @nx/js:lib packages/config --bundler=none --unitTestRunner=vitest
 ```
 
-Scaffold `packages/config` as a plain `@nx/js` lib holding the locked,
-shared files:
+`packages/config` is a plain `@nx/js` lib holding the locked, shared
+files:
 
 - `packages/config/eslint-base.js` — flat config, extended by every
   app/lib. Include `@nx/enforce-module-boundaries` and `depConstraints`

package/src/templates/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "app",
+  "private": true,
+  "packageManager": "pnpm@9.0.0"
+}