architect

Convert ambiguous project ideas into SPEC.md, DESIGN.md, and Mermaid diagrams.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/Keiji-Miyake/agent-skills --skill architect-keiji-miyake
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/Keiji-Miyake/agent-skills/tree/main/skills/architect
Command: npx skills add https://github.com/Keiji-Miyake/agent-skills --skill architect-keiji-miyake

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps product teams and developers transform ambiguous requirements into precise technical specifications and architecture designs, reducing miscommunication and rework.

Core Features & Use Cases

  • SPEC Generation: Convert user goals into a detailed SPEC.md that captures scope, constraints, and acceptance criteria.
  • DESIGN Creation: Produce a coherent DESIGN.md outlining architecture, components, data flows, and interfaces.
  • Visualization & ADR Support: Generate Mermaid diagrams to visualize system structure and decisions; support Architecture Decision Records (ADRs) as needed.

Quick Start

Provide an initial project idea or requirements prompt, and the Architect Skill will draft SPEC.md and DESIGN.md to guide implementation.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I turn vague project ideas into concrete specifications and architecture designs?

To turn vague project ideas into concrete specifications and architecture designs, provide an initial requirements prompt to generate a detailed SPEC.md capturing scope, constraints, and acceptance criteria, alongside a DESIGN.md outlining components and interfaces.

How do I generate Mermaid diagrams and Architecture Decision Records for system design?

Generate Mermaid diagrams and Architecture Decision Records for system design by processing early-stage planning requirements to visualize system structure, data flows, and specific architectural decisions.

What is the best way to create a SPEC.md for early-stage planning and requirements refinement?

The best way to create a SPEC.md for early-stage planning and requirements refinement is to input ambiguous project goals, which are then converted into precise technical specifications capturing scope, constraints, and acceptance criteria.

Can I use this to produce a DESIGN.md for features, modules, and data flows?

Yes, you can produce a DESIGN.md for features, modules, and data flows. The process converts ambiguous requirements into a coherent design document outlining architecture, components, interfaces, and data flows.

Do I need any dependencies or prior environment setup to generate technical specifications?

No dependencies or prior environment setup are required to generate technical specifications. You simply provide an initial project idea or requirements prompt to begin drafting the design and specification documents.