Loading
Documentation architecture workflow that discovers source truth, designs information architecture, authors living documentation, embeds diagrams, validates links, and gates publication.
npx skills add Reactive-Skills/skills --skill docs-architectnpx -y @reactive-skills/axi invoke docs-architect11
Hierarchical nodes
INTAKE
Bootstrap entrypoint
5
Whitelisted for safety
3
Automated projections
Visual state machine topology parsed directly from the official STATECHART.md in Reactive-Skills/skills:
Each state is an isolated operational slice. Transitions occur only when typed signals satisfy programmatic guard conditions.
Collect source paths, audience, outcomes, and documentation scope
Outgoing Transitions
Array.isArray(event.payload.source_paths) && event.payload.source_paths.length > 0 && event.payload.audience != null && Array.isArray(event.payload.outcomes)!(Array.isArray(event.payload.source_paths) && event.payload.source_paths.length > 0 && event.payload.audience != null && Array.isArray(event.payload.outcomes))Inventory source files and identify authoritative documentation inputs
Outgoing Transitions
event.payload.exit_code === 0event.payload.exit_code !== 0Extract facts, APIs, decisions, interfaces, and operational constraints
Outgoing Transitions
Array.isArray(event.payload.extracted_facts) && event.payload.extracted_facts.length > 0!Array.isArray(event.payload.extracted_facts) || event.payload.extracted_facts.length === 0Choose information architecture and map content to audience outcomes
Outgoing Transitions
event.payload.architecture_decision != null && Array.isArray(event.payload.documentation_outline) && event.payload.documentation_outline.length > 0event.payload.architecture_decision == null || !Array.isArray(event.payload.documentation_outline) || event.payload.documentation_outline.length === 0Draft concise, source-linked documentation from the approved outline
Outgoing Transitions
event.payload.draft_path != null && event.payload.draft_path.length > 0event.payload.draft_path == null || event.payload.draft_path.length === 0Create embedded diagrams from documented relationships and decisions
Outgoing Transitions
Array.isArray(event.payload.diagram_inventory) && event.payload.diagram_inventory.length > 0!Array.isArray(event.payload.diagram_inventory) || event.payload.diagram_inventory.length === 0Check links, terminology, source traceability, diagram integrity, and readability
Outgoing Transitions
event.payload.validation_exit_code === 0event.payload.validation_exit_code !== 0Human review gate for accuracy, usefulness, and publication readiness
Outgoing Transitions
event.payload.approved === trueevent.payload.revisions_requested === trueevent.payload.rejected === trueTerminal state: validated documentation architecture is published
Terminal state: publication rejected or blocked by review
Terminal state: documentation workflow failed
Inspect or drive this state machine directly via the token-efficient AXI CLI:
Check state:
Inspect hierarchy:
Tail events:
Runtime variables persisted across state transitions:
source_pathsaudienceoutcomesdocumentation_scopeextracted_factsarchitecture_decisiondocumentation_outlinediagram_inventorydraft_pathvalidation_exit_codereview_decisiondeliverable_pathRead models automatically rendered upon transition:
Add to your Claude Desktop, Cursor, or VS Code settings:
{
"mcpServers": {
"reactive-skills": {
"command": "npx",
"args": [
"-y",
"@reactive-skills/axi",
"mcp"
]
}
}
}