skills.rest
terrylica
terrylicaCOMMUNITY
Explore all skills by this author →
GitHub

adr-graph-easy-architect

Create ASCII architecture diagrams for ADRs using Graph-Easy syntax.

62|10|Updated Dec 4, 2025
Search Tags:#architecture#documentation#visualization#ADR#diagrams#ASCII#graph-easy
One-click install
npx skills add https://github.com/terrylica/cc-skills --skill adr-graph-easy-architect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-graph-easy-architect
Source: https://github.com/terrylica/cc-skills/tree/main/plugins/itp/skills/adr-graph-easy-architect
Command: npx skills add https://github.com/terrylica/cc-skills --skill adr-graph-easy-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Creating clear, embeddable architecture diagrams for Architecture Decision Records (ADRs) often requires external image tools or complex syntax, leading to maintenance headaches and broken rendering. This skill simplifies diagramming by generating pure ASCII text diagrams directly within Markdown.

Core Features & Use Cases

  • Pure ASCII Diagram Generation: Creates architecture diagrams using graph-easy that embed directly into Markdown, eliminating image dependencies.
  • Automated Layout: Focus on defining relationships, and the tool handles the visual layout, saving design time.
  • ADR-Specific Patterns: Provides guidance and examples for "Before/After" and "Architecture" diagrams, crucial for ADRs.
  • Use Case: When documenting a new system architecture or a significant change, use this skill to quickly generate a clear, version-controlled diagram that lives alongside your ADR, ensuring consistency and easy updates.

Quick Start

Generate an ASCII architecture diagram for the current ADR. Include a 'Before/After' diagram for the Context section and an 'Architecture' diagram for the Architecture section.

Frequently Asked Questions about adr-graph-easy-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create ASCII architecture diagrams for ADRs without external tools?▼

ASCII architecture diagrams embed directly in Markdown using Graph-Easy syntax, eliminating image dependencies and rendering issues. This Skill generates pure text diagrams that version-control alongside your ADR documentation.

Can I visualize Before/After architecture changes in my ADR?▼

Yes. This Skill provides Before/After diagram patterns specifically for ADRs documenting migrations, integrations, or system changes, letting you show architectural transitions clearly within Markdown.

What's the best way to document system architecture decisions with diagrams?▼

Embed ASCII diagrams directly in your ADR using Graph-Easy. The Skill automates layout from relationship definitions, producing clear Architecture views that stay synchronized with your documentation.

Do I need rendering dependencies to include architecture diagrams in Markdown?▼

No. Graph-Easy ASCII diagrams require no external rendering tools or image assets. They display as plain text in any Markdown viewer, reducing maintenance overhead and broken links.

Can Graph-Easy handle complex system architecture diagrams?▼

Yes. Graph-Easy automates visual layout for relationship-based diagrams, handling complex architectures without manual positioning. Focus on defining connections; the tool manages the spatial arrangement.

When should I use ASCII diagrams instead of image-based architecture documentation?▼

Use ASCII diagrams for ADRs and version-controlled documentation where portability, searchability, and git diffs matter. They're ideal when external image tools create maintenance friction or rendering inconsistency.

Related Skills

Explore More Software Engineering Skills→
jonnathan-lsjonnathan-ls

architecture

Document architectural decisions with trade-offs using ADR templates.

Community
Advanced
microsoftmicrosoft
2.9k

wiki-vitepress

Package wiki Markdown into a VitePress static site with dark theme and Mermaid diagrams.

Official
Advanced
abudhahirabudhahir

mermaid-diagrams

Generate flowcharts, sequence, class, and ER diagrams from Mermaid syntax.

Community
Intermediate
walterfanwalterfan
1

Diagram Render Skill

Render PlantUML, Mermaid, and Graphviz code blocks into PNG or SVG images.

Community
Intermediate