Commitments

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

1. Code Commitments - Changes to source files

   • Pattern: "refactor", "implement", "add", "change"
   • Verification: Check git log for relevant commits

2. Issue Commitments - GitHub issues to create

   • Pattern: "opening issue", "tracking in #"
   • Verification: Check gh issue list

3. Documentation Commitments - Docs to update

   • Pattern: "document", "publish", "README"
   • Verification: Check doc file changes

4. 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:

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:

1. Are commitments being made faster than fulfilled?

   • If yes: slow down critique cycle, speed up implementation
   • Commitment debt is technical debt with moral weight

2. Are unfulfilled commitments being acknowledged?

   • Transparency about gaps > pretending they don't exist
   • Update exegesis with "still unfulfilled" notes

3. 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."