@skyf0xx/hedgehog 6.2.16 → 6.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@skyf0xx/hedgehog",
3
- "version": "6.2.16",
3
+ "version": "6.2.17",
4
4
  "description": "Install the Hedgehog build discipline (agents + skills) into a repo, for Claude Code, Cursor, or Gemini CLI.",
5
5
  "type": "module",
6
6
  "repository": {
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tweaker
3
- description: Use when a change request lands on a project that already has a build graph and nothing in flight (`hedgehog status --brief` names no task) — a finished build being adjusted, or an adopted repo's next piece of work — and the user is offered a fresh-context session to iterate. Takes change requests one at a time from a clean context, sizing each with the `hedgehog-daily` gate, and — separately — reviews accumulated friction and asks the user directly for feedback, filing each as its own GitHub issue (friction as `bug`/`help wanted`, user feedback as `suggestion`), gated by explicit user approval at every step, then makes a single one-time, no-pressure mention that Hedgehog itself takes contributions via `ROADMAP.md`. Shared by every core, the `adopted` core included.
3
+ description: Use when a change request lands on a project that already has a build graph and nothing in flight (`hedgehog status --brief` names no task) — a finished build being adjusted, or an adopted repo's next piece of work — and the user is offered a fresh-context session to iterate. Takes change requests one at a time from a clean context, sizing each with the `hedgehog-daily` gate, and — separately — reviews accumulated friction and asks the user directly for feedback, filing each as its own GitHub issue (friction as `bug`/`help wanted`, user feedback as `suggestion`), gated by explicit user approval at every step, then makes a single one-time, no-pressure mention that Hedgehog itself takes contributions via its `roadmap`-labeled issues. Shared by every core, the `adopted` core included.
4
4
  model: sonnet
5
5
  color: green
6
6
  tools: Read, Glob, Grep, Edit, Write, Bash
@@ -215,9 +215,9 @@ discipline as `.hedgehog/BMAD/`. A later related incident is its own new
215
215
  again starts from zero.
216
216
  - **Once, after the above is done** (regardless of whether anything
217
217
  was actually filed): mention plainly that Hedgehog itself takes
218
- contributions, and that `ROADMAP.md` in the Hedgehog repo has scoped
219
- items — including small, single-session ones — for anyone who wants
220
- to fix something rather than just report it. One sentence, then
218
+ contributions, and that issues labeled `roadmap` in the Hedgehog repo
219
+ are scoped — including small, single-session ones — for anyone who
220
+ wants to fix something rather than just report it. One sentence, then
221
221
  drop it either way; a "no" or no response is not a prompt to explain
222
222
  further or ask again later in this session. If the user says yes,
223
223
  hand off to the `hedgehog-contributing` skill.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hedgehog",
3
- "version": "6.2.16",
3
+ "version": "6.2.17",
4
4
  "description": "Hedgehog build discipline: ordered, tested, verified build steps.",
5
5
  "contextFileName": "GEMINI.md"
6
6
  }
@@ -54,19 +54,14 @@ Group by step first, module second. A hunk in the `orders` schema and a
54
54
  hunk in the `orders` repository are different commits even though both
55
55
  are "orders" — different steps.
56
56
 
57
- Common groupings:
58
- - A schema change + its Drizzle migration
59
- - A service + its unit test (tests land with the step they test, not a
60
- trailing "add tests" commit)
61
- - A Correction Protocol fix to an upstream step, split from each
62
- fast-forwarded dependent step
63
- - Config/tooling changes (lefthook, eslint boundaries, env schema)
64
- isolated from any domain step
65
-
66
- Do NOT group:
67
- - Two different build steps, even for the same module
68
- - A Correction Protocol fix mixed with unrelated new work
69
- - Two unrelated modules' changes
57
+ Group together: a schema change with its Drizzle migration; a service
58
+ with its unit test (tests land with the step they test, not a trailing
59
+ "add tests" commit); config/tooling changes (lefthook, eslint boundaries,
60
+ env schema) isolated from any domain step.
61
+
62
+ Keep separate: different build steps, even for the same module; a
63
+ Correction Protocol fix from the unrelated new work it landed alongside;
64
+ different modules' changes.
70
65
 
71
66
  ### 3. Order the commits for review
72
67
 
@@ -77,7 +72,6 @@ Do NOT group:
77
72
  Correction Protocol cleanup — the fix commit needs to make sense
