Skip to content

feat: groundtruth doctor + fact-checked launch kit (v0.7.0)#29

Merged
youcefzemmar merged 1 commit into
veltiq:mainfrom
youcefzemmar:feat/growth-kit-0.7.0
May 31, 2026
Merged

feat: groundtruth doctor + fact-checked launch kit (v0.7.0)#29
youcefzemmar merged 1 commit into
veltiq:mainfrom
youcefzemmar:feat/growth-kit-0.7.0

Conversation

@youcefzemmar
Copy link
Copy Markdown
Collaborator

Two things: the highest-ROI onboarding feature, and a complete go-to-market kit (every claim fact-checked against the codebase and primary research — non-negotiable for an anti-hallucination tool).

groundtruth doctor

One command answers "is it actually wired up and working?" — checks Node, the Stop hook (project + global), the binary, git evidence, config, transcript discoverability, the verify-loop state, and the ledger, with an actionable hint when anything's off (exit 1 on failure).

groundtruth doctor — /your/project
  ✓ Node.js       v22 (>= 20)
  ✗ Stop hook     not wired into Claude Code — turns aren't being checked
    → Run `groundtruth setup`, then restart Claude Code.
  ✓ Git evidence  this directory is a git repo
  ...

New src/doctor.ts (pure buildDoctorReport + scanSettings seam) + 9 tests.

Launch kit (docs/launch/)

Fact-checked drafts for a human to post (nothing auto-published): Show HN, X thread, Reddit, Product Hunt, dev.to, the awesome-claude-code submission, good-first-issues, and an ordered CHECKLIST. Plus docs/comparison.md (vs tests / manual review / AI code reviewers) and a refreshed social card.

Produced and adversarially fact-checked by a multi-agent workflow; one fabricated stat was caught and removed, and the README "Why" now cites the real research it was built onGong et al., MSR'26 (arXiv:2601.04886): never-implemented changes are the #1 message-vs-code inconsistency (45.4%), accepted 51.7% less often. Citation independently verified against the paper before landing.

Quality

150 tests pass (+9), typecheck + biome clean. doctor behaviorally smoke-tested (wired vs unwired, exit codes). Ships as 0.7.0.

🤖 Generated with Claude Code

Adds the highest-ROI onboarding feature and a complete, fact-checked
go-to-market kit (produced + adversarially verified by a multi-agent
workflow; every claim checked against the codebase and primary research).

- feat: `groundtruth doctor` — diagnose an install in one command (Node, hook
  wiring project+global, binary, git, config, transcript discoverability,
  verify-loop state, ledger) with actionable hints; exit 1 on any failure.
  New src/doctor.ts (pure buildDoctorReport seam + scanSettings) + 9 tests.
- docs: launch kit under docs/launch/ (Show HN, X thread, Reddit, Product Hunt,
  dev.to, awesome-claude-code submission, good-first-issues, ordered CHECKLIST)
  — drafts for a human to post, nothing auto-published.
- docs: new docs/comparison.md (vs tests / manual review / AI code reviewers).
- docs: README "Why" now cites the research it's built on — Gong et al., MSR'26
  (arXiv:2601.04886): never-implemented changes are the veltiq#1 message-vs-code
  inconsistency (45.4%), accepted 51.7% less often. Citation independently
  verified against the paper before landing.
- chore: refreshed assets/social-card.svg (new tagline + the catch); plugin.json
  synced to 0.7.0.

150 tests pass, typecheck + biome clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@youcefzemmar youcefzemmar merged commit b5c7559 into veltiq:main May 31, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant