graph-architecture

Manage system architecture with C4 Model, ADR lifecycle, and fitness functions.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/luissimon96/orchestration-devops-agents --skill graph-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: graph-architecture
Source: https://github.com/luissimon96/orchestration-devops-agents/tree/main/.agents/skills/graph-architecture
Command: npx skills add https://github.com/luissimon96/orchestration-devops-agents --skill graph-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill manages system architecture by ensuring alignment between documentation and the actual codebase, identifying and addressing drift over time.

Core Features & Use Cases

  • C4 Model Management: Utilizes C4 Model (Context, Container, Component) to visually represent and manage system architecture.
  • ADR Lifecycle: Manages Architecture Decision Records (ADR) to maintain a clear and up-to-date documentation of decisions made.
  • Fitness Functions: Implements automated checks to verify architecture quality and compliance.
  • Layer Boundary Enforcement: Ensures proper dependency direction across layers of the application.
  • Drift Detection: Monitors and detects architecture drift, helping maintain consistency over time.
  • Use Case: Regularly use this Skill during architecture reviews or when onboarding new developers to ensure everyone is aligned with the system's architecture.

Quick Start

Run the graph-architecture skill to generate a comprehensive architecture report for your system.

Frequently Asked Questions about graph-architecture

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

FAQPage Schema
How do I detect architecture drift between my codebase and documentation?

Architecture drift detection is achieved by comparing your documented C4 Model against the actual codebase. This Skill monitors and reports inconsistencies, ensuring your implementation stays aligned with the intended architectural design.

What is the C4 Model and how does it manage system architecture?

The C4 Model manages system architecture by visualizing it across Context, Container, and Component levels. This Skill leverages these hierarchical diagrams to represent and maintain your system's structural integrity and layer boundaries.

How do I manage the ADR lifecycle for architecture decisions?

Managing the ADR lifecycle involves tracking Architecture Decision Records from creation through evolution. This Skill maintains a clear, up-to-date log of decisions, ensuring software engineering teams have a reliable historical context for architectural changes.

Can I automate architecture governance checks with fitness functions?

Yes, fitness functions automate architecture governance by running checks to verify quality and compliance. This Skill implements these automated functions to enforce proper dependency direction across layers and validate architectural rules continuously.

How do I enforce layer boundary dependencies in my application?

Layer boundary enforcement is handled by verifying proper dependency direction across application layers. This Skill detects improper dependencies, ensuring that architectural rules regarding layer interactions are consistently respected and maintained.

When should I use an architecture governance skill during development?

Architecture governance is best applied during regular architecture reviews or when onboarding new developers. This Skill ensures team alignment with the documented system architecture and maintains consistency by actively detecting drift.