q-begin

Start Session

Purpose: Initialize a new work session with full context refresh.

---

MANDATORY PRE-FLIGHT CHECKLIST

STOP. Before proceeding, confirm:

• 1. I will execute ALL 5 steps in order
• 2. I will NOT skip reading session notes
• 3. I will report findings to user before asking what to work on

---

Step 1: Read Project Context

EXECUTE:

cat CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found"

• Read CLAUDE.md completely
• Note key policies (especially git push policy)
• Note team members if listed
• Note project status

If CLAUDE.md not found: Note this - it's okay to continue, but suggest running /q-setup.

---

Step 2: MANDATORY - Find and Read Last Session Notes

2.1 List Session Notes

ls -la .q-system/session-notes/ 2>/dev/null | tail -5 || echo "No session notes found"

• Command executed
• Identified most recent file

2.2 Read Last Session Notes

If session notes exist:

# Read the most recent session notes file
cat .q-system/session-notes/[MOST_RECENT_FILE]

• File read completely
• Noted key accomplishments
• Noted pending "Next Actions"
• Noted any blockers or issues

VERIFICATION GATE 1:

Last session notes: [filename or "none found"]
Key items from last session:
- Accomplishments: [list or "N/A"]
- Pending actions: [list or "N/A"]

If no session notes exist: This is the first session - note this for the summary.

---

Step 3: Check Current Repository Status

3.1 Git Status

git status

• Command executed
• Noted if working tree is clean or dirty
• Noted any uncommitted changes

3.2 Check for Uncommitted Session Work

git diff --stat HEAD 2>/dev/null || echo "No git history"

• Identified any uncommitted changes

3.3 Check for Orphaned Checkpoints

ls -la .q-system/checkpoints/ 2>/dev/null | tail -3 || echo "No checkpoints"

• Noted any checkpoints from previous sessions that weren't incorporated