Architecture Graph FAQs

Question 1

What is architectural drift detection?

Accepted Answer

Drift detection uses the /graph:check command to scan your codebase and compare it against your YAML specifications. It identifies missing anchors, implementation mismatches, or orphaned code, helping you maintain a consistent source of truth throughout the development lifecycle.

Question 2

What is the Architecture Graph skill?

Accepted Answer

The Architecture Graph skill is a specialized capability for Claude Code that implements spec-driven development. it allows you to define architectural entities in YAML files within a .graph/ directory and synchronize those definitions directly with your source code through traceable anchors.

Question 3

When should I use this skill?

Accepted Answer

You should use this skill when you want to maintain a 'spec-first' approach to coding. It is ideal for managing complex data models, defining clear relationships between entities, and ensuring that code implementations don't deviate from the intended architectural design.

Question 4

Can this skill help with impact analysis?

Accepted Answer

Yes. By using the /graph:impact command, the skill analyzes entity relations and code references to show you exactly how a proposed change will affect the rest of your system, reducing the risk of breaking changes during refactoring.

Question 5

How do @graph anchors improve my workflow?

Accepted Answer

Anchors are specialized comments (e.g., // @graph:Entity.type) that create a bidirectional link between your design spec and your implementation. This ensures that Claude always knows exactly which code blocks correspond to specific architectural entities, making updates more precise and searchable.

Architecture Graph

Architecture Graph

Características Principales

Casos de Uso

Características Principales

Casos de Uso