kept-promises

Audit owner instructions against git history to verify what actually landed.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/timikalo7/Execute --skill kept-promises-timikalo7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kept-promises
Source: https://github.com/timikalo7/Execute/tree/main/.claude/skills/kept-promises
Command: npx skills add https://github.com/timikalo7/Execute --skill kept-promises-timikalo7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When an AI agent claims it implemented everything you asked for, there is no way to verify that claim without manually digging through git history. This Skill produces a count, not a promise: it reads the transcript of every instruction you gave and checks git for evidence that work actually landed afterward, flagging anything that was dropped, thinly done, or claimed with a commit sha that does not exist. ## Core Features & Use Cases - Instruction extraction: Parses Claude Code session transcripts and classifies owner turns as instructions versus questions, acknowledgements, navigation, or pasted exercises. - Four verdicts per instruction: KEPT (a later commit matches strongly), WEAK (something matches thinly and needs human eyes), NO TRACE (nothing in history matches), and PHANTOM (a commit sha was quoted in a reply but does not resolve in git). - Sha-linking over keyword guessing: Commit shas quoted in assistant replies are verified directly with git cat-file, so a fabricated commit reference becomes the loudest possible finding. - Use Case: At a project milestone, run the full audit to get a count of kept, weak, and untraced instructions across all session transcripts, then review the WEAK and NO TRACE lists before trusting any completion claim. ## Quick Start Ask the agent to run the kept-promises audit across all transcripts and show which of my past instructions have no trace in git.

Frequently Asked Questions about kept-promises

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

FAQPage Schema
How do I verify an AI agent actually implemented what I asked?

Run the ledger script with node ledger.mjs --all to audit every instruction from your session transcripts against git history. Each instruction gets a KEPT, WEAK, NO TRACE, or PHANTOM verdict based on commits that landed after it was given.

How do I detect a fake commit sha quoted by an AI assistant?

The audit extracts every sha-shaped token from assistant replies and resolves each one with git cat-file -e. A quoted sha that does not resolve is reported as a PHANTOM verdict, which is never folded into a softer category.

What does a NO TRACE verdict mean in the audit?

NO TRACE means no commit after the instruction matched its keywords. It is a review list, not an accusation: instructions answered in chat need no commit, and commits using different wording are missed by keyword matching.

Why does the audit print how many commits were searched?

An earlier parser bug saw only one commit and reported 25 false NO TRACE verdicts. Printing the evidence size lets you doubt the number when it does not match the repository's actual history.

What are the limitations of keyword-based commit matching?

Keyword matching misses synonyms and can credit a commit that merely mentions the right noun. The instruction classifier is regex-based and can mis-file turns, so the WEAK list should always be read by a human.