Project storage
| Path | Ownership | Purpose |
|---|---|---|
.saggar/project.json | Shared | Project name, emoji, and documentation folder |
.saggar/commands.md | Shared | Commands and startup roles |
.saggar/jobs/*.json | Shared | Scheduled jobs |
.saggar/scratchpad.md | One checkout | Working notes and handoff context |
.saggar/state.local.json | One Mac | Machine-local project state |
Commit shared files when they are useful to everyone working in the repository. Ignore checkout-local and machine-local files with:
.saggar/**/*.local.*
.saggar/scratchpad.md
User-global state lives under ~/.saggar/. Credentials and grants remain in
the login Keychain. See .gitignore and .saggar for the rationale.