ADR / FEATURE / CHANGE
Durable trails for agent work.
Backtrail turns planning, architecture decisions, and implementation work into visible records. Less hidden context. More reversible execution.
Plan before mutation
Record intent, trade-offs, and rollback
Keep implementation tied to durable decisions
change 42 reversible
STATUS READY
Agent modifies system only after intent is named.
Guardrail
Risk zones stay explicit: auth, money, migrations, distributed state.
Trail
Decisions connect to changes instead of living as orphan notes.
backtrail create improve_agent_handoff
backtrail implement change 42
plan accepted - edits scoped - verification required - rollback noted
workflow
Slow down where mistakes cost.
01
Ground truth
Read repo, docs, and prior decisions before proposing work.
02
Choose path
State trade-offs, constraints, and rollback before mutation.
03
Ship change
Implement against accepted record, then verify actual behavior.
record types
Three records, one trail.
ADR
Architecture
Capture system decisions before they disappear into chat history.
FEATURE
Product
Shape user-facing work into scoped, reviewable plans.
CHANGE
Execution
Turn approved intent into tracked implementation steps.