pacto-move

name	pacto-move
description	Agent contract for the Pacto move workflow.

Pacto Move Skill

Use this skill as an agent contract for the move workflow in Pacto projects.

Objective

Move a plan slice between canonical states.

When To Use

Use for explicit state transitions such as to-implement -> current or current -> done.

Input Contract

Required Inputs

• <from-state> in current|to-implement|done|outdated.
• <slug> matching [a-z0-9][a-z0-9-]*.
• <to-state> in current|to-implement|done|outdated.

Optional Inputs

• --root <path> to target a specific project root.
• --reason <text> to append transition context in plan README.
• --force to overwrite destination when it already exists.

Execution Contract

• Tool target: Cursor Agent and Codex (project skills under .agents/skills/)
• Recommended command: pacto move [--root ] [--reason ] [--force]

Output Contract

• Moves plan directory from source state folder to destination state folder.
• Updates moved plan README Status line.

Validation Checklist

• Confirm source plan exists before moving.
• Confirm destination does not exist unless force overwrite is intended.
• Confirm pacto status reflects the new state location.

Failure Modes and Handling

• Invalid state values or invalid slug format.
• Source plan missing or destination conflict without --force.
• Filesystem move/write failure during transition.

Implementation Status

• Status: Implemented
• Fallback: If transition fails, run pacto status --root <path> to verify current filesystem state before retrying.