architecture-design

Designs technical architecture documents from task_spec inputs covering components, data models, and interfaces.

Updated Aug 4, 2026
One-click install
npx skills add https://github.com/rombel00/game-processes --skill architecture-design-rombel00
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-design
Source: https://github.com/rombel00/game-processes/tree/main/plugins/delivery/skills/architecture-design
Command: npx skills add https://github.com/rombel00/game-processes --skill architecture-design-rombel00

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It turns an approved task_spec into a concrete technical architecture document, so implementation starts from justified decisions about components, data models, interfaces, and stack instead of ad-hoc choices made during coding. ## Core Features & Use Cases - Architecture Document Generation: Produces a structured architecture artifact covering functional and system architecture, data model, interfaces, technology stack, analytics events, security, reliability, and deployment. - Simplicity Enforcement: Requires every component and technology to be justified by a specific task_spec requirement, flagging unjustified complexity as premature design. - Existing-System Awareness: For enhancement work, studies prior architecture documents and code first, and raises open questions to the owner instead of silently refactoring. - Use Case: After a game slice's task_spec passes handoff review, use this Skill to produce the architecture document, then route it through the architecture-review gate before task planning begins. ## Quick Start Use the architecture-design skill to design the technical architecture for the current slice based on its approved task_spec.

Frequently Asked Questions about architecture-design

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

FAQPage Schema
How do I design a software architecture document from a specification?▼

Start from an approved task_spec and map each slice unit to components, then detail the data model, interfaces, stack choices, and failure behavior. This Skill enforces that structure through a shared checklist also used by the reviewer.

What should a technical architecture document include?▼

It should cover functional and system architecture, state and data with entities and migrations, internal and external interfaces, technology stack with rationale, analytics events, security, reliability, deployment, open questions, and decision records.

Does this architecture skill write implementation code?▼

No, it explicitly forbids writing code and produces only the architecture document. Code and tests are handled later by the implementation skill after task planning.

Can I use it when extending an existing project instead of starting fresh?▼

Yes, it requires studying the current architecture and prior slice documents before designing. New work must integrate with existing structure, and any needed refactoring is raised as an open question to the owner.

What happens when an architecture decision cannot be made from the spec?▼

Critical uncertainties become blocking open questions for the owner rather than silent assumptions, and the skill returns a blocked status. Non-critical choices may be assumed but must be marked as assumptions.