Eureka

Eureka is a Claude Code skill. It runs foundation changes (migrations, rebuilds, teardowns, cross-repo and cross-runtime work) as a faculty pipeline:

• Self routes the work.
• Imagination maps the cut.
• Hands executes one cut at a time.
• Soul tries to falsify what Hands promised.
• Mind Steward keeps memory honest.
• The operator rules on real forks.

It is the Claude Code counterpart of Epiphany and shares Epiphany's faculty vocabulary.

The pipeline was extracted from the Aetheria CultCache migration (2026-09-12..15). In that migration, 29 of 32 independent Soul passes found real defects that the implementing agent's own tests had passed. references/postmortem-cultcache.md has the evidence, and references/changelog.md records every change to the skill along with the evidence behind it.

Install

Clone into your Claude Code skills directory:

git clone https://github.com/GameCult/Eureka.git ~/.claude/skills/eureka

Claude Code discovers the skill by the name and description in SKILL.md.

Layout

• SKILL.md: the pipeline (the faculties, the loop, Self's discipline, and git/tooling rules).
• references/briefs.md: brief templates for Imagination, Hands, Soul, Mind Steward and Eyes.
• references/cut-map.md: the shape of the target document and the cut map.
• references/postmortem-template.md
• references/postmortem-cultcache.md: the worked example.
• references/epiphany-comparison-2026-09-15.md: a dated, source-grounded comparison with Epiphany.
• references/changelog.md

Status

Eureka currently keeps pipeline state in committed documents and memory. A campaign in Epiphany (notes/eureka-pipeline-state-target.md) is adding typed pipeline state. Epiphany owns the schemas and admission. Each campaign's store is committed in the repo where the task runs. A per-session eureka-state MCP server lets Eureka agents admit and query that state. This skill will be rewired to use it once that campaign lands.