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.