architecture

Translate product requirements into architecture.md and ADR-lite records.

41|4|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/etr/groundwork --skill architecture-etr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/etr/groundwork/tree/main/skills/architecture
Command: npx skills add https://github.com/etr/groundwork --skill architecture-etr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Translate product requirements into a concrete, auditable system architecture.

Core Features & Use Cases

  • PRD-driven architecture drafting: Convert requirements into a structured architecture document with ADR-lite decisions.
  • Decision logging and validation: Track decisions and ensure alignment with PRD constraints and NFRs.
  • Output generation: Produce {{specs_dir}}/architecture.md and a references skeleton for architecture notes.

Quick Start

Provide your PRD at {{specs_dir}}/product_specs.md and run this skill to generate the architecture draft and ADRs.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I translate a PRD into a system architecture?

To translate a PRD into system architecture, provide your product requirements document and run the skill to generate a structured architecture draft. It enforces PRD alignment checks to ensure the design matches constraints and captures decisions as ADR-lite records.

What is an ADR-lite record and when do I need it for architecture documentation?

An ADR-lite record is a lightweight architecture decision log used to track and validate design choices. You need it when drafting architecture documentation to ensure decisions are auditable and aligned with product requirements.

How do I generate an architecture.md file from product specs?

You generate an architecture.md file by placing your PRD at the product specs path and running this skill. It drafts the system architecture and outputs the markdown file alongside a references skeleton for notes.

Can I validate architectural decisions against PRD constraints and NFRs?

Yes, you can validate architectural decisions against PRD constraints and NFRs. The skill performs PRD alignment checks during the drafting process to ensure your system architecture remains auditable and compliant.

Does this skill work without external dependencies for drafting architecture?

Yes, the skill works without external dependencies for drafting architecture. It operates independently to transform your product requirements into a structured architecture document and ADR-lite records.