Prompt & Tooling Versioning
Source: content/manual/03-ai-agents/chapters/04-prompt-and-tooling-versioning.md
Purpose and scope
Treat prompts and agent tools like code with reviews and tests.
Outcomes
- Traceability from output to prompt/tool version.
- Easier rollbacks of behavior changes.
- Better evaluation over time.
Signals of trouble
- Ad-hoc prompt edits in the UI.
- No history for behavior changes.
- Evaluation results not linked to versions.
Remediation steps
- Store prompts and tools in Git; require PRs and reviews.
- Tag versions with evaluations and changelogs.
- Use templates for structured outputs.
Checklists and assets
playbooks/build-your-own-dev-agent/checklist.mdversioning steps.
References
.agents/prompt repository; output templates undertemplates/.