Skip to content

docs: reposition as the human-in-the-loop for AI coding (v0.6.1)#27

Merged
youcefzemmar merged 1 commit into
veltiq:mainfrom
youcefzemmar:docs/positioning-0.6.1
May 31, 2026
Merged

docs: reposition as the human-in-the-loop for AI coding (v0.6.1)#27
youcefzemmar merged 1 commit into
veltiq:mainfrom
youcefzemmar:docs/positioning-0.6.1

Conversation

@youcefzemmar
Copy link
Copy Markdown
Collaborator

Sharpens how groundtruth is described everywhere — README, npm + GitHub descriptions, plugin manifest — to lead with what it is, not just what it catches.

The story: left unsupervised, an AI agent confidently reports work it didn't do, misses requirements, and leaves typos/half-edits — and the faster it codes, the more slips through. groundtruth is the human-in-the-loop, automated:

  1. Verifies the claims against the real diff (deterministic, zero LLM calls).
  2. Makes the agent prove it works (opt-in verify loop) — run / screenshot / test against the original request, hunt for its own mistakes, fix-and-recheck until it holds up.

→ higher-quality output you don't have to babysit.

Changes

  • README hero + intro rewritten; leads with npx @veltiq/groundtruth setup.
  • package.json + .claude-plugin/plugin.json descriptions refreshed; +keywords (self-healing, code-review, playwright).
  • GitHub repo description + topics updated to match (already live).
  • Docs/metadata only — no behavior change. 141 tests pass, typecheck + biome clean.

Ships as 0.6.1 so the new description + README reach the npm page.

🤖 Generated with Claude Code

Lead with what groundtruth is, not just what it catches: the automated
human-in-the-loop for AI coding. It verifies an agent's claims against the
real diff AND (opt-in) makes the agent run/screenshot/test its own work and
self-fix before finishing — catching the lies, typos, and skipped work that
slip through when an AI codes unsupervised.

- README hero + intro rewritten around the human-reviewer framing and the
  two-stage value (verify claims → prove it works); leads with `setup`.
- package.json + .claude-plugin/plugin.json descriptions refreshed; new
  keywords (self-healing, code-review, playwright). GitHub repo description
  and topics updated to match.
- Docs/metadata only — no behavior change. 141 tests pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@youcefzemmar youcefzemmar merged commit 3a2f6fb 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