Adr evaluate
Orchestrate adversarial evaluation of architectural options using domain-specific architect agents and produce ranked ADR drafts. TRIGGER when: evaluating design decisions with multiple competing approaches, running architecture trade-off analysis, or needing structured multi-perspective evaluation. DO NOT TRIGGER when: creating a simple ADR (use Dev10x:adr), or making code changes without architecture impact.From its SKILL.md
npx -y skills add Dev10x-Guru/Dev10x-Claude --skill adr-evaluateAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
5.7 KB, as published. Nobody here has run it
ADR Evaluation Skill
Orchestrate adversarial discussion between architect agents to evaluate architectural options and produce ranked ADR drafts.
Input
The user provides:
- Topic: what decision needs to be made
- ADR Number: the target ADR number (optional)
- Options: 2-4 options to evaluate
- Agent assignments: which architect agent advocates for each option (optional — auto-assigned based on domain)
Available Architect Agents
| Agent | Domain |
|---|---|
architect-api | API design, schema, real-time |
architect-db | Database, schema, multi-tenant |
architect-domain | DDD, aggregates, bounded contexts |
architect-frontend | Components, state, SSR, testing |
architect-infra | Deployment, CI/CD, Docker, observability |
Workflow
Phase 1: Dispatch Advocates
For each option, launch the assigned architect agent as a parallel subagent:
Agent(subagent_type="general-purpose",
model="opus", # Design tier — architecture evaluation
description="Advocate for Option N",
prompt="""You are advocating for: [Option N — description]
Context:
- [Topic description]
- [Relevant existing ADRs]
- [Current code state summary]
Your task:
1. Read all relevant source files in the codebase
2. Find evidence supporting your assigned option
3. Count concrete metrics (models, files, LOC, patterns)
4. Identify 3-5 arguments WITH file:line citations
5. Identify risks of NOT choosing your option
6. Be honest about weaknesses of your position
Output format:
## Arguments for [Option N]
1. [Argument with file:path evidence]
## Metrics
- [Concrete counts and measurements]
## Risks of Alternatives
- [What goes wrong if NOT chosen]
## Acknowledged Weaknesses
- [Honest downsides]
Report your final status as the LAST line of your output,
with exactly one of these prefixes:
- DONE — advocacy complete
- DONE_WITH_CONCERNS: <text> — complete but flagged
(weak evidence, conflicting
ADRs, scope creep)
- NEEDS_CONTEXT: <what> — missing input (ADR refs,
file paths, constraint set)
- BLOCKED: <reason> — permission wall, missing
tool, unrecoverable error
Do not write anything after the status line.""",
run_in_background=true)
Parse the trailing status line per
references/orchestration/subagent-status-protocol.md (GH-69):
DONE/DONE_WITH_CONCERNS:→ include the advocacy in the Phase 2 synthesis input; surface concerns to the user as part of "Unverified claims flagged" in Phase 3NEEDS_CONTEXT: <what>→ re-dispatch the affected advocate once with the requested context inlined (do not stall the other advocates)BLOCKED: <reason>→ drop that advocate, run its advocacy inline from the main session, and surface the reason in the final ADR draft so reviewers know one option received reduced rigor
Inline-context preference (GH-69): When the controller has
already read the relevant source files (e.g., during topic
scoping), inline them under <file path="...">...</file>
blocks instead of asking each advocate to Read them dynamically.
Advocates running at Design tier may still Read additional
files when their advocacy requires it, but the controller-
provided baseline avoids N advocates duplicating the same
Reads (and the same permission prompts).
Phase 2: Synthesize
After all advocates return, launch the adr-reviewer agent with
all collected arguments. The reviewer:
- Fact-checks at least 3 claims per advocate (reads cited files)
- Identifies consensus points and genuine trade-offs
- Ranks options by: architecture alignment, migration effort, long-term maintainability, team feasibility
- Drafts ADR following project template
Reviewer agent skip (acceptable): When the main agent has
already accumulated sufficient codebase context from prior
research and advocate agents, it may perform the synthesis
inline without launching the adr-reviewer sub-agent. This
avoids an unnecessary round-trip while preserving the option
for complex evaluations where independent fact-checking adds
value.
Phase 3: Present
Present the draft ADR to the user with:
- Ranked recommendation and confidence level
- Key trade-offs identified
- Unverified claims flagged
- Suggested next steps
REQUIRED: Call AskUserQuestion (do NOT use plain text).
Options:
- Accept recommendation
- Choose a different option
- Request deeper analysis on specific aspect
- Revise options and re-evaluate
Usage Example
/Dev10x:adr-evaluate
Topic: State management approach for the dashboard
ADR Number: 025
Options to evaluate:
1. Server-side state via load functions
2. Client-side reactive store
3. Hybrid with server-first, client cache
Agent assignments:
- architect-frontend (Option 1): SSR patterns
- architect-frontend (Option 2): reactivity patterns
- architect-api (Option 3): data loading