create-architecture

Generate an engine-version-aware master architecture document from game design documents and ADRs.

Updated May 13, 2026
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill create-architecture-francisvarga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-architecture
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/create-architecture
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill create-architecture-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents chaotic, undocumented implementation by translating multiple approved GDDs and existing design artifacts into a single, engine-version-aware master architecture document before coding begins.

Core Features & Use Cases

  • Guided architecture authoring: Produces docs/architecture/architecture.md in an ordered, section-by-section walkthrough aligned to the studio’s hierarchy of design-to-implementation handoff.
  • Engine-version-aware validation: Reads the pinned engine reference library, flags HIGH/MEDIUM risk domains, and records knowledge gaps to reduce incorrect assumptions.
  • System-to-code readiness outputs: Defines layer mapping, module ownership, data flows, API boundaries, performs ADR audit and traceability coverage, and lists required new ADRs.
  • Review-gated sign-off workflow: Runs Technical Director self-review, optionally spawns Lead Programmer feasibility review based on review mode, then records sign-off into the architecture document and updates session state for the next stage.

Quick Start

Run the create-architecture skill in full mode to generate the complete master architecture blueprint at 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 translate game design documents into a software architecture blueprint?

To translate game design documents into an architecture blueprint, you map GDD systems into layers, define module ownership, specify data flows, and audit ADR coverage to produce a master architecture document.

What is engine-version-aware architecture validation for game development?

Engine-version-aware architecture validation reads pinned engine reference files, extracts technical requirements, and flags HIGH or MEDIUM risk domains to reduce incorrect assumptions before sprint planning.

How do I audit ADR coverage against my game's system architecture?

To audit ADR coverage against your system architecture, you validate existing Architecture Decision Records against mapped layers and API boundaries, then list required new ADRs to close traceability gaps.

How to define API boundaries and module ownership for a game engine architecture?

Defining API boundaries and module ownership for game engine architecture requires mapping GDD systems into layered structures, enforcing cross-checking on risk domains, and recording technical requirements into a baseline.

Does the architecture generation process support a review-gated sign-off workflow?

Yes, the architecture generation process supports a review-gated sign-off workflow by running Technical Director self-review, optionally spawning Lead Programmer feasibility review, and recording sign-off into the architecture document.

What format does the master architecture blueprint output to?

The master architecture blueprint outputs to a markdown file located at docs/architecture/architecture.md, containing layer mapping, data flows, API boundaries, and ADR audit results.