dn-writer

Convert discussion summaries into structured Markdown Design Notes with decisions, assumptions, and acceptance criteria.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/AntonBespalov/WC_IST --skill dn-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dn-writer
Source: https://github.com/AntonBespalov/WC_IST/tree/main/.codex/skills/dn-writer
Command: npx skills add https://github.com/AntonBespalov/WC_IST --skill dn-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts collaborative discussions and decisions into formal, publishable Design Notes (DNs) that capture what was decided, why, and what evidence or rollback is required. It anchors requirements, interfaces, timing, risks, and verification in canonical documentation.

Core Features & Use Cases

  • Create a concise DN that translates discussion outcomes into a structured document.
  • Link DN content to canonical docs (docs/design-notes/*) and reference related context (docs/PROJECT_CONTEXT.md, safety and verification plans).
  • Use Case: After a requirements or architecture meeting, generate a DN that outlines decisions, assumptions, dependencies, and acceptance criteria.

Quick Start

Convert the latest discussion summary into a complete Markdown Design Note using the standard template.

Frequently Asked Questions about dn-writer

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

FAQPage Schema
How do I convert architecture discussions into formal design notes for traceability?

To convert architecture discussions into formal design notes, summarize the meeting outcomes into a structured Markdown document. This anchors decisions, requirements, and verification plans in canonical documentation for review and rollback.

What is the best way to document requirements decisions and rollback planning after a meeting?

Documenting requirements decisions and rollback planning is best achieved by generating a formal Design Note. It captures what was decided, the evidence required, and assumptions into a structured Markdown template for traceable verification.

Does the design note generation process work for both software and hardware projects?

Yes, design note generation works for both software and hardware projects. It produces canonical documentation that captures interfaces, timing, risks, and requirements, ensuring decisions are traceable across diverse engineering disciplines.

How do I structure a decision record using a standard design note template?

To structure a decision record using a design note template, populate a Markdown document conforming to the standard DN structure. Include frontmatter, assumptions, dependencies, acceptance criteria, and verification links for review.

Can I link my design notes directly to existing project context and safety plans?

Yes, you can link design notes directly to existing project context and safety plans. The generated document references canonical files like docs/PROJECT_CONTEXT.md and related verification plans to ensure complete traceability.

What should a design note include for software architecture verification and traceability?

A design note for software architecture verification should include decisions, assumptions, dependencies, acceptance criteria, and rollback planning. It conforms to a standard Markdown template to anchor requirements in canonical documentation.