Agent skill
commitments
Extract and track builder commitments from critique exegesis. Use /commitments to audit promises made in prose, verify implementation status, and identify unfulfilled obligations.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/commitments
SKILL.md
Commitment Tracker
This skill closes the accountability gap between promises in prose and implementation in code.
Purpose
Exegesis generates concrete commitments. Without tracking, these become:
- Forgotten intentions
- Unfulfilled promises
- Accountability theater
This skill extracts commitments, links them to issues/PRs, and reports on fulfillment status.
Invocation
/commitments # Full audit of all commitments
/commitments extract # Extract new commitments from exegesis
/commitments status # Show fulfillment status
/commitments [slug] # Audit specific critique's commitments
/commitments unfulfilled # List only unfulfilled commitments
Commitment Detection
Patterns That Indicate Commitments
Look for these phrases in <div class="exegesis"> blocks:
"Adding to..." → Task commitment
"Opening issue..." → Issue commitment
"Implementing..." → Code commitment
"Refactoring..." → Code commitment
"Let me commit to..." → Explicit commitment
"Adding to the roadmap" → Roadmap commitment
"needs to change" → Implicit commitment
"I'll add..." → Task commitment
"Target: before..." → Deadline commitment
Commitment Categories
-
Code Commitments - Changes to source files
- Pattern: "refactor", "implement", "add", "change"
- Verification: Check git log for relevant commits
-
Issue Commitments - GitHub issues to create
- Pattern: "opening issue", "tracking in #"
- Verification: Check
gh issue list
-
Documentation Commitments - Docs to update
- Pattern: "document", "publish", "README"
- Verification: Check doc file changes
-
Governance Commitments - Process changes
- Pattern: "DAO", "governance", "vote"
- Verification: Check governance files
Extraction Procedure
1. Parse Exegesis Blocks
# Extract all exegesis content
grep -A 10 '<div class="exegesis">' src/posts/data.ts
2. Identify Commitment Statements
For each exegesis block, look for:
- Action verbs: "adding", "implementing", "opening", "creating"
- Future tense: "will", "going to", "need to"
- File references:
code blocks, path mentions - Issue references: #123, "issue to track"
3. Structure Commitments
{
"id": "commit-001",
"source": "the-hyphal-hierarchy/section-viii",
"statement": "Implement Gini coefficient measurement",
"category": "code",
"target": "univrs-enr or univrs-network",
"status": "unfulfilled",
"verificationMethod": "grep for 'gini' in ecosystem repos",
"linkedIssue": null,
"linkedPR": null,
"dateExtracted": "2026-01-02"
}
Verification Procedures
For Code Commitments
# Search for implementation across repos
for repo in univrs-dol univrs-vudo univrs-enr univrs-network cryptosaint.io; do
echo "=== $repo ==="
git -C ~/repos/$repo log --oneline --since="2026-01-01" --grep="[commitment keyword]"
done
For Issue Commitments
# Check if issue exists
gh issue list --repo ardeshir/[repo] --search "[commitment keyword]"
For Documentation Commitments
# Check for doc changes
git log --oneline --since="2026-01-01" -- "*.md" "docs/"
Output Format
Status Report
┌─────────────────────────────────────────────────────────────┐
│ COMMITMENT AUDIT │
├─────────────────────────────────────────────────────────────┤
│ Total commitments: 12 │
│ Fulfilled: 3 (25%) │
│ In progress: 2 (17%) │
│ Unfulfilled: 7 (58%) │
└─────────────────────────────────────────────────────────────┘
UNFULFILLED COMMITMENTS:
1. [the-hyphal-hierarchy] Implement Gini coefficient
Category: code
Target: univrs-enr
Days since commitment: 0
2. [the-brics-bridge] Add governance.rs to CryptoSaint
Category: code
Target: cryptosaint.io
Days since commitment: 0
3. [the-progress-machine] Add user metrics to MilestoneTracker
Category: code
Target: learn.univrs.io
Days since commitment: 0
Commitment Detail
┌─────────────────────────────────────────────────────────────┐
│ COMMITMENT: Implement Gini coefficient │
├─────────────────────────────────────────────────────────────┤
│ Source: the-hyphal-hierarchy / Section VIII │
│ Statement: "If I can't measure inequality, I can't claim │
│ to be reducing it." │
│ Category: code │
│ Status: UNFULFILLED │
│ Linked Issue: None │
│ Linked PR: None │
├─────────────────────────────────────────────────────────────┤
│ VERIFICATION ATTEMPTED: │
│ - Searched univrs-enr for "gini": 0 matches │
│ - Searched univrs-network for "gini": 0 matches │
│ - No issues found mentioning "gini coefficient" │
└─────────────────────────────────────────────────────────────┘
Known Commitments (Extracted Cycle 5)
From exegesis across all 4 critiques:
| # | Commitment | Source | Category | Target |
|---|---|---|---|---|
| 1 | Add user metrics to MilestoneTracker | progress-machine | code | learn.univrs.io |
| 2 | Add /status command showing role/priority | hyphal-hierarchy | code | univrs-network |
| 3 | Implement Gini coefficient measurement | hyphal-hierarchy | code | univrs-enr |
| 4 | Add governance.rs to CryptoSaint | brics-bridge | code | cryptosaint.io |
| 5 | Bioregional weight >= satellite weight | brics-bridge | code | cryptosaint.io |
| 6 | Emergency alerts to all participants | brics-bridge | code | cryptosaint.io |
| 7 | Make fee distribution DAO-controlled | brics-bridge | code | cryptosaint.io |
| 8 | Show "0/1 users" honestly in dashboard | progress-machine | code | learn.univrs.io |
| 9 | Publish model assumptions as DOL schemas | brics-bridge | docs | univrs-dol |
| 10 | Document BRICS alignment explicitly | brics-bridge | docs | cryptosaint.io |
Integration with Evolution Loop
/critique → [generates critique]
↓
/respond → [adds exegesis with commitments]
↓
/commitments extract → [identifies new commitments]
↓
/evolve → [tracks commitment fulfillment as gap metric]
↓
[Builder implements]
↓
/commitments status → [verifies fulfillment]
↓
/evolve → [updates metrics, proposes next focus]
The Accountability Question
Every commitment audit must answer:
-
Are commitments being made faster than fulfilled?
- If yes: slow down critique cycle, speed up implementation
- Commitment debt is technical debt with moral weight
-
Are unfulfilled commitments being acknowledged?
- Transparency about gaps > pretending they don't exist
- Update exegesis with "still unfulfilled" notes
-
Is this skill creating more work than value?
- If tracking commitments becomes busywork, deprecate
- The goal is accountability, not administration
Storage
Commitments are tracked in .claude-flow/metrics/commitments.json:
{
"version": "1.0.0",
"lastAudit": "2026-01-02",
"commitments": [
{
"id": "commit-001",
"source": "the-hyphal-hierarchy/viii",
"statement": "Implement Gini coefficient measurement",
"category": "code",
"status": "unfulfilled",
"dateExtracted": "2026-01-02",
"dateFulfilled": null,
"linkedPR": null
}
],
"summary": {
"total": 10,
"fulfilled": 0,
"inProgress": 0,
"unfulfilled": 10
}
}
Off-Ramp
If commitment tracking becomes:
- More overhead than value
- A source of guilt rather than action
- Performance theater rather than accountability
The builder can:
rm -rf .claude/skills/commitments/
rm .claude-flow/metrics/commitments.json
Commitments still exist in exegesis. This skill just makes them visible.
"Promises in prose without accountability in code are just words. This skill makes words heavier."
Didn't find tool you were looking for?