Design Doc Manager FAQs

Question 1

How does this skill handle code examples in documentation?

Accepted Answer

The skill encourages minimizing actual code to prioritize conceptual clarity. It suggests keeping code blocks between 10-20 lines and using pseudocode or diagrams for complex explanations.

Question 2

What are the three main category files in the specs directory?

Accepted Answer

The directory uses command.md for CLI interfaces, architecture.md for system design and technical decisions, and notes.md for research and miscellaneous findings.

Question 3

Where are design documents stored with this skill?

Accepted Answer

All documents must be stored in specific subdirectories under the design-docs/ folder, such as specs/, references/, and user-qa/. Creating files directly in the root design-docs/ folder is prohibited.

Question 4

How are items requiring user confirmation tracked?

Accepted Answer

Questions and pending decisions are stored in the design-docs/user-qa/ directory using specific prefixes like qa- for questions and pending- for decisions.

Question 5

What should I do if a design document becomes too long?

Accepted Answer

For detailed content, you should create a supporting document following the design-*.md naming convention and reference it within the main category files.

Design Doc Manager

주요 기능

사용 사례

Design Doc Manager

주요 기능

사용 사례