create-architecture

Orchestrate architecture decisions through structured Q&A and artifact generation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ian97531/goodplan --skill create-architecture-ian97531
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-architecture
Source: https://github.com/ian97531/goodplan/tree/main/skills/create-architecture
Command: npx skills add https://github.com/ian97531/goodplan --skill create-architecture-ian97531

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architecture decisions are often made in an ad-hoc, siloed fashion. This Skill guides teams through a structured Q&A workflow to capture goals, constraints, and decisions.

Core Features & Use Cases

  • Interactive sessions that drive conventions.md and architecture files, ensuring traceability across epics.
  • Re-entrant workflow that handles active epics and fallback paths for non-epic projects.
  • Generates architecture directory scaffolds (overview, conventions, data-model, and API surfaces) aligned with epic/architecture strategy and ready for writing.

Quick Start

Start the process with /create-architecture to begin driving architecture decisions.

Frequently Asked Questions about create-architecture

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

FAQPage Schema
Does the structured architecture workflow support re-entrancy across multiple sessions?▼

Yes, the structured architecture workflow supports re-entrancy across sessions. It handles active epics and fallback paths to ensure repeatable processes and traceability throughout the architecture lifecycle.

How do I document software architecture decisions from an initial idea to a concrete design?▼

To document software architecture decisions from an initial idea, this Skill uses structured Q&A to orchestrate goals and constraints, then generates architecture files like conventions and data models for traceable design.

What is the best way to establish architecture conventions for an active epic workstream?▼

The best way to establish architecture conventions for an active epic is through a re-entrant workflow that drives conventions.md and architecture files, ensuring decisions remain traceable across ongoing architecture workstreams.

How do I scaffold an architecture directory with overview, conventions, and API surfaces?▼

You scaffold an architecture directory by completing the interactive Q&A process, which generates ready-to-write files for overview, conventions, data-model, and API surfaces aligned with your project strategy.

Can I use this architecture workflow for standalone repositories without an active epic?▼

Yes, you can use this architecture workflow for standalone repositories. It includes fallback paths for non-epic projects, ensuring the structured decision-making process applies to any standalone repo.

Does the structured architecture workflow support re-entrancy across multiple sessions?▼

Yes, the structured architecture workflow supports re-entrancy across sessions. It handles active epics and fallback paths to ensure repeatable processes and traceability throughout the architecture lifecycle.