GameCult/Eureka
Watch
9
0
Fork
You've already forked Eureka
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Eureka: a faculty pipeline for Claude Code agents
9 commits 61 branches 0 tags 14 MiB
  • Shell 63.9%
  • Python 29.6%
  • TeX 3.5%
  • Rust 1.6%
  • Dockerfile 1%
  • Other 0.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Meta Vens 82074a7ab5 Fold the Ghostlight L0 lessons into the briefs and the fork rule 
The Soul template now attacks constructibility at sealed boundaries (a
derive is a public constructor, and on stable rustc a compile_fail test does
not pin its error code). It also asks for forgeries shaped like real values
and treats text scanners as tripwires with stated limits.

The Hands template now says to wait for long jobs instead of reporting a
to-do list, to restore mutations without git checkout, to measure warnings
from forced rebuilds, and to prefer semantic tools for semantic properties.

The fork rule now weighs proportion: a fork guarding only against the
project's own code gets a default and a recorded follow-up.

Evidence: Ghostlight's library extraction postmortem, recorded in the
changelog.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-16 12:26:08 +02:00
references Fold the Ghostlight L0 lessons into the briefs and the fork rule 2026-09-16 12:26:08 +02:00
LICENSE Publish Eureka, the Claude Code faculty pipeline skill 2026-09-15 20:15:10 +02:00
README.md Publish Eureka, the Claude Code faculty pipeline skill 2026-09-15 20:15:10 +02:00
SKILL.md Fold the Ghostlight L0 lessons into the briefs and the fork rule 2026-09-16 12:26:08 +02:00

README.md

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.