Sessions 2 & 4: Add helper agents to assist Sessions 1 & 3

**Session 2 Helper Agents (Phase 1 - Start Immediately):**
- Agent 0A: Technical Validation Assistant (verify competitor APIs, check feasibility)
- Agent 0B: Citation Automation (SHA-256 hash generation, URL verification)
- Agent 0C: Web Scraping Assistant (structured data extraction from competitor sites)
- Agent 0D: ROI Calculator Backend (build framework before Session 1 data arrives)

**Session 4 Helper Agents (Phase 1 - Start Immediately):**
- Agent 0A: Research Coordination Dashboard (track Session 1 agent progress in real-time)
- Agent 0B: Citation Quality Checker (pre-validate citations before Session 5)
- Agent 0C: Demo Script Structure (create template with placeholders for Session 1 data)
- Agent 0D: Cross-Session Dependency Tracker (visual dependency graph, critical path analysis)

**Status Updates:**
- Session 2: 🟡 READY → 🟢 ACTIVE (Helper) - 4/15 agents
- Session 4:  COMPLETE → 🟢 ACTIVE (Helper) - 4/14 agents

**InfraFabric S² Pattern:** Transform idle sessions into active helpers, eliminating wait time and accelerating overall project completion.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Danny Stocker 2025-11-13 03:12:59 +01:00
parent 8544f5a020
commit bdf4e10e9d
3 changed files with 385 additions and 23 deletions

View file

