Agent workflows

Plans deserve their own environment.

HeySpex is where plans get developed, challenged, and settled. Your IDE is where they get built. Keeping those two apart is not a limitation. It is the design.

Why separate

The agent that builds should not be the agent that plans.

Plan modes inside IDEs feel convenient and fail quietly. The planning context is polluted by the implementation context. The plan gets rubber-stamped by the thing that wants to start typing. And nothing forces it to be settled before the build starts, so "plan" becomes a preamble instead of a gate.

Code solved this problem decades ago: drafts, reviews, versions, approvals. Specs deserve the same development discipline, in their own environment. That is what HeySpex is.

Plan mode in the IDE
Planning context inherits whatever the session was doing: open files, half-finished diffs, the last wrong turn.
The implementing agent grades its own plan. The thing that wants to start typing approves the reason to start typing.
Nothing forces the plan to settle. Plan mode is a preamble, not a gate, and the build starts when the agent gets restless.
The plan scrolls away when the session ends. Next session reconstructs intent from chat history, badly.
Claude Code

Built to sit inside your Claude Code workflow.

The vault is not a tab you switch to. Hooks, skills, slash commands, and MCP tools put HeySpex inside the session: capture a thought mid-build, preflight a task before an agent claims it, pull the next settled task with its context already packed.

Hooks
Preflight and alignment checks fire at the moments that matter: before an agent claims work, before a session commits to a direction.
Skills
Project workflows your agent loads on demand, so procedures live in the vault instead of in your head.
Slash commands
Pull the next settled task into your session with its context pack loaded, without leaving the terminal.
MCP tools
40-plus vault operations: file a task, claim work, recall a decision, ground a plan against the codebase.

And nothing is locked to one vendor. Claude Code is the deepest integration, not the only one: Cursor, Cline, Continue, and whatever ships next month are first-class over the same open protocol. Switching agents never means losing your project's memory.

roadmapHS-CKOT-EPIC · Checkout: billing onboarding flow2 agents active
HS-ONBS-TASKAdd onboarding state machineC·4f2ain_progress · claim held
HS-STRP-TASKConnect Stripe setup to onboarding state machineC·9c1ein_review
HS-WBHK-TASKHandle Stripe webhook retries with idempotency keysunclaimedblocked by HS-ONBS-TASK
claims are atomic · a claimed task cannot be claimed twice
claude code · cursor · cline · continue · any mcp agent
Deterministic

The queue is plain code. That is the safety.

The core problem has not changed: AI agents are good at executing the wrong thing perfectly. HeySpex's answer is to keep the judgment layer deterministic. The scheduler, the gates, and the ranking are plain code over the markdown in your vault. Same vault, same answer, every time, with the reason named.

When "what should happen next, and is it safe to start" has a provable answer, handing dispatch to a nondeterministic agent stops being reckless. The agents stay creative. The ground they stand on does not move.

The plans are only half of it.

What the agents read, and why retrieval never misses, is covered in the second brain.