create-architecture

Generate an engine-aware master architecture document from GDDs, ADRs, and engine references.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill create-architecture-carlosq96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-architecture
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/create-architecture
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill create-architecture-carlosq96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides the creation of a complete, engine-aware master architecture for the game before any code is written, aligning GDDs, ADRs, and the engine reference library into a concrete blueprint.

Core Features & Use Cases

  • Generates a master architecture document that translates approved GDDs into a concrete technical blueprint.
  • Validates decisions against the pinned engine version and flags gaps or risks.
  • Serves as the bridge between design and implementation to guide sprint planning and ADR creation.

Quick Start

Run the create-architecture skill to generate the master architecture skeleton and save it to docs/architecture/architecture.md.

Frequently Asked Questions about create-architecture

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

FAQPage Schema
How do I generate a master architecture document for a game engine?

Generate a master architecture document by consolidating Game Design Documents, system indexes, and Architecture Decision Records into a single blueprint. The output is a production-ready architecture.md file that guides technical decisions and sprint planning.

What is the best way to align GDDs with engine references before coding?

Align GDDs with engine references by validating design decisions against the pinned engine version. This process flags technical gaps and risks early, translating approved design documents into a concrete, engine-aware technical blueprint.

When do I need an architecture blueprint for sprint planning?

You need an architecture blueprint for sprint planning when preparing for ADR auditing and architecture sign-off. It serves as the bridge between game design and implementation, ensuring all system indexes and engine references are consolidated.

Does this architecture design process enforce engine-version compatibility?

Yes, the architecture design process enforces engine-version compatibility by validating consolidated decisions against the pinned engine version. It actively flags gaps or risks related to engine constraints before producing the final architecture.md.

How do ADRs relate to the master architecture document?

ADRs are consolidated into the master architecture document and subsequently guided by it. The architecture blueprint acts as the foundational skeleton that informs and shapes future Architecture Decision Records and technical implementations.

What are the limitations of using a consolidated architecture document?

A consolidated architecture document requires approved Game Design Documents and a pinned engine version as prerequisites. Without these foundational inputs, the generated blueprint cannot accurately flag technical gaps or validate system compatibility.