@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
package/src/agents/tweaker.md
CHANGED
|
@@ -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 `
|
|
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 `
|
|
219
|
-
|
|
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.
|
|
@@ -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
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
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
|
|
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
|
|
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,
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|