create-architecture

Generate a master architecture document with layer maps, module ownership, and API boundaries.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/emcconnell/nova-scout --skill create-architecture-emcconnell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-architecture
Source: https://github.com/emcconnell/nova-scout/tree/main/.claude/skills/create-architecture
Command: npx skills add https://github.com/emcconnell/nova-scout --skill create-architecture-emcconnell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides the creation of a complete master architecture document that translates approved GDDs and technical constraints into a concrete, implementable blueprint, preventing fragmented decisions and misaligned engineering efforts.

Core Features & Use Cases

  • Comprehensive Context Loading: Automatically reads engine reference files, all GDDs, systems index, existing ADRs, and technical preferences to build a numbered Technical Requirements Baseline.
  • Engine-Aware Risk Flagging: Verifies engine APIs against docs/engine-reference, extracts HIGH/MEDIUM risk changes, and surfaces knowledge gaps before decisions are made.
  • Structured Architecture Output: Produces a system layer map, module ownership tables, data flow diagrams, API boundary contracts, ADR audit and traceability, and a prioritized list of required new ADRs.
  • Collaborative, Incremental Workflow: Runs guided phases with user approvals, writes approved sections incrementally to docs/architecture/architecture.md, and supports Technical Director sign-off and lead-programmer feasibility gating.

Quick Start

Ask the skill to create the master architecture by saying Create a full architecture for the project targeting the configured engine and write 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 blueprint from my design documents?

To generate a master architecture blueprint, consolidate your GDDs, systems index, and ADRs to produce layer maps, data flow diagrams, and API boundaries. This process translates approved design documents into a single actionable architecture document.

How does system design handle engine compatibility for game architecture?

Game architecture system design handles engine compatibility by verifying engine APIs against reference files and flagging HIGH to MEDIUM risk changes. This enforces review gates to prevent fragmented decisions and misaligned engineering efforts across engine versions.

What is included in a technical requirements baseline for system design?

A technical requirements baseline for system design includes a numbered list extracted from engine reference files, GDDs, and existing ADRs. It provides the foundational constraints needed to produce module ownership tables and prioritized required ADRs.

Can I use ADRs to trace module ownership in my architecture document?

Yes, you can use ADRs to trace module ownership by running an ADR audit within your architecture document. This establishes clear API boundary contracts and generates a prioritized list of required new ADRs for technical director sign-off.

What is the best way to consolidate GDDs and engine reference files into one architecture document?

The best way to consolidate GDDs and engine reference files is through a collaborative, incremental workflow that writes approved sections directly to an architecture markdown file. This ensures all technical constraints and design decisions are captured in a single blueprint.

When do I need a master architecture document for my project?

You need a master architecture document when your project faces fragmented decisions and misaligned engineering efforts across multiple GDDs. It becomes necessary to translate approved design documents and engine constraints into a concrete, implementable blueprint.