resources-to-notion-technical-design

Create production-grade Notion technical design documents from mixed resources and codebase analysis.

1|Updated May 8, 2026
One-click install
npx skills add https://github.com/dicarsmtz/product-engineering-kit --skill resources-to-notion-technical-design-dicarsmtz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resources-to-notion-technical-design
Source: https://github.com/dicarsmtz/product-engineering-kit/tree/main/plugins/product-engineering/skills/resources-to-notion-technical-design
Command: npx skills add https://github.com/dicarsmtz/product-engineering-kit --skill resources-to-notion-technical-design-dicarsmtz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning scattered PRDs, tickets, URLs, notes, and codebase evidence into a coherent, implementation-ready technical design is time-consuming and often requires senior engineering judgment. This Skill synthesizes heterogeneous inputs, analyzes the current repository, compares architecture options, and publishes a decision-ready technical design document directly to Notion. ## Core Features & Use Cases - Resource Synthesis: Fetches and normalizes PRDs, Jira/Confluence pages, URLs, local files, transcripts, and raw notes into a source ledger with confidence labels. - Codebase-Grounded Design: Inspects the current repository for architecture, data models, APIs, jobs, infrastructure, and tests before recommending an approach. - RFC/ADR-Style Decisions: Compares credible implementation options, records decision rationale, rejected alternatives, and revisit triggers. - Enterprise Dependency & IaC Planning: Evaluates cloud-native services versus vendor wrappers and includes Terraform/IaC plans when infrastructure changes are needed. - Use Case: Given a PRD link, a Confluence page, and access to the repo, the Skill produces a Notion technical design with requirements tables, options comparison, rollout plan, and risks—ready for Jira planning. ## Quick Start Use the resources-to-notion-technical-design skill to analyze my PRD and this repository, then publish a technical design document to my Notion page.

Frequently Asked Questions about resources-to-notion-technical-design

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

FAQPage Schema
How do I create a technical design document in Notion from a PRD?

Provide the PRD link or file along with any supporting resources and a target Notion location. The Skill fetches all sources, analyzes the current repository, compares implementation options, and publishes a complete technical design page to Notion.

What inputs does this technical design workflow accept?

It accepts PRDs, Notion/Jira/Confluence pages, URLs, local files, screenshots, transcripts, raw notes, and repository context. All sources are normalized into a source ledger with confidence labels before drafting the design.

Does the technical design include codebase analysis?

Yes, codebase analysis is mandatory whenever a repository is available. The Skill inspects architecture, data models, APIs, jobs, infrastructure-as-code, and tests, and separates repo-validated facts from source claims, inferences, and assumptions.

Can it update an existing Notion technical design page?

Yes, when given an existing Notion page it rewrites it into one coherent current design. It does not append version logs or correction sections unless explicitly requested, keeping the page as a single source of truth.

Does it handle infrastructure and Terraform planning?

Yes, when the design introduces infrastructure changes it includes Terraform or the repo's existing IaC tool, covering modules, IAM, secrets, alarms, rollout, rollback, and validation steps like terraform validate and plan review.

What happens if Notion tools are unavailable?

If Notion access is blocked, the Skill produces the technical design as a Markdown fallback artifact and clearly states what prevented direct publishing. It never silently stores the canonical design elsewhere.