{"ref":"capability:architecture-diagrams","page":"/capabilities/architecture-diagrams","json":"/capabilities/architecture-diagrams.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"architecture-diagrams","name":"Architecture diagrams","domain":"developer-experience","ecosystems":["btp"],"universal":false,"description":"Drawing the architecture and components of a solution so another person can understand their responsibilities and connections. Shared notation makes diagrams readable across teams.","short":"Drawing a solution's architecture and components","core_coverage":{"state":"core-and-community","assessed_at":"2026-09-28","relationship":"narrow-by-design","what_core_does":"SAP publishes the visual language as the [SAP BTP Solution Diagram Guidelines](artifact:sap-btp-solution-diagrams), with editable templates for [draw.io](external:drawio) and PowerPoint and a set of service icons for Lucidchart. SAP's reference architectures in [SAP/architecture-center](artifact:architecture-center) carry their diagrams as editable draw.io files, and its site runs an Architecture Validator that checks an uploaded draw.io diagram.","where_it_stops":"It stops at the rules, the templates and a check of a diagram someone has already drawn. Nothing official turns a description into a diagram that follows them.","community_adds":"The community answer is a generator: agent skills and an MCP server that turn a described landscape into a diagram in this style, carrying SAP's icons and reference templates with them. Several also check what they drew before handing it over, either by reading the file or by looking at the rendered picture.","sources":[{"url":"https://github.com/SAP/btp-solution-diagrams","title":"SAP/btp-solution-diagrams — README","checked":"2026-09-13","quote":"solution diagram repository, based on the official SAP Business Technology Platform Solution diagram guideline"},{"url":"https://github.com/SAP/btp-solution-diagrams","title":"SAP/btp-solution-diagrams — README","checked":"2026-09-13","quote":"For the [Lucidchart](https://lucid.app/marketplace#/listing/8e327624-ad9a-4ccf-b74c-325bb907a0ef) integration please check the offical documentation how to add the **SAP Business Technology Platform Service Icons**"},{"url":"https://sap.github.io/btp-solution-diagrams/","title":"SAP BTP Solution Diagrams — site","checked":"2026-09-13","quote":"Currently, editable BTP Solution Diagram templates are only provided for draw.io and PowerPoint."},{"url":"https://raw.githubusercontent.com/SAP/architecture-center/main/docs/community/02-Guidelines/08-ArchitectureValidator/readme.md","title":"Architecture Validator in SAP/architecture-center","checked":"2026-09-28","quote":"It performs automated content checks to support contributors and reviewers in identifying common issues early in the authoring process."},{"url":"https://raw.githubusercontent.com/SAP/architecture-center/main/docs/community/02-Guidelines/08-ArchitectureValidator/readme.md","title":"Architecture Validator in SAP/architecture-center","checked":"2026-09-28","quote":"Only **draw.io** diagrams are supported at this time."},{"url":"https://raw.githubusercontent.com/SAP/architecture-center/main/docs/community/02-Guidelines/05-components.md","title":"Components guideline in SAP/architecture-center","checked":"2026-09-15","quote":"This section features an admonition for a Draw.io file located in the architecture section of the page."}]},"facets":[{"key":"diagram_format","label":"Diagram format","kind":"many","values":["drawio","powerpoint"]},{"key":"checks_the_file","label":"Checks the file","kind":"flag","group":"checking"},{"key":"checks_the_picture","label":"Checks the picture","kind":"flag","group":"checking"},{"key":"repairs_findings","label":"Repairs findings","kind":"flag","group":"checking"}],"drafted_with_ai":true,"history":[{"date":"2026-09-15","field":"core_coverage.what_core_does","from":"SAP publishes the visual language as the [SAP BTP Solution Diagram Guidelines](artifact:sap-btp-solution-diagrams), with editable templates for [draw.io](external:drawio) and PowerPoint and a set of service icons for Lucidchart.","to":"SAP publishes the visual language as the [SAP BTP Solution Diagram Guidelines](artifact:sap-btp-solution-diagrams), with editable templates for [draw.io](external:drawio) and PowerPoint and a set of service icons for Lucidchart. SAP's reference architectures in [SAP/architecture-center](artifact:architecture-center) carry their diagrams as editable draw.io files, and its site runs an Architecture Validator that checks an uploaded draw.io diagram.","reason":"The SAP Architecture Center enters as an artifact in this batch: its reference architectures carry their diagrams as draw.io files, and its Architecture Validator is an official check of a finished diagram."},{"date":"2026-09-15","field":"core_coverage.where_it_stops","from":"It stops at the rules and the templates. Nothing official turns a description into a diagram that follows them.","to":"It stops at the rules, the templates and a check of a diagram someone has already drawn. Nothing official turns a description into a diagram that follows them.","reason":"With the validator there is an official check of a drawn diagram, so the core no longer stops at the rules and the templates alone; generating a diagram from a description is still not covered."},{"date":"2026-09-28","field":"core_coverage.community_adds","from":null,"to":"The community answer is a generator: agent skills and an MCP server that turn a described landscape into a diagram in this style, carrying SAP's icons and reference templates with them. Several also check what they drew before handing it over, either by reading the file or by looking at the rendered picture.","reason":"The coverage state said core-and-community with nothing saying what the community side is. All five options were re-read for this pass: four of them generate a diagram from a description, which is the thing where_it_stops names as uncovered."},{"date":"2026-09-28","field":"facets","from":null,"to":"diagram_format, checks_the_file, checks_the_picture, repairs_findings","reason":"The options are otherwise the same shape — a described landscape in, a diagram in SAP's style out — so the columns are the two facts that separate them: what format the diagram comes in, and what happens to it after it is drawn. Columns every option would fill, such as bundled SAP icons, were left out."},{"date":"2026-09-28","field":"core_coverage.assessed_at","from":"2026-09-15","to":"2026-09-28","reason":"Every provider edge on this capability was re-read against its own documentation in this pass."},{"date":"2026-10-17","field":"description","from":"Drawing the architecture and components of a solution on BTP so that another person can read the diagram. SAP's solution diagram guideline sets a visual language for this, so a diagram that follows it reads the same whoever drew it.","to":"Drawing the architecture and components of a solution so another person can understand their responsibilities and connections. Shared notation makes diagrams readable across teams.","reason":"Keep the default capability wording neutral; preserve the previous wording in framing_by_ecosystem.btp. Maintainer-requested scope audit."}],"framing_by_ecosystem":{"btp":{"description":"Drawing the architecture and components of a solution on BTP so that another person can read the diagram. SAP's solution diagram guideline sets a visual language for this, so a diagram that follows it reads the same whoever drew it."}}},"sap_delivery":{"door":"btp","all":{"built_in":[],"documented_pattern":[],"announced":[],"packages":[{"ref":"artifact:sap-btp-solution-diagrams","name":"SAP BTP Solution Diagram Guidelines","json":"/artifacts/sap-btp-solution-diagrams.json"}]},"by_flavor":{}},"edges":{"use_cases":[{"id":"check-a-btp-solution-diagram-against-the-guideline","name":"Check a BTP solution diagram against the guideline","capability":"capability:architecture-diagrams","ecosystem":"btp","outcome":"A BTP solution diagram exists, and before it goes into a document or a review someone wants to know whether it follows SAP's visual language rather than only looking about right.","boundary":"About a diagram that has already been drawn, whoever or whatever drew it. Drawing one from a description is the rest of this capability and is not assessed here. Whether the architecture the diagram shows is a sound one is a different question that none of these checks answers.","origin":"Editorial hypothesis, taken from the capability's own boundary: SAP's coverage stops at a check of a diagram someone has already drawn, and every option on the capability says something about what happens after the drawing.","requirement_dimensions":["Whether the diagram is a draw.io file or something else","Whether Python is available on the machine that runs the check","Whether the check has to run without a person looking at the result"],"needs":[{"key":"checks_the_file"}],"contributions":[{"ref":"artifact:architecture-center","role":"SAP's own check of a finished diagram","state":"documented","description":"The Architecture Validator on the SAP Architecture Center site takes an uploaded diagram and reports common issues. It reads draw.io files and nothing else.","remaining_work":"Upload the diagram by hand and read the report. The readme names no individual rules, so which breaches are caught has to be found out by using it.","sources":[{"url":"https://raw.githubusercontent.com/SAP/architecture-center/main/docs/community/02-Guidelines/08-ArchitectureValidator/readme.md","title":"Architecture Validator in SAP/architecture-center","checked":"2026-09-28","quote":"It performs automated content checks to support contributors and reviewers in identifying common issues early in the authoring process."},{"url":"https://raw.githubusercontent.com/SAP/architecture-center/main/docs/community/02-Guidelines/08-ArchitectureValidator/readme.md","title":"Architecture Validator in SAP/architecture-center","checked":"2026-09-28","quote":"Only **draw.io** diagrams are supported at this time."}]},{"ref":"artifact:sap-btp-solution-diagrams","role":"the rules a diagram is read against","state":"documented","description":"States the visual language itself, in line with the SAP Fiori Horizon principles and colour palette. It is what every check here compares a diagram to; it runs no check of its own.","remaining_work":"Read the rule and compare the diagram by eye, unless one of the other contributions does it.","sources":[{"url":"https://github.com/SAP/btp-solution-diagrams","title":"SAP/btp-solution-diagrams — README","checked":"2026-09-13","quote":"designed in accordance with the SAP Fiori Horizon principles and color palette"}]},{"ref":"artifact:marianfoo-btp-drawio-skill","role":"a validator and an autofixer inside the drawing skill","state":"conditional","description":"validate.py reads the file for bent arrows, clipped labels, off-palette colours, off-grid coordinates, wrong stroke widths and non-Helvetica fonts, autofix.py repairs what it finds, and a second loop renders the diagram and scores the picture against the SAP corpus.","conditions":["Python 3.8 or later on the PATH: without it the validator and the scorer do not run, and the diagram is drafted without the checks"],"remaining_work":"Install the skill and drive it from an agent; the checks run as part of the skill's pipeline rather than against a file someone brings to it.","remaining_kinds":["configuration"],"sources":[{"url":"https://raw.githubusercontent.com/marianfoo/btp-drawio-skill/main/README.md","title":"marianfoo/btp-drawio-skill — README, What's bundled","checked":"2026-09-28","quote":"**A validator + autofixer** (`validate.py`, `autofix.py`) that catch and mechanically repair bent arrows, clipped labels, off-palette colors, off-grid coordinates, wrong stroke widths, non-Helvetica fonts, and more"},{"url":"https://raw.githubusercontent.com/marianfoo/btp-drawio-skill/main/README.md","title":"marianfoo/btp-drawio-skill — README, Good to know (limits)","checked":"2026-09-28","quote":"**No Python → no quality gates.** Claude can still draft a diagram, but the validator/scorer won't run, so you lose the off-palette / bent-arrow / clipped-label checks."},{"url":"https://raw.githubusercontent.com/marianfoo/btp-drawio-skill/main/README.md","title":"marianfoo/btp-drawio-skill — README, Nudge it to a good diagram","checked":"2026-09-28","quote":"The skill ships a feedback loop that closes the gap — when you ask Claude to keep improving, it renders the diagram to an image, scores it against the SAP corpus, *looks at the picture*, fixes one thing, and re-checks."}]},{"ref":"artifact:lemaiwo-btp-drawio-skill","role":"a validator script inside the drawing skill","state":"documented","description":"The plugin states validating a .drawio diagram against the SAP Fiori Horizon guidelines beside generating and editing one, and ships validate_drawio.py as one of three helper scripts.","remaining_work":"Install the plugin in Claude Code or Cowork and ask for the check; the README names no version of Python for the scripts.","remaining_kinds":["configuration"],"sources":[{"url":"https://raw.githubusercontent.com/lemaiwo/btp-drawio-skill/main/README.md","title":"lemaiwo/btp-drawio-skill — README, What you get","checked":"2026-09-28","quote":"Generate, edit, and validate SAP BTP solution diagrams (.drawio) following SAP Fiori Horizon guidelines — the full official BTP icon library bundled."},{"url":"https://raw.githubusercontent.com/lemaiwo/btp-drawio-skill/main/README.md","title":"lemaiwo/btp-drawio-skill — README, What's inside the plugin","checked":"2026-09-28","quote":"3 Python helper scripts (`validate_drawio.py`, `generate_btp_diagram.py`, `download_btp_libraries.py`) — zero third-party dependencies"}]},{"ref":"artifact:miyasuta-claude-drawio-btp-diagram","role":"two review steps in a person-and-Claude workflow","state":"documented","description":"WORKFLOW.md names a structural review Claude runs on the XML it wrote, and a visual review it runs on the screenshot the person pastes back. Both read the project's own rule and style files, which sit under its Japanese summary of SAP's guideline.","remaining_work":"A person has to paste the diagram into draw.io and share the screenshot before the second review can happen.","sources":[{"url":"https://raw.githubusercontent.com/miyasuta/claude-drawio-btp-diagram/main/docs/WORKFLOW.md","title":"claude-drawio-btp-diagram — WORKFLOW.md, step 4.5","checked":"2026-09-28","quote":"### ステップ4.5: 構造レビュー（Claude が自動実行）"},{"url":"https://raw.githubusercontent.com/miyasuta/claude-drawio-btp-diagram/main/docs/WORKFLOW.md","title":"claude-drawio-btp-diagram — WORKFLOW.md, step 5.5","checked":"2026-09-28","quote":"### ステップ5.5: ビジュアルレビュー（Claude が実行）"}]},{"ref":"artifact:etosin-arc-draw","role":"none for this outcome","state":"explicitly-unsupported","description":"The maintainer lists a diagram linter that would check an existing .drawio file against the SAP guideline on the roadmap, so the release carries no such check. The guideline reaches the agent as a drawing constitution before the diagram, not as a check after it.","remaining_work":"Read the drawn canvas by eye, or run one of the other contributions over the exported file.","sources":[{"url":"https://raw.githubusercontent.com/etosin/arc-draw/main/README.md","title":"ARC-DRAW — README, Roadmap","checked":"2026-09-28","quote":"- [ ] Diagram linter: check an existing `.drawio` file against the SAP guideline"}]}],"unknowns":["The Architecture Validator readme names no individual rules, so what it catches beyond common issues is not established.","Its readme speaks of baseline architectural expectations and does not say it reads a diagram against the SAP BTP Solution Diagram Guidelines, so the two are not documented as the same check.","lemaiwo/btp-drawio-skill ships validate_drawio.py as a Python script and states no version requirement, so whether the check runs on a machine without Python is not established.","No source read in this pass shows any of these checks catching a guideline breach in a finished diagram, so every entry here rests on the maintainer's description of the check.","None of the community checks documents running over a diagram it did not draw itself."],"assessed_at":"2026-09-28","drafted_with_ai":true,"readings":[],"omitted_contributions":0,"assessment_kind":"documented-contributions"}],"shared_tasks":[],"related_tasks":[],"options":[{"ref":"artifact:likweitan-abap-skills","name":"abap-skills","json":"/artifacts/likweitan-abap-skills.json","ecosystem":"abap","origin_ring":"independent"},{"ref":"artifact:etosin-arc-draw","name":"ARC-DRAW","json":"/artifacts/etosin-arc-draw.json","ecosystem":"btp","origin_ring":"independent"},{"ref":"artifact:lemaiwo-btp-drawio-skill","name":"btp-solution-diagram-generator","json":"/artifacts/lemaiwo-btp-drawio-skill.json","ecosystem":"btp","origin_ring":"independent"},{"ref":"artifact:miyasuta-claude-drawio-btp-diagram","name":"drawio-btp-diagram-skills","json":"/artifacts/miyasuta-claude-drawio-btp-diagram.json","ecosystem":"btp","origin_ring":"independent"},{"ref":"artifact:lofond-drawio-skill-sap","name":"drawio-skill-sap","json":"/artifacts/lofond-drawio-skill-sap.json","ecosystem":"btp","origin_ring":"independent"},{"ref":"artifact:sap-btp-solution-diagrams","name":"SAP BTP Solution Diagram Guidelines","json":"/artifacts/sap-btp-solution-diagrams.json","ecosystem":"btp","origin_ring":"sap-official"},{"ref":"artifact:marianfoo-btp-drawio-skill","name":"sap-architecture","json":"/artifacts/marianfoo-btp-drawio-skill.json","ecosystem":"btp","origin_ring":"independent"}],"samples":[{"ref":"artifact:architecture-center","name":"SAP/architecture-center","json":"/artifacts/architecture-center.json"}],"explained_by":[{"ref":"content:creating-an-arc-1-btp-diagram-with-codex-and-a-drawio-skill","name":"Creating an ARC-1 BTP Diagram with Codex and a draw.io Skill","json":"/content/creating-an-arc-1-btp-diagram-with-codex-and-a-drawio-skill.json"}],"normative_context":[]}}