MUST-READ-FIRST Document Summary

Details

Raw Data

{
  "id": "aad644a1-211a-4137-99a3-571de30d6d92",
  "type": "general",
  "status": "completed",
  "title": "MUST-READ-FIRST Document Summary",
  "description": "Schema and architecture index for the greatVibe platform",
  "context": {
    "output": "<div style=\"background:#1e1e1e;color:#e0e0e0;padding:20px;border-radius:8px;font-family:'Consolas','Monaco',monospace;\">\n<h2 style=\"font-family:sans-serif;color:#fff;margin:0 0 16px 0;\">MUST-READ-FIRST - Schema & Architecture Index</h2>\n\n<p style=\"color:#98c379;margin-bottom:16px;\">Quick reference document that indexes all essential documentation for the greatVibe platform.</p>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">Document Hierarchy</h3>\n<pre style=\"background:#2d2d2d;padding:16px;border-radius:6px;overflow-x:auto;line-height:1.8;color:#e0e0e0;\">\n<span style=\"color:#56b6c2;font-weight:bold;\">MUST-READ-FIRST.md</span>          <span style=\"color:#7f848e;\">← You are here</span>\n    │\n    ├── <span style=\"color:#98c379;font-weight:bold;\">CLAUDE.md</span>               <span style=\"color:#7f848e;\">← Project instructions (CRITICAL)</span>\n    │   └── Kontask creation, tool usage, output format\n    │\n    ├── <span style=\"color:#e5c07b;\">VIBE.md</span>                 <span style=\"color:#7f848e;\">← Backlog & feature status</span>\n    │   └── Session Briefing v2, Quick Turn, WebSocket Console\n    │\n    └── <span style=\"color:#c678dd;\">/gv/docs/</span>\n        ├── gvPlatformVision.md     <span style=\"color:#7f848e;\">← Architecture overview</span>\n        ├── gvFlowSchema.md         <span style=\"color:#7f848e;\">← Core: gvTurn, gvSession, gvFlow</span>\n        ├── gvKontaskSchema.md      <span style=\"color:#7f848e;\">← Current: Kontask (→ gvTurn)</span>\n        ├── gvDecisionSchema.md     <span style=\"color:#7f848e;\">← Decisions: design, action, deferred</span>\n        ├── gvGraphSchema.md        <span style=\"color:#7f848e;\">← Relationships: edges between nodes</span>\n        ├── gvTopicSchema.md        <span style=\"color:#7f848e;\">← Topics: semantic classification</span>\n        └── gvGlossary.md           <span style=\"color:#7f848e;\">← Reference: All terminology</span>\n</pre>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">Quick Navigation</h3>\n\n<div style=\"display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:12px;margin-bottom:16px;\">\n  <div style=\"background:#2d2d2d;padding:12px;border-radius:6px;border-left:3px solid #22c55e;\">\n    <div style=\"color:#22c55e;font-weight:bold;margin-bottom:4px;\">For Immediate Work</div>\n    <div style=\"color:#7f848e;font-size:0.9em;\">\n      • <span style=\"color:#e5c07b;\">CLAUDE.md</span> - START HERE<br/>\n      • <span style=\"color:#e5c07b;\">VIBE.md</span> - Backlog<br/>\n      • <span style=\"color:#e5c07b;\">API.md</span> - Service contracts\n    </div>\n  </div>\n  <div style=\"background:#2d2d2d;padding:12px;border-radius:6px;border-left:3px solid #3b82f6;\">\n    <div style=\"color:#3b82f6;font-weight:bold;margin-bottom:4px;\">For Platform Architecture</div>\n    <div style=\"color:#7f848e;font-size:0.9em;\">\n      • gvPlatformVision.md<br/>\n      • gvFlowSchema.md<br/>\n      • gvKontaskSchema.md\n    </div>\n  </div>\n</div>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">Critical CLAUDE.md Sections</h3>\n\n<table style=\"width:100%;border-collapse:collapse;font-size:0.9em;\">\n  <tr style=\"background:#2d2d2d;\">\n    <th style=\"text-align:left;padding:8px;color:#61afef;border-bottom:1px solid #444;\">Section</th>\n    <th style=\"text-align:left;padding:8px;color:#61afef;border-bottom:1px solid #444;\">Key Points</th>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#98c379;\">Turn Context</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;color:#7f848e;\">Auto-injected &lt;turn-context&gt; tag, active flows, flowId linking</td>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#98c379;\">Kontasks</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;color:#7f848e;\">HTML output (dark theme), choices array, interactive components</td>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#98c379;\">gvFlow</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;color:#7f848e;\">Emergent flows, auto-create, Claude steers via flowId</td>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#98c379;\">Thread Detection</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;color:#7f848e;\">Debugging sequences via 'continues' edges, rabbit hole tracking</td>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;\"><span style=\"color:#98c379;\">Turn Completion</span></td>\n    <td style=\"padding:8px;color:#7f848e;\">Commit before kontask, include commitSha</td>\n  </tr>\n</table>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">Schema Mapping (Current → Future)</h3>\n\n<table style=\"width:100%;border-collapse:collapse;font-size:0.9em;\">\n  <tr style=\"background:#2d2d2d;\">\n    <th style=\"text-align:left;padding:8px;color:#c678dd;border-bottom:1px solid #444;\">Current</th>\n    <th style=\"text-align:left;padding:8px;color:#c678dd;border-bottom:1px solid #444;\">Future</th>\n    <th style=\"text-align:left;padding:8px;color:#c678dd;border-bottom:1px solid #444;\">Schema Doc</th>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#e5c07b;\">Kontask</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#98c379;\">gvTurn</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;color:#7f848e;\">gvKontaskSchema → gvFlowSchema</td>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#e5c07b;\">Session</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#98c379;\">gvSession</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;color:#7f848e;\">gvFlowSchema</td>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#7f848e;\">-</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;\"><span style=\"color:#98c379;\">gvFlow</span></td>\n    <td style=\"padding:8px;border-bottom:1px solid #333;color:#7f848e;\">gvFlowSchema</td>\n  </tr>\n  <tr>\n    <td style=\"padding:8px;\"><span style=\"color:#e5c07b;\">gvDecision</span></td>\n    <td style=\"padding:8px;\"><span style=\"color:#98c379;\">gvDecision</span></td>\n    <td style=\"padding:8px;color:#7f848e;\">gvDecisionSchema</td>\n  </tr>\n</table>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:24px 0 12px 0;\">TypeScript Sources</h3>\n\n<pre style=\"background:#2d2d2d;padding:16px;border-radius:6px;overflow-x:auto;line-height:1.6;color:#e0e0e0;font-size:0.85em;\">\n<span style=\"color:#56b6c2;\">/konnectvol/konui/src/</span>\n├── <span style=\"color:#e5c07b;\">kontask-types.ts</span>      <span style=\"color:#7f848e;\"># Kontask interface</span>\n├── <span style=\"color:#e5c07b;\">gv-flow-types.ts</span>      <span style=\"color:#7f848e;\"># gvFlow, gvSession</span>\n├── <span style=\"color:#e5c07b;\">gv-decision-types.ts</span>  <span style=\"color:#7f848e;\"># gvDecision</span>\n├── <span style=\"color:#e5c07b;\">gv-edge-types.ts</span>      <span style=\"color:#7f848e;\"># gvEdge, gvTopic, gvDomain</span>\n├── <span style=\"color:#e5c07b;\">gv-gravity.ts</span>         <span style=\"color:#7f848e;\"># gvGravity (flow suggestions)</span>\n├── <span style=\"color:#e5c07b;\">gv-thread-detection.ts</span><span style=\"color:#7f848e;\"># Thread Detection</span>\n└── <span style=\"color:#e5c07b;\">turn-context.ts</span>       <span style=\"color:#7f848e;\"># Turn Context</span>\n</pre>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-top:20px;border-left:3px solid #f59e0b;\">\n<div style=\"color:#f59e0b;font-weight:bold;margin-bottom:8px;\">Summary</div>\n<p style=\"color:#e0e0e0;margin:0;line-height:1.6;\">\nThis index is the starting point for understanding the greatVibe platform. It covers:\n<br/>• <strong>Immediate work:</strong> CLAUDE.md (project instructions), VIBE.md (backlog), API.md (contracts)\n<br/>• <strong>Platform architecture:</strong> gvPlatformVision, gvFlowSchema, gvKontaskSchema, gvDecisionSchema, gvGraphSchema\n<br/>• <strong>Build docs:</strong> gvShellDesign, gvAgentDesign, gvConnectionDesign, gvCodingStandards\n</p>\n</div>\n\n</div>",
    "requestedAt": "2026-01-11T10:00:00.000Z",
    "requestId": "fa16e7a1-e8a1-4ec5-8ac2-f04a70e1c33b",
    "choices": [
      {
        "label": "Read CLAUDE.md",
        "value": "Read CLAUDE.md - the main project instructions document",
        "primary": true
      },
      {
        "label": "Read VIBE.md",
        "value": "Read VIBE.md to see the current backlog and feature status"
      },
      {
        "label": "Read Platform Vision",
        "value": "Read /gv/docs/gvPlatformVision.md for full platform architecture"
      }
    ],
    "turnTiming": {
      "totalMs": 46943,
      "ttfeMs": 95,
      "thinkingMs": 46846,
      "toolExecutionMs": 0,
      "toolCallCount": 0,
      "thinkingPct": 100,
      "toolsPct": 0,
      "ttfePct": 0
    }
  },
  "createdBy": "claude",
  "createdAt": "2026-01-11T13:49:42.674Z",
  "updatedAt": "2026-01-11T13:49:47.791Z",
  "requestId": "fa16e7a1-e8a1-4ec5-8ac2-f04a70e1c33b",
  "scope": "greatvibe",
  "tags": [
    "docs",
    "architecture",
    "schemas"
  ],
  "sessionId": "ses_f1a97fe1-589"
}