Skip to content
claudelint

Design Documents

Design Documents

Section titled “Design Documents”

This directory contains detailed design documents for feature implementation.

What are Design Documents?

Section titled “What are Design Documents?”

Design documents describe how a feature or system will be built. Each design document includes:

  • Overview: What is being designed and why
  • Goals and Non-Goals: Scope boundaries
  • Detailed Design: Architecture, APIs, data models
  • Testing Strategy: How the design will be validated
  • Migration Plan: How to roll out the changes

Creating a New Design Document

Section titled “Creating a New Design Document”
Terminal window
docz create design "Your Design Title"

Design Status

Section titled “Design Status”
  • Draft: Initial draft, still being written
  • In Review: Ready for review and feedback
  • Approved: Approved and ready for implementation
  • Implemented: Design has been fully implemented
  • Abandoned: Design was not pursued

All Design

Section titled “All Design”
IDTitleStatusDateAuthorLink
DESIGN-0001Claudelint linter architecture and rule engineDraft2026-04-18Donald Gifford0001-claudelint-linter-architecture-and-rule-engine.md
DESIGN-0002Phase 2 — marketplaces, MCP rules, and GitHub ActionDraft2026-04-23Donald Gifford0002-phase-2-marketplaces-mcp-rules-and-github-action.md
DESIGN-0003Dual-output docs site — shared source, MkDocs for TechDocs, Starlight for publicImplemented2026-05-31Donald Gifford0003-dual-output-docs-site-shared-source-mkdocs-for-techdocs.md
DESIGN-0004Starlight landing page polish and brand passDraft2026-06-08Donald Gifford0004-starlight-landing-page-polish-and-brand-pass.md
DESIGN-0005Agent rules and opt-in rule mechanismApproved2026-07-10Donald Gifford0005-agent-rules-and-opt-in-rule-mechanism.md