# Maintain Designs

> Skill for maintaining clear, DRY, and easy-to-navigate design documents for architect agents.

- Skill: `majiayu000/maintain-designs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/maintain-designs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/maintain-designs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/maintain-designs

---


## Objects

Clarity, easy discovery, minimal redundancy, low upkeep designs with clear canonicals and minimal code.

## Principles

One topic per page; one canonical per topic. Prefer deletion with consolidation instead of duplicates. Keep pages skimmable. Stay high-level and include minimal code.

## Workflow

### Inventory (quick)

List all docs with a one-line summary and note overlaps. No metadata beyond that. Cluster by theme Group loosely (e.g., UI, backend, parsing, patterns, specs). Keep flexible. Choose canonicals For overlapping topics, pick the clearest/most current as the canonical.

### Consolidate

Pull unique, still-relevant bits into the canonical. Rewrite for skim: Title, TL;DR, When to use, How, Gotchas, Links. Split only if a page becomes unwieldy.

### Prune

Delete or replace overlaps with a one-line stub linking to the canonical. Move rough-but-useful notes to a lightweight WIP area; drop the rest. Delete obsolete docs and references. Design docs should never reference plans.

### Organize

Arrange under a small set of theme folders or keep flat. Use nesting sparingly and only when it clearly aids navigation.

### Index

Add or update a minimal top-level index (and optional per-theme) with curated links and one-liners. Remove drift and new duplicates.

### Done when

No obvious duplicates. Everything is discoverable from a minimal index. Docs are short, skimmable, and easy to maintain.