# Progress Reading Protocol

Run the fixed 6-step session-opening sequence, pwd, read progress, git log, count...

- Repository: https://github.com/Archive228/loopkit (756 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-07-14
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Archive228/loopkit --skill progress-reading-protocol -g -a claude-code -y`
Codex: `npx skills add Archive228/loopkit --skill progress-reading-protocol -g -a codex -y`
Cursor: `npx skills add Archive228/loopkit --skill progress-reading-protocol -g -a cursor -y`
Gemini CLI: `npx skills add Archive228/loopkit --skill progress-reading-protocol -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Archive228/loopkit`

## Description

Run the fixed 6-step session-opening sequence, pwd, read progress, git log, count remaining features, init.sh, smoke-test last feature, before touching any new work. The orientation ritual that lets fresh-context sessions reconstruct project state in under a minute.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Progress-Reading Protocol

You have no memory of the previous session. The repo does. Every fresh session burns 5-10 minutes reconstructing state unless you follow a fixed opening sequence, with the sequence, it drops to 30-60 seconds. The cost is 2-4k tokens at the top of every session; the payoff crosses over past four sessions on the same project.

Skipping steps is the failure mode. Sessions that skip the smoke-test step (6) reliably build new features on top of silently broken ones. See the "looks shipped, isn't shipped" bug (originally documented in the shift-work harness pattern).

## When to apply

- First tool calls of any coding-agent session in a multi-session project.
- After a context reset, compaction, or crash mid-project, treat the resumed context as a fresh session.
- Before you write a single line of new code. No exceptions for "quick fixes."

## Procedure, run in order, no skipping

The rest: https://github.com/Archive228/loopkit/blob/HEAD/skills/progress-reading-protocol/SKILL.md