{"id":"98120d09-a4fc-48be-9f46-98090b1fd98d","shortId":"JXveLA","kind":"skill","title":"030-architecture-adr-general","tagline":"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","description":"# Java ADR Generator with interactive conversational approach\n\nGenerate 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**.\n\n**What is covered in this Skill?**\n\n- ADR file storage configuration\n- Conversational information gathering: context, stakeholders, decision drivers, options with pros/cons, outcome, consequences\n- MADR template generation\n\n## Constraints\n\nHandle ambiguity and blockers explicitly to avoid implicit assumptions.\n\n- **EDGE CASE**: If the user goal is ambiguous, stop and ask a clarifying question before editing files or running project-wide commands\n- **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\n- **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\n\n## When to use this skill\n\n- Generate ADR\n- Create Architecture Decision Record\n- Document architecture decision\n- Architecture Decision Record for Java\n- Write ADR\n- Document technical decision\n- Architecture documentation\n- Record design decision\n- Technology choice documentation\n- Framework selection ADR\n- Database choice ADR\n- Architectural trade-offs\n- Technical alternatives evaluation\n- Why did we choose\n- Deployment strategy ADR\n- Infrastructure choice\n- Vendor selection ADR\n\n## Workflow\n\n1. **Read ADR reference and gather context**\n\nRead `references/030-architecture-adr-general.md`, then collect context, stakeholders, decision drivers, options, and trade-offs through conversation.\n\n2. **Synthesize and confirm decision**\n\nSummarize recommended option, rationale, and consequences, and confirm alignment with the user before creating the ADR artifact.\n\n3. **Generate ADR output**\n\nCreate a MADR-style ADR document with the final decision, alternatives, consequences, and follow-up actions.\n\n## Reference\n\nFor detailed guidance, examples, and constraints, see [references/030-architecture-adr-general.md](references/030-architecture-adr-general.md).","tags":["030","architecture","adr","general","cursor","rules","java","jabrena","agent-skills","ai-skills","claude","claude-code"],"capabilities":["skill","source-jabrena","skill-030-architecture-adr-general","topic-agent-skills","topic-ai-skills","topic-claude","topic-claude-code","topic-claude-code-skills","topic-claude-code-subagents","topic-claude-skills","topic-cursor-agent","topic-cursor-ai","topic-cursor-skills","topic-cursorai","topic-github-copilot"],"categories":["cursor-rules-java"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jabrena/cursor-rules-java/030-architecture-adr-general","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jabrena/cursor-rules-java","source_repo":"https://github.com/jabrena/cursor-rules-java","install_from":"skills.sh"}},"qualityScore":"0.631","qualityRationale":"deterministic score 0.63 from registry signals: · indexed on github topic:agent-skills · 362 github stars · SKILL.md body (2,257 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-26T18:53:39.761Z","embedding":null,"createdAt":"2026-04-18T22:01:44.091Z","updatedAt":"2026-04-26T18:53:39.761Z","lastSeenAt":"2026-04-26T18:53:39.761Z","tsv":"'030':1 '1':250 '2':272 '3':294 'action':315 'adr':4,15,38,46,56,76,89,198,212,226,229,243,248,252,292,296,303 'align':285 'altern':235,309 'ambigu':110,125 'approach':51 'architectur':3,12,53,200,204,206,216,230 'architecture-adr-gener':2 'artifact':293 'ask':128,157,182 'assumpt':117 'avoid':115 'blocker':112,154 'boundari':177 'case':119,142,167 'chang':170 'choic':222,228,245 'choos':240 'clarifi':130 'collect':260 'command':140 'configur':92 'confirm':185,275,284 'conflict':171,180 'consequ':104,282,310 'constraint':108,174,322 'context':28,70,96,145,256,261 'convers':23,50,63,93,271 'cover':85 'creat':199,290,298 'credenti':147 'databas':227 'decis':13,54,98,201,205,207,215,220,263,276,308 'deploy':241 'design':219 'detail':318 'document':39,77,203,213,217,223,304 'driver':99,264 'edg':118,141,166 'edit':133 'evalu':236 'exampl':320 'explain':178 'explicit':113,155 'fallback':164 'file':90,134,146 'final':307 'follow':313 'follow-up':312 'framework':224 'gather':27,67,95,255 'general':5 'generat':11,47,52,107,197,295 'goal':123 'guidanc':165,319 'handl':109 'implicit':116 'inform':94 'infrastructur':244 'interact':22,49,62,81 'java':18,45,58,210 'madr':105,301 'madr-styl':300 'miss':151 'necessari':69 'need':9 'off':233,269 'option':30,100,265,279 'outcom':32,103 'output':297 'prefer':188 'proceed':160 'process':24,64 'produc':34,72 'project':19,59,138,173 'project-wid':137 'pros/cons':102 'question':131 'rational':280 'read':251,257 'recommend':278 'record':14,55,202,208,218 'refer':253,316 'references/030-architecture-adr-general.md':258,324,325 'report':152 'request':44,169 'requir':144 'run':136 'safeti':176 'see':323 'select':225,247 'setup':162 'skill':82,88,196 'skill-030-architecture-adr-general' 'source-jabrena' 'stakehold':29,97,262 'stop':126 'storag':91 'strategi':242 'structur':37,75 'style':302 'summar':277 'synthes':273 'systemat':26,66 'technic':214,234 'technolog':221 'templat':106 'tool':149 'topic-agent-skills' 'topic-ai-skills' 'topic-claude' 'topic-claude-code' 'topic-claude-code-skills' 'topic-claude-code-subagents' 'topic-claude-skills' 'topic-cursor-agent' 'topic-cursor-ai' 'topic-cursor-skills' 'topic-cursorai' 'topic-github-copilot' 'trade':190,232,268 'trade-off':189,231,267 'trigger':42 'use':6,194 'user':122,184,288 'vendor':246 'well':36,74 'well-structur':35,73 'whether':158 'wide':139 'workflow':249 'write':211","prices":[{"id":"1970d72e-2fc4-48d2-a186-07c282e6ba2c","listingId":"98120d09-a4fc-48be-9f46-98090b1fd98d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jabrena","category":"cursor-rules-java","install_from":"skills.sh"},"createdAt":"2026-04-18T22:01:44.091Z"}],"sources":[{"listingId":"98120d09-a4fc-48be-9f46-98090b1fd98d","source":"github","sourceId":"jabrena/cursor-rules-java/030-architecture-adr-general","sourceUrl":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/030-architecture-adr-general","isPrimary":false,"firstSeenAt":"2026-04-18T22:01:44.091Z","lastSeenAt":"2026-04-26T18:53:39.761Z"}],"details":{"listingId":"98120d09-a4fc-48be-9f46-98090b1fd98d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jabrena","slug":"030-architecture-adr-general","github":{"repo":"jabrena/cursor-rules-java","stars":362,"topics":["agent-skills","ai-skills","claude","claude-code","claude-code-skills","claude-code-subagents","claude-skills","cursor-agent","cursor-ai","cursor-skills","cursorai","github-copilot","intellij-idea","java","prompting","system-prompts"],"license":"apache-2.0","html_url":"https://github.com/jabrena/cursor-rules-java","pushed_at":"2026-04-26T13:48:39Z","description":"A curated and opinionated collection of Skills and Agents to be used in modern SDLC workflows for Java Enterprise development with your favorite AI Agent harness.","skill_md_sha":"59d55c2e6b6725439bfe2605e32ed514704e9365","skill_md_path":"skills/030-architecture-adr-general/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/030-architecture-adr-general"},"layout":"multi","source":"github","category":"cursor-rules-java","frontmatter":{"name":"030-architecture-adr-general","license":"Apache-2.0","description":"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 cursor-rules-java project"},"skills_sh_url":"https://skills.sh/jabrena/cursor-rules-java/030-architecture-adr-general"},"updatedAt":"2026-04-26T18:53:39.761Z"}}