CLAUDE CODE PLUGIN · OPEN SOURCE
GITHUB.COM/ATULJHA23/HOLOCRON · JEDI ARCHIVES v0.3.0 LATEST TRANSMISSION

Holocron

A Jedi council for your codebase — 14 role-specialist agents, 24 domain commands, 11 skills, a SQLite-backed learning crystal that compounds your corrections across sessions, and a token economy that makes every $ of Claude Code usage visible.

14 Agents 24 Commands 11 Skills 13 Hook Scripts 6 Events SQLite + FTS5 Cost tracking MIT

NEW IN v0.3.0 Token economy. Every session's $, token counts, cache hit rate, and per-model split are logged and browsable via /holocron:cost. Set a /holocron:budget. Prune MCP overhead with /holocron:mcp-audit. Ranked savings proposals from @cost-analyst.

01 · CORE ARCHITECTURE

Command → Agent → Skill → Hook → Crystal

Commanduser input · slash
→
Agentrole specialist
→
Skilldomain rubric
Hookevent-driven
↔
Crystalpersistent SQLite
  • Agents hand off explicitly — none try to be everything.
  • Hooks auto-load learnings and guard writes.
  • Crystal survives compaction, session restart, and new repos.
02 · JEDI COUNCIL

14 Role Specialists

@architectDesign, ADRs, tradeoffs
@frontend-engineerReact · Vue · Svelte · UX
@backend-engineerAPIs · data · services
@qa-engineerStrategy · gaps · flakes
@a11y-auditorWCAG 2.2 AA
@perf-engineerWeb Vitals · N+1
@security-reviewerOWASP · authz · crypto
@threat-modelerSTRIDE / LINDDUN
@sre-engineerDocker · k8s · CI · SLOs
@data-engineerSQL · dbt · pipelines
@cost-analystRanked $ savings from usage data NEW
@debuggerHypothesis-driven triage
@code-reviewerStaff-level PR review
@docs-writerREADMEs · runbooks · ADRs

Each has a rubric and a "not my jurisdiction" delegation table.

03 · WHAT'S INSIDE

Plugin Inventory

14Agents
24Commands
11Skills
13Hook Scripts
6Hook Events
4Rules
4Contexts
MITLicense
DATABASE
SQLite FTS5 Porter tokenizer User + project scope
PLATFORMS
Claude Code
04 · THE LEARNING CRYSTAL

Corrections That Compound

Every correction you capture becomes a durable rule — stored in SQLite with full-text search, indexed by bm25, loaded on every session start, and matched against every prompt you send.

1
Correctuser redirects the model
↓
2
Capture/holocron:learn "<rule>"
↓
3
PersistSQLite + FTS5, local-first
↓
4
Recallinjected on SessionStart + PromptSubmit
USER SCOPE ~/.holocron/learnings.db Follows you across every project.
PROJECT SCOPE <repo>/.holocron/learnings.db Lives with the repo. Commit or ignore per team.
"The holocron was the ultimate Jedi repository of knowledge. What the archives preserve, the archives protect."
05 · HOOK AUTOMATION

6 Events · 10 Scripts

SessionStartLoad crystalInject top-K recent learnings
UserPromptSubmitFTS matchInject top 3 relevant rules
PreToolUse · EditRead-before-writeNudge on unread targets
PreToolUse · EditSecret scanBlock on confident matches
PreToolUse · BashPre-commit gateSurface repo quality gates
PreToolUse · BashPre-push nudgeSuggest /holocron:handoff
PostToolUse · EditDebug residueFlag console.log/debugger/TODO
PostToolUse · BashTest failure learnNudge /holocron:learn
PreCompactSnapshotPersist session state
StopCapture promptDetect correction markers
Session Prompt PreTool PostTool Compact Stop
06 · COMMAND ROSTER

24 Slash Commands

META · WORKFLOW
/holocron:onboardDraft a repo-appropriate CLAUDE.md
/holocron:planPlan-mode scaffold
/holocron:developResearch → Plan → Implement → Review
/holocron:commitQuality-gated commit
/holocron:reviewStaff-level review of the diff
/holocron:handoffSession handoff doc
/holocron:learnCapture a correction
/holocron:recallFTS search the crystal
/holocron:insightsCorrection heatmap NEW
/holocron:worktreeParallel git worktree setup NEW
/holocron:doctorSelf-check install
DOMAIN
/holocron:a11yWCAG audit on UI diff
/holocron:perfWeb Vitals · N+1 · indexes
/holocron:test-gapPrioritized missing tests
/holocron:flakyFlake-triage tree
/holocron:sec-scanSAST + secrets + CVE
/holocron:threat-modelSTRIDE on the diff NEW
/holocron:adrMADR-style decision record
OPS · GATES
/holocron:permission-tuneAnalyze denials · suggest allow/deny rules
/holocron:llm-gateAI verdict before destructive ops
TOKEN ECONOMY
/holocron:cost$ and tokens across sessions · cache hit rate NEW
/holocron:budgetSet per-session / daily / monthly caps NEW
/holocron:mcp-auditMCP token footprint · prune unused servers NEW
/holocron:context-sizeSnapshot context · find trim candidates NEW
07 · SKILL LIBRARY

