23. File naming conventions
[!ref] Full details in the User Manual, "Workspaces".
| Category | Pattern | Description |
|---|---|---|
| Session file | <sid>.jsonl |
sid is 8 random chars; first 4 chars are the short id |
| Plan snapshot | <sid>.plan.json |
Sibling of the jsonl |
| Todo snapshot | <sid>.todos.json |
|
| Workspace configs | agents.yaml tools.yaml channels.yaml etc. |
Per-feature standalone files |
| Skill | <skill-name>/SKILL.md |
Skill root directory; lowercase hyphenated recommended |
| Persona | <persona-id>.yaml |
Slashes encoded as __ in paths |
| Logs | avlcode-YYYYMMDD.log |
Daily rotation |