chapter eleven

11 Prompt Management

 

This chapter covers

  • Diagnosing where your team sits on the prompt management maturity journey and identifying the next practical step
  • Moving prompts through a structured lifecycle: draft, test, approve, deploy, observe, improve, and retire
  • Designing lightweight governance for a shared prompt library: ownership, access, and approval without unnecessary friction
  • Reading the signals a well-run management process naturally produces to decide which prompts need attention next
  • Recognizing the ten most common prompt management failures and applying a targeted fix to each

In Chapter 5, you built prompt templates, reusable blueprints that separate stable instructions from variable inputs, making prompts easier to maintain and share. In Chapter 10, you learned that a well-crafted, precisely constrained prompt is a harder target for adversarial manipulation. Both chapters shared an underlying principle: prompts are artifacts worth designing carefully, not just strings to write once and forget. Chapter 11 follows that principle to its practical conclusion. A prompt engineered well is still fragile if it has no owner, no version history, and no process for changing it safely. This chapter is about what happens after the prompt is written.

11.1 Why Prompt Management Matters

11.1.1 The six pillars of prompt management

11.1.2 Build vs. buy

11.1.3 Practical Example 1: The Support Bot Audit

11.2 The Maturity Journey

11.2.1 Stage 1 - Inline Prompts

11.2.2 Practical Example: The Weekend Hack That Shipped

11.2.3 Stage 2 - Config Files and Version Control

11.2.4 Practical Example: The Product Manager Problem

11.2.5 Stage 3 - Prompt Store

11.2.6 Practical Example: The Stale Prompt Discovery

11.2.7 Stage 4 - Dedicated Prompt Management System

11.2.8 Practical Example: The Promotion Without an Approval Record

11.3 The Prompt Lifecycle

11.3.1 Draft

11.3.2 Practical Example: The Under-Specified Draft

11.3.3 Test

11.3.4 Practical Example: The Invisible Regression

11.3.5 Approve

11.3.6 Deploy

11.3.7 Observe

11.3.8 Improve

11.3.9 Retire

11.4 Governance and Collaboration

11.4.1 RBAC patterns

11.4.2 Approval flow patterns

11.4.3 Practical Example: The Tone Drift Incident

11.4.4 Audit trail and rollback

11.4.5 Inline collaboration

11.5 Using Management Signals to Guide Improvement