Skip to main content

Managing Versions

The prompt repository uses date-based versioning to track which prompts your team is running and manage updates over time.

Checking Your Current Version​

The VERSION file at prompts/VERSION in your repository records the version you are currently running:

cat prompts/VERSION
version: 2026.10.07-1430
source_sha: 0559d73b9d821f8abc9da967623fe7cf2ec2eafc
context_sha: aab803f1d43c5090e86fa7cef452b6683531e04b
aegis_commit: 71093f23bfbee22378fb69c39d8c1b8473bc1216
released_at: 2026-10-07T14:30:00Z

See Overview for what each field means.

If there is no VERSION file, your repository predates the versioning system. The next prompt update PR you merge will include one.

Comparing Versions​

Since versions are date-based (YYYY.MM.DD-HHMM), comparing them is straightforward — a higher number means a newer release.

To see what changed between your current version and an incoming update, review the PR diff or compare branches directly:

git diff main..prompts/2026.10.07-1430 -- prompts/

To see what changed for one technology, limit the diff to its folder, for example -- prompts/python/django/.

Finding a Prompt​

prompts/index.json lists every prompt in your current release. To find the prompt for a technology and see which versions are available:

jq -r '.prompts | to_entries[] | select(.value.name == "Django") | "\(.key)  reviewed \(.value.last_reviewed)"' prompts/index.json
python/django/5.2  reviewed 2026-09-29
python/django/6.0  reviewed 2026-09-12
python/django/6.1  reviewed 2026-09-12

Use the version that matches what your project runs. When you upgrade a framework, switch to that version's prompt.

Rolling Back​

If a prompt update causes issues (e.g., a prompt change produces worse output for your use case), revert to the previous version:

# Revert the merge commit
git revert -m 1 <merge-commit-sha>

This creates a new commit that undoes the update while preserving your Git history. The next prompt update PR will re-include the reverted changes along with any new updates — you can review them again at that point.

Pinning a Version​

If you need to stay on a specific prompt version (e.g., for compliance or audit reasons):

  1. Do not merge new prompt PRs until you are ready to update
  2. Document the pinned version in your team's runbook
  3. When ready to update, review all accumulated changes in the latest PR before merging

Version History​

Your repository's Git log and merged PR history serve as a complete audit trail of every prompt version your team has adopted:

# View prompt update history
git log --oneline --grep="Update prompts to"

Each merged PR corresponds to a specific prompt release, making it straightforward to trace when a particular version was adopted and what changed.

Propagating Updates to Deployment Points​

When you merge a prompt update PR, your prompts/ directory is updated but your deployment points (IDE config files, CI/CD pipelines, API scripts) may still reference old prompt content. To propagate updates:

  • File-based deployments (.github/copilot-instructions.md, CLAUDE.md, .cursor/rules/) — These files typically reference or include prompt content directly. After merging an update, check whether any deployment files need to be refreshed with the updated prompt content. If the update removed a prompt you reference, index.json shows the versions that replace it.
  • API-driven deployments — If your scripts read prompts from disk at runtime (with open("prompts/...") as f), they pick up updates automatically after the merge. No action needed.
  • CI/CD pipelines — Pipelines that reference prompts by path pick up updates on the next run. Pipelines that have prompts inlined in configuration files need to be updated manually.

If you use the Team and Enterprise deployment pattern, your automation layer handles propagation.

Multi-Team Version Management​

Every release includes the full prompt set, so one prompt repository serves every team in your organization. Each team uses the prompts for its own technologies and versions, and reviews the changes to those prompts in each PR.