{"id":"b6ca6618-7d6a-4948-adfc-bb1b6b7f0cf0","shortId":"yuChxW","kind":"skill","title":"033-architecture-diagrams","tagline":"Use when you need to generate Java project diagrams — including UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, and ER (Entity Relationship) diagrams — through a modular, step-based interactive process that adapts to your specific visuali","description":"# Java Diagrams Generator with modular step-based configuration\n\nGenerate comprehensive Java project diagrams through a modular, step-based interactive process that covers UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, and ER (Entity Relationship) diagrams using PlantUML syntax. **This is an interactive SKILL**.\n\n**What is covered in this Skill?**\n\n- UML sequence diagram generation for application workflows and API interactions\n- UML class diagram generation for package structure and class relationships\n- C4 model diagram generation at Context/Container/Component levels only (levels 1–3; Code/Level 4 not generated)\n- UML state machine diagram generation for entity lifecycles and business workflows\n- ER diagram generation from SQL schema (DDL, migrations) using PlantUML Chen notation\n- PlantUML syntax for all diagram types\n- File organization strategies: single-file, separate-files, or integrated with existing documentation\n- Final diagram validation with PlantUML syntax checking\n\n## Constraints\n\nBefore applying any diagram generation, ensure the project validates. If validation fails, stop immediately — do not proceed until all validation errors are resolved.\n\n- **MANDATORY**: Run `./mvnw validate` or `mvn validate` before applying any diagram generation\n- **SAFETY**: If validation fails, stop immediately — do not proceed until all validation errors are resolved\n- **BEFORE APPLYING**: Read the reference for detailed good/bad examples, constraints, and safeguards for each diagram generation pattern\n- **C4 LIMIT**: C4 diagrams restricted to levels 1, 2, 3 only (Context, Container, Component); never generate Level 4 (Code) diagrams\n\n## When to use this skill\n\n- Generate UML diagram\n- Create sequence diagram\n- Create class diagram\n- Create state machine diagram\n- Create C4 diagram\n- Generate ER diagram\n\n## Workflow\n\n1. **Validate project state**\n\nRun `./mvnw validate` or `mvn validate` before applying any diagram generation.\n\nStep constraints:\n- If validation fails, stop and ask to resolve errors first\n\n2. **Read reference and configure diagram scope**\n\nRead `references/033-architecture-diagrams.md`, identify requested diagram types, and confirm output organization strategy (single-file, separate-files, or integrated docs).\n\n3. **Generate PlantUML diagrams**\n\nCreate requested diagrams in PlantUML syntax (sequence, class, C4 levels 1-3 only, state machine, ER) using project inputs and context.\n\nStep constraints:\n- Never generate C4 Level 4 (Code) diagrams\n\n4. **Validate and finalize outputs**\n\nCheck generated diagrams for syntax correctness and consistency with selected scope before final delivery.\n\n## Reference\n\nFor detailed guidance, examples, and constraints, see [references/033-architecture-diagrams.md](references/033-architecture-diagrams.md).","tags":["033","architecture","diagrams","cursor","rules","java","jabrena","agent-skills","ai-skills","claude","claude-code","claude-code-skills"],"capabilities":["skill","source-jabrena","skill-033-architecture-diagrams","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/033-architecture-diagrams","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,836 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.981Z","embedding":null,"createdAt":"2026-04-18T22:01:46.311Z","updatedAt":"2026-04-26T18:53:39.981Z","lastSeenAt":"2026-04-26T18:53:39.981Z","tsv":"'-3':370 '/mvnw':214,306 '033':1 '1':132,263,301,369 '2':264,328 '3':133,265,355 '4':135,273,386,389 'adapt':42 'api':111 'appli':190,220,240,312 'applic':108 'architectur':3 'architecture-diagram':2 'ask':323 'base':38,54,66 'busi':147 'c4':21,77,123,256,258,295,367,384 'check':187,394 'chen':159 'class':19,75,114,121,288,366 'code':274,387 'code/level':134 'compon':269 'comprehens':57 'configur':55,332 'confirm':342 'consist':401 'constraint':188,248,317,381,414 'contain':268 'context':267,379 'context/container/component':128 'correct':399 'cover':70,99 'creat':284,287,290,294,359 'ddl':155 'deliveri':407 'detail':245,410 'diagram':4,13,17,20,23,27,32,48,60,73,76,79,83,88,105,115,125,141,150,165,182,192,222,253,259,275,283,286,289,293,296,299,314,333,339,358,361,388,396 'doc':354 'document':180 'ensur':194 'entiti':30,86,144 'er':29,85,149,298,374 'error':209,236,326 'exampl':247,412 'exist':179 'fail':200,227,320 'file':167,172,175,348,351 'final':181,392,406 'first':327 'generat':10,49,56,106,116,126,137,142,151,193,223,254,271,281,297,315,356,383,395 'good/bad':246 'guidanc':411 'identifi':337 'immedi':202,229 'includ':14 'input':377 'integr':177,353 'interact':39,67,95,112 'java':11,47,58 'level':129,131,262,272,368,385 'lifecycl':145 'limit':257 'machin':26,82,140,292,373 'mandatori':212 'migrat':156 'model':22,78,124 'modular':35,51,63 'mvn':217,309 'need':8 'never':270,382 'notat':160 'organ':168,344 'output':343,393 'packag':118 'pattern':255 'plantuml':90,158,161,185,357,363 'proceed':205,232 'process':40,68 'project':12,59,196,303,376 'read':241,329,335 'refer':243,330,408 'references/033-architecture-diagrams.md':336,416,417 'relationship':31,87,122 'request':338,360 'resolv':211,238,325 'restrict':260 'run':213,305 'safeguard':250 'safeti':224 'schema':154 'scope':334,404 'see':415 'select':403 'separ':174,350 'separate-fil':173,349 'sequenc':16,72,104,285,365 'singl':171,347 'single-fil':170,346 'skill':96,102,280 'skill-033-architecture-diagrams' 'source-jabrena' 'specif':45 'sql':153 'state':25,81,139,291,304,372 'step':37,53,65,316,380 'step-bas':36,52,64 'stop':201,228,321 'strategi':169,345 'structur':119 'syntax':91,162,186,364,398 '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' 'type':166,340 'uml':15,18,24,71,74,80,103,113,138,282 'use':5,89,157,278,375 'valid':183,197,199,208,215,218,226,235,302,307,310,319,390 'visuali':46 'workflow':109,148,300","prices":[{"id":"56aeefe8-b947-4af2-8016-6bf76aafebf2","listingId":"b6ca6618-7d6a-4948-adfc-bb1b6b7f0cf0","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:46.311Z"}],"sources":[{"listingId":"b6ca6618-7d6a-4948-adfc-bb1b6b7f0cf0","source":"github","sourceId":"jabrena/cursor-rules-java/033-architecture-diagrams","sourceUrl":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/033-architecture-diagrams","isPrimary":false,"firstSeenAt":"2026-04-18T22:01:46.311Z","lastSeenAt":"2026-04-26T18:53:39.981Z"}],"details":{"listingId":"b6ca6618-7d6a-4948-adfc-bb1b6b7f0cf0","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jabrena","slug":"033-architecture-diagrams","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":"067c05a029ebbaf8d62c3aa080939fc9f1889c51","skill_md_path":"skills/033-architecture-diagrams/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jabrena/cursor-rules-java/tree/main/skills/033-architecture-diagrams"},"layout":"multi","source":"github","category":"cursor-rules-java","frontmatter":{"name":"033-architecture-diagrams","license":"Apache-2.0","description":"Use when you need to generate Java project diagrams — including UML sequence diagrams, UML class diagrams, C4 model diagrams, UML state machine diagrams, and ER (Entity Relationship) 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 C4 diagram. Part of cursor-rules-java project"},"skills_sh_url":"https://skills.sh/jabrena/cursor-rules-java/033-architecture-diagrams"},"updatedAt":"2026-04-26T18:53:39.981Z"}}