Development
Skill
/adr
Use when a design decision is made that is expensive to reverse, affects multiple components, or rejects a plausible alternative — record it as an Architecture Decision Record under docs/hydraia/adr/. Also use to supersede an old decision. Not for trivial choices.
Claude Code
$ npx -y skills add jdanigo/hydraia --skill adr --agent claude-code
Codex
$ npx skills add jdanigo/hydraia --skill adr -a codex -y
Cursor
$ npx skills add jdanigo/hydraia --skill adr -a cursor -y
Gemini CLI
$ npx skills add jdanigo/hydraia --skill adr -a gemini-cli -y
GitHub Copilot
$ npx skills add jdanigo/hydraia --skill adr -a github-copilot -y
OpenCode
$ npx skills add jdanigo/hydraia --skill adr -a opencode -y
Windsurf
$ npx skills add jdanigo/hydraia --skill adr -a windsurf -y
SKILL.md
adr.SKILL.mdname: adr
description: Use when a design decision is made that is expensive to reverse, affects multiple components, or rejects a plausible alternative — record it as an Architecture Decision Record under docs/hydraia/adr/. Also use to supersede an old decision. Not for trivial choices.
ADR — Architecture Decision Records (MADR-lite)
One file per decision: `docs/hydraia/adr/NNNN-<slug>.md`, zero-padded, monotonic (`0001-...`, `0002-...`). Find the next number with `ls docs/hydraia/adr/ | sort | tail -1`.
When to write one (all it takes is ONE of these)
- Expensive to reverse (data store, auth model, hosting, framework).
- Affects multiple components or teams.
- A plausible alternative was seriously considered and rejected.
When NONE hold → no ADR. ADR spam buries the decisions that matter.
Template
NNNN — <decision title>
**Status:** proposed | accepted | superseded by NNNN **Date:** YYYY-MM-DD
Context
<the forces: requirements, constraints, and any assumption made because the human could not answer — stated as an assumption with its revisit trigger>
Decision
<what was decided, in one or two sentences, active voice>
Alternatives considered
- <alternative> — rejected because <reason>
Consequences
- Good: <what this buys>
- Bad: <what this costs — every decision costs something; empty is a smell>
Lifecycle rules
- Write at decision time (Phase 2 / greenfield step 5), commit with the spec.
- Supersede, never rewrite: a change of mind = NEW ADR + flip the old one's Status to `superseded by NNNN`. History stays honest.
- The Phase 2 spec references ADRs by number; reviewers check code against accepted ADRs.
Read more
name: adr description: Use when a design decision is made that is expensive to reverse, affects multiple components, or rejects a plausible alternative — record it as an Architecture Decision Record under docs/hydraia/adr/. Also use to supersede an old decision. Not for trivial choices.
ADR — Architecture Decision Records (MADR-lite)
One file per decision: `docs/hydraia/adr/NNNN-<slug>.md`, zero-padded, monotonic (`0001-...`, `0002-...`). Find the next number with `ls docs/hydraia/adr/ | sort | tail -1`.
When to write one (all it takes is ONE of these)
- Expensive to reverse (data store, auth model, hosting, framework).
- Affects multiple components or teams.
- A plausible alternative was seriously considered and rejected.
When NONE hold → no ADR. ADR spam buries the decisions that matter.
Template
NNNN — <decision title>
**Status:** proposed | accepted | superseded by NNNN **Date:** YYYY-MM-DD
Context
<the forces: requirements, constraints, and any assumption made because the human could not answer — stated as an assumption with its revisit trigger>
Decision
<what was decided, in one or two sentences, active voice>
Alternatives considered
- <alternative> — rejected because <reason>
Consequences
- Good: <what this buys>
- Bad: <what this costs — every decision costs something; empty is a smell>
Lifecycle rules
- Write at decision time (Phase 2 / greenfield step 5), commit with the spec.
- Supersede, never rewrite: a change of mind = NEW ADR + flip the old one's Status to `superseded by NNNN`. History stays honest.
- The Phase 2 spec references ADRs by number; reviewers check code against accepted ADRs.
Stats
8
Stars
0
Forks
Maintained
Maintenance
JavaScript
Language
MIT
License
Last commit
Created
Ships withhydraia
An agentic development harness for Claude Code. **One command runs the entire feature pipeline** — it collaborates with you on the design, then builds autonomously: plan, execute, double-review, and verify.
852 skills27 agents
Stars on GitHub
Momentum
- stars in total
- 8
Other skills on hydraia.
More skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about adr.
- Which coding agents can use adr?
- adr installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.