Reference workflow

SMALL is designed to make agent work resumable and verifiable. This workflow is the default.

This workflow is defined in detail in How to Use SMALL.

Workflow

  1. Initialize SMALL artifacts

    • Create .small/ and commit it.
  2. Define intent and constraints

    • Intent is the why.
    • Constraints are the hard rules.
  3. Generate a plan

    • Plans are disposable and allowed to change.
  4. Execute work

    • Make changes in the repo normally.
  5. Append progress with evidence

    • Commit hashes, commands run, screenshots, links, test output.
  6. Generate a handoff

    • Deterministic summary for another agent to resume.
  7. Verify

    • small validate and small lint must pass.

Rules of the road

  • Progress is append-only.
  • Handoff is the only resume entrypoint.
  • If it is not evidenced, it did not happen.