11 Cross-Cutting Rubrics

context-engineeringWrite · Select · Compress · Isolate
test-patternsDeep assertions over spies · AAA
api-designREST + GraphQL conventions
a11y-checklistWCAG 2.2 AA walkthrough
security-checklistOWASP pre-merge sweep
perf-checklistCore Web Vitals · query rubric
debug-playbookHypothesis-driven triage
pr-review-rubricWhat a staff engineer asks
observability-checklistLogs · traces · metrics · correlation
migration-patternsExpand / contract · backfill · online DDL
token-economyModel tiering · cache hygiene · Read discipline NEW
08 · TOKEN ECONOMY NEW IN v0.3.0

Your $ and cache, visible

The Stop hook parses every session's transcript and writes per-session token & cost records to ~/.holocron/sessions/. You can browse them, set budgets that warn you in-session, prune MCP overhead, and get ranked savings from @cost-analyst.

SEE YOUR SPEND
# $ + tokens + cache hit rate
/holocron:cost --breakdown

# Top sessions by cost
/holocron:cost --by-session
SET A BUDGET
# Per-session + daily caps
/holocron:budget \
  --session 2 --daily 10

# Stop hook warns at 80% / 100%
CUT THE FAT
# MCP token footprint
/holocron:mcp-audit

# Biggest context offenders
/holocron:context-size

# Ranked savings
@cost-analyst
AUTOMATIC NUDGES
# Large Read, no offset/limit
#   → nudge to use a range

# Tool output > ~8k tokens
#   → nudge to narrow

# Cache hit rate low in /cost
#   → tip on what's busting it

Pricing hardcoded for Claude 4.x (Opus / Sonnet / Haiku). Update scripts/holocron-usage.js when rates change.

09 · QUICKSTART BY ROLE

Pick Your Lightsaber

SOFTWARE ENGINEER
/holocron:onboard
/holocron:plan
/holocron:develop <feature>
/holocron:commit
/holocron:learn "<rule>"
FRONTEND ENGINEER
@frontend-engineer <task>
/holocron:a11y
/holocron:perf
/holocron:test-gap <file>
BACKEND ENGINEER
@backend-engineer <task>
/holocron:sec-scan
/holocron:perf
/holocron:adr "<title>"
QA ENGINEER
@qa-engineer <task>
/holocron:test-gap <file>
/holocron:flaky <test>
SRE / PLATFORM
@sre-engineer <task>
/holocron:llm-gate "push to main"
/holocron:permission-tune
SECURITY
@threat-modeler <feature>
/holocron:threat-model
/holocron:sec-scan
10 · INSTALL

Enter the Archive

// 1 — add the marketplace
/plugin marketplace add atuljha23/holocron

// 2 — install the plugin
/plugin install holocron@holocron

// 3 — reload
/reload-plugins

// 4 — self-check
/holocron:doctor

First SessionStart runs npm install automatically if the SQLite native binding is missing. Node ≥ 18 required.

11 · PHILOSOPHY

Measured Force

  • Role specialists beat generalists. A staff reviewer, an a11y auditor, and a QA engineer think differently. The council reflects that.
  • Corrections compound. A rule captured once should never need saying twice.
  • Cost is a first-class citizen. If you can't see what a session costs, you can't decide whether it was worth it.
  • Local-first. Your crystal and usage logs live on your machine. No telemetry. No phone home.
  • Fail safe. Hooks never crash the session. Advisory by default; block only where evidence is high.
  • Read before write. Every time. No exceptions for "small changes".
12 · CREDITS

Acknowledgements

Structural inspiration: rohitg00/pro-workflow (MIT). Holocron reimplements the persistent-learning idea from scratch and builds role-specialist content on top.

Plugin authoring reference: Anthropic's Claude Code plugin docs.

Star Wars, Jedi, Sith, and Holocron are trademarks of Lucasfilm Ltd. This project is unaffiliated thematic homage.