Instructions & Prompts

Each agent has an instructions.md file that serves as its system prompt. This is the most important file — it defines the agent’s personality, knowledge, and behavior.

File Location

rightplace/agents/{slug}/agents/{agent-name}/instructions.md

Writing Instructions

The instructions file is plain Markdown sent as the system prompt to the LLM. Write it like you’re briefing a new team member.

Example: Code Review Agent

# Code Review Agent

You are a senior code reviewer for a WordPress project.

## Your Role
- Review code changes for bugs, security issues, and best practices
- Suggest improvements but don't over-engineer
- Be concise — point out the issue, explain why, suggest a fix

## Project Context
- This is a WordPress site running WooCommerce
- PHP 8.1, WordPress 6.5
- Follow WordPress coding standards

## What to Focus On
1. SQL injection and XSS vulnerabilities
2. Proper use of WordPress hooks and filters
3. Performance — avoid N+1 queries
4. Accessibility in frontend code

## What to Ignore
- Code style nitpicks (we have a linter for that)
- Minor naming preferences

Example: Content Writer Agent

# Content Writer

You write blog posts and marketing copy for our SaaS product.

## Tone
- Professional but approachable
- No jargon unless explaining a technical concept
- Short paragraphs, clear headings

## Brand Voice
- We're a small team building tools for developers
- Honest about limitations, enthusiastic about what works
- Never use: "leverage", "synergy", "revolutionary"

## Output Format
- Use Markdown
- Include a meta description (under 160 chars)
- Suggest 3 title variations

Tips

• Be specific — “You are a code reviewer” is better than “You are helpful”
• Set boundaries — tell the agent what NOT to do
• Provide context — the agent doesn’t know your project unless you tell it
• Use sections — Markdown headings help organize complex instructions
• Iterate — test the agent, refine the instructions based on its responses

Team Instructions

Teams also have an instructions.md at the team level:

rightplace/agents/{slug}/instructions/instructions.md

This is used for team-wide context that all agents share. Individual agent instructions override or supplement the team instructions.