Projects & Sessions
Projects hold the workspace context. Sessions keep a task conversation and its artifacts connected to that context.
Projects
A project maps to a software project directory and gives CODVIAN a stable place to find files, instructions, tools, and recent work.
- Keep project instructions near the repository root
- Use one project per codebase or clearly separated workspace
- Review which folders are in scope before granting access
Sessions
A session is an interaction within a project. Start a new session for a distinct goal, and continue an existing session when the next instruction builds on the same context.
A practical rule
Use one session for a feature, bug fix, migration, or investigation. Start a new session when the goal, branch, or review context changes.
Artifacts and recents
Files created or edited during a session can be reviewed from the workspace. Use artifacts to understand what changed without reconstructing the conversation from memory.