Guide
Backlog
The backlog carries items forward between generations — deferred tasks, genome changes, and environment changes. It lives in .reap/life/backlog/.
Item Types
| Type | Description | When Applied |
|---|---|---|
| task | Deferred work, tech debt, feature ideas | Referenced as goal candidates in next generation |
| genome-change | Genome modifications discovered mid-generation | Applied to Genome during Completion adapt phase |
| environment-change | External environment changes discovered mid-generation | Applied to Environment during Completion reflect phase |
Status
| Status | Meaning |
|---|---|
| pending | Not yet processed (default) |
| consumed | Processed in a generation (requires consumedBy: gen-XXX-{hash}) |
Archiving Rules
At archiving time, consumed items move to lineage. Pending items are carried forward to the next generation's backlog.
Task Deferral
Partial completion is normal — tasks depending on Genome changes are marked [deferred] and handed to the next generation.
Abort Backlog
When a generation is aborted via /reap.abort, the goal and progress can be saved to backlog with abort metadata (abortedFrom, abortReason, stage, sourceAction, changedFiles). This preserves context for resuming later.
File Format
yaml
---
type: task
status: pending
priority: medium
---
# Task Title
Description of the task.