paydirt76

Clearstep — Productivity skill for Claude Code

Productivity community

Context-engineered, plan-driven, step-at-a-time workflow for Claude Code.

How to install Clearstep

This entry records only its repository, not the path inside it, so there is no exact command to give. Open paydirt76/clearstep and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Clearstep does

Context-engineered, plan-driven, step-at-a-time workflow for Claude Code. Mainly with skills and a slash command.

Alternatives in Productivity

Run Discovery — Workflow recipe — go from a vague opportunity to validated insight and a prioritised next step by chaining 4 s 1.3k ★
Maestro Issue — Intent-driven issue lifecycle management — describe what you want in natural language (报告一个 bug / 列出开放 issue / 530 ★
Carl — Context Augmentation & Reinforcement Layer — Domain-based behavioral rules for Claude Code, keyword-matched an 368 ★

README

Clear Step

**Context-engineered, plan-driven, step-at-a-time workflow for Claude Code.**

Four commands. Two templates. Your plan survives `/clear` because state lives on disk, not in the conversation.

If you've been burned by an autonomous AI run that changed 47 files overnight — or you keep hitting Claude Code's weekly usage caps — this is built for you.

Under the hood, this is a context engineering layer. Every step in the plan declares the files and line ranges it needs upfront. The harness loads exactly those under a 50k-token budget, runs one step, writes a `**Results:**` block, advances the `[n]` marker, then sharpens the next step's Context with what it just learned. The plan file — not the conversation — is the source of truth for what comes next. That makes adherence to the plan structural rather than willpower-based, turns `/clear` into a feature (the next `/step` re-reads the plan from disk, finds the marker, and keeps going), and lets multi-step work that would otherwise pile up 100k+ tokens of accumulated context fit in a focused 50k window per step.

Setup

Clone this repo, then let Claude Code install it -- or copy the files manually. All five files are at the repo root. Each gets renamed and placed into the right directory in your project.

git clone https://github.com/paydirt76/clearstep.git

**Easiest:** Open Claude Code in your project directory and say:

Read the README in ../clearstep (or wherever you cloned it) and install Clear Step in this project.

**Manual install:** Copy each file to its destination, creating directories as needed.

Repo file	Install to	What it is
`step.md`	`.claude/commands/step.md`	The `/step` slash command
`question-loop.md`	`.claude/skills/question-loop/SKILL.md`	Socratic exploration skill
`plan-creation.md`	`.claude/skills/plan-creation/SKILL.md`	Plan authoring skill
`plan-completion.md`	`.claude/skills/plan-completion