start

name	start
description	Start Session

Start Session

Initialize your AI development session and begin working on tasks.

If the upcoming work is intended for delivery, plan the changelog draft early. Do not leave draft creation to the very end.

Initialization

Step 1: Understand Workflow

cat .trellis/workflow.md
cat .trellis/spec/index.md
cat .trellis/spec/terminology.md
cat .trellis/spec/backend/index.md

If the work is likely to ship, also read:

cat .trellis/spec/backend/ship-delivery-gate.md

Step 2: Get Current Context

python3 ./.trellis/scripts/get_context.py
python3 ./.trellis/scripts/task.py list
git status

Step 3: Report and Ask

Report:

• developer identity
• current branch
• uncommitted state
• active tasks
• whether the work appears to be heading to ship / merge delivery

If the user already knows this work is heading to ship / merge delivery, remind them that a changelog draft will be required before ship.

Working Rule

• Read spec before changing implementation
• If work changes contracts, update spec before ship
• Use $finish-work before $ship
• Create changelog draft before $ship
• Use $record-session after tested and committed work