@skyf0xx/hedgehog 2.0.5 → 2.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyf0xx/hedgehog",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "description": "Install the Hedgehog build discipline (agents + skills) into a repo.",
   "type": "module",
   "repository": {

package/src/agents/landing-copywriter.md

@@ -93,7 +93,18 @@ directly while writing, not as a pass after:
    `landing-systems`'s voice spec and token system, `landing-sequencer`'s
    section list and beat structure — not a summary of any of them.
 2. Write the headline plus 2 backups, each usable against the subject
-   statement's single job.
+   statement's single job. **The reader wants an outcome, not the
+   mechanism that produces it** — the headline's grammatical subject must
+   be what the reader gets (what changes for them, what they now have or
+   no longer have to worry about), not the product, feature, or mechanism
+   that delivers it. A headline built from the subject statement's own
+   phrasing ("ZenBin is one cryptographic trust primitive...") tends to
+   smuggle the mechanism into the subject position by default — naming it
+   is not the same as leading with it. Demote the mechanism one level: it
+   belongs in the subhead or the sentence right after, earning its
+   specificity once the outcome has already landed. If a backup headline
+   only works because the reader already knows what the mechanism is
+   for, it's failing this test, not passing it narrowly.
 3. Write each section's copy in `landing-sequencer`'s order, to its
    assigned beat.
 4. Write CTA text, checked against the token system's CTA styling intent
@@ -119,6 +130,16 @@ directly while writing, not as a pass after:
 - The headline and every section trace to a named adjective or the
   subject statement — a line that could run on a competitor's page
   unchanged (the swap test, applied to copy specifically) gets rewritten.
+- **The headline's subject is the reader's outcome, not the mechanism.**
+  Read only the headline, with no subhead for context: does it state
+  what the reader gets, or does it name the thing that gets it to them?
+  "One signature. Three uses." fails this (the signature is the
+  subject); "Your agent's work outlives the session that made it."
+  passes (the outcome is the subject, and "signature" doesn't need to
+  appear at all). If the headline's first noun phrase is the product,
+  the feature, or the underlying mechanism rather than the change in the
+  reader's situation, rewrite it before presenting — don't let it pass
+  because it's otherwise on-voice and traceable.
 
 ## Constraints
 

package/src/agents/landing-strategist.md

@@ -27,7 +27,8 @@ literally.
 
 **In:** raw brief (from `planner`'s planning intake,
 `.hedgehog/chain/00-brief.md`)
-**Out:** one-paragraph subject/audience/job statement
+**Out:** one-paragraph subject/audience/job statement, confirmed by the
+user before Step 2 starts
 
 Name the concrete subject, its audience, and the page's single job. If
 the brief doesn't pin this down, state the assumption explicitly rather
@@ -35,6 +36,28 @@ than proceeding on vagueness — an unstated assumption here is the single
 most expensive thing to get wrong, since every later phase inherits it
 silently.
 
+**Plain-verb check (run before presenting the statement):** restate the
+subject in one sentence using only the concrete verb a builder would use
+describing it out loud — no abstraction noun ("primitive," "mechanism,"
+"infrastructure layer") standing in for the verb. If that plain-verb
+sentence doesn't foreground the same verb as the formal subject
+statement, the statement has already been abstracted past what the user
+actually said — tighten it, or if there's a genuine choice between
+leading with the action versus the mechanism behind it, that's not yours
+to resolve silently.
+
+**Confirm the statement before Step 2.** Show the user the subject/
+audience/job statement in plain language — not the finished prose, the
+one-line "here's the big idea" version — and get explicit go-ahead before
+any adjective work is built on it. This is a hard stop, the same weight
+as planning intake's own Confirm & Lock: every phase from here through
+`landing-copywriter` inherits this framing silently, and by the time
+copy is reviewed at phase 9, correcting the framing means unwinding
+multiple committed phases via the Correction Protocol instead of one
+quick revision now. A revision at this point is just another pass at
+Step 1, not a Correction Protocol entry, since nothing downstream exists
+yet.
+
 ### Step 2 — Brand Anthropologist
 
 **In:** subject statement
@@ -84,15 +107,24 @@ adjective is meant to fade rather than hold constant throughout the page.
 1. Read `.hedgehog/chain/00-brief.md` (written by `planner` at planning
    intake). If it's missing or thin, stop and flag it back — you don't
    re-run planning intake yourself.
-2. Run step 1 (subject/audience/job).
-3. Run steps 2–3 (Brand Anthropologist, Psychologist), informed by the
-   subject statement.
-4. Run step 4c (Perfumer) against the completed sort from step 3.
-5. Self-test (below) before presenting.
-6. Commit the combined artifact as `feat(landing): strategy`.
+2. Run step 1 (subject/audience/job), including its plain-verb check.
+3. **Confirm step 1's statement with the user. Wait for explicit
+   go-ahead before proceeding to step 2** — this is a hard stop, not a
+   formality; nothing downstream exists yet, so a revision here is free.
+4. Run steps 2–3 (Brand Anthropologist, Psychologist), informed by the
+   confirmed subject statement.
+5. Run step 4c (Perfumer) against the completed sort from step 3.
+6. Self-test (below) before presenting the combined artifact.
+7. Commit the combined artifact as `feat(landing): strategy`.
 
 ## Self-test
 
+- The subject statement was confirmed by the user before step 2 started
+  — not drafted and assumed. If it wasn't, stop now and go back for
+  confirmation rather than letting adjective work compound on an
+  unconfirmed framing.
+- The plain-verb check was run and passed (or the framing choice — action
+  vs. mechanism — was put to the user explicitly, not resolved silently).
 - Every adjective has a named opposite. An adjective without one isn't
   falsifiable — send it back through step 2.
 - Every adjective is sorted into exactly one of visceral/behavioral/

package/src/skills/hedgehog-landing-loop/SKILL.md

@@ -147,6 +147,15 @@ one working-tree pass and needs splitting back into per-phase commits.
 
 ## Phase Transition Checks
 
+Before `landing-strategist`'s step 2 (Brand Anthropologist) starts,
+confirm step 1's subject/audience/job statement has been shown to and
+confirmed by the user — not just drafted. This is the cheapest point in
+the whole chain to correct the core framing (nothing downstream exists
+yet); every phase after it inherits that framing silently, and by the
+time `landing-copywriter` is reviewed at phase 9, a wrong framing means
+unwinding four committed phases via the Correction Protocol instead of
+one free revision here.
+
 Before `landing-critic` starts, confirm `landing-copywriter`'s copy has
 been presented to and confirmed by the user, not just written —
 `landing-critic`'s traceability audit reads confirmed copy, not a draft