Use when you need to generate Architecture Decision Records (ADRs) for a Java project through an interactive, conversational process that systematically gathers context, stakeholders, options, and outcomes to produce well-structured ADR documents. This should trigger for requests such as Generate ADR; Create Architecture Decision Record; Document architecture decision; Architecture Decision Record for Java. Part of Plinth Toolkit
SkillScore73Maintained
Automatic
◆Doc Ops pack
Last verified 8/20/2026
What it changes
Passed 16 of 22 test cases with the skill, and 15 of 22 without it.
Without skill68%
With skill73%
Checks it passed that the model alone missed
Asks a clarifying question about the caching requirements or context before creating the record.
Restricts context gathering to the current conversation and explicitly available repository files.
2 fixed14 passed either way5 still failing1 broke
Pass-rate lift
+5 pp
Tokens
-3%
Agent turns
0%
Response time
-21%
Model gemini-3.6-flashMeasured 8/20/2026v116 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 2 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 2
Prompt
I need an ADR for my Java application's caching setup. Please write the complete ADR file right away.
What was checked, without and with the skill
Checked
Without skill
With skill
Asks a clarifying question about the caching requirements or context before creating the record.
Missed
Passed
case-01 · gemini-3.6-flash · 8/20/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md55 lines2 files
Java ADR Generator with interactive conversational approach
Generate Architecture Decision Records (ADRs) for Java projects through an interactive, conversational process that elicits the decision inputs needed for a well-structured ADR. This is an interactive SKILL. Use only the current conversation and repository files explicitly available in the current session; do not expose, persist, or reuse unrelated user/project context.
What is covered in this Skill?
ADR file storage configuration
Conversational information gathering: context, stakeholders, decision drivers, options with pros/cons, outcome, consequences
MADR template generation
Constraints
Handle ambiguity and blockers explicitly to avoid implicit assumptions.
EDGE CASE: If the user goal is ambiguous, stop and ask a clarifying question before editing files or running project-wide commands
EDGE CASE: If required context, files, credentials, or tools are missing, report the blocker explicitly and ask whether to proceed with setup or fallback guidance
EDGE CASE: If requested changes conflict with project constraints or safety boundaries, explain the conflict and ask for user confirmation on the preferred trade-off
Use when you need to generate Java project diagrams — including UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, UML Deployment Diagrams, ER (Entity Relationship) diagrams, and bounded-context diagrams — through a modular, step-based interactive process that adapts to your specific visualization needs. This should trigger for requests such as Generate UML diagram; Create sequence diagram; Create class diagram; Create state machine diagram; Create deployme