Shoe Choo Specifications
Complete project specifications generated through the AI-DLC (AI-Driven Development Life Cycle) methodology.
Architecture
- System Architecture — Tech stack, component diagram, data flow, concurrency model, and design decisions
Inception Phase
Vision & Requirements
- Vision Document — Product vision, target users, MVP features, competitive landscape
- Requirements — Intent analysis, functional and non-functional requirements
- Requirements Questions — Open questions and decisions from requirements analysis
User Stories
- Personas — Target user profiles (Haruka, Kenji, Mei)
- User Stories — Full user story backlog with acceptance criteria
Planning
- Execution Plan — AI-DLC stage execution plan
- Story Generation Plan — User story generation methodology
- Application Design Plan — Application design approach
- User Stories Assessment — Story quality and coverage assessment
Application Design
- Application Design Overview — High-level application architecture
- Components — Component breakdown and responsibilities
- Component Methods — Public interfaces and method signatures
- Component Dependencies — Dependency graph between components
- Services — Service layer design (Export, File, Image)
- Units of Work — Development unit definitions
- Unit Dependencies — Build order and unit dependencies
- Unit–Story Map — Mapping of user stories to development units
Technical Environment
- Technical Environment — Development tools, platform requirements, dependencies
Construction Phase
Planning
- Unit 1 Functional Design Plan — Functional design approach for Unit 1
Unit 1: Core Editor Engine
- Domain Entities — EditorNode, BlockKind, InlineRun, EditorNodeModel
- Business Logic — Parse, render, active-block resolution, formatting
- Business Rules — Validation rules and constraints
- Frontend Components — ShoechooTextView, WYSIWYGTextView, EditorView
- NFR Requirements — Performance, reliability, usability targets
- Tech Stack Decisions — Technology choices and rationale
Unit 2: Document Management
- Domain Entities — MarkdownDocument, file I/O model
- Business Logic — Open, save, auto-save, snapshot management
- Business Rules — File handling rules and constraints
- Frontend Components — DocumentGroup, sidebar, recent files
- NFR Requirements — File I/O performance, data integrity
- Tech Stack Decisions — ReferenceFileDocument, NSLock approach
Unit 3: Focus & Immersion
- Domain Entities — Focus mode, typewriter scrolling state
- Business Logic — Dimming, scroll centering, full-screen
- Business Rules — Focus mode activation rules
- Frontend Components — Focus overlay, typewriter scroll view
- NFR Requirements — Animation smoothness, responsiveness
- Tech Stack Decisions — NSTextView extension approach
Unit 4: Image & Media
- Domain Entities — Image reference, assets directory model
- Business Logic — Drag-and-drop, paste, filename generation
- Business Rules — Supported formats, path validation
- Frontend Components — Drop zone, image preview
- NFR Requirements — Import speed, file size limits
- Tech Stack Decisions — NSImage, UTType approach
Unit 5: Export & Polish
- Domain Entities — Export configuration, output formats
- Business Logic — HTML generation, PDF rendering pipeline
- Business Rules — Export format rules, CSS embedding
- Frontend Components — Export dialog, preferences
- NFR Requirements — Export speed, output fidelity
- Tech Stack Decisions — WKWebView PDF, MarkupWalker HTML