Author or refine agent instructions: $ARGUMENTS

Before Starting

Search OpenAI docs for prompt engineering guidance:
- Use mcp__openai-docs__search_openai_docs with query "system instructions best practices" for latest recommendations
- Use mcp__openai-docs__search_openai_docs with query "agent instructions" for agents-specific patterns
Read the existing instruction architecture to understand the composable pattern:
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/ai-lab/instructions/core.ts — identity + voice markers + failure modes
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/ai-lab/instructions/themes.ts — theme-specific layers (metanoia, movemental, mdna)
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/ai-lab/instructions/modes.ts — pedagogical modes (teacher, coach, reflection, mentor, companion)
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/ai-lab/instructions/styles.ts — interaction styles (conversation, challenge, socratic, evaluative, explainer)
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/ai-lab/instructions/context.ts — dynamic user context per run
Read the writing assistant instruction pattern:
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/writing-assistant/instructions.ts — buildWritingAssistantPrompt() with pluggable content sources
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/writing-assistant/instructions/identity.ts — voice identity template
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/writing-assistant/instructions/content-forms.ts — content form templates
- {{PROJECT_ROOT}}/{{AGENTS_DIR}}/writing-assistant/instructions/examples.ts — voice calibration examples

write-instructions