confluence-prd-to-sdd-spec

This skill acts as a crucial bridge in the Spec-Driven Development (SDD) lifecycle by automating the transition from a Product Requirement Document (PRD) to actionable technical specifications. Designed for software engineers and product managers, it streamlines the handoff process by programmatically fetching page content from Confluence and refactoring it into a standardized local format. This eliminates the need for manual copy-pasting and ensures that the RD (Responsible Developer) starts the specification phase with a clean, well-contextualized data source. By focusing on structural fidelity, it preserves the original intent of the PO while highlighting unresolved requirements as TBD markers for later discussion.

• Automatically fetches PRD content using Atlassian MCP tools (confluence_search and confluence_get_page).

• Restructures disparate PRD formats into a consistent markdown schema including Problem Statements, Goals, User Stories, Functional/Non-Functional Requirements, and Constraints.

• Identifies missing information within the PRD and automatically inserts [TBD] placeholders to guide future AI-assisted refinements.

• Simplifies the transition to the spec-kit specify command, providing a ready-to-use prd-source.md file as input context.

• Maintains traceability by including metadata such as the original Confluence Page ID, title, and last-fetched timestamps.

• Requires an configured Atlassian MCP server with valid credentials in .env.mcp-atlassian.

• Users must provide a page ID or a search keyword to initiate the retrieval process.

• The output file, typically named prd-source.md, is designed to be version-controlled and used as a source of truth for the spec.md creation process.

• The tool is strictly faithful to the original source; it avoids inferring or editorializing requirements to prevent deviation from the PO's intent.

• Perfect for recurring updates; if the source PRD changes in Confluence, the skill can be re-run to update the local environment and reflect the latest business needs.