Add v0.1 spec draft, JSON Schema, and shadcn/ui example

[ryandmonk]

Summary

Delivers the first three repo-local roadmap milestones, turning the repository from placeholder scaffolding into a first usable spec package.

• spec/dspack-v0.1.md — v0.1 specification draft defining document structure, tokens, components, patterns, anti-patterns, framework bindings, extensibility (x- prefix convention), ID conventions, and 5 documented open questions
• schema/dspack.v0.1.schema.json — JSON Schema (draft 2020-12) with $defs for all reusable structures, enforcing required fields, type constraints, and ID naming patterns
• examples/shadcn-ui.dspack.json — shadcn/ui reference example with 21 tokens (3 categories), 7 components, 3 patterns, 3 anti-patterns, and React framework bindings
• Minimal README updates pointing to the new artifacts and marking roadmap milestones as draft-available
• RFC guidance tightened to reference v0.1 for compatibility considerations

Key design decisions

Decision	Rationale
Only dspack + name required	Real systems are partial; optional sections support incremental adoption
Tokens carry resolved values	dspack is a snapshot, not a build pipeline
Framework bindings at top level	Keeps component definitions framework-agnostic (stated design goal)
Relationships via ID references	Conservative scope; sufficient for v0.1 query patterns
x- prefix for extensions	Well-established convention (OpenAPI); prevents future field collision
reason required on anti-patterns	A prohibition without context isn't useful

Validation performed

• Example validates against schema (Python jsonschema)
• Minimal valid document validates
• Schema correctly rejects: missing name, missing dspack, wrong version, anti-pattern missing reason, component missing description, uppercase component ID

Remaining follow-up items (later milestones)

• ds-mcp v0 release — validate spec against reference implementation
• Community RFCs — process is in place, awaiting proposals
• v1.0 stabilization — resolve the 5 open questions in spec section 14
• Additional examples beyond shadcn/ui
• CI-based schema validation

🤖 Generated with Claude Code