Create or update human-validated architecture documentation for a package.
Generates human-validated architecture documentation with C4 diagrams and audit trails.
/plugin marketplace add pietgk/vivief/plugin install devac@viviefCreate or update human-validated architecture documentation for a package.
/validate-architecture <package-path>
# Validate devac-core architecture
/validate-architecture packages/devac-core
# Validate current package
/validate-architecture .
Analyzes package using devac MCP tools:
query_sql for structural queriesfind_symbol for key componentsget_call_graph for relationshipsquery_effects for external integrationsGenerates documentation files:
docs/c4/architecture-validated.md - Full docs with ASCII diagramsdocs/c4/architecture-validated.c4 - LikeC4 DSL for comparisondocs/c4/architecture.reasoning.md - Audit trailSupports refinement - request changes like:
Marks as verified when approved
Human-readable documentation with:
LikeC4 DSL format enabling:
.c4Documents the analysis process:
After validation, run gap analysis:
# Check gap between validated and generated
devac architecture score -p packages/devac-core
# See structural differences
devac architecture diff -p packages/devac-core
devac validate --architecture warnsdevac architecture status - Check if docs need updatingdevac architecture score - Calculate gap metricsdevac architecture diff - Show structural differencesdevac c4 - Generate C4 diagrams from effects