holocron

Holocron

A Claude Code plugin that gives you a Jedi council of role-specialist agents, domain commands (a11y, perf, QA, security, ADR), and a SQLite-backed learning crystal that compounds your corrections across sessions.

A holocron, in Star Wars lore, is a crystalline cube that stores Jedi teachings. This one stores yours — every correction you make becomes durable knowledge the assistant carries into the next session.

atuljha23.github.io/holocron · v0.3.0 · MIT · targets SWEs, frontend engineers, backend engineers, QAs, SREs, and security.

---

Why holocron

If you use Claude Code daily you already know the failure mode: you correct the assistant the same way a dozen times, every session feels like starting over, and the "plan → review" discipline rots the moment compaction hits. Holocron does three things about that:

1. Specialist agents — not one generic "reviewer", but ten role-flavored agents (@frontend-engineer, @qa-engineer, @a11y-auditor, @security-reviewer, @perf-engineer, …) each with a sharpened rubric and clear handoff boundaries.
2. Domain commands — a11y audits, performance checks, test-gap analysis, flaky-test hunting, security scans, ADR drafting. The stuff engineers actually reach for, as slash commands.
3. The crystal — a SQLite + FTS5 store of your corrections. New sessions load the top matches automatically. Compaction can't wipe them.

---

Install (30 seconds)

# Add this repo as a marketplace and install the plugin
/plugin marketplace add atuljha23/holocron
/plugin install holocron@holocron

# One-time: install the native dependency the learning crystal needs
cd ~/.claude/plugins/marketplaces/holocron && npm install

Local dev against a clone:

git clone https://github.com/atuljha23/holocron ~/projects/holocron
cd ~/projects/holocron && npm install
/plugin marketplace add ~/projects/holocron
/plugin install holocron@holocron

Health check:

/holocron:doctor

---

What's inside (v0.3.0)

Component	Count	Where
Role / meta agents	14	agents/
Slash commands	24	commands/
Skills	11	skills/
Hook scripts	13	scripts/
Hook events wired	6	hooks/hooks.json
Context profiles	4	contexts/
Rules	4	rules/

Run node scripts/holocron-cli.js inventory anytime to verify counts match this table.

v0.3.0 — Token Economy. Every Claude Code session's $ and tokens are logged to ~/.holocron/sessions/. Run /holocron:cost for the rolling total, /holocron:budget to set caps, /holocron:mcp-audit to cut schema bloat, @cost-analyst for ranked savings proposals.

---

Quickstart by role

If you're a software engineer

/holocron:onboard            # draft a CLAUDE.md for this repo
/holocron:plan               # enter plan mode with a real scaffold
/holocron:develop <feature>  # research → plan → implement → review
/holocron:commit             # quality-gated commit with a reviewed diff
/holocron:learn "<rule>"     # capture a correction so it sticks

If you're a frontend engineer

@frontend-engineer <task>    # role-specialist for component/UX work
/holocron:a11y               # audit changed UI files against WCAG 2.2 AA
/holocron:perf               # bundle / LCP / CLS check on the diff
/holocron:test-gap <file>    # find the component states nobody tests

If you're a backend engineer

@backend-engineer <task>     # API / data / service work
/holocron:sec-scan           # SAST + secrets + dep advisories on the diff
/holocron:perf               # N+1 and index-gap sweep
/holocron:adr "<title>"      # record a real decision, not a Slack message

If you're in QA

@qa-engineer <task>          # test strategy / coverage / flakes
/holocron:test-gap <file>    # prioritized list of missing tests
/holocron:flaky <test>       # walk the flake-triage tree with evidence

If you're SRE / platform

@sre-engineer <task>         # Docker / k8s / CI / runbooks
/holocron:llm-gate "push to main"
/holocron:permission-tune    # reduce prompt fatigue with allow/deny tuning

If you're security

@threat-modeler <feature>    # STRIDE on a proposed change
/holocron:threat-model       # design-level review
/holocron:sec-scan           # SAST + secrets + CVE on the diff

If you care about cost

/holocron:cost --breakdown          # $ + tokens + cache hit rate
/holocron:budget --session 2 --daily 10
/holocron:mcp-audit                 # MCP token overhead
@cost-analyst                       # ranked savings from usage data

---

Agents

All live under agents/ and invoke as @<name>: