completion-promise

Enforce verifiable session completion via CLI stop gates and per-criterion evidence.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/bjornslib/cobuilder-harness --skill completion-promise
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: completion-promise
Source: https://github.com/bjornslib/cobuilder-harness/tree/main/.claude/skills/completion-promise
Command: npx skills add https://github.com/bjornslib/cobuilder-harness --skill completion-promise

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined, file-based mechanism to ensure that sessions end only when user goals are demonstrably achieved by tracking a Completion Promise and per-goal acceptance criteria.

Core Features & Use Cases

  • Create and manage a structured completion promise with acceptance criteria tied to goals, epics, and features.
  • Attach and verify evidence for each criterion, supporting iterative progress across multiple PRD references and session iterations.
  • Stop gates and orchestration integrate with a CLI workflow (cs-status, cs-promise, cs-verify) to enforce completion before ending a session.

Quick Start

Initialize a session, extract goals, create a structured completion promise with acceptance criteria, and start adding epics and features to drive verifiable progress.

Frequently Asked Questions about completion-promise

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

FAQPage Schema
How do I verify session completion against acceptance criteria in a CLI workflow?

You verify session completion by enforcing a verifiable Completion Promise through a CLI workflow using cs-status, cs-promise, and cs-verify commands to validate per-criterion acceptance criteria before stopping a session.

What is a completion promise and how does it track goals across multiple sessions?

A completion promise is a file-based session state mechanism that tracks user goals, epics, and features by attaching verifiable evidence to each acceptance criterion, enabling iterative progress validation across multiple session iterations and PRD references.

How do I set up stop gates to prevent ending a session before goals are met?

Stop gates are configured by creating a structured completion promise with acceptance criteria tied to your goals, then using the cs-verify CLI command to enforce completion validation, ensuring session stoppage only occurs when all criteria are demonstrably achieved.

Can I track epics and features with per-criterion validation using file-based session state?

Yes, file-based session state supports per-criterion validation by allowing you to extract goals, create a structured completion promise, and attach evidence to individual epics and features for iterative progress tracking.

What's the best way to manage evidence-based verification for software engineering goals?

Evidence-based verification is managed through a CLI workflow that records progress against acceptance criteria, requiring per-criterion validation and a file-based completion promise to ensure goals are demonstrably achieved before session stoppage.

Do I need any external dependencies to run completion promise verification?

No external dependencies are required. Completion promise verification operates using a file-based session state and a CLI workflow with cs-status, cs-promise, and cs-verify commands to manage and validate acceptance criteria independently.