gspec-architect

Generate a technology-aware architecture document with data models and API design.

6|2|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/gballer77/gspec --skill gspec-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gspec-architect
Source: https://github.com/gballer77/gspec/tree/main/pages/.claude/skills/gspec-architect
Command: npx skills add https://github.com/gballer77/gspec --skill gspec-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert product specifications into a concrete, actionable Technical Architecture Document that guides implementation and identifies technical gaps.

Core Features & Use Cases

  • Generate a complete Technical Architecture Document mapping product requirements to system components, data models, API contracts, and deployment considerations.
  • Identify technical gaps, ambiguities, and edge cases in existing specs and propose concrete, trade-off informed solutions with rationale.
  • Produce architecture artifacts (directory structure, ERD, API design, environment setup) that feed into gspec-implement and downstream teams.

Quick Start

Analyze the current gspec docs and generate gspec/architecture.md with a technology-aware Architectural Document.

Frequently Asked Questions about gspec-architect

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

FAQPage Schema
How do I convert product specifications into a technical architecture document?

Converting product specifications into a technical architecture document involves mapping requirements to system components, data models, and API contracts. This Skill generates a structured architecture.md with directory structures and deployment considerations from your existing specs.

What is gap analysis in software architecture design?

Gap analysis in software architecture design identifies technical ambiguities, missing specifications, and edge cases in product requirements. It proposes concrete, trade-off informed solutions with rationale to ensure the architecture is complete and actionable for downstream implementation.

How do I design an API and data model from existing product specs?

Designing an API and data model from product specs requires mapping product requirements to system components. This Skill produces architecture artifacts including ERD data models and API design contracts, aligning the technical stack with your specification documents.

Does generating an architecture document include deployment and environment configuration?

Generating an architecture document includes deployment considerations and environment configuration setup. The output provides a complete, technology-aware technical architecture covering directory structure, data models, API design, and deployment factors suitable for review.

What is the best way to identify technical gaps in product specifications?

The best way to identify technical gaps in product specifications is performing an explicit gap analysis during architecture creation. This process highlights ambiguities and edge cases, proposing actionable options with rationale to resolve missing technical details.