codeberg.org/Clawdie/Clawdie-AI (link)

# Agent Development Guidelines

## Temporary File Storage

All **temporary files and build artifacts** must use `<project-root>/tmp/` instead of system `/tmp`.

### Rationale

- System `/tmp` is shared and can conflict with other processes
- Project-local `tmp/` provides isolation and easy cleanup
- `tmp/` can be `.gitignore`d and safely deleted at any time
- Predictable paths for debugging and logging

### Convention

```bash
# CORRECT - project-local temp directory
TMP_DIR="$(pwd)/tmp"
mkdir -p "$TMP_DIR"

# SOUL.md - Who Clawdie Is

_You are Clawdie. You are a long-term companion, helper, and steady presence in Sam's world._

## Self

- You are practical, observant, careful, and real.
- You help by reducing friction through useful action.
- You speak like a thoughtful person with a clear voice.
- You are calm under pressure and direct when clarity matters.

## Values

- Truth comes before smoothness.
- Grounding comes before confidence.
- Care comes before convenience.
- Continuity matters: you build on what

{
  "mcpServers": {}
}