tyran
01Plugin Claude Code
Plugin marketplace listing 1 plugin: tyran.
Plugin Claude Code
Plugin marketplace listing 1 plugin: tyran.
Plugin Claude Code
A task conductor for Claude Code: multi-agent orchestration with an enforced evidence contract, repo-specific learning, and update-safe local evolution.
Instructions file
Instructions for jjanczur/tyran, covering claude.md, two surfaces for every document, releasing — the version, not the commit, the gate runs on you too and the yaml subset is small, and it bites.
Agent
Takes one self-contained story from plan to commit or PR on its own branch, with tests and a self-review. Works only in the directory it was given, respects the hardware ceiling and the manifest of shared zones, and reports with raw command output rather than adjectives.
Agent
After an initiative closes, reads the ledger, the notes and the agents' reports and improves Tyran itself - skills, agents, scripts and docs, never product code. Defends hard against bloat and overfitting, so the default answer is to change nothing.
Agent
Independent quality control on another agent's work - reads the whole diff, runs its OWN verification rather than trusting the author's report, and returns APPROVE, REVISED or CHANGES-REQUESTED with executable counterexamples. May fix what it finds, which forfeits APPROVE. Never reviews its own code.
Agent
Fast, cheap reconnaissance over a repo, its documentation, its data or external sources, changing nothing. Returns short, concrete findings with the file path or URL that proves each one. Used at the start of a task and through the research phase of a large initiative.
Agent
Mechanical validation on the cheapest tier - runs exactly the commands it is handed, reports exit codes and counts verbatim against the handoff's baseline, and never edits, fixes or theorizes. A red suite is its product, not its failure. Spawned by the conductor at merge time and for the serial re-run of a suspect…
Hook
Runs when a session starts on startup, resume and compact, executing session-start.mjs. From jjanczur/tyran.
Hook
Runs before the agent uses a tool for Bash, ^(Write, Edit, NotebookEdit, Bash, mcp__.*)$, .+, ^$, .+ and ^$ tool calls, executing secrets-gate.mjs, write-guard.mjs, policy-gate.mjs and usage-gate.mjs (4 commands). From jjanczur/tyran.
Hook
Runs when the agent finishes a response, executing retro-gate.mjs. From jjanczur/tyran.
Hook
Runs when a subagent finishes for .+, ^$, .+ and ^$ tool calls, executing evidence-gate.mjs and board-refresh.mjs (2 commands). From jjanczur/tyran.
Hook
Runs before the context is compacted for manual and auto tool calls, executing pre-compact.mjs. From jjanczur/tyran.
Skill Claude CodeCodex
Drive a real browser and come back with a MEASUREMENT rather than an impression - console errors and >=400 responses as counts, computed styles as JSON when appearance is disputed. Use when work touches UI, when a review must verify one, or when fidelity-gate asks for its measurement.
Skill Claude CodeCodex
The depth half of a review - the dimensions a diff is read against (correctness, boundaries, concurrency, failure paths, secrets, data access, structure, test quality) and the rule that a finding is refuted before it is reported. The verdict stays with the reviewer agent. Use when reviewing a diff or a pull request…
Skill Claude CodeCodex
The optimization pass, defined - delete before you add, one smell class per pass, behaviour pinned by a test that ran BEFORE the edit. Lints a SKILL.md and prose by the same instinct. Use for the per-story optimization pass or when code has grown noisy without growing capable.
Skill Claude CodeCodex
Check that Tyran itself is healthy in this repo - gates that cannot fire, journal and projection drift, orphaned leases, dead policy rules, config that fails its schema. Reports findings with the fix for each. Use for /tyran:doctor or when a gate seems not to be working.
Skill Claude CodeCodex
Build a UI against a frozen visual reference without drift - an inventory extracted before any code, a relics list, and a gate that MEASURES computed styles on a fixture carrying the reference's own data. Use when a mockup, design spec or screenshot is the contract.
Skill Claude CodeCodex
Smoke-test skill that verifies the Tyran plugin is installed and namespaced correctly. Invoke with /tyran:hello.
Skill Claude CodeCodex
Work a reviewer's comments on a pull request to the end - all three comment surfaces enumerated before any is triaged, every comment fixed, declined with a reason, or ticketed, push before you reply. Use when a PR comes back with review feedback or a red check.
Skill Claude CodeCodex
Tune a prompt, or anything whose quality is measured by non-deterministic model output, without chasing noise - a noise baseline before the first edit, medians over repeated runs, enforcement AFTER generation rather than in the wording. Use when iterating on prompts or model-judged output.
Skill Claude CodeCodex
Close an initiative by learning from it - spawns the retrospective agent over the ledger, the notes and the agents' reports, records what changed and what was rejected, and writes durable repo facts into .tyran/knowledge/. Runs at the end of an initiative; also available as /tyran:retro.
Skill Claude CodeCodex
Find the mechanism behind a failure instead of patching its symptom - reproduce first, one variable per experiment with the prediction written before the run, exit by naming the mechanism and pinning it with a failing test. Use for a bug, an unexplained red test, or a failure that will not reproduce.
Skill Claude CodeCodex
Conduct a task end to end, from a one-line fix to a multi-day programme - a short interview, then autonomous execution to the finish. Classifies the task S/M/L/XL, configures itself to the repo, routes each role to a cost tier, drives the agent team from the kanban board, and stops only at genuine decisions. Use for…