@ -10,14 +10,16 @@
| Session | Agent ID Range | Status | Progress | Outputs |
|---------|---------------|--------|----------|---------|
| Session 1 | S1-H01 to S1-H10 | 🟡 READY | 0/10 agents | `intelligence/session-1/` |
| Session 2 | S2-H01 to S2-H10 | 🟡 READY | 0/10 agents | `intelligence/session-2/` |
| Session 2 | S2-H0A to S2-H10 | 🟢 ACTIVE (Helper) | 4/15 agents | `intelligence/session-2/` |
| Session 3 | S3-H01 to S3-H10 | 🟡 READY | 0/10 agents | `intelligence/session-3/` |
| Session 4 | S4-H01 to S4-H10 | ✅ COMPLETE | 10/10 agents | `intelligence/session-4/` |
| Session 5 | S5-H0A to S5-H10 | 🟢 ACTIVE (QA) | 0/13 agents | `intelligence/session-5/` |
| Session 4 | S4-H0A to S4-H10 | 🟢 ACTIVE (Helper) | 4/14 agents | `intelligence/session-4/` |
| Session 5 | S5-H0A to S5-H10 | 🟢 ACTIVE (QA) | 3/13 agents | `intelligence/session-5/` |
**Status Legend:**
- 🟡 READY - Session initialized, waiting to start
- 🟢 ACTIVE - Session running, agents working
- 🟢 ACTIVE (Helper) - Session assisting other sessions while waiting
- 🟢 ACTIVE (QA) - Session providing quality assurance support
- 🔵 BLOCKED - Waiting for dependencies from other sessions
- ✅ COMPLETE - All outputs delivered
@ -49,20 +51,37 @@ Next: Session 2 unblocked
---
### **Session 2: Technical Integration**
### **Session 2: Technical Integration + Helper Agents**
**Current Task:** Codebase analysis + sticky feature architecture
**Current Task:** PHASE 1 - Helper agents assisting Sessions 1 & 3 (START NOW)
**Instructions:**
1. **First:** Agent 1 (S2-H01) analyzes NaviDocs codebase (NO dependency on Session 1)
2. **Parallel:** Agents 2-9 research technical solutions (inventory, cameras, maintenance, etc.)
3. **When Session 1 completes:** Poll for `intelligence/session-1/session-1-handoff.md`
4. **Then:** Agent 10 synthesizes with Session 1 pain point priorities
5. Output to `intelligence/session-2/` (architecture.md, integration-specs.md, handoff.md)
**IMMEDIATE ACTIONS (Agents 0A, 0B, 0C, 0D):**
1. **Agent 0A (CONTINUOUS):** Technical validation assistant
- Verify competitor tech stacks for Session 1
- Check API availability (YachtWorld, Boat Trader, etc.)
- Validate technical feasibility of Session 3 UX proposals
2. **Agent 0B (CONTINUOUS):** Citation automation
- Generate SHA-256 hashes for Session 1 web URLs
- Verify URL accessibility (flag broken links)
- Auto-generate IF.TTT-compliant citation JSON
3. **Agent 0C (CONTINUOUS):** Web scraping assistant
- Extract competitor feature lists, pricing tables
- Parse industry reports for Session 1
- Create structured competitor-data.json
4. **Agent 0D (PREP WORK):** ROI calculator backend
- Build generic calculator framework NOW
- Ready to plug in Session 1 data when it arrives
- Prepare chart generation and export functionality
**PHASE 2 - Technical Architecture (WAIT FOR SESSION 1):**
5. **When Session 1 completes:** Poll for `intelligence/session-1/session-1-handoff.md`
6. **Agents 1-9 + 3A + 7A:** Codebase analysis + feature design (11 agents)
7. **Agent 10:** Synthesize with Session 1 pain point priorities
8. Output to `intelligence/session-2/` (architecture.md, integration-specs.md, handoff.md)
**Dependencies:**
- **Agent 1 task:** NONE (start immediately)
- **Agent 10 synthesis:** Session 1 complete
- **Agents 0A-0D:** NONE (start immediately - assist Sessions 1 & 3)
- **Agents 1-9 + 3A + 7A + Agent 10:** Session 1 complete
**Polling Command:**
```bash
@ -103,20 +122,41 @@ fi
---
### **Session 4: Implementation Planning**
### **Session 4: Implementation Planning + Helper Agents**
**Current Task:** Generic sprint planning + roadmap templates
**Current Task:** PHASE 1 - Helper agents providing project management support (START NOW)
**Instructions:**
1. **Parallel:** Week agents research sprint best practices, roadmap templates
2. **When Sessions 1+2+3 complete:** Poll for handoff files
3. **Then:** Week agents create detailed sprint plans with feature priorities from Session 1
4. **Finally:** Agent 10 creates integrated 4-week roadmap
5. Output to `intelligence/session-4/` (sprint-plan.md, roadmap.md, handoff.md)
**IMMEDIATE ACTIONS (Agents 0A, 0B, 0C, 0D):**
1. **Agent 0A (CONTINUOUS - Every 5 minutes):** Research coordination dashboard
- Track Session 1 agent progress (7/10 complete, etc.)
- Monitor deliverable status (market-analysis.md: COMPLETE, etc.)
- Predict completion times for all sessions
- Detect blockers early (agent stuck, over-budget, etc.)
2. **Agent 0B (CONTINUOUS):** Citation quality checker
- Pre-validate Session 1, 2, 3 citations BEFORE Session 5
- Check IF.TTT compliance (citation_id, sources, confidence, SHA-256)
- Flag issues immediately (single-source claims, missing hashes, etc.)
- Faster feedback loop than waiting for Session 5 validation
3. **Agent 0C (PREP WORK):** Demo script structure
- Research winning demo flows (problem → solution → demo → ROI → close)
- Create generic template with placeholders for Session 1 data
- Research yacht owner objections (cost, complexity, time)
- Ready to fill with Session 1 findings when available
4. **Agent 0D (CONTINUOUS - Every 5 minutes):** Cross-session dependency tracker
- Visual dependency graph (Mermaid) of all sessions
- Critical path identification (slowest session = bottleneck)
- Real-time completion predictions
- Parallel work opportunity detection
**PHASE 2 - Implementation Planning (WAIT FOR SESSIONS 1+2+3):**
5. **When Sessions 1+2+3 complete:** Poll for handoff files
6. **Agents 1-9:** Create detailed 4-week sprint plan with feature priorities
7. **Agent 10:** Synthesize integrated roadmap
8. Output to `intelligence/session-4/` (sprint-plan.md, roadmap.md, handoff.md)
**Dependencies:**
- **Week 1-4 generic planning:** NONE (start immediately)
- **Detailed feature breakdown:** Sessions 1+2+3 complete
- **Agents 0A-0D:** NONE (start immediately - assist all sessions)
- **Agents 1-10:** Sessions 1+2+3 complete
**Polling Command:**
```bash

View file

