By krzemienski
Shannon — Claude Code plugin for high-stakes multi-stage agentic work. Iron Rule: real-system evidence on disk, refuses verdicts without proof. Embedded sub-agent skills (sub-agents carry their skills, can't fail to load). Standalone — no required MCP servers; Context7 and sequential-thinking recommended.
Read-only audit with severity classification. Scopes: screen, app, session, drift. No edits.
Refusal-driven retry loop around /shannon:cook. Preserves Iron Rule + refusal-discipline pattern.
Execute a plan or brief end-to-end with iron-rule validation + evidence gates. Wraps planning, execution, validation, completion gate.
Subagent dispatch with mode flag. Sequential | parallel | competitive. Each subagent gets IRON-RULE inject; judge confirms output.
Health check. Validates plugin manifest, hooks.json registration, settings.json sanity, log dirs writable, marketplace declarations, build state.
Severity-rated review producing BLOCKING/HIGH/MEDIUM/LOW verdicts
Deep multi-wave planner for complex brownfield initiatives — decomposes objectives into dependency-grouped waves with per-wave synthesis gates
Generic task executor for plan steps — the most-spawned agent type
Pillar 4: rubric YAML generator before any judge/oracle/critic runs
Plan synthesis: intake → research → design → tasks → executable plan
Full-lifecycle autopilot orchestrator for /shannon:autopilot. ALWAYS use when the user says "autopilot", "run autonomously", "Spec→Plan→Execute→QA→Validate→Cleanup", "keep retrying until it works", or invokes /shannon:autopilot. Drives a six-phase lifecycle with stall detection, multi-perspective validation, SDK harness instrumentation, resume semantics, and transcript-evidence Iron Rule enforcement.
Parallelized repo-wide context survey via the sciomc scientists pattern (3-7 parallel agents with [FINDING:][EVIDENCE:][CONFIDENCE:] tags), with cross-validation, proving-commands extraction, and incremental caching. ALWAYS use when the user says "analyze codebase", "repo context", "module map", "hot path identification", "survey the repo", or starts /shannon:scope. Produces structured machine-extractable findings under e2e-evidence/<run-id>/codebase-analysis/.
Final completion gate evaluator for Shannon runs. ALWAYS use when the user says "completion gate", "ship gate", "evaluate completion", "final gate", or is about to claim a task is done. Reads the entire evidence tree, checks every Mandatory Success Criterion (MSC) against cited evidence, requires three-reviewer consensus PASS plus Oracle quorum APPROVED, and emits report.json. No override flag, no force-complete. Outer mechanical layer above evidence-gate (per-claim) and verification-before-completion (per-commit).
Multi-validator agreement gate with 5-state synthesis and multi-round debate iteration. ALWAYS use when the user says "consensus validation", "validate with N reviewers", "agreement gate", "high-confidence validation", "consensus gate", or needs confidence-scored verdicts. Spawns ≥2 (default 3) independent validators in isolated evidence dirs, applies the 5-state synthesis table (UNANIMOUS_PASS / UNANIMOUS_FAIL / MAJORITY_PASS / MAJORITY_FAIL / SPLIT), and escalates SPLIT or borderline MAJORITY to up to 3 rounds of filesystem-mediated debate.
Create optimized prompts for Claude-to-Claude pipelines with research, planning, and execution stages. Use when building prompts that produce outputs for other prompts to consume, or when running multi-stage workflows (research -> plan -> implement).
Matches all tools
Hooks run on every tool call, not just specific ones
Executes bash commands
Hook triggers when Bash tool is used
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Modifies files
Hook triggers on file write and edit operations
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Uses power tools
Uses Bash, Write, or Edit tools
Claude Code plugin for high-stakes multi-stage agentic work. Iron Rule: real-system evidence on disk, refuses verdicts without proof. Embedded sub-agent skills — sub-agents carry their skills, can't fail to load. Standalone — no required MCP servers.
Version 1.0.0 — first stable release. The five pillars are on disk and self-verified by /shannon:doctor.
# In Claude Code — install from the GitHub repo:
/plugin marketplace add krzemienski/shannon
/plugin install shannon@shannon
# Or from a local clone:
/plugin marketplace add /path/to/shannon
/plugin install shannon@shannon-local
A Claude Code plugin that turns multi-stage agentic work — research, planning, implementation, validation, release — into a sequence of provable steps.
Five pillars:
/shannon:doctor and /shannon:audit work — the plugin observes itself.Optional but pair well:
Anything else: ship as research surfaces a need.
# 1. Install (from the published GitHub repo)
/plugin marketplace add krzemienski/shannon
/plugin install shannon@shannon
# 2. Activate in your project
/shannon:enforce on
# 3. Verify
/shannon:doctor
# 4. First workflow
/shannon:plan "Your feature here"
/shannon:cook plans/<date>-<slug>/
Full guide: docs/QUICK_START.md.
| Command | Purpose |
|---|---|
/shannon:plan | Plan author (linear / brownfield / converge / tournament / deep) |
/shannon:scope | Brownfield reconnaissance — codebase + skill inventory + session context |
/shannon:cook | End-to-end execution with iron-rule validation |
/shannon:autopilot | Refusal-driven retry loop around cook |
/shannon:fix | 3-strike bug-fix runner |
/shannon:loop | do/verify/reflect convergence loop |
/shannon:dispatch | Sub-agent dispatch (sequential / parallel / competitive) |
/shannon:team | Multi-teammate orchestration with file-ownership boundaries |
/shannon:validate | Functional validation with cited evidence |
/shannon:audit | Read-only audit (screen / app / session / drift / completion-evidence) |
/shannon:research | Parallel researcher fan-out |
/shannon:prd | Interview-driven PRD authoring |
/shannon:reflect | Self-refinement (self / critique / memorize) |
/shannon:why | Five-whys root-cause analysis |
/shannon:trace | Session JSONL timeline |
/shannon:retro | Mine sessions for retrospectives |
/shannon:resume | Resume halted runs from evidence tree |
/shannon:enforce | Toggle Shannon hooks (on/off) for current project |
/shannon:install | Atomic install + activation |
/shannon:doctor | Mechanical contract check |
Five layers:
skills/<name>/SKILL.md + references/*.md (progressive disclosure)agents/<name>/AGENT.md with embedded SKILL.md content inlined by build/embed-skills.py/shannon:* entry points routing to agents/skillshooks/*.js with required_hooks contract enforced by scripts/doctor.pyscripts/harness/sdk_runner.py + tmux_runner.pyFull breakdown: docs/ARCHITECTURE.md.
v1.0.0 — stable. All five layers are on disk and pass the mechanical contract in
scripts/doctor.py (10/10 checks). The build path that produced v1 is preserved below as
provenance.
| Milestone | Status | Output |
|---|---|---|
| PRD approval | ✅ | PRD-V1.md + DECISIONS.md |
| Skill curation (67 → 33) | ✅ | skills/ (33 dirs) |
| Agent embedding | ✅ | agents/ (9 manifests + AGENT.md + _built/) |
| Command consolidation (27 → 20) | ✅ | commands/ (20 dirs) |
| Hook curation (16 → 7) + contract | ✅ | hooks/ (7) + scripts/doctor.py |
| Validation harnesses | ✅ | scripts/harness/ (SDK + Tmux) |
| Documentation | ✅ | README + 7 docs/ files |
| Brownfield planning | ✅ | /shannon:scope + skill-inventory + --brownfield modes |
| v1.0.0 release | ✅ | doctor 10/10 PASS; counts reconciled to disk (33/9/20/7) |
npx claudepluginhub krzemienski/shannon --plugin shannonShannon Framework v6 — single-plugin consolidation replacing OMC + VF + Crucible + 13 others. 26 commands, 22 skills, 10 agents, 14 hooks across 7 domain modules + 4 enforcement layers.
Sharp-eyed visual-audit suite for Claude Code. Two coupled skills catch real UI defects — contrast failures, false affordances, modal opacity, contract mismatches — via real-system probes, zero mocks, evidence-cited verdicts.
Deepest-mode planning — consensus + gates + phase hierarchy + multi-plan tournament synthesis. Self-contained. Works with Claude Code and OpenCode.
3-agent unanimous consensus validation with hard gates for Claude Code. Maps Lead/Alpha/Bravo roles to CC subagents, enforces unanimity at phase transitions, persists evidence per phase+role.
Fixed-Point Deepen architecture of the Anneal plugin family. One plan, heated and cooled repeatedly — inline red team at every depth, Momus 0-100 scoring, convergence by variance/delta/cap.
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Curate auto-memory, promote learnings to CLAUDE.md and rules, extract proven patterns into reusable skills.
Memory compression system for Claude Code - persist context across sessions
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.