navidocs/builder/prompts/README.md

NaviDocs Cloud Session Prompts

Created: 2025-11-13 Purpose: Centralized prompt library for cloud-based development sessions Access: https://github.com/dannystocker/navidocs/tree/navidocs-cloud-coordination/builder/prompts

---

Directory Structure

builder/prompts/
├── README.md (this file)
├── current/          # Active feature development (PRIORITY)
├── implementation/   # MVP feature builds
└── research/         # Strategy and planning sessions

---

🚀 Current Sessions (Start Here!)

Location: builder/prompts/current/

These are the ACTIVE sessions for the v0.5 → v1.0 feature roadmap:

Session 1: Smart OCR Optimization

File: current/session-1-smart-ocr.md Branch: feature/smart-ocr Duration: 60 minutes Priority: P0 (36x performance improvement)

Goal: Extract native PDF text first, only OCR scanned pages Performance: 180s → 5s for text-heavy PDFs Dependencies: npm install pdfjs-dist

Quick Start:

git checkout -b feature/smart-ocr
# Follow prompt instructions

---

Session 2: Multi-Format Upload

File: current/session-2-multiformat.md Branch: feature/multiformat Duration: 90 minutes Priority: P1 (Feature expansion)

Goal: Support JPG, PNG, DOCX, XLSX, TXT, MD uploads Dependencies: npm install mammoth xlsx

Quick Start:

git checkout -b feature/multiformat
# Follow prompt instructions

---

Session 3: Timeline Feature (TBD)

File: current/session-3-timeline.md Branch: feature/timeline Duration: 2 hours (backend + frontend) Priority: P1 (Core demo feature)

Goal: Organization activity timeline (uploads, maintenance, events) Spec: /home/setup/navidocs/FEATURE_SPEC_TIMELINE.md

---

📦 Implementation Sessions

Location: builder/prompts/implementation/

These prompts build MVP features for the Riviera Plaisance demo:

1. Photo Inventory - Boat photo upload with tag filtering
2. Document Search - Smart classifier + ranking
3. Maintenance Timeline - Service alerts + history
4. Demo Polish - UI/UX optimization
5. Integration Testing - Quality gate + sign-off

Use Case: Sequential deployment for demo readiness (7.5 hours total)

Index File: See CLOUD_PROMPTS_INDEX.md for full details

---

🔬 Research Sessions

Location: builder/prompts/research/

These prompts perform deep analysis and strategic planning:

1. Market Research - Competitive intelligence + TAM/SAM
2. Technical Integration - Architecture + API design
3. UX + Sales Enablement - Pitch deck + ROI calculator
4. Implementation Planning - 4-week sprint breakdown
5. Synthesis + Validation - Guardian review + dossier

Use Case: Strategic planning before feature builds

---

🔄 Polling for Updates

Cloud sessions should poll this directory for updated instructions:

# Check for new prompts or updates every 15 minutes
git fetch origin
git diff origin/navidocs-cloud-coordination -- builder/prompts/

Update Notifications:

• New files indicate new sessions available
• Modified files indicate updated instructions
• Check README.md for announcements

---

📋 Session Launch Protocol

For Cloud Session Operators:

1. Read the prompt file - Understand mission + success criteria
2. Create feature branch - Use naming convention: feature/[name]
3. Follow implementation steps - Code, test, document
4. Commit with tag - Use [SESSION-N] prefix
5. Report completion - Create SESSION-N-COMPLETE.md summary
6. Push to GitHub - git push origin feature/[name]

Communication:

• Progress updates every 30 minutes
• Blockers escalated within 15 minutes
• Completion report required before next session

---

🎯 Success Criteria

Each prompt includes specific success criteria. General requirements:

• ✅ All code committed to feature branch
• ✅ Tests passing (if applicable)
• ✅ No regressions in existing functionality
• ✅ Documentation updated
• ✅ Session completion report created

---

🚨 If Blocked

Check these resources:

1. /home/setup/navidocs/SESSION_DEBUG_BLOCKERS.md - Known issues
2. /home/setup/navidocs/ARCHITECTURE-SUMMARY.md - System overview
3. GitHub Issues - Open issue with [BLOCKER] tag

Escalation Path:

1. Try 2 workarounds first (15 min max)
2. Document blocker clearly
3. Signal for help via GitHub Issue or session report

---

📊 Status Dashboard

Session	Status	Branch	Completion
Session 1: Smart OCR	⏳ Ready	feature/smart-ocr	0%
Session 2: Multi-format	⏳ Ready	feature/multiformat	0%
Session 3: Timeline	📝 Planning	feature/timeline	0%
Session 4: TBD	💤 Pending	-	0%
Session 5: TBD	💤 Pending	-	0%

Last Updated: 2025-11-13 13:05 UTC Next Review: After Session 1 completion

---

🔗 Key Links

• GitHub Repo: https://github.com/dannystocker/navidocs
• Working Branch: navidocs-cloud-coordination
• Demo Tag: v0.5-demo-ready
• Local Dev: /home/setup/navidocs

API Endpoints:

• Backend: http://localhost:8001
• Frontend: http://localhost:8081
• Meilisearch: http://localhost:7700

Test Credentials:

• User: test2@navidocs.test
• Pass: TestPassword123
• Org ID: 6ce0dfc7-f754-4122-afde-85154bc4d0ae

---

📝 Version History

Date	Change	Commit
2025-11-13	Initial prompts directory created	TBD
2025-11-13	Added current/ implementation/ research/ structure	TBD

---

Welcome to NaviDocs builder system! 🚢

Start with current/session-1-smart-ocr.md for immediate impact.