State

📍 State: Updating Project State...

Maintain a living document of where you are right now in a project.

Activation

When this skill activates, output:

📍 State: Updating project state...

Then execute the protocol below.

Context Guard

Protocol

Reading State (session start or "where was I")

1. Check for STATE.md in the current project's .claude/ directory:

   Copy code
   {project_dir}/.claude/STATE.md
   

2. If found, read it and present a brief summary:
   • What was being worked on
   • Any blockers
   • The immediate next step
3. If not found, say: "No STATE.md exists yet. I can create one after we start working."

Writing/Updating State

1. Gather current state:

   • What task/phase is actively being worked on right now
   • Decisions made during this session (with rationale)
   • Open blockers or unanswered questions
   • Explicit next steps (not vague, specific enough to resume cold)
   • Key files modified recently

2. Check git status for uncommitted work:

   bashCopy code
   git status --short
   

3. Write STATE.md to the project's .claude/ directory:

   markdownCopy code
   # Project State
   *Last updated: {YYYY-MM-DD HH:MM}*
   
   ## Currently Working On
   {Active task or phase: be specific}
   
   ## Decisions Made
   - {Decision}: {Rationale}
   
   ## Blockers
   - [ ] {Blocker description}
   
   ## Next Steps
   1. {Immediate next action, specific enough to start cold}
   2. {Following action}
   
   ## Recently Modified Files
   - {file path}: {what changed}
   
   ## Uncommitted Changes
   {List any unstaged/uncommitted work, or "None: clean working tree"}
   

4. Confirm with a brief summary of what was saved.

Deconfliction

State is the present tense complement to Diary's past tense. State tells you where to resume; Diary tells you what happened.

Inputs

• Current working context (project, files, git status)
• User's description of current state (or auto-detected from session)

Outputs

• {project_dir}/.claude/STATE.md: updated living document
• Brief confirmation summary

Example Usage

User: "update state"

Copy code
📍 State: Updating project state...

Saved: C:\Projects\AdminStack\.claude\STATE.md

Currently: Building CC Monitor notification system
Blockers: None
Next: Wire up WebSocket events to notification dropdown

This will auto-load next session for seamless pickup.

Level History

• Lv.1: Base: Living STATE.md creation and update protocol. Read via Work Step 0 or manual invocation. Deconfliction with Diary/Project/Work. (Origin: MemStack v3.1, Feb 2026)