53 lines
2 KiB
Markdown
53 lines
2 KiB
Markdown
|
# 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](https://github.com/GameCult/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:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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.
|