build-infrastructure

Generate an Infrastructure Diagram HTML from approved Database, Architecture, and SoW.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/aoecosystem/project-foundations --skill build-infrastructure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-infrastructure
Source: https://github.com/aoecosystem/project-foundations/tree/main/.cursor/skills/build-infrastructure
Command: npx skills add https://github.com/aoecosystem/project-foundations --skill build-infrastructure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the generation of a consistent Infrastructure Diagram HTML from the approved Database, Architecture, and SoW, ensuring alignment with the project's template and governance rules.

Core Features & Use Cases

  • Generate project-diagrams/<slug>-infrastructure-diagram.html by integrating data from the approved SoW, Architecture, and Database.
  • Enforce Stage: DATABASE_APPROVED through pre-flight checks and stage-gate validation to prevent premature diagram creation.
  • Apply architecture style rules (monolith, hybrid, microservices, serverless) from system-architecture/styles/<style>.md to reflect the chosen approach in the Infrastructure diagram.

Quick Start

Execute the infrastructure diagram generation by issuing /build-infrastructure after the database, architecture, and SoW are approved.

Frequently Asked Questions about build-infrastructure

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

FAQPage Schema
How do I automatically generate an infrastructure diagram from approved architecture documents?

To generate an infrastructure diagram, use the build-infrastructure skill after your Database, Architecture, and Scope of Work are approved, producing a production-grade HTML diagram in the project-diagrams directory.

When do I need stage-gate validation for infrastructure diagram generation?

Stage-gate validation is needed before infrastructure diagram generation to enforce the DATABASE_APPROVED stage, preventing premature output and ensuring the diagram aligns with approved database, architecture, and SOW data.

How to apply architecture style rules to an infrastructure diagram?

Apply architecture style rules by consulting style files like monolith, hybrid, microservices, or serverless, reflecting the chosen system architecture approach directly within the generated infrastructure diagram HTML.

Does infrastructure diagram generation work without an approved Scope of Work?

No, infrastructure diagram generation does not work without an approved Scope of Work, Database, and Architecture, as pre-flight checks enforce the DATABASE_APPROVED stage gate to halt premature creation.

What is the best way to maintain template fidelity when drafting infrastructure diagrams?

The best way to maintain template fidelity when drafting infrastructure diagrams is using automated generation that preserves the project's template while marking the diagram as draft until final review is completed.

Why does my infrastructure diagram output remain marked as draft?

Your infrastructure diagram output remains marked as draft because the generation process intentionally applies this status until final review, ensuring the HTML file awaits explicit approval before production use.