Claude MarketplacesSubmit
github avatar

Breakdown Epic Arch

github/awesome-copilotOfficial

Takes a Product Requirements Document and generates a comprehensive technical architecture specification for an Epic. Creates detailed Mermaid diagrams showing user, application, service, data, and infrastructure layers, then breaks down high-level features, technical enablers, and technology stack requirements. Outputs everything as a structured markdown file ready for your docs folder. Built for teams using TypeScript, Next.js, tRPC, and Docker who need to bridge the gap between product requirements and actual development work. The architecture specs include t-shirt sizing and technical value estimates, making sprint planning much more predictable.

skills.sh installs
9K
GitHub stars
41K
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add github/awesome-copilot --skill breakdown-epic-arch --agent claude-code

Installs into .claude/skills of the current project.

Files

Epic Architecture Specification Prompt

Goal

Act as a Senior Software Architect. Your task is to take an Epic PRD and create a high-level technical architecture specification. This document will guide the development of the epic, outlining the major components, features, and technical enablers required.

Context Considerations

  • The Epic PRD from the Product Manager.
  • Domain-driven architecture pattern for modular, scalable applications.
  • Self-hosted and SaaS deployment requirements.
  • Docker containerization for all services.
  • TypeScript/Next.js stack with App Router.
  • Turborepo monorepo patterns.
  • tRPC for type-safe APIs.
  • Stack Auth for authentication.

Note: Do NOT write code in output unless it's pseudocode for technical situations.

Output Format

The output should be a complete Epic Architecture Specification in Markdown format, saved to /docs/ways-of-work/plan/{epic-name}/arch.md.

Specification Structure

1. Epic Architecture Overview
  • A brief summary of the technical approach for the epic.
2. System Architecture Diagram
SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/github/awesome-copilot
Categories
Git & Pull Requests, Code Review & Quality, AI & Agent Building

More from github/awesome-copilot

All 318

Recommended

More Git & Pull Requests
1github avatarremember-interactive-programminggithub/awesome-copilotA micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Dr9Kskills.sh installs
2github avatarwhat-context-neededgithub/awesome-copilotAsk Copilot what files it needs to see before answering a question8.9Kskills.sh installs
3github avatarupdate-markdown-file-indexgithub/awesome-copilotUpdate a markdown file section with an index/table of files from a specified folder.8.9Kskills.sh installs
4github avatarazure-static-web-appsgithub/awesome-copilotHelps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configu8.9Kskills.sh installs
5github avatarjava-refactoring-remove-parametergithub/awesome-copilotRefactoring using Remove Parameter in Java Language8.9Kskills.sh installs
6github avatarlegacy-circuit-mockupsgithub/awesome-copilotGenerate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic co8.9Kskills.sh installs