bmad-code-org/bmad-method-wds-expansion/memory

WDS Memory — File Backend

Handles all persistent state for WDS sessions. Two operations: save and load.

State lives in progress/ at the project root. This folder is project-scoped — not global, not per-machine.

save

Called by: wrap (step 3), handoff (step 3)

Input:

• agent_id — the agent whose state is being saved (saga, freya, mimir)
• data — the compiled state block (Wrapped, Context, Plan, Next, Learned, Spec Sync fields)

Steps:

1. Ensure progress/ exists at the project root. Create it if not.
2. Write progress/[agent_id].md with the data block exactly as provided.
3. Return: saved progress/[agent_id].md

load

Called by: start (step 2)

Input:

• agent_id — the agent whose state is being loaded

Steps:

1. Check if progress/[agent_id].md exists.
2. If found: return the full file content.
3. If not found: return nothing. The calling tool handles the fresh-start case.

Notes

• progress/ should be in .gitignore. It is machine-local session context, not project content.
• Both save and load are synchronous file operations — no tokens, no async, no IDs.
• This is the canonical storage backend. State is local to the machine and project — not synced, not shared.