Documentation

Reference

Directory layout and file conventions.

Directory Structure

~/assistant/                          # Agent root (git repo)
├── agent.yaml                        # Agent manifest
├── SOUL.md                           # Agent identity
├── RULES.md                          # Behavior rules (optional)
├── DUTIES.md                         # Responsibilities (optional)
├── .env                              # API keys (gitignored)
├── .gitignore
│
├── workspace/                        # Output directory
│
├── memory/                           # Persistent memory
│   ├── MEMORY.md                     # Main memory
│   ├── mood.md                       # Mood tracking
│   ├── photos/                       # Captured moments
│   │   └── INDEX.md
│   ├── journal/                      # Session reflections
│   └── archive/                      # Archived entries
│
├── skills/                           # Installed skills
│   └── skill-name/
│       └── SKILL.md
│
├── workflows/                        # SkillFlows
│   └── pipeline.yaml
│
├── schedules/                        # Cron jobs
│   └── daily-standup.yaml
│
├── hooks/                            # Lifecycle hooks
│   ├── hooks.yaml
│   └── validate.sh
│
├── tools/                            # Custom declarative tools
│   └── my-tool.yaml
│
├── plugins/                          # Installed plugins
│   └── plugin-id/
│       └── plugin.yaml
│
├── config/                           # Environment configs
│   ├── default.yaml
│   └── production.yaml
│
├── knowledge/                        # Knowledge base
│   └── domain.md
│
├── compliance/                       # Compliance config
│   ├── regulatory-map.yaml
│   └── validation-schedule.yaml
│
└── .gitagent/                        # Internal state (gitignored)
    ├── state.json
    ├── audit.jsonl
    └── learning/
        ├── tasks.json
        └── skills.json