harness-feature-state

Normalizes feature state across feature_list.json and Markdown task files with evidence rules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running agent workflows lose track of task state across sessions: features get marked passing without proof, multiple tasks run in progress at once, and blocked items lack actionable reasons. This Skill enforces a single durable source of truth for feature status so state stays auditable across sessions. ## Core Features & Use Cases - Schema enforcement: Every feature in feature_list.json must carry id, priority, area, title, user_visible_behavior, dependencies, status, verification, evidence, and notes. - Status discipline: Enforces exactly one in_progress feature (WIP=1), requires evidence citing a gate report path and metric line for passing, and requires the failing metric with value and threshold for blocked. - Markdown task support: Reads task rows and checklists in .specs/features//tasks.md, agent-os/specs//tasks.md, and per-ticket files with Status and Blocked by lines. - Use Case: Before an Execute phase, run the audit checklist to confirm all features have required fields, exactly one task is in progress, and every passing feature cites verifiable evidence. ## Quick Start Audit the current feature_list.json and Markdown task files, then report any WIP violations or passing features missing evidence.

Frequently Asked Questions about harness-feature-state

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

FAQPage Schema
How do I track feature status across agent sessions?

Store state in feature_list.json with the required schema fields including status, verification, and evidence. The Skill audits this file plus Markdown task files so state survives session handoffs and stays checkable.

What evidence is required to mark a feature as passing?

A passing status requires a non-empty evidence field citing the gate report path and the metric line for that change, such as a mutation score with its threshold. Prose like tests pass is not accepted because it cannot be verified later.

Can I have multiple features in progress at once?

No. Exactly one feature may be in_progress across both JSON and Markdown sources. Two active tasks is a WIP violation that must be resolved to WIP=1 before any Execute phase.

Does it support Markdown task files instead of JSON?

Yes. It reads task rows in .specs/features/*/tasks.md and agent-os/specs/*/tasks.md, and treats each agent-os ticket file as a task using its Status and Blocked by lines. Ambiguous formats are reported with a proposal to normalize to feature_list.json.

What makes a blocked status valid?

A blocked feature must have non-empty evidence containing the failing metric, its actual value, and its threshold. A generic note like tests failed is rejected because it gives no actionable or auditable reason.