免费在 GitHub 公开

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. 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

中文简介正在准备中。当前显示原文说明。

jabrena/plinth

实测评分未实测

查看安装方法

包含的文件（2）

SKILL.md2.9 KB
references/030-architecture-adr-general.md18.4 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

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

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.

Synthesize and confirm decision

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

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.

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

001-commands-inventory

免费

Use when you need to generate a checklist document with embedded commands inventory, following the embedded template exactly and producing INVENTORY-COMMANDS-JAVA.md in the project root. This should trigger for requests such as Create embedded commands inventory checklist; Generate INVENTORY-COMMANDS-JAVA.md; Use @001-commands-inventory; Inventory embedded Java project commands; List command files bundled for Java agents. Part of Plinth Toolkit

中文简介正在准备中。当前显示原文说明。