| name | project-design |
| description | Use when defining or revising repository architecture, design documents, concept boundaries, or cross-document relationships before implementation. |
Project Design
This skill replaces the operational role of Claude's architect agent and /design command.
Use This Skill For
- New concepts that need a design document.
- Architecture changes that affect interfaces or assumptions.
- Updating
.claude/designs/ and .claude/index.yaml together.
Required Reads
./CLAUDE.md
./.claude/commands/design.md
./.claude/index.yaml
Required Outputs
./.claude/designs/<concept>.md
- matching updates in
./.claude/index.yaml
Workflow
- Read the relevant design docs and
index.yaml.
- Restate the problem and list the affected concepts.
- Present options and trade-offs before finalizing the design.
- Write or update the design document in English.
- Update
index.yaml to reflect design relationships.
Boundaries
- Do not implement code while using this skill.
- Keep design docs synchronized when interfaces or assumptions change.