bubbles-claim-grounding

Validates factual claims against session-verified sources before asserting or editing code.

1|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/pkirsanov/bubbles --skill bubbles-claim-grounding-pkirsanov
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bubbles-claim-grounding
Source: https://github.com/pkirsanov/bubbles/tree/main/skills/bubbles-claim-grounding
Command: npx skills add https://github.com/pkirsanov/bubbles --skill bubbles-claim-grounding-pkirsanov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents routinely assert facts about files, APIs, gates, and test results they never actually verified, causing phantom references and fabricated claims to propagate through a codebase. This Skill enforces a discipline where every factual assertion must trace to a source actually read, executed, or retrieved in the current session. ## Core Features & Use Cases - Closed source list: Only repository artifacts opened this session, captured command output, retrieved external research, or explicit operator statements count as admissible evidence. - Phantom reference prevention: Blocks citing gate IDs, scripts, modules, or paths that were never confirmed to exist, with mechanical checks via Gate G132 and gate-id-grep.sh. - Structured Assumption records: When verification is impossible, the Skill mandates a labeled Assumption block stating the premise, why it is unverified, blast radius, and what would confirm or refute it. - Use Case: Before editing a function or reporting that a test suite passes, run the six-point self-check to confirm every claim names its file, command, or source from this session. ## Quick Start Before making any claim about the codebase, apply the claim grounding self-check and cite the exact file, command output, or source you verified in this session.

Frequently Asked Questions about bubbles-claim-grounding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify claims before editing code with an AI agent?▼

Read the exact file region in the current session before editing it, and name the path and symbol behind every claim you write. If you cannot name the source, either verify it, downgrade it to a labeled Assumption, or remove the claim.

What counts as a valid source for a factual claim?▼

Four sources are admissible: a repository artifact opened this session, captured output from a real command run, external research retrieved this session, or an explicit operator statement. Training recall, name-based inference, and prior sessions do not count.

How do I handle a premise I cannot verify?▼

Record it as a labeled Assumption block stating the premise, why verification was blocked, the blast radius if false, and the concrete check that would settle it. An Assumption cannot satisfy a Definition-of-Done item or support a completion claim.

Can I cite a gate ID or script path from memory?▼

No. Citing a gate ID, script, module, or path you did not confirm exists is a phantom reference and is mechanically checked by Gate G132 and the gate-id-grep.sh script. Always verify existence before citing.

Why is a correct guess still treated as a violation?▼

A correct guess and an incorrect guess are the same violation because neither is repeatable or reviewable. The standard requires traceability to a session source, not accuracy of the outcome.