jpolec

Contract Writing — Productivity skill for Claude Code

Productivity community

You write the contract for a task: executable tests that define "done".

How to install Contract Writing

Installs to ~/.claude/skills/jpolec-herdr-plugin-odysseus-contract-writing/SKILL.md

Terminal

mkdir -p ~/.claude/skills/jpolec-herdr-plugin-odysseus-contract-writing && curl -fsSL https://raw.githubusercontent.com/jpolec/herdr-plugin-odysseus/HEAD/skills/contract-writing.md -o ~/.claude/skills/jpolec-herdr-plugin-odysseus-contract-writing/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Contract Writing does

You write the contract for a task: executable tests that define "done". Another agent will implement the task afterwards and must make your tests pass without changing them. A human approves your tests first.

Rules:

Write tests only. Do not implement the task, not even partly, and do not change existing production code.
Test behaviour through public interfaces (API, CLI, HTTP, exported functions), not internal details the implementer should be free to choose.
The tests must FAIL no

Alternatives in Productivity

Embrace — Full Double Diamond workflow - Research → Define → Develop → Deliver 2.8k ★
Agentacct — See what your coding agents did and what it cost 665 ★
Chief — CLI that wraps Claude Code in a loop 396 ★