harness-continuity

Manages multi-session task state with one-task-at-a-time transitions and clean-state checkpoints.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-continuity-maicongambini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-continuity
Source: https://github.com/MaiconGambini/opencode-harness-guide/tree/main/skills/harness-continuity
Command: npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-continuity-maicongambini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running agent work that spans multiple sessions often loses track of which task is active, leaves stale in-progress states, or commits changes without evidence. This Skill enforces durable task continuity so work can be resumed, blocked, or handed off cleanly between sessions. ## Core Features & Use Cases - One-Task-At-A-Time Rule: Locates feature state in feature_list.json, .specs/features/*/tasks.md, or session todos and ensures only one task is in_progress at any time. - State Transition Control: Enforces the not_started → in_progress → passing/blocked lifecycle, requiring an exact blocker reason for blocked tasks. - Clean-State Checkpoint: Verifies startup commands, observable evidence, scoped git diff output, and updated progress files before commits or handoffs. - Use Case: An agent session ends mid-feature. The next session reads the state file, finds the single in_progress task with its evidence, and continues implementation without duplicating or skipping work. ## Quick Start Ask the agent to check the current task state, pick the next eligible task, and run the clean-state checkpoint before committing.

Frequently Asked Questions about harness-continuity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage task state across multiple agent sessions?

Store task state in a durable file such as feature_list.json, .specs/features/*/tasks.md, or a session todo. Each session locates the state, continues the single in_progress task or picks one eligible not_started task, and updates status with evidence before ending.

How do I hand off unfinished work between agent sessions?

Run the clean-state checkpoint before ending a session: verify the startup command passes, record observable evidence or an exact blocker reason, confirm git diff shows only relevant files, and update the progress file and handoff notes.

What should I do when a task is blocked mid-way?

Set the task status to blocked in the state file, record the exact blocker reason in the evidence or blocker field, and update the Blockers section of the progress file. Never leave two tasks in_progress at the same time.

Can multiple tasks be in progress at the same time?

No. The one-task-at-a-time rule (WIP=1) allows only a single task in the in_progress state at any moment. You must complete, pass, or block the active task before starting another one.

What files track progress for multi-session agent work?

Progress is tracked in .specs/project/STATE.md, docs/harness/progress.md, or agent-progress.md, depending on the project setup. Task-level state lives in feature_list.json or .specs/features/*/tasks.md.