generate-tech-spec

Translate natural-language workload descriptions into AWS technical specifications and architecture diagrams.

1|1|Updated Oct 21, 2024

Search Tags:#architecture #aws #cloud #infrastructure-as-code #diagram #well-architected #tech-spec

Ready to run

npx skills add https://github.com/yuvarajd85/ai-ml-learnings-exemplars --skill generate-tech-spec

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: generate-tech-spec
Source: https://github.com/yuvarajd85/ai-ml-learnings-exemplars/tree/main/.claude/skills/generate-tech-spec
Command: npx skills add https://github.com/yuvarajd85/ai-ml-learnings-exemplars --skill generate-tech-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Convert a natural-language workload requirement into a precise AWS-centric technical specification and architecture diagram, ensuring consistent outputs for downstream IaC generation and stakeholder communication.

Core Features & Use Cases

Generates two artifacts: a structured tech-stack.md and an architecture diagram generated by the ar-diagram skill.
Anchors recommendations to the AWS Well-Architected Framework with explicit trade-offs and justified service selections.
Works for greenfield designs and architectural planning across workloads such as trading systems, ETL pipelines, document processing, API services, and ML inference.

Quick Start

Describe your workload in natural language (e.g., "design a backend on AWS for a real-time trading platform"), and the skill will produce the required artifacts under the output directory.

Frequently Asked Questions about generate-tech-spec

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

FAQPage Schema

How do I generate an AWS architecture diagram from a natural language workload description?▼

Generate an AWS architecture diagram by providing a natural language workload description, which produces a structured tech-stack.md and a visual topology diagram organized under a specific output directory.

Can I use this to create technical specifications for greenfield AWS designs?▼

Create technical specifications for greenfield AWS designs by submitting a text prompt describing your intended system, which yields a fixed Section D structure suitable for downstream resource builders.

Does this skill align service selections with the AWS Well-Architected Framework?▼

Align service selections with the AWS Well-Architected Framework through generated technical specifications that explicitly state architectural trade-offs and justify chosen AWS services for your specific workload.

What types of workloads can I design with an automated AWS tech spec generator?▼

Automated AWS tech spec generation supports workloads including real-time trading systems, ETL pipelines, document processing, API services, and ML inference, translating each into a precise technical specification.

How do I visualize topology for an ETL pipeline on AWS?▼

Visualize topology for an ETL pipeline by describing the data flow in natural language, which triggers an automated process to output an architecture diagram via the ar-diagram component.

Do I need infrastructure-as-code knowledge to use an automated AWS architecture planning tool?▼

Infrastructure-as-code knowledge is not required to start architecture planning, as the tool translates natural language inputs directly into technical specifications and diagrams for downstream IaC generation.