From astro-dev
Architecture planning and system design for complex Astro/Starlight systems - provides design docs without implementation
npx claudepluginhub superbenefit/sb-marketplace --plugin astro-dev# /design Command Architecture planning and system design for complex Astro and Starlight projects. Provides structured design documents, schemas, and implementation roadmaps. ## Usage ## Description The `/design` command helps you plan complex system architectures before implementation. It loads architecture patterns from the astro-coding skill and creates comprehensive design documents with schemas, routing strategies, and implementation roadmaps. **Note**: This command focuses on planning and documentation only. Use `/dev` to implement the designs. ## What It Does 1. **Analyzes ...
/designDesigns system architecture, APIs, components, and databases producing specifications, diagrams, or code. Accepts target and optional --type (architecture|api|component|database) and --format flags.
/designGuides interactive frontend design workflow: project discovery, trend research, moodboard creation, color/typography selection, and production-ready code generation.
/designCreates comprehensive feature design documents with research and architecture for a given feature name or idea.
/designGenerates Markdown technical design document framework for a feature (doc mode, default). Also supports checklist mode for S-Tier SaaS design quality checks.
/designEnforces SwiftUI design rules for uniform constants, flexible accessible layouts, system styling, and inclusive practices across devices.
/designDesigns system architecture with mandatory C4 (Mermaid) diagrams and tech stack recommendations, consulting prior requirements and flagging contradictions.
Architecture planning and system design for complex Astro and Starlight projects. Provides structured design documents, schemas, and implementation roadmaps.
/design [architecture or system description]
The /design command helps you plan complex system architectures before implementation. It loads architecture patterns from the astro-coding skill and creates comprehensive design documents with schemas, routing strategies, and implementation roadmaps.
Note: This command focuses on planning and documentation only. Use /dev to implement the designs.
Use /design when you need:
Don't use for simple components or standard features - just use /dev directly.
/design Blog system with categories, tags, authors, and related posts
Output: Collection schemas, relationship structures, query patterns, implementation steps
/design System that combines local MDX, GitBook API content, and PostgreSQL data
Output: Loader architecture, data transformation patterns, caching strategies, integration approach
/design Multi-language documentation with versioning and fallbacks
Output: Route structure, content organization, i18n strategy, implementation roadmap
/design Authentication system with Supabase and role-based access
Output: System architecture, data flow, security considerations, implementation phases
/design How to refactor 100+ MDX files to use content collections
Output: Migration strategy, schema design, automation approach, rollback plan
The design command provides structured architecture documents:
# [System Name] Architecture
## Overview
[High-level description of the system and its goals]
## Requirements Analysis
- [Functional requirement 1]
- [Functional requirement 2]
- [Non-functional requirements: performance, security, scalability]
- [Constraints and considerations]
## System Design
### Collection Structure
[Content collection definitions with relationships and data flow]
### Schema Definitions
```typescript
// Fully-typed TypeScript schemas
import { defineCollection, z } from 'astro:content';
export const collections = {
blog: defineCollection({
type: 'content',
schema: z.object({
title: z.string(),
// ... full schema
}),
}),
};
[Design for custom content loaders with caching, error handling, incremental updates]
[URL patterns, dynamic routes, static generation approach]
[How data moves through the system, from source to output]
Why: [Rationale] Trade-offs: [What we gain vs what we lose] Alternatives considered: [Other options and why they were not chosen]
...
[Build time, bundle size, runtime performance implications]
[Authentication, authorization, secret management, XSS prevention]
[Code organization, testing strategy, documentation needs]
[How the system handles growth in content, users, or complexity]
Ready to implement? Use:
/dev Implement the [system name] architecture we just designed
Or implement in phases:
/dev Implement Phase 1 of the [system] architecture
## Integration with /dev
After designing, implement with `/dev`:
```bash
# 1. Design the system
/design Multi-language blog with external API integration
# 2. Review the architecture document
# 3. Implement it
/dev Implement the multi-language blog architecture
# Or implement in phases:
/dev Implement Phase 1: collection schemas and base structure
/dev Implement Phase 2: dynamic routes and i18n
/dev Implement Phase 3: API integration and caching
Step 1: /design [describe complex system]
Step 2: Review and discuss architecture
Step 3: /dev [implement the system]
/design Strategy to refactor content from pages/ to collections
Output: Migration plan, schema design, compatibility approach
/design Compare content collections vs custom loaders for my use case
Output: Analysis of both approaches with pros/cons and recommendation
/design Document the architecture of our multi-tenant docs system
Output: Comprehensive architecture document for team reference
/design How to integrate Supabase auth with existing Astro app
Output: Integration architecture, data flow, security considerations
❌ /design a blog
✅ /design Blog with 10 categories, tag taxonomy, author profiles, related posts, and RSS feeds
✅ /design Content system (must work with existing PostgreSQL database)
✅ /design Routing (SEO-friendly URLs required, sub-100ms page loads)
✅ /design Authentication (using Supabase, needs role-based access)
✅ /design Compare approaches for multi-language content: collections vs loaders vs both
✅ /design Evaluate SSR vs SSG for this e-commerce catalog
✅ /design Blog system (expecting 1000+ posts, 50+ categories)
✅ /design API integration (10k requests/day, 1-second response time max)
Don't use /design for:
/dev Create a Button component)/dev Add a blog with categories)/dev Create an about page)/dev Fix the header alignment)Use /design for:
# 1. Design first
/design Multi-tenant documentation system with org-based access control
# 2. Review architecture
# Read the design doc, discuss with team
# 3. Implement
/dev Implement the multi-tenant docs architecture --audit=comprehensive
# 1. Design the integration
/design Integrate Stripe payments with existing Astro site
# 2. Implement in phases
/dev Implement Phase 1: Stripe client setup and config
/dev Implement Phase 2: Payment routes and webhooks
/dev Implement Phase 3: User dashboard and receipts
# 1. Plan the refactor
/design Refactor 200 markdown pages to content collections with categories
# 2. Execute the plan
/dev Implement the refactoring strategy with migration scripts
| Aspect | /design | /dev |
|---|---|---|
| Output | Architecture documents | Working code |
| Use Case | Complex system planning | Implementation |
| Time | 2-5 minutes | 1-20 minutes |
| When | Before complex builds | For all implementation |
| Focus | Planning and decisions | Code and validation |
Command Version: 2.0 (v0.4.0)
Replaces: /architect from v0.3.x
Compatible with: astro-dev plugin v0.4.0+
Last Updated: 2025-11-05
Use /design when you need thoughtful system architecture before diving into implementation.