← Back to Kontasks

Coding Standards Section in CLAUDE.md

Overview of the Go coding standards for the /gv folder

✓ Completed
on 9 Jan 2026, 8:30 pm

Output

CRITICAL: Coding Standards Compliance (gv/ folder)

Location: Lines 75-130 in CLAUDE.md
Applies to: All code in /gv folder (gvShell Go code)

6 Mandatory Checks

1. Error Wrapping NEVER use bare return err. Always wrap:
return fmt.Errorf("context: %w", err)
2. Package Docs Every package MUST have // Package name... comment
3. Sentinel Errors Scope by package: errors.New("session: not found")
4. Never Log Secrets No tokens, API keys, passwords in logs
5. Context Threading Long-running ops accept context.Context first
6. Tests Required New code requires corresponding *_test.go files

Pre-Commit Validation

# All must pass before committing to /gv
cd /konnectvol/gv/gvshell
/usr/local/go/bin/go vet ./...           # Must pass
/usr/local/go/bin/go test -race ./...    # Must pass
/usr/local/go/bin/go build ./...         # Must succeed

Full Standards Document

For significant gv/ work, read the complete document at:
/gv/docs/gvCodingStandards.md

It covers:

  • File naming conventions
  • Module boundaries (core cannot import providers)
  • Logging standards (snake_case fields, structured JSON)
  • Testing patterns (table-driven, golden tests, fuzz tests)
  • Security standards (input validation, default deny, evidence redaction)

Quick Actions

▶ View Turn
Original Request

No layout configured

Details

Type General
Status Completed
Scope vibetools
Tags claude-mdcoding-standardsgvshell
Created 9 Jan 2026, 8:28 pm
Updated 9 Jan 2026, 8:30 pm
Timing
⏱️ 38.3s
0 tools
● TTFE 1% ● Thinking 99% ● Tools 0%
Created By claude

📋 Claude's Context

Session ses_d3abe491...

Raw Data

{
  "id": "5035eb27-71fe-439d-88dc-3f27ca2ba34c",
  "type": "general",
  "status": "completed",
  "title": "Coding Standards Section in CLAUDE.md",
  "description": "Overview of the Go coding standards for the /gv folder",
  "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;\">CRITICAL: Coding Standards Compliance (gv/ folder)</h2>\n\n<p style=\"line-height:1.6;margin:0 0 16px 0;\">\n<strong style=\"color:#f97316;\">Location:</strong> Lines 75-130 in CLAUDE.md<br/>\n<strong style=\"color:#f97316;\">Applies to:</strong> All code in <code style=\"background:#2d2d2d;padding:2px 6px;border-radius:4px;\">/gv</code> folder (gvShell Go code)\n</p>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 8px 0;\">6 Mandatory Checks</h3>\n\n<table style=\"width:100%;border-collapse:collapse;margin-bottom:16px;\">\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:10px;color:#c678dd;font-weight:bold;width:30%;\">1. Error Wrapping</td>\n<td style=\"padding:10px;\">NEVER use bare <code>return err</code>. Always wrap:<br/><code style=\"color:#98c379;\">return fmt.Errorf(\"context: %w\", err)</code></td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:10px;color:#c678dd;font-weight:bold;\">2. Package Docs</td>\n<td style=\"padding:10px;\">Every package MUST have <code>// Package name...</code> comment</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:10px;color:#c678dd;font-weight:bold;\">3. Sentinel Errors</td>\n<td style=\"padding:10px;\">Scope by package: <code style=\"color:#98c379;\">errors.New(\"session: not found\")</code></td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:10px;color:#c678dd;font-weight:bold;\">4. Never Log Secrets</td>\n<td style=\"padding:10px;\">No tokens, API keys, passwords in logs</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:10px;color:#c678dd;font-weight:bold;\">5. Context Threading</td>\n<td style=\"padding:10px;\">Long-running ops accept <code>context.Context</code> first</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:10px;color:#c678dd;font-weight:bold;\">6. Tests Required</td>\n<td style=\"padding:10px;\">New code requires corresponding <code>*_test.go</code> files</td>\n</tr>\n</table>\n\n<h3 style=\"font-family:sans-serif;color:#98c379;margin:16px 0 8px 0;\">Pre-Commit Validation</h3>\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<pre style=\"margin:0;color:#e0e0e0;\"><span style=\"color:#7f848e;\"># All must pass before committing to /gv</span>\n<span style=\"color:#61afef;\">cd</span> /konnectvol/gv/gvshell\n<span style=\"color:#e5c07b;\">/usr/local/go/bin/go</span> vet ./...           <span style=\"color:#7f848e;\"># Must pass</span>\n<span style=\"color:#e5c07b;\">/usr/local/go/bin/go</span> test -race ./...    <span style=\"color:#7f848e;\"># Must pass</span>\n<span style=\"color:#e5c07b;\">/usr/local/go/bin/go</span> build ./...         <span style=\"color:#7f848e;\"># Must succeed</span></pre>\n</div>\n\n<h3 style=\"font-family:sans-serif;color:#e5c07b;margin:16px 0 8px 0;\">Full Standards Document</h3>\n<p style=\"line-height:1.6;margin:0 0 16px 0;\">\nFor significant gv/ work, read the complete document at:<br/>\n<code style=\"background:#2d2d2d;padding:4px 8px;border-radius:4px;color:#61afef;\">/gv/docs/gvCodingStandards.md</code>\n</p>\n\n<p style=\"line-height:1.6;margin:0;\">It covers:</p>\n<ul style=\"margin:8px 0 0 0;line-height:1.8;\">\n<li><span style=\"color:#56b6c2;\">File naming conventions</span></li>\n<li><span style=\"color:#56b6c2;\">Module boundaries</span> (core cannot import providers)</li>\n<li><span style=\"color:#56b6c2;\">Logging standards</span> (snake_case fields, structured JSON)</li>\n<li><span style=\"color:#56b6c2;\">Testing patterns</span> (table-driven, golden tests, fuzz tests)</li>\n<li><span style=\"color:#56b6c2;\">Security standards</span> (input validation, default deny, evidence redaction)</li>\n</ul>\n\n</div>",
    "requestedAt": "2026-01-09T00:00:00.000Z",
    "requestId": "bd57757d-f181-4195-8c7d-c4dae30abb7f",
    "turnTiming": {
      "totalMs": 38280,
      "ttfeMs": 380,
      "thinkingMs": 37900,
      "toolExecutionMs": 0,
      "toolCallCount": 0,
      "thinkingPct": 99,
      "toolsPct": 0,
      "ttfePct": 1
    }
  },
  "createdBy": "claude",
  "createdAt": "2026-01-09T10:28:48.593Z",
  "updatedAt": "2026-01-09T10:30:26.753Z",
  "targetUser": "claude",
  "requestId": "bd57757d-f181-4195-8c7d-c4dae30abb7f",
  "scope": "vibetools",
  "tags": [
    "claude-md",
    "coding-standards",
    "gvshell"
  ],
  "sessionId": "ses_d3abe491-395",
  "flowId": "flow_01KEGVRXHHK7E25VFSX4HCV289",
  "flowLinks": [
    {
      "flowId": "flow_01KEGVRXHHK7E25VFSX4HCV289",
      "edgeType": "evidence",
      "createdAt": "2026-01-09T10:28:48.593Z"
    }
  ]
}
DashboardReportsKontasksFlowsDecisionsSessionsTelemetryLogs + Go