just-demand-execution

Executes formal work items through main-agent implementation or gated subagent dispatch with script-owned state.

Updated May 21, 2026
One-click install
npx skills add https://github.com/Sighthesia/just-demand --skill just-demand-execution-sighthesia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: just-demand-execution
Source: https://github.com/Sighthesia/just-demand/tree/main/.opencode/skills/just-demand-execution
Command: npx skills add https://github.com/Sighthesia/just-demand --skill just-demand-execution-sighthesia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents role drift, hidden state, and ad hoc subagent handoffs during coding work by enforcing a structured execution lifecycle where scripts own workflow state and every dispatch passes explicit eligibility gates. ## Core Features & Use Cases - Gated Subagent Dispatch: Applies six eligibility gates and three net-benefit questions before delegating to tester, advisor, or compatibility researcher/coder roles, keeping uncertain work in the main session. - Script-Owned State Management: Routes all lifecycle transitions through CLI commands like mark, select-task, update-audit, and complete-verification so progress survives sessions. - Checkpoint Commit Policy: Creates conventional commits after every clean verification via complete-verification or checkpoint-commit, with a script-owned safety gate that stages only task-scoped changes. - Use Case: A developer finishes clarifying a bug fix task, marks it executing, dispatches a tester subagent after implementation, and closes the task with an automatic checkpoint commit and archive. ## Quick Start Ask the agent to execute the currently active formal task and verify the result before committing.

Frequently Asked Questions about just-demand-execution

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

FAQPage Schema
How do I execute a formal task in the Just Demand workflow?▼

Run `just-demand . list-active` to confirm the task, select it with `select-task` or `resume` if needed, verify required context files exist, then mark it executing before implementing. Completion flows through `complete-verification`, which records verification, creates a checkpoint commit, and archives the task.

When should I dispatch a subagent instead of executing in the main session?▼

Dispatch only when all six eligibility gates pass (goal stability, boundary independence, context compressibility, result verifiability, capability match, failure recoverability) plus three net-benefit questions. Any uncertainty means the main agent executes, even for multi-file work.

What is the difference between just-demand-tester and just-demand-advisor?▼

The tester validates results against the task brief, checks visible effects, and applies low-risk local fixes. The advisor provides fresh-context diagnosis and independent recommendations for repeated failures or cross-boundary problems without doing large-scale implementation.

Can I use just-demand-researcher or just-demand-coder for new tasks?▼

No. These are compatibility-only roles dispatched only when a legacy task already records the role or the user explicitly requests it. New tasks use the main agent plus tester and advisor subagents.

What happens if a subagent is unavailable or dispatch fails?▼

The agent tells the user the subagent path is unavailable and asks whether to retry now or skip one turn, preferably via the question tool. It never silently falls back to a different plan; retrying the same session is usually the right first move.

Why does execution stop before implementation starts?▼

Execution halts when clarification gates fail: unresolved blocking questions, missing scope or expected behavior fields, or absent task context files like context.md and verify.md. The workflow routes back to clarification rather than guessing user intent.