architect

Generate docs/architecture.md from user stories with Mermaid diagrams.

1|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/sjev/robodev --skill architect-sjev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/sjev/robodev/tree/main/skills/architect
Command: npx skills add https://github.com/sjev/robodev --skill architect-sjev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill helps you define and document the core architecture of your software project, ensuring a solid foundation based on user needs.

Core Features & Use Cases

  • Architecture Definition: Generates a comprehensive architecture.md document.
  • User Story Alignment: Bases architectural decisions on provided user stories.
  • Use Case: When starting a new project, use this Skill to create the initial architecture document by feeding it your project's user stories.

Quick Start

Use the architect skill to create the architecture document based on the user stories.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I generate system architecture documentation from user stories?

To generate system architecture documentation, this Skill analyzes your `docs/user_stories.md` file and existing context. It prompts for clarifying questions to refine decisions before producing a structured `docs/architecture.md` document.

What is the best way to align software design with user needs?

Aligning software design with user needs is achieved by deriving architectural decisions directly from defined user stories. This ensures the foundational system design explicitly addresses documented requirements and constraints.

Can I include Mermaid diagrams when I design system architecture?

Yes, you can include Mermaid diagrams when you design system architecture. The generated `architecture.md` document adheres to a specified template that explicitly incorporates Mermaid diagrams and stated assumptions.

Do I need existing architecture context to create an architecture.md file?

You do not need existing architecture context to create an `architecture.md` file, though the Skill analyzes it if available. It generates the initial document primarily by analyzing your project's `docs/user_stories.md`.

How does the system design process handle unclear architectural decisions?

The system design process handles unclear architectural decisions by prompting you with clarifying questions. This interactive step refines ambiguous architectural choices before the final documentation is generated.

What assumptions are documented when defining software architecture?

When defining software architecture, explicit assumptions are documented directly within the generated `architecture.md` file. This ensures foundational design choices and inferred constraints are transparently recorded.