Agents, workflows and remote work#
PacketCode can delegate bounded subtasks, run multi-step workflows and place work on registered SSH computers.
Before you start#
- The primary project is a clean Git checkout or its changes are intentionally preserved.
- Tasks have nonoverlapping ownership.
- Background limits and permission policy are configured.
- Remote hosts have verified SSH keys and absolute project paths.
Background agents#
Delegate a concrete, bounded task and choose read-only or write authority. Write-enabled agents can use isolated Git worktrees. PacketCode does not merge or delete those worktrees for you; inspect their branches before cleanup.
Workflows#
Workflows describe ordered or parallel steps in TOML. Use read-only verification steps where possible, cap retries, and avoid parallel steps that own the same files. Treat a verifier's verdict as evidence, not as an automatic merge decision.
Packet Computers#
Register the SSH host, pin its host key and set an absolute remote root. Test the connection before assigning an agent. Remote commands run with the remote account's authority.
Verify#
- Inspect every agent or workflow result.
- Run
git worktree listand review each produced branch. - Run project tests in the worktree that contains the change.
- Integrate approved commits through the normal Git process.
- Remove worktrees only after useful commits are reachable from a preserved branch or remote.
If it does not work#
| Symptom | Check | Recovery |
|---|---|---|
| A background agent is stuck | Which stage it is waiting on | See A background agent or workflow is stuck |
| A workflow never starts | Whether its trigger fired at all | A workflow that did not start has no logs to read; check the trigger first |
| Remote work fails | Reachability before anything else | See Remote work fails |
| Delegated work exceeded its bounds | The delegation's permission profile | Delegation inherits bounds; if it exceeded them, record it before re-running |