architect-project

Design cross-service architecture from PDR requirements into .docs artifacts and OpenAPI contracts.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Dijjo10/sdd-opencode --skill architect-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-project
Source: https://github.com/Dijjo10/sdd-opencode/tree/main/templates/root/.opencode/skills/architect-project
Command: npx skills add https://github.com/Dijjo10/sdd-opencode --skill architect-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineering teams translate a PDR into a coherent cross-service architecture, ensuring clear boundaries, service ownership, and traceable tradeoffs.

Core Features & Use Cases

  • Decompose a system into bounded contexts and candidate services.
  • Define inter-service contracts and data ownership with explicit tradeoffs.
  • Produce architecture artifacts: .docs/architecture.md, .docs/infra.md, and OpenAPI contracts in .docs/contracts.

Quick Start

After drafting the PDR, run architect-project to outline bounded contexts, service ownership, and generate the architecture, infra, and contract docs.

Frequently Asked Questions about architect-project

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

FAQPage Schema
How do I translate PDR requirements into a microservices architecture?

To translate PDR requirements into a microservices architecture, define bounded contexts, establish service ownership, and map communication patterns. This ensures clear service boundaries and traceable tradeoffs directly linked to your original requirements.

How do I generate OpenAPI contracts from a project requirements document?

Generating OpenAPI contracts from a PDR involves defining inter-service communication patterns and data ownership rules. The process outputs explicit contract files into a designated documentation directory for downstream implementation.

What is the best way to document bounded contexts for microservices?

The best way to document bounded contexts is to decompose the system into candidate services and generate structured architecture artifacts. This includes detailed markdown files capturing explicit tradeoffs and service ownership boundaries.

Can I define inter-service data ownership without prior infrastructure setup?

Yes, you can define inter-service data ownership without infrastructure setup by analyzing PDR requirements. The architecture design phase focuses on logical boundaries and contracts before generating the infrastructure needs documentation.

Do I need a completed PDR before designing cross-service architecture?

Yes, a completed PDR is required before designing cross-service architecture. The PDR provides the foundational requirements needed to accurately define bounded contexts, communication patterns, and traceable tradeoffs across services.