Help us improve
Share bugs, ideas, or general feedback.
From ritual
Use to create or update design decision docs (architecture, patterns, rationale) in docs/decisions/ — checks alignment with domain knowledge, triggers clash-check on specs
npx claudepluginhub yanekyuk/arcana --plugin ritualHow this skill is triggered — by the user, by Claude, or both
Slash command
/ritual:run-design-decisionsonnetThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are creating or updating a design decision document — architectural choices, patterns, and their rationale.
Guides technical evaluation of code review feedback: read fully, restate for understanding, verify against codebase, respond with reasoning or pushback before implementing.
Share bugs, ideas, or general feedback.
You are creating or updating a design decision document — architectural choices, patterns, and their rationale.
Directives: If docs/ritual-config.json exists, read directives.documentation from the config. These are soft guidelines that influence your documentation style, detail level, and terminology. Apply them when writing decision docs. If the field is missing or empty, proceed without directives.
docs/domain/ for related tags and read matches. Verify the decision doesn't violate any domain rules.docs/decisions/<kebab-case-title>.md:---
title: "<descriptive title>"
type: decision
tags: [<lowercase, hyphen-separated, matching module/directory names>]
created: <YYYY-MM-DD>
updated: <YYYY-MM-DD>
---
## Decision
<What was decided>
## Context
<Why this decision was needed>
## Rationale
<Why this option was chosen over alternatives>
## Constraints
<Domain rules that influenced this decision>
git add docs/decisions/<filename>.md
git commit -m "docs: add design decision — <title>"
updated dateDesign decisions sit in the middle tier. Check both directions:
run-clash-check as a subagent targeting docs/specs/. This is a depth-1 cascade — run-clash-check must NOT trigger further cascades.Report: