design-tracker

Track and document project design decisions in DESIGN.md files.

17|5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/gaebalai/claude-code-orchestrator --skill design-tracker-gaebalai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-tracker
Source: https://github.com/gaebalai/claude-code-orchestrator/tree/main/.claude/skills/design-tracker
Command: npx skills add https://github.com/gaebalai/claude-code-orchestrator --skill design-tracker-gaebalai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill manages the project's design documentation (.claude/docs/DESIGN.md). It automatically tracks architecture decisions, implementation plans, library choices and their rationale, and TODO items and open questions.

Core Features & Use Cases

  • Automatically update DESIGN.md with new design decisions from ongoing conversations.
  • Track architecture, implementation plans, library choices, rationale, TODOs, and open questions.
  • Provide quick access to current design state and generate changelog entries.

Quick Start

Record a design decision by explaining it during a conversation or by saying record this, and DESIGN.md will be updated 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 track architecture decisions during project development?

To automatically track architecture decisions, this skill reads your ongoing conversations and appends date-stamped changelog entries to a DESIGN.md file. It captures implementation plans, library choices, and rationale without manual formatting.

What is the best way to maintain a centralized design changelog for project management?

Maintaining a centralized design changelog is done by updating the .claude/docs/DESIGN.md file with new design decisions, TODOs, and open questions. The skill triggers during architecture discussions or when prompted to record specific decisions.

Do I need a specific file structure to document design decisions and open questions?

Yes, documenting design decisions requires a DESIGN.md file located at .claude/docs/DESIGN.md. The skill reads existing entries from this file and updates the appropriate sections with new, date-stamped architecture information.

How do I record library selection rationale in my project documentation?

To record library selection rationale, explain the choice during your conversation or explicitly prompt the skill to document it. The rationale is then automatically captured and appended to the corresponding section of your DESIGN.md file.

Can I trigger automatic design documentation updates using explicit prompts?

Yes, you can trigger automatic design documentation updates by using explicit phrases like "record this" or "document this". The skill detects these prompts, extracts the design decision, and updates the changelog in DESIGN.md.

What limitations exist when tracking design decisions through automated conversation parsing?

Tracking design decisions through automated conversation parsing is limited to text-based architecture discussions and requires the .claude/docs/DESIGN.md file to exist. It updates specific sections and does not generate entirely new architecture frameworks.