gvDecision Schema Written to Design Docs

Details

Raw Data

{
  "id": "addd5d4d-b5b5-4052-b2d8-26eb9c70eb8c",
  "type": "general",
  "status": "completed",
  "title": "gvDecision Schema Written to Design Docs",
  "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;\">gvDecision Schema - Written to Design Docs</h2>\n\n<p style=\"color:#98c379;margin:0 0 16px 0;\">Created <code style=\"background:#2d2d2d;padding:2px 6px;border-radius:4px;\">/gv/docs/gvDecisionSchema.md</code> (852 lines)</p>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 12px 0;\">Schema Highlights</h3>\n\n<pre style=\"background:#2d2d2d;padding:16px;border-radius:6px;overflow-x:auto;line-height:1.6;color:#e0e0e0;margin:0 0 16px 0;\">\n<span style=\"color:#c678dd;font-weight:bold;\">Categories</span>\n├── <span style=\"color:#98c379;\">design</span>    <span style=\"color:#7f848e;\"># Architecture, patterns, data, API, library choices</span>\n├── <span style=\"color:#e5c07b;\">action</span>    <span style=\"color:#7f848e;\"># Workflow decisions: test, commit, explore, scope</span>\n└── <span style=\"color:#61afef;\">deferred</span>  <span style=\"color:#7f848e;\"># Questions for humans: clarification, approval, risk</span>\n\n<span style=\"color:#c678dd;font-weight:bold;\">Decision Types</span> (30+ types across 3 categories)\n├── design:architecture, design:pattern, design:api, design:security...\n├── action:test, action:commit, action:scope, action:rollback...\n└── deferred:clarification, deferred:approval, deferred:choice...\n\n<span style=\"color:#c678dd;font-weight:bold;\">Key Fields</span>\n├── <span style=\"color:#56b6c2;\">dependsOn[]</span>     <span style=\"color:#7f848e;\"># Decision DAG - traces dependencies</span>\n├── <span style=\"color:#56b6c2;\">supersedes</span>      <span style=\"color:#7f848e;\"># Immutable pivots create new decisions</span>\n├── <span style=\"color:#56b6c2;\">confidence</span>      <span style=\"color:#7f848e;\"># certain/high/medium/low/guess</span>\n├── <span style=\"color:#56b6c2;\">impact.level</span>    <span style=\"color:#7f848e;\"># low/medium/high/critical</span>\n├── <span style=\"color:#56b6c2;\">reversibility</span>   <span style=\"color:#7f848e;\"># Can this be undone? At what cost?</span>\n└── <span style=\"color:#56b6c2;\">affects{}</span>       <span style=\"color:#7f848e;\"># Files, functions, types, APIs, tests, docs</span>\n\n<span style=\"color:#c678dd;font-weight:bold;\">Timestamps</span> (append-only, status computed)\n├── createdAt     <span style=\"color:#7f848e;\"># When made</span>\n├── reviewedAt    <span style=\"color:#7f848e;\"># When human saw it</span>\n├── approvedAt    <span style=\"color:#7f848e;\"># When approved</span>\n└── documentedAt  <span style=\"color:#7f848e;\"># When added to ADRs/CHANGELOG</span>\n</pre>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 12px 0;\">Commit</h3>\n<p style=\"margin:0 0 16px 0;\"><code style=\"background:#2d2d2d;padding:4px 8px;border-radius:4px;font-size:13px;\">da8d6c62</code> Turn: Add gvDecision complete schema specification</p>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 12px 0;\">Files Changed</h3>\n<pre style=\"background:#2d2d2d;padding:12px;border-radius:6px;line-height:1.6;margin:0 0 16px 0;\">\n<span style=\"color:#98c379;\">+ gv/docs/gvDecisionSchema.md</span>  <span style=\"color:#7f848e;\">(new - 852 lines)</span>\n<span style=\"color:#e5c07b;\">~ gv/docs/gvFlowSchema.md</span>      <span style=\"color:#7f848e;\">(added reference + TODO checkmark)</span>\n</pre>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 12px 0;\">Next Steps</h3>\n<p style=\"color:#e0e0e0;margin:0;\">The schema is designed for long-term stability with version field and metadata extensibility. Implementation can begin in konsole/konui as a prototype before gvHub.</p>\n</div>",
    "commitSha": "da8d6c62",
    "filesChanged": [
      "gv/docs/gvDecisionSchema.md",
      "gv/docs/gvFlowSchema.md"
    ],
    "choices": [
      {
        "label": "Start implementation",
        "value": "Begin implementing gvDecision in konsole - create the types, storage, and extraction logic",
        "primary": true
      },
      {
        "label": "Add to gvShell roadmap",
        "value": "Add gvDecision implementation to gvBUILD.md backlog"
      },
      {
        "label": "Review schema again",
        "value": "Open the gvDecisionSchema.md file for review"
      },
      {
        "label": "Design decision UI",
        "value": "Design the konui decision review interface for surfacing decisions needing attention"
      }
    ]
  },
  "createdBy": "claude",
  "createdAt": "2026-01-09T03:50:00.965Z",
  "updatedAt": "2026-01-09T03:50:01.534Z",
  "scope": "vibetools",
  "tags": [
    "gvshell",
    "gvhub",
    "decisions",
    "schema",
    "documentation"
  ],
  "targetUser": "claude"
}