update-design

Record design decisions into mapped sections of .claude/docs/DESIGN.md.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/treejh/ai-agent-skills --skill update-design-treejh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-design
Source: https://github.com/treejh/ai-agent-skills/tree/main/skills/claude-orchestrator/.claude/skills/update-design
Command: npx skills add https://github.com/treejh/ai-agent-skills --skill update-design-treejh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design decisions discussed in conversations often never make it into the canonical project design document, leaving architecture, rationale, and TODOs out of sync; this Skill records and organizes those decisions into .claude/docs/DESIGN.md to keep the living design document current.

Core Features & Use Cases

  • Read & Merge: Reads the existing DESIGN.md, extracts decisions and context from the conversation, and merges or appends updates into the appropriate sections.
  • Section Mapping & Structure: Maps conversation topics to specific sections (Overview, Architecture, Implementation Plan subsections, TODO, Open Questions) so entries stay organized and discoverable.
  • Changelog Entries: Adds a dated changelog entry summarizing what was recorded for auditability.
  • Use Case: After a design discussion that settles on library choices and key patterns, run this Skill to record the decisions into Implementation Plan > Libraries and Patterns and add a changelog note.
  • Operational Mode: Designed to operate without invoking external models when disable-model-invocation is required; supports English technical content and Korean descriptions for user-facing notes.

Quick Start

Please update the project DESIGN.md by recording decisions from this conversation and map goals to Overview and implementation choices to the appropriate Implementation Plan sections.

Frequently Asked Questions about update-design

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

FAQPage Schema
How do I update a design document with new architecture decisions from a conversation?

To update a design document with new architecture decisions, the Skill reads the existing DESIGN.md, extracts decisions from the discussion, and maps them into appropriate sections like Overview, Architecture, or Implementation Plan to keep the living design document current.

What is the best way to maintain a changelog for design decisions in software projects?

Maintaining a changelog for design decisions involves appending a dated entry summarizing recorded choices and unresolved questions into the design document, ensuring architecture rationale stays auditable and synchronized with project development.

How does mapping conversation topics to design document sections work?

Mapping conversation topics to design document sections works by reading the discussion context, extracting settled decisions, and placing those entries into targeted sections such as Implementation Plan, TODO, or Open Questions for organized discoverability.

Can I document design decisions without invoking external models?

Yes, you can document design decisions without invoking external models. This Skill operates without external model invocation when disable-model-invocation is required, directly reading and merging content into the local .claude/docs/DESIGN.md file.

When do I need to record unresolved questions in a project design document?

You need to record unresolved questions in a project design document during design conversations or orchestrator workflows when architecture choices or open questions arise, ensuring they are mapped to the Open Questions section for future resolution.

Does this design documentation tool support non-English technical content?

Yes, the tool supports English technical content within the design document structure while providing Korean descriptions for user-facing notes, allowing bilingual project teams to maintain architecture records effectively.