mcpField
0
030-architecture-adr-general

030-architecture-adr-general

github.com/jabrenaDevelopment456355 installsUpdated 1d ago
Repository

About 030-architecture-adr-general

An interactive skill for creating MADR-style Architecture Decision Records for Java projects. It gathers stakeholders, decision drivers, options, and trade-offs in the conversation, then confirms the decision before writing the record.

Key features

  1. 01Conversationally gathers decision inputs
  2. 02Captures options and trade-offs
  3. 03Confirms the decision before drafting
  4. 04Generates a MADR-style ADR

Use cases

  1. 01Recording a Java framework selection
  2. 02Documenting database or infrastructure choices
  3. 03Comparing architectural alternatives

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jabrena/plinth --skill 030-architecture-adr-general

After installing, type/030-architecture-adr-generalin Claude Code to confirm it loaded.

Bundled filesreferences/030-architecture-adr-general.md

Details

From the project README

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

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

Workflow

  1. Load ADR reference and elicit decision inputs

Load references/030-architecture-adr-general.md from this skill, then elicit stakeholders, decision drivers, options, and trade-offs through the current conversation only.

  1. Synthesize and confirm decision

Summarize recommended option, rationale, and consequences, and confirm alignment with the user before creating the ADR artifact.

  1. Generate ADR output

Create a MADR-style ADR document with the final decision, alternatives, consequences, and follow-up actions.

Reference

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

Comments

Markdown supported