# Env Persistence

> Env Persistence is an Agent Skill for development published in the fossasia/visdom repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Safely modify environment serialization, reload data, and view layout persistence. Use when changing env save/load formats or storage behavior.

- Skill name: `env-persistence`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/fossasia/visdom/blob/HEAD/.agents/skills/env-persistence/SKILL.md
- Repository: fossasia/visdom (10,264 GitHub stars when collected)

## SKILL.md

# Skill: Environment Persistence

## When to Use

Use this skill for persistence format changes and env reload/view layout behavior.

## Core Workflow

1. Map data writes/reads for `jsons` and `reload` structures.
2. Apply changes in server utility/handler paths that serialize or restore env state.
3. Keep backward compatibility with existing env JSON files.
4. Preserve view/layout behavior and environment tree organization.
5. Validate save/fork/delete and restart/reload workflows end-to-end.

## Guardrails

- Do not introduce breaking env format changes without migration handling.
- Keep env path handling sanitized and scoped.
- Preserve compare and standard env behaviors.

## Documentation

- [Skill reference](references/REFERENCE.md)
- `py/visdom/utils/server_utils.py`
- `py/visdom/server/handlers/web_handlers.py`
- `py/visdom/server/app.py`
- `AGENTS.md`
- `CONTRIBUTING.md`

## Assets

- See `assets/README.md` and store templates/resources in `assets/`.

## Tests

- Follow the default flow in `references/TESTS.md`.

---

Source: https://www.openparable.com/skill/development/env-persistence (OpenParable). Cite the canonical URL above.
