planning-md

Creates and revises product specification markdown files using a section-contract template.

Updated May 10, 2026
One-click install
npx skills add https://github.com/dadafinger/dadafinger-skills --skill planning-md-dadafinger
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planning-md
Source: https://github.com/dadafinger/dadafinger-skills/tree/main/planning-md
Command: npx skills add https://github.com/dadafinger/dadafinger-skills --skill planning-md-dadafinger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Writing and updating product planning specs (spec md) often leads to inconsistent structure, lost originals, and ambiguous feedback handling. This Skill standardizes spec authoring with a fixed template and protects existing documents by versioning copies instead of overwriting them. ## Core Features & Use Cases - New spec creation: Collects a draft outline plus required metadata (title, version, save location) and writes the spec in the 명세서_템플릿.md format with changelog table and Open Issues section. - Safe revision workflow: Reads an existing md, maps free-form feedback (natural language, screenshots) to sections, flags conflicts or ambiguities for confirmation, then writes a version+1 copy while preserving the original. - Section contract enforcement: Defines section boundaries (### N · 기능요소명 with marker comments) that downstream HTML, Figma, and QA outputs consume for four-way consistency. - Use Case: A product manager receives meeting notes requesting changes to an alarm rule spec. The Skill maps each request to a section, asks about ambiguous items, and produces spec v7.md with a changelog entry and ⭐ markers at changed points. ## Quick Start Ask the assistant to revise the attached spec md with these feedback notes and save it as the next version, or request a new spec draft from your outline.

Frequently Asked Questions about planning-md

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

FAQPage Schema
How do I update a product spec document without losing the original?▼

Use a duplicate-and-version-up workflow: read the existing md, apply feedback to a copy named with the next version number, and update the changelog. The original file stays untouched, and changed points get version markers for traceability.

How do I write a product specification document from scratch?▼

Provide a draft outline of the screen or feature plus the file title, version, and save location. The spec is then written using a template with Screen ID, changelog, entry path, per-section functional specs, and a QA checklist.

What should a spec md template include for design handoff?▼

Include a section contract where each numbered section heading maps to mockup markers, HTML area classes, and Figma description sections. Each section body covers UI elements, states, constraints, and behavior policies in that order.

How are ambiguous change requests handled during spec revision?▼

Ambiguous or conflicting feedback is collected into a confirmation list and asked all at once instead of being guessed. Items that cannot be resolved are deferred to the Open Issues section rather than mixed into the spec body.

When should undecided items go in Open Issues instead of the spec body?▼

Any unresolved or pending-decision item belongs in the Open Issues checklist at the document end, not in the main sections. This keeps the normative spec clean and makes outstanding decisions visible for review.