swe-wm-update

/swe-wm-update

Single source of truth for WM updates. Uses swe-wm MCP tools for targeted section updates — never overwrites daemon-managed fields.

Every WF_* transition MUST use this skill instead of manual updates.

---

⚠️ CRITICAL: Use MCP Tools, NOT write_memory

NEVER use write_memory or edit_memory to update WM files. These overwrite the entire file and risk clobbering daemon-managed fields.

ALWAYS use swe-wm MCP tools:

Tool	Purpose
swe_wm_read	Read WM state + content
swe_wm_update_section	Update a specific section (agent-owned only)
swe_wm_update_status	Update **[STATUS]**: tag

Daemon-managed fields (updated automatically by Python hooks — DO NOT touch):

• **Current State**: — updated on WF_* reads
• **Previous State**: — updated automatically
• ### Transitions — appended automatically
• **Edit Count Since Checkpoint**: — incremented on file edits
• **Last Updated**: — timestamped automatically

---

Step 1: Read Current WM

mcp__swe-wm__swe_wm_read(session_id="{session_id}")

Note the current state and section contents for your update decisions.

---

Step 2: Gather Data Using Step-Specific Checklist

Find the checklist matching your --from argument below. Complete ALL items.

WF_START

• Feature(s) identified from INDEX_FEATURES
• Task description captured
• Update Current Task section with task + context
• Update Feature(s) section
• Update Progress with initial items

WF_CLASSIFY

• Features identified from INDEX_FEATURES
• FEATURE_[KEY] loaded for each feature
• Supporting memories loaded (DOM_, SYS_, REF_, ARCH_, INDEX_*)
• Requirements validated against domain memories (or "none detected")
• Task type classified (simple / medium / large / operational)
• Update Affected Features with Primary / Secondary
• Update Files with key file paths from feature memories
• Update Progress with classification and feature loading steps completed

WF_RESEARCH

• Research findings summarized
• Symbols / patterns discovered noted
• Update Files with files examined
• Update Progress with research outcomes
• Update Notes with findings

WF_CONTINUE

• Previous state verified from WM
• Resume point identified
• Progress carried forward from previous session
• Update Files with files from previous work

WF_ARCH_REVIEW

• Design documented with explicit file paths
• Update Files with files to modify/create
• Layer compliance verified (pass / fail per criterion)
• Swarm assessment completed (needed / not needed)
• User approval status noted
• Update Progress with review results
• Update Notes with design decisions

WF_SWARM_ORCHESTRATE

• Swarm configuration documented
• Agent assignments noted
• Topology selected
• Update Progress with orchestration steps
• Update Notes with swarm config

WF_EXECUTE

• Current subtask status
• Update Files with files modified / created with descriptions
• Tests written / run status
• Blockers noted (if any)
• Update Progress with implementation steps

WF_CHECKPOINT

• All work since last checkpoint summarized
• Update Files with files modified with change descriptions
• Current phase / subtask status
• Update Progress comprehensively

WF_VERIFY

• CLAUDE_OBLIGATIONS compliance verified
• Architecture compliance verified
• Test coverage verified
• All progress items marked complete or noted
• Update Files — complete list of every file touched in session
• Update status to VERIFY_COMPLETE or COMPLETED

WF_DONE

• Update status to COMPLETED
• Update Context with summary of all work done
• Update Notes with memories updated during session
• Follow-up items documented (if any)
• All Progress items checked off

WF_CLARIFY

• Clarification question and user response noted
• Task description updated if scope changed
• Update Progress with clarification outcome

---

Step 3: Write Updates Using MCP Tools

Use targeted section updates. One call per section that changed.

# Update task status
mcp__swe-wm__swe_wm_update_status(session_id="{session_id}", status="IN_PROGRESS")

# Update specific sections (replace mode)
mcp__swe-wm__swe_wm_update_section(
  session_id="{session_id}",
  section="Progress",
  content="- [x] Step 1 done\n- [ ] Step 2 pending"
)

# Append to a section (e.g., adding a new file entry)
mcp__swe-wm__swe_wm_update_section(
  session_id="{session_id}",
  section="Notes",
  content="- New finding: ...",
  append=true
)

Agent-owned sections (safe to update):

Current Task, Progress, Files, Notes, Requirements, Implementation Notes, Previous Task, Task Context, Affected Features, Context, Feature(s)

Protected sections (tool will reject these):

Workflow Context, Transitions

---

Step 4: Validate

After writing, optionally re-read to confirm:

mcp__swe-wm__swe_wm_read(session_id="{session_id}")

Verify:

• Session ID is correct
• Feature Key(s) is NOT empty or "(to be determined)"
• Task description is NOT empty
• Progress has actual items
• Files lists actual files (if any were touched)
• Status reflects reality

---

Step 5: Confirm & Resume

Output: 📋 Updated Working Memory: WM_{session_id}

⚠️ CRITICAL: DO NOT STOP HERE. This skill is a utility — you MUST continue.

---

Exit

IMMEDIATELY resume the workflow step you were on before invoking this skill. This is a utility skill — no state change occurs. Your calling step's instructions told you to invoke /swe-wm-update as a sub-step, NOT as a stopping point.

After outputting the confirmation line above:

1. Do NOT wait for user input
2. Do NOT end your response
3. Continue with the next action from the calling WF step_*

If you were invoked from a WF_* step's "MANDATORY NEXT STEP" table, proceed to the transition listed there. If you were invoked mid-step, continue where you left off in that step's instructions.