/gaia-val-save

user-facing
Category:
Validation
Lifecycle phase:
4 -- Implementation

What it does

/gaia-val-save persists the current validation session's decisions and findings to the validator's memory sidecar. It writes to two files: the decision log (append-only chronological record) and the conversation context (replaced with the latest session summary). This ensures validation decisions are remembered across sessions.

When to use it

  • After a validation run, you want to save specific decisions or findings for future reference.
  • You are closing a validation session and want to persist what was discussed.

Prerequisites

  • Session findings must be in context. The command works with the findings from the current or most recent validation session.

How to invoke

/gaia-val-save

What it does step by step

  1. Load session context Reads the current validation findings from context and checks the existing state of the memory sidecar files.
  2. Format session data Formats decision-log entries using the standardized header format, and prepares a conversation-context snapshot summarizing the session.
  3. User confirmation Presents both formatted outputs for review. You choose to approve, edit, or discard.
  4. Write to memory files On approval, appends entries to decision-log.md and replaces the body of conversation-context.md.
  5. Verify writes Reads back the files to confirm the writes succeeded.

Inputs

InputSourceDescription
Session findingsCurrent contextThe validation findings and decisions from the active session.

Outputs

OutputLocationDescription
Decision log entries_memory/validator-sidecar/decision-log.mdNew entries appended to the chronological log.
Conversation context_memory/validator-sidecar/conversation-context.mdSession summary replacing the previous context.

Example session

> /gaia-val-save

Formatting session data...

Decision-log entry:
  ### [2026-05-07] Architecture validation
  - Agent: validator
  - Type: validation
  - Status: active
  3 findings verified, 1 dismissed.

Conversation-context snapshot:
  Validated architecture.md. 3 claims verified, 1 dismissed (outdated count).

[a] Approve and save  [e] Edit  [d] Discard
> a

2 decision(s) logged, conversation context updated.

What to run next

  • Continue with your next task. The validation memory is now persisted.

Troubleshooting

No session findings to save

There are no findings in the current context to persist. Run a validation first.

Write failed

The memory sidecar directory could not be written to. Check file permissions.