Galicia

Spend less context. Keep engineering judgement.

Agents reread whole docs, repeat checks and ask questions the repo already answers. You pay in tokens, waiting and attention.

Galicia gives coding agents nine concise skills and a map to the context each task needs. Resolve decisions, write specs, split work, find root causes, write tests and land them as small commits. Keep agreed answers and decisions in your repo, ready for the next session.

Spend effort where it earns trust. Preserve evidence, exact contracts and uncertainty. Everything stays project-local, in files you can read and edit. Read the philosophy.

Skill	Job
terse	Compress chat until stop. Default ultra. No hidden-reasoning savings claim.
rubberduck	Resolve design decisions. Pick one-question or independent-batch cadence at setup.
spec	Write local change specification; recommend breakdown for larger work.
breakdown	Produce approved vertical tickets with explicit blockers.
find-rc	Reproduce symptom, minimise, test hypotheses, fix root cause, verify regression.
unit-test	Test one file in isolation. Arrange-Act-Assert, collaborators mocked, run until green.
behavioural-test	Test one user-facing scope. Mock lowest layer only; real layers above prove data flow.
e2e-test	Test critical user journey through running app. Playwright preferred.
commit	Split agreed work into small commits. Each behaviour change includes the unit, behavioural, or e2e test that proves it.

Install

Homebrew, macOS or Linux:

brew tap mrlemoos/galicia https://github.com/mrlemoos/galicia
brew install mrlemoos/galicia/galicia
cd /path/to/project
galicia init

Homebrew installs the CLI and Node. Skills, context and hooks stay in the chosen project. The explicit tap URL uses this repository; no separate tap repository required. Homebrew may ask you to trust the formula. Available after the first tagged release publishes Formula/galicia.rb. Release and local validation guide.

galicia --version prints the installed version. galicia init and galicia check check the latest public stable GitHub release. Any different version prints a reminder and command:

brew update && brew upgrade mrlemoos/galicia/galicia

Lookup capped at 1.5 seconds, runs alongside setup, writes no cache. Offline, rate-limited or invalid responses stay silent. Help/version make no request. Set GALICIA_NO_UPDATE_CHECK=1 to disable the lookup. No telemetry or project contents sent. Upgrading the CLI leaves existing projects unchanged; rerun galicia init in each project to review updates. Customised generated files still require conflict resolution.

Without Homebrew, run the pinned bootstrap from your project's root. Requires Node 22.18+, curl and tar.

curl -fsSL https://raw.githubusercontent.com/mrlemoos/galicia/main/scripts/setup.ts | node --input-type=module

Setup downloads pinned source, opens interactive choices, previews project changes, then removes temporary files. No clone, npm install or global installation. Command executes remote code. Bootstrap follows main; downloaded installer pins commit 050d4835a5e0032230f6a358567771ea3ec4e73d.

From an existing checkout, use node src/cli.ts init --project /absolute/path/to/project. Runtime has no dependencies or build step. Git required only for Codex startup hooks and the optional Git downloader.

Arrow keys move, space selects, enter continues. Setup chooses agents, skills, grilling cadence and optional hooks, then previews files. NO_COLOR=1 uses plain numbered prompts. Existing context stays authoritative. Edited generated files cause a conflict; installer writes nothing until conflicts resolved. Repeat identical setup makes no changes.

galicia init --project /absolute/path/to/project --agents codex,claude,cursor,grok --cadence ask --hooks --dry-run
galicia init --project /absolute/path/to/project --agents codex --cadence one --yes

--dry-run shows before/after contents. --yes accepts the displayed plan. Hooks are opt-in. Skills/context remain project-local. No telemetry or model calls. Different target selections add/update selected files; they do not delete previously installed skills or hooks. Review removal manually.

Choose an exact revision

For a reviewed bootstrap, replace main in the install URL with its full commit SHA. Bootstrap still downloads its embedded installer revision.

Existing checkouts also support the Git downloader:

node scripts/download.ts --repo mrlemoos/galicia --ref 050d4835a5e0032230f6a358567771ea3ec4e73d --project /absolute/path/to/project

Requires Git/network. Fetches exact commit into temporary directory, verifies SHA, runs interactive setup, removes download. Branches and tags rejected.

Context that scales

AGENTS.md points to root context.md. That map links business domains, their local context, glossary and ADRs. Load only task-relevant links. Small projects keep context at root; large Nx/Bazel repos distribute by business ownership, with technical packages linking to owning domains. .data saves no tokens by itself.

Initialiser creates templates only where absent:

context.md
docs/Language.md
docs/adr/README.md
docs/specs/README.md
.galicia/templates/adr.md
.galicia/templates/spec.md
.galicia/templates/ticket.md
.galicia/config.json

One authoritative definition per domain term. Glossary excludes framework/library terminology. Specs describe changes; ADRs retain durable decisions. Context conventions.

This is the beginning of the README. Read the rest at the original. Read the full README ↗