sdd-platform-spec

Guide platform spec creation with SpecKit and MCP workflows.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/javierhbr/random-poc --skill sdd-platform-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-platform-spec
Source: https://github.com/javierhbr/random-poc/tree/main/sdd-mcp/sdd-mcp/mnt/user-data/outputs/sdd-agent/skills/sdd-platform-spec
Command: npx skills add https://github.com/javierhbr/random-poc --skill sdd-platform-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill guides Platform Architects and Product Managers in creating comprehensive Platform Specifications using SpecKit and MCP, ensuring all platform non-negotiables are encoded.

Core Features & Use Cases

  • Platform Spec Creation: Define the "what + why + UX" for cross-domain initiatives.
  • Constitution Enforcement: Encode and enforce platform standards (UX, security, observability, etc.).
  • Iterative Development: Guides through prerequisite checks, constitution setup, spec definition, gap analysis, and planning.
  • Use Case: A Platform Architect needs to define a new cross-domain feature. They use this skill to ensure the spec covers end-to-end UX, domain responsibilities, NFRs, and contract definitions, adhering to the platform's constitution.

Quick Start

Use the sdd-platform-spec skill to start defining a new platform feature by running the /speckit.constitution command.

Frequently Asked Questions about sdd-platform-spec

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

FAQPage Schema
How do I define platform specs for cross-domain initiatives using SpecKit?

To define platform specs for cross-domain initiatives using SpecKit, you structure the workflow through prerequisite checks, constitution definition, platform spec creation, gap analysis via ADRs, and technical planning. This ensures all non-negotiables and domain responsibilities are encoded.

What is a platform constitution in SpecKit and when do I need to set it up?

A platform constitution in SpecKit is a set of encoded platform standards covering UX, security, and observability. You need to set it up during the initial phase of platform spec creation to enforce non-negotiables before defining cross-domain initiative scope and contracts.

How do I conduct gap analysis for platform specifications using ADRs?

Gap analysis for platform specifications is conducted by generating Architecture Decision Records (ADRs) after defining the initial spec. ADRs identify missing domain responsibilities, UX requirements, or NFRs, ensuring the final platform spec adheres to the platform constitution.

Does this SpecKit workflow support fan-out task generation for technical planning?

Yes, the SpecKit workflow supports fan-out task generation for technical planning. After completing prerequisite checks, constitution setup, and gap analysis, it automatically generates downstream technical tasks to execute the cross-domain platform initiative.

Can I use this SpecKit workflow to define contracts and non-functional requirements (NFRs)?

Yes, you can use this SpecKit workflow to define both contracts and non-functional requirements (NFRs). It explicitly guides Platform Architects and Product Managers to satisfy requirements for domain responsibilities, contract definitions, and NFRs while ensuring adherence to platform non-negotiables.

What is the best way to enforce platform standards like UX and observability during spec creation?

The best way to enforce platform standards like UX and observability during spec creation is by defining a platform constitution using SpecKit. This constitution acts as a prerequisite check, ensuring all subsequent cross-domain features and technical plans adhere to these encoded non-negotiables.