design-tracker

Update DESIGN.md with conversation-derived design decisions and log changes to the Changelog.

Updated May 29, 2021
One-click install
npx skills add https://github.com/hikch/dotfiles --skill design-tracker-hikch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-tracker
Source: https://github.com/hikch/dotfiles/tree/main/.claude/skills/design-tracker
Command: npx skills add https://github.com/hikch/dotfiles --skill design-tracker-hikch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proactively capture and document project design decisions to prevent important choices from getting lost or forgotten, enabling faster alignment and easier future reference.

Core Features & Use Cases

  • Automatically track architecture decisions, implementation plans, library choices and their rationale, TODO items, and open questions.
  • Update and maintain .claude/docs/DESIGN.md with conversation-derived decisions and log changes to the Changelog for traceability.
  • Activate when architecture discussions or design decisions occur, and respond to explicit prompts like "記録して", "設計どうなってる", or "record this".

Quick Start

Record a new design decision by updating .claude/docs/DESIGN.md and append today's changelog entry.

Frequently Asked Questions about design-tracker

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

FAQPage Schema
How do I automatically track and document architecture decisions?

This Skill automatically tracks architecture decisions by reading existing DESIGN.md files, updating them with conversation-derived choices, and appending daily change logs to maintain a traceable decision history.

What is the best way to maintain a design decision log for software projects?

Maintaining a design decision log is best achieved by proactively recording implementation choices, library selections, and rationale into a structured DESIGN.md file and an appended Changelog for traceability.

How do I record design notes during architecture discussions?

You can record design notes during architecture discussions by prompting the tracker with explicit commands like "record this" to automatically extract decisions and update your project documentation.

Can I use this to track library selection rationale and open questions?

Yes, you can use this to track library selection rationale, architecture choices, TODO items, and open questions by automatically organizing them into your DESIGN.md and Changelog files.

Does this design tracker require an existing DESIGN.md file to function?

No, it does not strictly require an existing DESIGN.md file to function, as it can proactively create and update the .claude/docs/DESIGN.md path while logging new changes to the Changelog.