Skills

Skill Intent Contract

Use when starting a complex or ambiguous task that risks scope drift

Install

npx skills add nyldn/claude-octopus --skill skill-intent-contract -g -a claude-code -y
Repository
nyldn/claude-octopus4.4k
Category
Engineering
Updated
3d ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Use when starting a complex or ambiguous task that risks scope drift

Intent Contract System

Purpose

The intent contract creates a persistent record of user intent that:

  • Captures what the user is trying to accomplish
  • Defines success criteria upfront
  • Establishes boundaries and constraints
  • Travels through the entire workflow
  • Validates final outputs against original intent

This closes the loop between intention and delivery.


Intent Contract Structure

The intent contract is stored in the current resolved plan run directory as session-intent.md. Use scripts/plan-storage.sh to create or recover that directory; never write a loose intent file into .claude/.

# Intent Contract

**Created**: [ISO timestamp]
**Workflow**: [discover/embrace/review/etc.]
**Status**: [active/validating/completed]

## Job Statement
What the user is trying to accomplish (JTBD framework).

[User's goal in plain language]

## Success Criteria

### Good Enough
- [Minimum viable success criterion 1]
- [Minimum viable success criterion 2]

### Exceptional
- [Excellence criterion 1]
- [Excellence criterion 2]

## Boundaries
What this should NOT be:
- [Boundary 1: What to avoid]
- [Boundary 2: What's out of scope]

## Context & Constraints

**Stakeholders**: [Who needs this to work for them]
**Existing Assets**: [What to build on]
**Timeline**: [Time constraints if any]
**Technical Constraints**: [Platform, language, dependencies]

## Clarifying Context
[Any answers from the 3-question pattern]
Read the whole SKILL.md on GitHub

More in Engineering