For: James Kerby, Expert Clinical Nutrition Coach
Location: Winchester, Hampshire, UK
Website: https://viridian-hf.com
This package contains EVERYTHING needed to build the Viridian Nutrition Intelligence Platform from concept to production.
Total Documentation: 400+ KB
Completion Level: 100% Ready to Build
Time to MVP: 8-9 weeks
Estimated Cost: $207,341 (full development) OR $10 (self-build with Claude Code)
File: viridian-nutrition-app-prd.md (44 KB)
Contains:
- Product vision and value proposition
- User roles and capabilities
- Core features (MVP 1.2 specification)
- Context engineering architecture
- Agent personas and tool specifications
- UK-specific requirements
- Success metrics and business model
- Schema.org ontology mappings
Use This For: Understanding WHAT to build and WHY
File: viridian-product-breakdown-structure.md (44 KB)
Contains:
- Hierarchical product decomposition
- 8 major deliverables (epics)
- 50+ work packages with detailed descriptions
- 175 story points total
- Acceptance criteria for each feature
- Dependencies matrix
- Resource allocation by epic
- Sprint planning structure
Use This For: Agile sprint planning and feature tracking
File: viridian-work-breakdown-structure.md (56 KB)
Contains:
- Deliverable-oriented decomposition
- 9 Level 1 phases
- 50+ detailed work packages
- Task breakdowns (2-8 hour increments)
- Resource assignments by role
- Total effort: 1,832 hours
- Total cost: $207,341 (labor + software + contingency)
- Gantt chart with critical path
- Control accounts for budget tracking
Use This For: Traditional project management, budgeting, resource planning
File: viridian-implementation-guide.md (110 KB)
Contains:
- 8-week sprint-by-sprint execution plan
- Technical architecture and patterns
- Claude Agent SDK implementation details
- 20 Mermaid diagrams showing system architecture
- Database schemas and migrations
- API route implementations
- Platform PMF Module integration
- Testing strategies
- Deployment procedures
- Cost optimization techniques
Use This For: Technical development and architecture decisions
File: viridian-agent-set-specification-full.md (86 KB)
Contains:
- 4 Complete AI Agents:
- ✅ Nutrition Advisor Agent (5000+ word system prompt)
- ✅ Meal Planner Agent (structured JSON output)
- ✅ Progress Analyst Agent (data insights)
- ✅ PMF Feedback Agent (product insights)
- 8 Agent Tools with full implementations:
- Recipe Search, Protocol RAG, Macro Calculator, Substitutions, Shopping List, Validation, Database Query, Escalation
- Full TypeScript implementations
- Three-tier context engineering
- Safety validation layer
- Base agent class
- Tool execution patterns
- Cost optimization (prompt caching)
Use This For: AI agent development with Claude SDK
File: viridian-github-claude-code-setup.md (20 KB)
Contains:
- Step-by-step setup instructions for running from GitHub
- Complete project structure
- Database migrations (SQL)
- Environment variable templates
- API route implementations
- Seed data scripts
- Testing procedures
- Troubleshooting guide
- YES - You CAN run this from GitHub in Claude Code!
Use This For: Quick start development with Claude Code
File: viridian-figma-to-mvp-workflow.md (53 KB)
Contains:
- Complete UI/UX design process
- Phase 1: Figma design & prototyping (wireframes → high-fidelity)
- Phase 2: Design system setup (tokens, components)
- Phase 3: Figma-to-code preparation
- Phase 4: Frontend development (Next.js + Shadcn UI)
- Phase 5: Backend integration
- Phase 6: MVP testing & launch
- 12 core screens specifications
- Component library structure
- Design system with Tailwind config
- Developer handoff procedures
- 8-9 week timeline from design to production
Use This For: UI/UX design and frontend development
Cost: $207,341
Time: 8 weeks
Team: 7-8 people (PM, Tech Lead, Backend Dev, Frontend Dev, AI/ML Dev, QA, DevOps)
Use:
- WBS for project planning
- PBS for sprint tracking
- Implementation Guide for technical specs
- Hire development team
Cost: ~$10 (API testing)
Time: 8-9 weeks (part-time)
Team: Just you + Claude Code
Use:
- GitHub Setup Guide to initialize project
- Agent Set Specification for AI implementation
- Figma to MVP Workflow for UI/UX
- Implementation Guide for reference
Steps:
- Open Claude Code
- Say: "Follow the GitHub setup guide to build Viridian"
- Claude Code creates entire project structure
- Add your API keys
- Start building!
Cost: $50-100K
Time: 8-12 weeks
Team: 1 Senior Developer + Claude Code assistance
Use:
- All documentation for reference
- Claude Code for boilerplate
- Developer for custom logic and integration
- Perfect balance of cost and quality
- Total Story Points: 175
- Total Hours: 1,832
- Core Features: 8 major deliverables
- User Stories: 50+ with acceptance criteria
- API Endpoints: 15+
- Database Tables: 10+
- AI Agents: 4 specialized agents
- Agent Tools: 8 complete tools
- Labor: $187,720 (91%)
- Software/Services: $772 (0.4%)
- Contingency: $18,849 (9%)
- Total: $207,341
- Anthropic API: $180/month (with caching)
- Supabase: $30/month
- Vercel: $20/month
- Total: $230/month for 30 clients (79% margin)
- Framework: Next.js 14 (App Router)
- UI Library: Shadcn UI + Radix UI
- Styling: Tailwind CSS
- Icons: Lucide React
- Forms: React Hook Form + Zod
- Charts: Recharts
- Database: Supabase (PostgreSQL + Auth)
- Vector Search: pgvector (for RAG)
- File Storage: Supabase Storage
- API: Next.js API Routes
- LLM: Claude Sonnet 4 (via Anthropic SDK)
- Embeddings: OpenAI text-embedding-3-small
- Agent Framework: Custom (based on Claude SDK)
- Context Engineering: Three-tier caching
- Hosting: Vercel
- Domain: Custom domain
- SSL: Automatic via Vercel
- CDN: Vercel Edge Network
Primary Brand: #40826D (Viridian Green)
Secondary: #2D5F4F (Dark Viridian)
Background: #E8F5F1 (Light Viridian)
Text: #212529 (Dark Gray)
Success: #28A745
Warning: #FFC107
Error: #DC3545Font Family: Inter (Google Fonts)
Sizes: 12px, 14px, 16px, 18px, 20px, 24px, 32px
Weights: 400 (regular), 500 (medium), 600 (semibold), 700 (bold)
Line Heights: 1.25 (tight), 1.5 (normal), 1.75 (relaxed)4px, 8px, 16px, 24px, 32px, 48px, 64px- Conversational AI Advisor - Chat with nutrition expert
- 7-Day Meal Plans - Personalized meal planning
- 100+ UK Recipes - British ingredients and cuisine
- Progress Tracking - Weight, adherence, energy, sleep
- Recipe Search - Filter by macros, allergies, preferences
- Shopping Lists - Auto-generated and categorized
- Meal Prep Guides - Weekly prep instructions
- Client Dashboard - Overview of all clients
- Progress Monitoring - Track client outcomes
- Conversation Review - Review flagged chats
- PMF Analytics - Product metrics and insights
- Bulk Operations - Manage multiple clients efficiently
- Nutrition Advisor - General Q&A and recipe suggestions
- Meal Planner - Generate structured 7-day plans
- Progress Analyst - Analyze trends and generate insights
- PMF Feedback - Product improvement recommendations
- 30+ clients onboarded
- 70%+ adherence rate
- NPS score >40
- 80%+ Week 2 retention
- <30 min/week coach time per client
- <2s page load time
- >99% uptime
- <$200/month API costs
- 0 security incidents
- Mobile responsive (all screens)
- GDPR Compliant - UK data protection standards
- Row-Level Security - Supabase RLS policies
- Encrypted at Rest - All data encrypted
- HTTPS Only - SSL/TLS everywhere
- Auth: Supabase Auth with JWT tokens
- AfN Guidelines - Association for Nutrition standards
- No Medical Claims - Nutrition advice only
- Evidence-Based - Scientific backing required
- Safety Validation - AI safety checks before sending responses
- All documents in
/mnt/user-data/outputs/ - README (this file) for overview
- Each document standalone and complete
- GitHub repository (to be created)
- Slack channel (optional)
- Email support (optional)
- Technical consulting available
- Development team recommendations
- James Kerby coaching methodology support
-
Review Documentation
- Read PRD for vision
- Review PBS for features
- Check WBS for budget/timeline
-
Choose Development Approach
- Full team vs self-build vs hybrid
- Budget approval
- Timeline confirmation
-
Set Up Accounts
- Anthropic API key
- Supabase account
- Vercel account
- GitHub repository
- Figma Setup
- Follow Figma to MVP Workflow
- Create wireframes
- Build high-fidelity mockups
- User testing
- Follow Implementation Guide
- Week-by-week sprints
- Agent development
- Frontend components
- Backend integration
- Production Deployment
- Beta testing with 5 clients
- Bug fixes
- Go-live
- Marketing launch
- Use Claude Code to generate boilerplate
- Follow Shadcn UI for consistency
- Implement agents incrementally (Nutrition Advisor first)
- Test with mock data before real API calls
- Cache aggressively (50% cost savings)
- Review agent prompts carefully - they embody your coaching philosophy
- Test with real client questions early
- Set up coach dashboard first for oversight
- Start with 5 beta clients for feedback
- Iterate based on real usage patterns
- Use PBS for sprint planning (Jira)
- Track hours against WBS estimates
- Weekly PMF reviews
- Biweekly stakeholder demos
- Control account monitoring for budget
Documentation: © 2024 Viridian Health & Fitness
Code: MIT License (when open-sourced)
James's Protocols: Proprietary - not for distribution
Usage Rights:
- James Kerby: Full rights to all documentation and code
- Developers: Can use for Viridian project only
- No redistribution without permission
Created By: Claude (Anthropic) in collaboration with Amanda
For: James Kerby, Viridian Health & Fitness
Date: December 2024
Version: 1.0 Complete
James Kerby
Expert Clinical Nutrition Coach
Viridian Health & Fitness
Winchester, Hampshire, UK
https://viridian-hf.com
Ready to build something amazing! 🚀
All documentation is complete, interconnected, and production-ready. Choose your path and start building today.
File: viridian-figma-to-mvp-workflow-v2.md (65 KB)
What's New in v2.0:
-
✅ Updated Brand Colors:
- Primary: #94134d (Deep Magenta/Pink) - replaces Viridian Green
- Secondary: #0797d5 (Cyan Blue)
- Accent: #009b90 (Teal)
- Complete color palette with semantic colors
-
✅ New Typography:
- Body Font: Arial (replaces Inter)
- Heading Font: Georgia (serif)
- Weights: 400 (normal), 700 (bold)
-
✅ Brand Assets Integrated:
- Logo files (primary, icon, white version)
- Favicon set (ICO, SVG, PNG 192, PNG 512)
- Hero image for landing page
- OG image for social sharing
- All assets linked from Google Drive
-
✅ Complete Design Tokens:
- Figma variables setup
- Tailwind config v2.0
- CSS custom properties
- Component library rebuilt
- JSON export format
-
✅ Migration Guide:
- v1.0 → v2.0 upgrade path
- Breaking changes documented
- Step-by-step instructions
Version History:
- v1.0 (Original): Viridian Green (#40826D) + Inter font
- v2.0 (Current): Magenta/Pink (#94134d) + Arial/Georgia
Use This For:
- Figma design with new brand colors
- Frontend development with updated design system
- Brand asset integration
- Design token management
- Version: 2.0
- Brand Colors: Pink/Magenta primary (#94134d)
- Typography: Arial (body) + Georgia (headings)
- Components: 10+ with v2.0 styling
- Design Tokens: Complete JSON export
- Brand Assets: 8 files from Google Drive
- Total Files: 8 documents
- Total Size: 465 KB (updated)
- Completion: 100%
- Version Control: Enabled
- Migration Path: v1.0 → v2.0 documented
-
Download Brand Assets:
- Get logos from Google Drive links in v2.0 doc
- Place in
public/brand/andpublic/favicons/
-
Set Up Figma:
- Create new file "Viridian v2.0"
- Import design tokens from v2.0 doc
- Configure color variables (#94134d primary)
- Set typography (Arial/Georgia)
-
Initialize Project:
npx create-next-app@14 viridian-nutrition-app # Copy Tailwind config from v2.0 doc # Copy global CSS from v2.0 doc # Import brand assets
-
Build Components:
- Use v2.0 component examples
- Follow new color scheme
- Implement logo component
- Add favicon setup
| # | Document | Version | Size | Description |
|---|---|---|---|---|
| 0 | README | 2.0 | 20 KB | This file (updated) |
| 1 | PRD | 1.2 | 44 KB | Product Requirements |
| 2 | PBS | 1.0 | 44 KB | Product Breakdown Structure |
| 3 | WBS | 1.0 | 56 KB | Work Breakdown Structure |
| 4 | Implementation Guide | 1.0 | 110 KB | 8-week technical plan |
| 5 | Agent Spec - Full | 1.0 | 86 KB | Complete AI agents |
| 6 | GitHub Setup | 1.0 | 20 KB | Claude Code setup |
| 7 | Figma Workflow v1 | 1.0 | 53 KB | Original (archived) |
| 8 | Figma Workflow v2 | 2.0 | 65 KB | Current (NEW) ⭐ |
Total Package: 465 KB
- Primary: #40826D (Viridian Green)
- Typography: Inter (sans-serif)
- Style: Natural, health-focused
- Status: Archived
- Primary: #94134d (Deep Magenta/Pink)
- Secondary: #0797d5 (Cyan Blue)
- Accent: #009b90 (Teal)
- Typography: Arial (body) + Georgia (headings)
- Style: Bold, energetic, modern
- Status: Active
Before starting development:
- Download all 8 brand assets from Google Drive
- Review Figma Workflow v2.0 document
- Set up Figma file with v2.0 design tokens
- Configure Tailwind with new color scheme
- Import logo component code
- Set up favicon files
- Test brand colors for accessibility (WCAG AA)
- Verify typography loads correctly
- Create component library with v2.0 styles
- Test responsive design on mobile
- Design: Use Figma Workflow v2.0
- Build: Follow WBS with v2.0 tokens
- Result: Enterprise-grade with new brand
- Design: Follow v2.0 design system
- Build: Use GitHub Setup + v2.0 tokens
- Result: Fully functional MVP with new brand
- Design: Figma Workflow v2.0
- Build: Developer + Claude Code assistance
- Result: High quality, lower cost, new brand
- Always use v2.0 design tokens (#94134d primary)
- Arial for body text, Georgia for headings
- Test color contrast ratios (pink text on white needs care)
- Use teal (#009b90) for success states
- Export assets at 1x and 2x resolution
- Import Tailwind config v2.0 exactly as specified
- Use CSS custom properties for theming
- Implement logo component with all variants
- Set up favicon properly (8 files total)
- Test brand colors across all components
- v2.0 is the current standard
- All new work uses v2.0 design system
- v1.0 is archived for reference only
- Migration from v1.0 to v2.0 is documented
- Budget includes brand asset integration time
Updated: December 5, 2024
Version: 2.0 Complete
Status: Ready to Build with New Brand! 🎨🚀