[!] Prerequisite: This command should only be used AFTER the human has tested and committed the code.

AI must NOT execute git commit - only read history (git log , git status , git diff ).

Record Work Progress (Simplified - Only 2 Steps)

Step 1: Get Context

python3 ./.trellis/scripts/get_context.py

Step 2: One-Click Add Session

Method 1: Simple parameters

python3 ./.trellis/scripts/add_session.py
--title "Session Title"
--commit "hash1,hash2"
--summary "Brief summary of what was done"

Method 2: Pass detailed content via stdin

cat << 'EOF' | python3 ./.trellis/scripts/add_session.py --title "Title" --commit "hash"

Updated Files:

• packages/api/modules/auth/router.ts
• apps/web/modules/auth/components/login-form.tsx EOF

Auto-completes:

• [OK] Appends session to journal-N.md

• [OK] Auto-detects line count, creates new file if >2000 lines

• [OK] Updates index.md (Total Sessions +1, Last Active, line stats, history)

Archive Completed Task (if any)

Archive tasks whose work is actually done — judge by work status, not the status field in task.json:

• Code committed? → Archive it (don't wait for PR)

• All acceptance criteria met? → Archive it

• Don't skip archiving just because status still says planning or in_progress

python3 ./.trellis/scripts/task.py archive <task-name>

Script Command Reference

Command Purpose

python3 ./.trellis/scripts/get_context.py

Get all context info

python3 ./.trellis/scripts/add_session.py --title "..." --commit "..."

One-click add session (recommended)

python3 ./.trellis/scripts/task.py create "<title>" [--slug <name>]

Create new task directory

python3 ./.trellis/scripts/task.py archive <name>

Archive completed task

python3 ./.trellis/scripts/task.py list

List active tasks