Blacksite/.agents/skills/blacksite-task-state/SKILL.md

1.4 KiB

name description
blacksite-task-state Maintain resumable Blacksite task state, scope deltas, verification validity, and exact next actions during multi-step implementation, user steering, reconnects, or context compaction. Use for long or multi-subsystem work; do not use for trivial one-file edits.

Blacksite task state

Read .codex/workflow.toml, then use python scripts/codex/state.py to create or update the ignored .codex/session/STATE.md.

Use this Skill for continue, resume, plan implementation, multi-crate work, material scope changes, native acceptance discoveries, reconnects, and path remapping.

  1. Verify the canonical repository path, branch, HEAD, dirty summary, and relevant live processes.
  2. Resume an existing valid state instead of rediscovering the repository.
  3. Keep the active goal, slice, acceptance target, non-goals, intentional files, decisions, evidence validity, and one exact next action current.
  4. Record steering with state.py scope-delta. Classify it as an active-slice refinement, newly discovered blocker, added acceptance criterion, or separate follow-up.
  5. State which evidence remains valid and invalidate only affected gates with verify.py invalidate.
  6. Update state after a completed slice, native checkpoint, or remote mutation.

Keep the file below the configured line limit. Never copy logs, issue bodies, large plans, or desktop dumps into it.