Make every coding agent inherit your project’s decisions

Whale Igniter turns foundations, components, decisions and approved exceptions into living constraints every agent can read, follow and verify.

$ npm install -g whale-igniter

View on npm

Node ≥ 20 · No API key required · MIT

Project continuity

Your decisions should survive every agent.

Whale keeps project decisions and their reasoning in the repo, then checks whether implementation still follows them.

Project-owned decisions

Foundations, components, decisions and approved exceptions stay as versioned JSON and Markdown next to your code.

Inherited by every agent

One sync updates CLAUDE.md, AGENTS.md and the wiki for Claude Code, Codex, Cursor and Copilot.

Verified against reality

Whale detects drift from project foundations and preserves the reason behind every intentional exception.

my-app · whale ignite

$ whale ignite my-app
# a structured intelligence layer, in one command

my-app/
├── whale.config.json      foundations, stack, theme
├── CLAUDE.md              agent brief, auto-synced
├── intelligence/
│   ├── components.json    catalog, variants, states
│   ├── decisions/         one ADR per decision
│   └── refinements/       approved exceptions
└── llm-wiki/              readable, one file per concern

# every agent inherits the same decisions and reasons

Read and write

Give agents structured access to project decisions.

Whale exposes project intelligence through MCP. Agents can consult decisions before changing code and record useful knowledge as they work.

Tool	What it does
whale_project_overview	Full project brief: stack, foundations, packs, context.
whale_list_components	Component catalog with files, variants, states and tokens.
whale_list_decisions	Architectural decisions with rationale and status.
whale_list_refinements	Approved exceptions with context for intentional drift.
whale_insights	Live analysis: orphans, coverage gaps, tensions, drift.
whale_record_decision	Log an architectural decision straight from the agent.

Design intelligence

Keep implementation aligned with decisions.

Whale reads CSS, JSX, Vue and Svelte and flags what falls outside your foundations. Record an intentional exception once to preserve the reason.

$ whale insights drift spacing        # off-grid spacing in CSS, JSX, Vue, Svelte
$ whale insights drift color          # raw hex values outside your token set
$ whale insights drift radii --review   # accept or queue each issue

Core commands

A small CLI that keeps project decisions current.

Fully local and deterministic. No API key required for any core flow.

Command	What it does
whale ignite my-app	Bootstrap a new Whale workspace.
whale adopt	Scan an existing project and propose components and foundations.
whale sync	Regenerate CLAUDE.md, the wiki and agent context.
whale check	Validation and project insights.
whale mcp config --client cursor	Configure an MCP client (Claude Code, Cursor, Zed).

Local-first. Core flows run offline, no data leaves your machine.

No telemetry. No analytics, ever. API keys stay in env vars.

MIT. Generated files are yours to keep and modify.

Let the next agent inherit the project.

One command creates the source of truth. Every configured agent reads the same decisions from then on.

$ npm install -g whale-igniter

View on npm