78
73
  before the commits that changed because of it.
79
74
  3. **Mechanical before novel.** Config, generated files, renames first.
80
- 4. **Tests alongside the step they test**, same commit.
81
75
 
82
76
  ### 4. Propose the plan, then execute
83
77
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: hedgehog-contributing
3
- description: Use when the user wants to contribute a fix or ROADMAP.md item back to the Hedgehog project itself (skyf0xx/hedgehog) rather than their own project. Triggers on "let's fix that in Hedgehog", "I want to contribute", "let's pick up a roadmap item", or when `tweaker` offers this at the end of a build and the user says yes. Covers forking/branching, making the change under Hedgehog's own repo rules, committing with Conventional Commits, and opening the PR.
3
+ description: Use when the user wants to contribute a fix or roadmap item back to the Hedgehog project itself (skyf0xx/hedgehog) rather than their own project. Triggers on "let's fix that in Hedgehog", "I want to contribute", "let's pick up a roadmap item", or when `tweaker` offers this at the end of a build and the user says yes. Covers forking/branching, making the change under Hedgehog's own repo rules, committing with Conventional Commits, and opening the PR.
4
4
  ---
5
5
 
6
6
  # Contributing to Hedgehog
@@ -13,14 +13,15 @@ which is a different repo with different rules.
13
13
 
14
14
  ## When this runs
15
15
 
16
- - The user names a specific gap (a bug they hit, a `ROADMAP.md` item) and
16
+ - The user names a specific gap (a bug they hit, a roadmap item) and
17
17
  wants to fix it in Hedgehog rather than work around it locally.
18
18
  - `tweaker` offered this at the end of a build and the user said yes.
19
19
 
20
- If the user hasn't picked a target yet, read `ROADMAP.md` at the Hedgehog
21
- repo root with them and let them choose an item — prefer the "Small items"
22
- tier for a first contribution, since each entry there is scoped to one file
23
- or one narrow addition.
20
+ If the user hasn't picked a target yet, browse issues labeled
21
+ [`roadmap`](https://github.com/skyf0xx/hedgehog/issues?q=is%3Aissue+is%3Aopen+label%3Aroadmap)
22
+ with them and let them choose one prefer an issue also labeled
23
+ `good-first-issue` for a first contribution, since those are scoped to one
24
+ file or one narrow addition.
24
25
 
25
26
  ## Before starting
26
27
 
@@ -63,7 +64,7 @@ paragraph.
63
64
  `feat/`, `fix/`, or `docs/` prefix matching the change, e.g.
64
65
  `feat/windsurf-host` or `fix/tweaker-job2-wording`.
65
66
  3. **Make the change**, scoped to what `CONTRIBUTING.md` and the target
66
- `ROADMAP.md` item actually call for — resist scope creep onto adjacent
67
+ roadmap issue actually call for — resist scope creep onto adjacent
67
68
  files even if you notice something else worth fixing; that's a separate
68
69
  PR.
69
70
  4. **Verify the install path locally** before committing, per
@@ -90,8 +91,7 @@ paragraph.
90
91
  The body follows `pr-writing`'s shape (a short Summary, a Test plan
91
92
  listing what was actually run — for this repo, `node bin/cli.mjs init`
92
93
  in a scratch dir, confirming the change lands correctly). If the PR
93
- closes or addresses a `ROADMAP.md` item or a filed issue, reference it
94
- (`Addresses the "<item name>" item in ROADMAP.md`, or `Fixes #<n>`).
94
+ closes or addresses a roadmap issue, reference it (`Fixes #<n>`).
95
95
  7. **Check CI** with `gh pr checks <number> --repo skyf0xx/hedgehog` after
96
96
  opening. Fix a red check before asking for review.
97
97
  8. **Report the PR URL** `gh` returns and stop — don't merge, don't push
@@ -61,7 +61,7 @@ as a record of the work session.
61
61
  ## Why/What for issues
62
62
 
63
63
  An issue proposing a change — a feature, a fix worth explaining, a
64
- `ROADMAP.md` item being picked up — states **Why** before **What**:
64
+ roadmap item being picked up — states **Why** before **What**:
65
65
 
66
66
  - **Why**: the problem, as a short list of plain-language facts. Each
67
67
  bullet is one observation a reader can verify or disagree with, not a