# Session State Standard

This reference defines the expected structure and format for `SESSION_STATE.md` in the `doot` project.

## Required Sections

### 1. Current Focus
- A single sentence or a few bullet points describing the primary task for the current session.
- Only one focus should be active at a time.

### 2. Recently Completed
- A list of tasks completed in the current or most recent sessions.
- Use a bulleted list with a summary of the work (e.g., "Migration 016, Store methods...").
- Include tests written and verified.

### 3. Previously Completed
- A historical list of completed tasks, grouped by milestone or theme.
- This section can be moved to a `HISTORY.md` if it grows too large.

### 4. Known Gaps
- A list of outstanding bugs, missing tests, or implementation details that need future attention.

### 5. Remaining Items (Feature Requests)
- A list of features that have been discussed but not yet implemented.
- These should often correspond to `claudomator` stories.

### 6. Next Steps
- A numbered list of the very next actions to take.
- Use this to maintain momentum across sessions.

## Claudomator Integration
Whenever a task is completed:
1. Move it from "Current Focus" to "Recently Completed".
2. Run `claudomator finish <story_id>` (if using ID-based stories).
3. Update "Next Steps" with the next `claudomator` story or sub-task.
4. If a new task is identified, run `claudomator create "Name" --instructions "Goals"`.

## Formatting
- Use standard GitHub Flavored Markdown.
- Keep the file concise; avoid deep nesting.
- Ensure the date and baseline commit are mentioned in related plans (e.g., `REFACTOR_PLAN.md`).