By yanekyuk
Software engineering workflow — triage, TDD, self-review, docs sync, and orchestrators for feat/fix/refactor/docs pipelines.
npx claudepluginhub yanekyuk/arcana --plugin ritualAutonomous documentation pipeline — reads handoff, loads project config, fetches docs, writes/updates documentation, runs clash-check, arch check, sync docs, opens PR
Autonomous feature development pipeline — reads handoff, loads project config, fetches docs, drafts spec, TDD cycle, self-review, arch check, sync docs, opens PR
Autonomous bug fix pipeline — reads handoff, loads project config, fetches docs, investigates root cause, reproduces bug via TDD, fixes, self-review, arch check, sync docs, opens PR
Autonomous refactoring pipeline — reads handoff, loads project config, fetches docs, guards with existing tests, refactors incrementally, self-review, arch check, sync docs, opens PR
Use to validate architecture rules against a diff -- hard gate that blocks PR creation on violations
Use to scan knowledge docs for contradictions, overlaps, and misalignments — dispatched as subagent to isolate token cost
Use to create a new issue (bug report or feature request) and route to the correct backend, then hand off to run-triage
Use to create or update design decision docs (architecture, patterns, rationale) in docs/decisions/ — checks alignment with domain knowledge, triggers clash-check on specs
Use to create or update domain knowledge docs (business rules, invariants, constraints) in docs/domain/ — triggers clash-check on decisions and specs
Use after a PR is opened — reviews the PR, suggests changes or merges to main, then cleans up worktree and branches
Use to finalize work — commits remaining changes, pushes branch, opens a PR with conventional title and structured body
Use to review your own changes — diffs against base branch, checks alignment with spec and domain knowledge
Use to configure a project for the ritual plugin -- detects tech stack, sets architecture rules, discovers versioning manifests, integration toggles, and custom directives
Use to create or update specification docs in docs/specs/ — checks alignment with parent domain knowledge and design decisions
Use when entering a worktree to start work — reads handoff artifact and dispatches the matching orchestrator agent
Use after implementation to detect if docs/ need updating based on changes made — updates docs, triggers clash-check
Use for test-driven development — write failing test, implement until green, repeat per unit of work
Use when starting new work — explores codebase, classifies as feat/fix/refactor/docs, creates branch + worktree + handoff artifact
___ ____ _____ ___ _ __ ___
/ _ | / __ \/ ___/ / _ | / | / / / _ |
/ __ | / /_/ / /__ / __ | / |/ / / __ |
/_/ |_|/_/ \_/\___/ /_/ |_|/_/|___/ /_/ |_|
Opinionated workflow plugins for Claude Code.
Skills, agents, and MCP servers that encode domain-specific processes — from triage to PR.
/plugin → Add Marketplace → yanekyuk/arcana
ritual — Software EngineeringAutonomous pipelines that take work from triage to PR.
Orchestrators — dispatch one, walk away:
| Agent | Pipeline |
|---|---|
feat-orchestrator | handoff → config → spec → TDD → self-review → arch check → docs → PR |
fix-orchestrator | handoff → config → investigate → TDD fix → self-review → arch check → docs → PR |
refactor-orchestrator | handoff → config → test guard → incremental refactor → self-review → arch check → docs → PR |
docs-orchestrator | handoff → config → write/update docs → clash-check → arch check → PR |
Skills — standalone or orchestrator-invoked:
| Skill | What it does |
|---|---|
/run-setup | Interactive project config wizard — tech stack, architecture rules, integrations |
/run-triage | Explore codebase, classify work, create branch + worktree + handoff |
/run-start | Read handoff, dispatch the right orchestrator |
/run-finish | Review PR, merge, clean up worktree and branches |
/run-tdd | Red → green → refactor → commit cycle |
/run-self-review | Diff-based review against spec, domain rules, code quality |
/run-arch-check | Validate architecture rules against diff — hard gate before PR |
/run-open-pr | Safe staging, conventional commit, PR with template |
/run-sync-docs | Detect implicit knowledge in diffs, update docs/ |
/run-spec | Create/update specs, check alignment with parent docs |
/run-domain-knowledge | Create/update domain rules, cascade clash-check |
/run-design-decision | Create/update architecture decisions, check alignment |
/run-clash-check | Detect contradictions across the knowledge hierarchy |
gamedev — Game DevelopmentComing soon.
research — Academic ResearchComing soon.
/run-setup
Interactive wizard that auto-detects your tech stack, lets you pick architecture presets (Layered, Hexagonal, Vertical Slices, or custom), toggle integrations, and add custom directives. Writes docs/ritual-config.json — required before any other skill will run.
/run-triage
Describe what you want to build or fix. Triage classifies it (feat/fix/refactor/docs), creates a branch + worktree, and writes a handoff artifact.
cd .worktrees/<branch-folder>
# start a new Claude session
/run-start
The correct orchestrator picks up the handoff and runs autonomously: spec → TDD → self-review → arch check → docs → PR.
# back in your main session (project root)
/run-finish
Reviews the PR (commits, diff quality, scope, version staleness), merges, and cleans up the worktree.
You: "Fix the auth bug in session handling"
│
/run-triage
│
┌───────────────┴───────────────┐
│ classify → fix │
│ branch → fix/session-auth │
│ worktree + handoff artifact │
└───────────────┬───────────────┘
│
/run-start (in worktree)
│
┌───────────────┴───────────────┐
│ fix-orchestrator │
│ │
│ 1. Read handoff │
│ 2. Load project config │
│ 3. Fetch knowledge docs │
│ 4. Investigate root cause │
│ 5. TDD: reproduce → fix │
│ 6. Self-review │
│ 7. Arch check │
│ 8. Sync docs │
│ 9. Open PR │
└───────────────┬───────────────┘
│
/run-finish (in main session)
│
┌───────────────┴───────────────┐
│ Review → merge → cleanup │
└───────────────────────────────┘
Two-session model: Session 1 (project root) runs /run-setup (once), /run-triage, and /run-finish. Session 2 (in worktree) runs /run-start which dispatches the autonomous pipeline.
The ritual plugin maintains a three-tier knowledge base in docs/:
domain/ ← business rules, invariants (highest authority)
decisions/ ← architecture choices, pattern rationale
specs/ ← feature/fix specifications (most specific)
Changes cascade downward. /run-clash-check detects contradictions across tiers.
MIT
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Complete collection of battle-tested Claude Code configs agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Team-oriented workflow plugin with role agents, 27 specialist agents, ECC-inspired commands, layered rules, and hooks skeleton.
AI-supervised issue tracker for coding workflows. Manage tasks, discover work, and maintain context with simple CLI commands.
Comprehensive C4 architecture documentation workflow with bottom-up code analysis, component synthesis, container mapping, and context diagram generation