Documentation
Task lifecycle and product docs
Learn how Terragon handles task planning, Git checkpointing, pull requests, review states, and the active task lifecycle from first prompt through final verification.
Automated acceptance phases
Task plan
Terragon prepares a task plan before implementation begins.
Pull request
Terragon opens or updates the task pull request even if auto-create PRs are disabled.
PR checks
The lifecycle waits for GitHub checks, including the no-checks case.
Check repair
When checks fail, Terragon investigates CI, fixes the issue, retests, and updates the branch.
Final review
After checks pass or no checks are reported, Terragon reviews the final diff against the task plan.
Final testing
Terragon runs the final test and verification pass, fixes regressions, and gets the task ready to ship.
Done
Terragon records the task lifecycle as complete for the task.
Where status appears
The task header shows a lifecycle status row whenever task lifecycle tracking is on. It uses the Terragon task lifecycle when available and falls back to task and pull request signals when lifecycle data is temporarily unavailable.
The task list also shows a compact lifecycle status icon, so check failures, pull request waiting, and final review or testing stay visible before opening the task.
Operational guardrails
- Git checkpointing must be enabled.
- Terragon records the task lifecycle.
- GitHub check repair is capped to avoid infinite loops.
- Final review/testing is still run when no checks exist.
More documentation
Create tasks
Prompting, repository selection, context, and submission.
Git checkpointing
Branch, commit, and pull request behavior.
Self-hosted macOS runners
Register Macs and route tasks between cloud and local VMs.
Automated acceptance
Task planning, PR checks, repairs, review, and testing.
Common workflows
Practical Terragon flows for day-to-day engineering.