update-design

Extract conversation decisions and append them to DESIGN.md with a changelog.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/nakaj1214/trader --skill update-design-nakaj1214
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-design
Source: https://github.com/nakaj1214/trader/tree/main/.claude/skills/update-design
Command: npx skills add https://github.com/nakaj1214/trader --skill update-design-nakaj1214

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that important design and implementation decisions made during a conversation are accurately recorded and maintained in the project's design documentation.

Core Features & Use Cases

  • Decision Capture: Automatically extracts key decisions, rationale, and context from conversations.
  • Documentation Update: Appends new decisions to the DESIGN.md file and maintains a changelog.
  • Use Case: After a meeting where the team decides to use a specific caching strategy, you can use this Skill to ensure that decision and its reasoning are immediately documented in the project's design document.

Quick Start

Use the update-design skill to record the decision to use Redis for caching in the design document.

Frequently Asked Questions about update-design

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

FAQPage Schema
How do I update design docs with decisions from a conversation?

To update design docs with conversation decisions, this Skill extracts key decisions, rationale, and context, then appends them to the DESIGN.md file while maintaining a structured changelog of updates.

What is the best way to record architecture decisions and rationale automatically?

Recording architecture decisions and rationale automatically involves parsing conversation content to identify goals, library choices, and patterns, then appending these entries in a structured format to project documentation.

Can I maintain a changelog of design decisions in DESIGN.md?

Yes, you can maintain a changelog of design decisions in DESIGN.md. The Skill operates by reading existing documentation, parsing new conversation content, and appending updates while preserving the historical record of decisions.

How to document caching strategy choices made during a meeting?

Documenting caching strategy choices made during a meeting requires extracting the decision and its reasoning from the conversation, then immediately recording them into the project's design documentation for future reference.

Does this design documentation tool require any dependencies?

No, this design documentation tool requires no external dependencies. It operates independently to parse conversation content and append new entries in a structured format to the existing DESIGN.md file.

What types of project knowledge can I capture with this knowledge management approach?

With this knowledge management approach, you can capture goals, architecture, patterns, library choices, decision rationale, and future work, ensuring important design and implementation decisions are accurately recorded.