Migrate Prompts

GPTClaudeGemini··▲ 1,193 copies·updated 2026-07-14

migrate-prompts.prompt

# Migrating Prompts

AIA includes a migration tool for converting prompt files from the legacy prompt_manager v0.5.8 format to the v1.0.0 format. This guide covers the migration process, what changes, and how to handle files that need manual attention.

## Why Migrate?

The prompt_manager gem moved from a two-file format (`.txt` + `.json`) with `[PLACEHOLDER]` syntax to a single `.md` file with YAML front matter and ERB parameters. The new format provides:

- **Self-contained prompts** — metadata, parameters, and body in one file
- **Standard ERB** — `<%= param %>` instead of custom `[PARAM]` syntax
- **YAML front matter** — structured configuration instead of `/` directives
- **Markdown body** — native rendering support in editors and documentation tools

## Format Comparison

### Old Format (v0.5.8)

Two files per prompt:

**`my_prompt.md`**

when to use it

Community prompt sourced from the open-source GitHub repo MadBomber/aia (MIT). A "Migrate Prompts" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.