OpenSkillIndex← back to search
claude-codeproductivity

Cursor-rules-java 030-architecture-adr-general

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. Part of the skills-for-java project

install
source · Clone the upstream repo
git clone https://github.com/jabrena/cursor-rules-java
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jabrena/cursor-rules-java "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/030-architecture-adr-general" ~/.claude/skills/jabrena-cursor-rules-java-030-architecture-adr-general && rm -rf "$T"
manifest: skills/030-architecture-adr-general/SKILL.md
tags
#adr#java#architecture#documentation#conversational#decision-making
source content

Java ADR Generator with interactive conversational approach

Generate Architecture Decision Records (ADRs) for Java projects through an interactive, conversational process that systematically gathers all necessary context to produce well-structured ADR documents. This is an interactive SKILL.

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
  • Validation with 
    ./mvnw validate
    or 
    mvn validate
    before proceeding

Constraints

Before applying any ADR generation, ensure the project validates. If validation fails, stop immediately — do not proceed until all validation errors are resolved.

  • MANDATORY: Run 
    ./mvnw validate
    or 
    mvn validate
    before applying any ADR generation
  • SAFETY: If validation fails, stop immediately — do not proceed until all validation errors are resolved
  • BEFORE APPLYING: Read the reference for detailed good/bad examples, constraints, and safeguards for each ADR generation pattern

When to use this skill

  • Generate ADR
  • Create Architecture Decision Record
  • Document architecture decision
  • Architecture Decision Record for Java
  • Write ADR
  • Document technical decision
  • Architecture documentation
  • Record design decision
  • Technology choice documentation
  • Framework selection ADR
  • Database choice ADR
  • Architectural trade-offs
  • Technical alternatives evaluation
  • Why did we choose
  • Deployment strategy ADR
  • Infrastructure choice
  • Vendor selection ADR

Reference

For detailed guidance, examples, and constraints, see references/030-architecture-adr-general.md.