Actofy documentation

How it works

Eight stages from your prompt to a pull request with evidence.

Every feature run follows the same spine. You stay in the loop at Checkpoints; Actofy handles execution and evidence collection.

  1. 01

    1 · You describe the work

    Assign a ticket or write natural language in the Workbench composer. Actofy routes intent to the right agent mode.

  2. 02

    2 · Control plane accepts the run

    Your desktop app talks to the local control server on your machine — policy, persistence, and routing live here, not in a remote black box.

  3. 03

    3 · Planner drafts a Blueprint

    Actofy reads repo context, maps architecture, and produces an execution plan. You approve before implementation starts.

  4. 04

    4 · Agents execute in a sandbox

    File edits, shell commands, and tests run inside an isolated Docker workspace. Your main environment stays clean.

  5. 05

    5 · Validators fan out

    Separate agents run tests, lint, and review logic. Results merge into one evidence bundle.

  6. 06

    6 · Checkpoints gate risk

    Destructive commands, merges, and deploys pause until you explicitly approve or reject.

  7. 07

    7 · Delivery

    Actofy opens a pull request with a full audit trail — diffs, terminal output, validator reports.

  8. 08

    8 · Recovery

    If something goes wrong, roll back via git revert, discard the run, or demote a feature flag — always through the same audited control plane.