@ -44,6 +44,146 @@ Design technical architecture for **sticky daily-use features** (inventory track
---
## PHASE 1: Helper Agents (START IMMEDIATELY - ASSIST SESSIONS 1 & 3)
**Mission:** While waiting for Session 1 market research and Session 3 UX/sales work, provide active technical assistance to accelerate their completion.
**NO DEPENDENCIES:** All Phase 1 agents can start immediately (no need to wait for other sessions).
---
### Agent 0A: Technical Validation Assistant (CRITICAL)
**AGENT ID:** S2-H0A
**START:** Immediately (no dependencies)
**Assist Session 1 (Market Research):**
- **Verify competitor tech stacks:** When Session 1 identifies competitors (YachtWorld, Boat Trader, etc.), validate their API documentation
- **Check API availability:** Research if competitor APIs are public, require auth, or need partner agreements
- **Document API contracts:** Create structured summaries of competitor API capabilities for Session 1 citations
**Assist Session 3 (UX/Sales):**
- **Technical feasibility checks:** When Session 3 proposes UI features, confirm if NaviDocs tech stack supports them
- **Performance estimates:** Provide load time estimates for proposed features (based on NaviDocs current architecture)
- **Mobile compatibility:** Validate if proposed UX patterns work on mobile (Vue 3 + PWA constraints)
**Deliverable:** `intelligence/session-2/helper-technical-validations.md` (updated in real-time as Sessions 1 & 3 work)
---
### Agent 0B: Citation Automation (SHA-256 Hash Generation)
**AGENT ID:** S2-H0B
**START:** Immediately (no dependencies)
**Assist Session 1 (Market Research):**
- **Generate SHA-256 hashes:** When Session 1 cites web URLs, automatically fetch and hash content
- **Verify URL accessibility:** Check if cited URLs return 200 OK (flag broken links immediately)
- **Extract structured data:** Parse web pages for key data points (pricing, features, market stats)
- **Create citation JSON:** Auto-generate IF.TTT-compliant citation entries with hashes
**Example Workflow:**
```bash
# Session 1 Agent 3 cites: "YachtWorld pricing: €25/month"
# Agent 0B immediately:
1. Fetches https://yachtworld.com/pricing
2. Generates SHA-256: a1b2c3d4e5f6...
3. Extracts pricing table
4. Creates citation JSON:
{
"citation_id": "if://citation/yachtworld-pricing-nov2025",
"claim": "YachtWorld charges €25/month for yacht management",
"sources": [{
"type": "web",
"url": "https://yachtworld.com/pricing",
"sha256": "a1b2c3d4e5f6...",
"accessed": "2025-11-13",
"quality": "primary",
"credibility": 9
}],
"status": "verified",
"confidence_score": 0.95
}
```
**Deliverable:** `intelligence/session-2/auto-citations.json` (append as Session 1 works)
---
### Agent 0C: Web Scraping Assistant (Structured Data Extraction)
**AGENT ID:** S2-H0C
**START:** Immediately (no dependencies)
**Assist Session 1 (Market Research):**
- **Extract competitor feature lists:** Scrape competitor websites for feature comparisons
- **Pricing table extraction:** Parse pricing pages into structured JSON
- **Market report parsing:** Extract key stats from industry reports (PDFs, web pages)
- **Automated data validation:** Cross-check data across multiple sources (detect conflicts)
**Example:**
```yaml
# Session 1 Agent 5 researching competitors
# Agent 0C scrapes:
- YachtWorld: Features (inventory, CRM, MLS integration)
- Boat Trader: Pricing (€15/month basic, €45/month pro)
- Dockwa: User counts (50K+ marinas, 250K+ boaters)
# Output: intelligence/session-2/competitor-data.json
{
"yachtworld": {
"features": ["inventory", "crm", "mls_integration"],
"pricing": {"basic": 25, "pro": 75},
"users": "unknown"
},
"boat_trader": {
"features": ["listings", "leads", "analytics"],
"pricing": {"basic": 15, "pro": 45},
"users": "unknown"
}
}
```
**Deliverable:** `intelligence/session-2/competitor-data.json` (structured data for Session 1 & 3 use)
---
### Agent 0D: ROI Calculator Backend (Build Before Session 1 Data Arrives)
**AGENT ID:** S2-H0D
**START:** Immediately (no dependencies)
**Build Generic ROI Calculator Framework:**
- **Formula engine:** Create generic calculator that accepts variables (warranty_savings, time_saved, resale_value_increase)
- **Input validation:** Define valid ranges for each variable (prevent unrealistic claims)
- **Visualization logic:** Prepare chart generation code (bar charts, pie charts for ROI breakdown)
- **Export functionality:** Generate PDF/Excel exports of ROI calculations
**Example Structure:**
```javascript
// server/services/roi-calculator.service.js
class ROICalculator {
calculate(inputs) {
// inputs: { warranty_savings, time_saved_hours, resale_value_increase }
const warranty_roi = inputs.warranty_savings * 12; // Annual savings
const time_roi = inputs.time_saved_hours * 50; // €50/hour labor cost
const resale_roi = inputs.resale_value_increase;
return {
total_annual_roi: warranty_roi + time_roi,
resale_value_lift: resale_roi,
payback_period_months: this.calculatePayback(inputs),
confidence: this.calculateConfidence(inputs)
};
}
}
```
**When Session 1 Data Arrives:**
- Agent 0D plugs in Session 1 findings (€8K-€33K warranty savings, etc.)
- Generates final ROI report for Session 3 pitch deck
- Creates interactive calculator UI for demos
**Deliverable:** `intelligence/session-2/roi-calculator-framework.js` (ready for Session 1 data integration)
---
## Agent Identity & Check-In Protocol

View file

@ -35,6 +35,188 @@ Create detailed 4-week implementation plan with task breakdown, dependencies, ac
---
## PHASE 1: Helper Agents (START IMMEDIATELY - ASSIST SESSIONS 1 & 3)
**Mission:** While waiting for Sessions 1+2+3 to complete, provide active project management assistance to accelerate overall coordination and quality.
**NO DEPENDENCIES:** All Phase 1 agents can start immediately (no need to wait for other sessions).
---
### Agent 0A: Research Coordination Dashboard (Real-Time Progress Tracking)
**AGENT ID:** S4-H0A
**START:** Immediately (no dependencies)
**Assist Session 1 (Market Research):**
- **Agent progress tracker:** Monitor which of the 10 Session 1 agents have completed their tasks
- **Completion status:** Track deliverables (market-analysis.md, citations.json, handoff.md)
- **Blocker detection:** Identify if any Session 1 agent is stuck or over-budget
- **Estimated completion:** Predict when Session 1 will finish based on current progress
**Dashboard Format:**
```yaml
# intelligence/session-4/coordination-dashboard.md
## Session 1 Progress (Updated Every 5 Minutes)
Agents Complete: 7/10 (70%)
Deliverables:
- market-analysis.md: ✅ COMPLETE (87KB)
- session-1-citations.json: 🟡 IN PROGRESS (43 citations so far)
- session-1-handoff.md: ⏳ PENDING (Agent 10 not started)
Estimated Completion: 15 minutes
Blockers: None
Token Usage: $12.50 / $15.00 budget (83% consumed)
```
**Deliverable:** `intelligence/session-4/coordination-dashboard.md` (updated every 5 minutes)
---
### Agent 0B: Citation Quality Checker (Pre-Validate Before Session 5)
**AGENT ID:** S4-H0B
**START:** Immediately (no dependencies)
**Assist Sessions 1, 2, 3 (Pre-Validation):**
- **Citation format check:** Validate citations follow IF.TTT schema (citation_id, sources, confidence_score, etc.)
- **Source quality scoring:** Verify primary sources have 9-10 credibility (not tertiary)
- **Multi-source validation:** Check high-confidence claims (≥0.9) have ≥2 sources
- **SHA-256 verification:** Confirm web URLs have SHA-256 hashes (tamper detection)
- **Broken link detection:** Test cited URLs return 200 OK (flag dead links)
**Example Feedback:**
```yaml
# intelligence/session-4/citation-quality-report.md
## Session 1 Citation Quality (43 citations reviewed)
✅ PASS (38 citations):
- All have if://citation/ IDs
- Primary sources properly cited
- ≥2 sources for high-confidence claims
⚠️ NEEDS ATTENTION (5 citations):
1. Citation: if://citation/broker-count-med
- Issue: Single source (need 2nd corroboration)
- Recommendation: Add Boat International report as 2nd source
2. Citation: if://citation/warranty-costs
- Issue: Missing SHA-256 hash for YachtWorld URL
- Recommendation: Run `sha256sum` on fetched page
3. Citation: if://citation/competitor-pricing
- Issue: Confidence 0.95 but only secondary sources (credibility 7-8)
- Recommendation: Lower confidence to 0.85 or find primary source
```
**Value:** Catch citation issues BEFORE Session 5 validation (faster feedback loop, less rework)
**Deliverable:** `intelligence/session-4/citation-quality-report.md` (updated as sessions work)
---
### Agent 0C: Demo Script Structure (Outline Before Session 1 Data)
**AGENT ID:** S4-H0C
**START:** Immediately (no dependencies)
**Assist Session 3 (UX/Sales):**
- **Demo flow research:** Study winning software demo structures (problem → solution → demo → ROI → close)
- **Generic outline:** Create demo script template with placeholders for Session 1 data
- **Objection handling:** Research common yacht owner objections (cost, complexity, time investment)
- **Storytelling techniques:** Identify emotional hooks (peace of mind, warranty savings, resale value)
**Generic Demo Outline (Before Session 1 Data):**
```markdown
# NaviDocs Demo Script (Template)
## 1. Opening (2 min)
- Pain point: "[INSERT: Top pain point from Session 1]"
- Teaser: "What if you could [INSERT: Key benefit]?"
## 2. Problem Deep Dive (3 min)
- Story: "[INSERT: Yacht owner story from Session 1]"
- Consequence: "Without NaviDocs, owners lose [INSERT: €X savings]"
## 3. Solution Demo (10 min)
- Feature 1: [INSERT: Sticky feature from Session 2]
- Show: [Screen recording placeholder]
- Benefit: [INSERT: Time/money saved]
## 4. ROI Reveal (5 min)
- Calculator: [INSERT: Session 1 warranty savings data]
- Comparison: "That's [X] hours saved per year"
## 5. Close (2 min)
- Call to action: "Sign up for Riviera pilot"
- Objection handling: [INSERT: Top 3 objections from Session 1]
```
**When Session 1 Completes:**
- Agent 0C fills placeholders with real data
- Creates final polished demo script for Session 3
**Deliverable:** `intelligence/session-4/demo-script-template.md` (ready for Session 1 data integration)
---
### Agent 0D: Cross-Session Dependency Tracker (Visual Dependency Graph)
**AGENT ID:** S4-H0D
**START:** Immediately (no dependencies)
**Monitor All Sessions:**
- **Dependency mapping:** Track which sessions are blocking others
- **Critical path visualization:** Identify slowest session (bottleneck)
- **Parallel work opportunities:** Find tasks that can run concurrently
- **Completion predictions:** Estimate when each session will finish
**Dependency Graph (Mermaid):**
```mermaid
graph TD
S1[Session 1: Market Research] --> S2[Session 2: Technical Architecture]
S1 --> S3[Session 3: UX/Sales]
S2 --> S3
S1 --> S4[Session 4: Implementation Planning]
S2 --> S4
S3 --> S4
S1 --> S5[Session 5: Guardian Validation]
S2 --> S5
S3 --> S5
S4 --> S5
style S1 fill:#90EE90
style S2 fill:#FFD700
style S3 fill:#FFD700
style S4 fill:#FFD700
style S5 fill:#87CEEB
```
**Real-Time Status Updates:**
```yaml
# intelligence/session-4/dependency-status.md
## Critical Path Analysis (Updated Every 5 Minutes)
SLOWEST SESSION: Session 1 (30 min remaining)
- Blocks: Session 2 (Agent 10), Session 3 (Agents 8-10), Session 4 (All agents)
PARALLEL WORK:
- Session 2 Phase 1 agents (0A-0D): ✅ RUNNING (assisting Session 1)
- Session 5 Phase 1 agents (0A-0C): ✅ RUNNING (deploying standards)
ESTIMATED COMPLETION:
- Session 1: 13:30 UTC
- Session 2: 14:00 UTC (depends on Session 1)
- Session 3: 14:30 UTC (depends on Sessions 1+2)
- Session 4: 15:00 UTC (depends on Sessions 1+2+3)
- Session 5: 16:30 UTC (depends on all)
```
**Deliverable:** `intelligence/session-4/dependency-status.md` (updated every 5 minutes with Mermaid graph)
---
## Agent Identity & Check-In Protocol