home/writing/system-prompts-11

System Prompts

GPTClaudeGemini··▲ 444 copies·updated 2026-07-14

system-prompts-11.prompt

# ADR-005: System Prompt Administration via `__system__` Project

**Status:** Accepted  
**Date:** 2026-04-26  
**Authors:** Spectrayan Team

---

## Context

Promptly's AI features (security scanner, prompt improver) use LLM system prompts to define their behavior. Initially, these prompts were hardcoded in Java adapter classes. This created two problems:

1. **Admins cannot customize AI behavior** without code changes and redeployment
2. **Prompt content is not versioned** — no audit trail of changes to critical AI instructions

We needed a mechanism for administrators to view, edit, version, and reset system prompts without introducing new API endpoints or controller infrastructure.

## Decision

Introduce a **well-known project** named `__system__` in the Prompt Registry. System prompts are stored as regular `Prompt` entities within this project, fully leveraging the existing versioning, RBAC, and audit infrastructure.

### Architecture

when to use it

Community prompt sourced from the open-source GitHub repo spectrayan/promptly (Apache-2.0). A "System 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.