First Agent Workflow

Jumpspace works best when the human approves intent in docs, then the agent executes against that approved source.

1. Find The Task

npx jumpspace find "approval flow" --json --compact
npx jumpspace context DOC-EXAMPLE-001 --json

Use compact results for cheap orientation, then pull full context for the task you actually plan to work on.

2. Review Or Save A Plan

Review the current plan:

npx jumpspace plan review DOC-EXAMPLE-001 --json
npx jumpspace plan show DOC-EXAMPLE-001

Save an approved plan:

npx jumpspace plan save DOC-EXAMPLE-001 --file plan.yml --json
npx jumpspace plan validate DOC-EXAMPLE-001 --json

A useful plan step has:

• a stable step ID
• an observable outcome
• dependencies
• linked source files
• linked tests
• executable checks
• evidence after completion

3. Ask For The Next Step

npx jumpspace next DOC-EXAMPLE-001 --json

next returns pending steps whose dependencies are complete. It does not return blocked steps.

4. Start Work From A Packet

npx jumpspace work DOC-EXAMPLE-001 --json

Use work when you want the full agent start packet. It gates on task approval, dependency state, audit health, and plan validity.

5. Complete A Step

After the implementation step is done, record evidence:

npx jumpspace step complete DOC-EXAMPLE-001 design --evidence "Human approved the UI states."

Step completion is not a substitute for verification. It records progress in the durable plan.

6. Verify The Task

npx jumpspace verify DOC-EXAMPLE-001 --check "npm test" --criteria AC-1 --evidence "Focused test suite passed." --json

verify runs the checks itself, records exit codes, commit SHA, timestamp, criteria coverage, and evidence, and only sets verified when the checks pass and criteria IDs exist.

7. Hand Off

npx jumpspace handoff --task DOC-EXAMPLE-001 --json

The handoff packet gives the next agent or human a concise state summary, recent mutations, health signals, and next useful commands.