Escapement
Claude Code plugin for structured development workflows. Regulated workflow, one tick at a time.
What This Is
Escapement is an opinionated workflow and Claude Code plugin that provides reusable modules to streamline your development process:
- meta-workflow: A prescribed sequential process supported by the plugin modules
- Skills: Automated workflow modules (issue setup, commits, PRs, etc.)
- Hooks: Session archiving on compaction
- Agents: Specialized AI assistants (scratchpad-planner for codebase analysis)
- Multi-Project Support: Works across all your repos simultaneously
Workflow Overview
Escapement guides you from idea to merged code through a structured workflow:
- Initialize (
setup-work) - Pull GitHub issue → Generate scratchpad plan → Create feature branch
- Execute (
do-work + commit-changes) - Work through scratchpad tasks → Make atomic commits
- Review (
create-pr + review-pr) - Create pull request → Review changes → Merge
- Archive (
archive-work) - Clean up scratchpad → Preserve session history
Each phase is handled by specialized skills that activate via natural language or explicit commands.
Installation
From Source (Development)
# Clone the repository
git clone https://github.com/fusupo/escapement.git
# Run Claude Code with the plugin
claude --plugin-dir /path/to/escapement
From Marketplace (Coming Soon)
# Once published to a marketplace
/plugin install escapement
Usage
High-Level Workflow
Work proceeds through four phases:
- Initialize: establish scope and plan
- Execute: implement planned work in small steps
- Review: validate and merge changes
- Archive: preserve artifacts and session history
The phases are sequential but not strictly linear; refinement can push work backward before execution begins.
Initialize (prime-session, setup-work)
The session begins either from an idea or an existing GitHub issue.
If needed, project context is loaded by reading CLAUDE.md and related documentation.
An issue is created or fetched, then analyzed to produce a scratchpad plan.
If the issue is too large, it is decomposed into sub-issues.
If assumptions are invalid, the issue may be reworked before proceeding.
A feature branch is created once the plan is acceptable.
Operator involvement is primarily directional: clarifying intent and approving scope.
Execute (do-work, commit-changes)
Work is driven by the scratchpad.
Tasks are selected one at a time, implemented, and committed as atomic changes following project conventions.
This loop continues until the scratchpad is complete.
The operator may intervene to adjust task order, clarify intent, or pause execution, but most actions are automated.
Review (create-pr, review-pr)
A pull request is created with full context from the scratchpad and commit history.
The PR is reviewed.
If changes are requested, work resumes and new commits are added before re-review.
This cycle repeats until the changes are accepted and merged.
Operator involvement is typically focused on decision-making and judgment rather than mechanics.
Archive (archive-work, hooks)
After merge, the scratchpad is archived.
Before Claude Code compacts the session, the transcript is saved via the PreCompact hook.
This preserves planning, execution, and review context as durable artifacts.
The session is then considered complete.
Full Workflow Map
This diagram shows all phases together, with swimlanes for each skill and the operator.
It illustrates where decisions occur, which actions are automated, and how control moves between skills over the life of a session.
Skills
Skills are invoked automatically by Claude Code when relevant, or you can reference them explicitly with the /escapement: prefix:
Natural Language Invocation:
# Claude uses the skill automatically based on context
"Setup GitHub issue #42"
"Commit these changes"
"Create a PR for this branch"
Explicit Invocation:
/escapement:setup-work
/escapement:commit-changes
/escapement:create-pr
Available Skills
