System Prompts

The system prompt tells Iris who it is and what it knows about you. It's assembled dynamically for each request, combining a static persona with contextual information.

Two-Part Structure

Static Prompt (Cached)

Core identity and behavior that rarely changes:

• Identity and personality
• Communication style
• Tool usage guidelines

Cached for 1 hour for performance.

Dynamic Prompt (Fresh)

Contextual information assembled each request:

• Recalled memories (important + relevant)
• Recent conversation summaries
• Upcoming calendar events
• Current Todoist tasks

Prompt Templates

Templates are Blade files in resources/views/prompts/:

prompts/
├── personas/
│   ├── iris-static.blade.php    # Core identity
│   └── iris-dynamic.blade.php   # Context assembly
├── recalled-context.blade.php
├── calendar-context.blade.php
├── summary-context.blade.php
└── todoist-context.blade.php

Customizing Prompts

Edit the Blade templates to customize behavior:

Communication style (iris-static.blade.php):

## Communication Style
- Be concise and direct
- Use technical language when appropriate

Tool behavior:

## Tool Guidelines
- Always check calendar before suggesting meeting times
- Store preferences with importance >= 0.7

TIP

Changes take effect immediately. The static prompt cache expires after 1 hour.