skills.rest
stellar-zk
stellar-zkOFFICIAL
Explore all skills by this author →
WebsiteGitHub

create-architecture

Creates software architecture decision documents through a guided multi-step collaborative workflow.

3|Updated Feb 26, 2026
Search Tags:#workflow#architecture#project structure#ai agents#solution design#technical decisions#consistency patterns
One-click install
npx skills add https://github.com/stellar-zk/stellar-zk --skill create-architecture-stellar-zk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-architecture
Source: https://github.com/stellar-zk/stellar-zk/tree/main/.claude/skills/create-architecture
Command: npx skills add https://github.com/stellar-zk/stellar-zk --skill create-architecture-stellar-zk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Software projects built by AI agents often suffer from inconsistent technical decisions, conflicting naming conventions, and mismatched patterns across components. This Skill produces a complete architecture decision document that acts as a single source of truth so AI agents implement consistently. ## Core Features & Use Cases - Guided 8-Step Workflow: Walks through initialization, project context analysis, starter template evaluation, core architectural decisions, implementation patterns, project structure, validation, and handoff. - Collaborative Decision Making: Acts as an architectural facilitator with A/P/C menus (Advanced Elicitation, Party Mode, Continue) at each step, requiring user approval before saving content. - Consistency Rules for AI Agents: Defines naming, structure, format, communication, and process patterns that prevent conflicts when multiple AI agents write code. - Use Case: After finishing a PRD for a new web app, run this workflow to produce an architecture.md covering technology stack with verified versions, data architecture, API patterns, and a complete project directory tree before any implementation begins. ## Quick Start Ask the AI to create the technical architecture for your project based on your PRD, for example by saying "let's create architecture".

Frequently Asked Questions about create-architecture

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

FAQPage Schema
How do I create a software architecture document with an AI agent?▼

Run the create-architecture workflow after preparing a PRD. It guides you through eight steps covering context analysis, starter template selection, core decisions, consistency patterns, project structure, and validation, producing an architecture.md document.

What inputs does the architecture workflow require?▼

A Product Requirements Document (PRD) is mandatory; the workflow will not proceed without one. It also optionally discovers UX designs, research documents, project documentation, and project-context.md files from your docs folders.

How does the workflow ensure AI agents write consistent code?▼

Step 5 defines implementation patterns covering naming conventions, file structure, API response formats, event naming, and error handling. These rules prevent different AI agents from making conflicting choices during implementation.

Can I resume an interrupted architecture workflow?▼

Yes. The workflow tracks progress in the document frontmatter via stepsCompleted. On reactivation, step-01b detects the existing document and offers options to resume, continue, review remaining steps, or start over.

Does the workflow verify technology versions before deciding?▼

Yes. Steps 3 and 4 mandate web searches to verify current versions of starter templates and technologies rather than relying on hardcoded versions, ensuring decisions reflect current stable releases.

Related Skills

Explore More Software Engineering Skills→
OzeroHAXOzeroHAX
32

docs-project-prd

Generate a Product Requirements Document with functional and non-functional requirements and acceptance criteria.

Community
Basic
sddevelopment-besddevelopment-be
13

Agent Profile Handoff Patterns Template

Document per-agent handoff patterns with minimal frontmatter and instructions.

Official
Intermediate
yabafreyabafre
2

aped-elicit

Generate structured critiques of selected drafts or decisions using elicitation methods.

Community
Intermediate
constellizeconstellize
1

guide-first-week-adoption

Guide teams through a five-day memory-bank adoption workflow with templates and checklists.

Official
Intermediate