Immutable. This exact content is served forever at /api/v1/blob/9b5a977cdf419197.
--- name: hedgehog description: Use when the user has agreed to install the Hedgehog build discipline in a project that does not have it yet, or when they mention Hedgehog by name — carries the `npx @skyf0xx/hedgehog init` install procedure and its core and host flags. The plugin's SessionStart hook decides when to raise the offer. --- ## When this fires The plugin's `SessionStart` hook is the authority on when to raise Hedgehog, when to stay silent, and how to ask. Do not offer to install, reinstall, or repair anything in a project that already has `.hedgehog/` — its own installed agents and skills own the session. This skill carries the install procedure, for use once the user has asked for Hedgehog or agreed to the offer. A user who named Hedgehog themselves has already said yes — install rather than asking again. ## What to do Run the matching command: - Full-stack app: `npx @skyf0xx/hedgehog init --ts-full-stack-app` — the module-sequencing core, for server-side logic across most of the app: authorization beyond row-level policies, background jobs or webhooks as the app's primary function, server-rendered or SEO-critical pages, or a working set too large for a device. - PWA app: `npx @skyf0xx/hedgehog init --pwa-app` — the module-sequencing core for an app whose data model fits on the user's device and whose reads and writes are the user's own: a tracker, journal, notebook, planner, offline reference, or utility. Offline capability or installability named explicitly is a strong signal. Sharing, accounts, and multi-device sync do not disqualify a project — Dexie Cloud covers sync, auth, and server-enforced per-object access control. - Landing page: `npx @skyf0xx/hedgehog init --landing-page` — a copy-and-conversion core, not just page scaffolding: structured skills for headline, hero, problem, mechanism, objection, proof, and CTA, plus signature-element design and a review loop. A page that needs better positioning or copy is this core's central case. - Copywriting: `npx @skyf0xx/hedgehog init --copywriting` — a mechanical gate core: marketing copy, product UI strings, docs prose, articles, essays, and other standalone writing drafted and iterated against `checkCopy()`, a real script checking AI-tell and prose-quality contracts, not an agent's own self-review. Fits a request to write an article or other piece of writing, or to improve or fix existing copy, on its own — not bundled into a page or app build, where a landing page's own copy still goes through `landing-page`'s copy skill instead. Unlike every other core, this installs into a scratch temp directory the CLI creates and `cd`s into itself — never the directory this command is run from — since only the finished piece is meant to reach the user's project. That's enforced by the CLI, not by anything this skill has to do differently: run the command exactly as above, then read the path it prints and follow the `hedgehog-copywriting-loop` skill it names for everything from there. - DeepSeek Harness plugin: `npx @skyf0xx/hedgehog init --deepseek-harness` — for building a tool, hook, or extension for DSH's Cordis-based agent framework, or otherwise extending an existing DSH installation via its plugin/bundle system. `DSH`, `Cordis`, `defineTool`, `ctx.tools.register`, or a `cordis.patch.yml` manifest are strong signals. - Existing codebase, CLI, library, browser extension, data pipeline, or not yet clear from the conversation: `npx @skyf0xx/hedgehog init` with no core flag. `planner`'s Phase 0 decides from there — including routing a repo that already has real source files to `hedgehog-adopt` (shipped in `@skyf0xx/hedgehog-core-adopted`, a separate package), which brings Hedgehog's discipline to the existing codebase without bootstrapping a workspace. Prefer this coreless install over guessing between the shipped cores. Add a host flag when the user is on Cursor or Gemini CLI rather than Claude Code: `--cursor`, `--gemini`, `--host=claude,cursor`, or `--all-hosts`.