design-tracker

Record design decisions from conversations into DESIGN.md and the changelog.

190|33|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/DeL-TaiseiOzaki/claude-code-orchestra --skill design-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-tracker
Source: https://github.com/DeL-TaiseiOzaki/claude-code-orchestra/tree/main/.claude/skills/design-tracker
Command: npx skills add https://github.com/DeL-TaiseiOzaki/claude-code-orchestra --skill design-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proactively tracks and documents design decisions to reduce knowledge loss and ensure a consistent design narrative across architecture, implementation, and tooling discussions.

Core Features & Use Cases

  • Automatic Design Tracking: Monitor conversations for architecture decisions, patterns, and library choices, updating the project DESIGN.md accordingly.
  • Unified Design Journal: Maintain a centralized changelog entry for every significant decision with a date stamp.
  • Query & Review: Answer questions like "what's our current design?" or "record this" with up-to-date design summaries.

Quick Start

To activate the design-tracker, begin discussions about design decisions and rely on the system to record them automatically.

Frequently Asked Questions about design-tracker

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

FAQPage Schema
How do I automatically document design decisions during architecture discussions?

Automatically document design decisions by monitoring architecture discussions and extracting choices to update your DESIGN.md file and append dated changelog entries. The system reads existing records and captures new decisions as topics arise.

What is a design decision log and when do I need one for my project?

A design decision log records architecture choices, patterns, and library selections in a centralized DESIGN.md file to prevent knowledge loss. You need one when project complexity grows and maintaining a consistent design narrative becomes difficult without centralized records.

How do I keep my changelog and design documentation up to date while coding?

Keep your changelog and design documentation current by using an automated tracker that extracts decisions from your workflow conversations. It updates relevant sections in DESIGN.md and adds timestamped changelog entries as you discuss architecture patterns and library selections.

Can I query my current project architecture and design history from a single file?

Yes, you can query your current project architecture by asking "what's our current design?" against your DESIGN.md file. The tracking system maintains a centralized design journal that provides up-to-date summaries of recorded decisions and patterns.

Does this design tracking approach work without additional dependencies or components?

Yes, this design tracking approach works without additional dependencies or components. It operates by reading your existing DESIGN.md file, extracting new information from conversations, and updating the documentation and changelog directly within your project environment.