32a4b077e2
- current/: Active feature development (smart-ocr, multiformat) - implementation/: MVP feature builds (photo, search, timeline, polish, testing) - research/: Strategy sessions (market, technical, UX, planning, validation) - README.md: Session launch protocol and status dashboard All prompts now accessible via GitHub for cloud sessions on separate machines.
213 lines
5.7 KiB
Markdown
213 lines
5.7 KiB
Markdown
# 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:**
|
|
```bash
|
|
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:**
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
# 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.
|