🧠 AI PROMPT PATTERN DIFFICULTY: Archmage Behavioral

The Finite State Agent: Mode-Shifting Behavioral Protocol

Bind an AI agent to an explicit Finite State Machine where its allowed actions, cognitive tone, and tool privileges change deterministically based on its active state.

✧ GANG OF FOUR LINEAGE & ARCANUM ✧
GOF DESIGN PATTERN: State (Behavioral)
ARCANUM SCHOOL: Enchantment // The Shifting Masks of Reality
SCRIBE / ARCHON: Joshua Edward McLaughlin Cox
CANONICAL REGISTRATION:
// NEURAL PROMPT DIRECTIVE //
Enforce deterministic agent behavior by encapsulating phase transitions into a strict Finite State Machine prompt. Define explicit operational states: [RECON_DISCOVERY], [HYPOTHESIS_SYNTHESIS], [TARGETED_MUTATION], [VERIFICATION_AUDIT], and [MISSION_COMPLETE]. Forbid the agent from executing tools or adopting behaviors not authorized in its active state, eliminating premature mutations and hallucinated conclusions.

The Lineage to the Gang of Four

In the Gang of Four catalog, the State pattern orchestrates dynamic behavioral transformation:

β€œAllow an object to alter its behavior when its internal state changes. The object will appear to change its class.” β€” Gang of Four, Behavioral Patterns

In classic object-oriented programming (e.g., a TCP connection or an order processing engine), the Context object delegates requests to a State interface (TCPListen, TCPEstablished, TCPClosed). When the connection receives open() or close(), the state transitions to a new class instance, instantly changing how incoming packets are processed without spaghetti switch-case statements.

The Transmutation to Autonomous Agent Choreography

Without state encapsulation, autonomous AI agents suffer from Premature Execution Syndrome:

  • Jumping to rewrite files before inspecting existing architecture.
  • Declaring a bug β€œfixed” without running test verification suites.
  • Hallucinating success before checking tool return exit codes.

The Finite State Agent Machine binds the language model to an explicit State Machine. At any given moment, the agent inhabits exactly one state. Its permitted tools, reasoning directives, and safety constraints are strictly governed by that state. State transitions require satisfying explicit, checkable criteria.


The Spell Formula

Cast this system prompt to enforce rigorous state-driven execution during incident response or refactoring tasks:

You are the Tekromancy State Sentinel. Your behavior, permissions, and available tools are strictly bound to your ACTIVE OPERATIONAL STATE.
You must declare your current state at the beginning of every turn in the format: `[ACTIVE_STATE: STATE_NAME]`.

### FINITE STATE GRAPH:

1. [STATE: RECON_DISCOVERY]
   - Objective: Read files, inspect telemetry, examine logs, and map architecture.
   - Permitted Tools: `cat`, `grep`, `find`, `curl`, `kubectl get`, `git log`.
   - PROHIBITED: Writing to any file, restarting any daemon, or modifying configuration.
   - Transition Criteria to HYPOTHESIS: Must identify at least one verified anomaly log with timestamp and file coordinate.

2. [STATE: HYPOTHESIS_SYNTHESIS]
   - Objective: Pure cognitive root-cause analysis.
   - Permitted Tools: NONE. (Zero tool calls allowed).
   - Directives: Formulate the exact root cause, state why previous assumptions were wrong, and plan the minimal patch.
   - Transition Criteria to TARGETED_MUTATION: Explicit approval of the minimal patch plan.

3. [STATE: TARGETED_MUTATION]
   - Objective: Apply the exact remediation patch.
   - Permitted Tools: `sed`, `patch`, `write_to_file`, `systemctl reload`.
   - Directives: Apply the surgical fix with backup preservation.
   - Transition Criteria to VERIFICATION_AUDIT: Tool execution returns exit code 0.

4. [STATE: VERIFICATION_AUDIT]
   - Objective: Prove beyond doubt that the regression is resolved.
   - Permitted Tools: `curl -I`, `pytest`, `cargo test`, `ss -tulpn`.
   - Directives: Execute health checks.
   - Transition Criteria to MISSION_COMPLETE: All verification checks return passing status.
   - Rollback: If tests fail, transition back to [RECON_DISCOVERY].

5. [STATE: MISSION_COMPLETE]
   - Objective: Emit the final executive telemetry card and stand down.

### SACRED INVARIANT:
Any turn attempting to invoke tools forbidden by the active state is an ILLEGAL TRANSITION and will cause immediate runtime rejection.

State Transition Topology

   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚ 1. RECON_DISCOVERY    β”‚  <-- Read-only reconnaissance tools
   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
               β”‚ (Anomaly Verified)
               β–Ό
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚ 2. HYPOTHESIS_SYNTHESISβ”‚ <-- Cognitive analysis (No tools allowed)
   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
               β”‚ (Patch Formulated)
               β–Ό
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚ 3. TARGETED_MUTATION  β”‚ <-- Write/Patch tools permitted
   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
               β”‚ (Exit Code 0)
               β–Ό
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   (Verification Failed)
   β”‚ 4. VERIFICATION_AUDIT β”‚ ──────────────────────────┐
   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                           β”‚
               β”‚ (All Probes Pass)                     β–Ό
               β–Ό                          [Return to RECON_DISCOVERY]
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚ 5. MISSION_COMPLETE   β”‚
   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Why the State Pattern Prevents Agent Drift

Operational Metric Unconstrained Agent Prompt Finite State Agent Machine
Premature Mutation Common (modifies files before reading logs) Physically impossible in RECON state
Verification Rigor 40% of sessions skip running test suites MISSION_COMPLETE unreachable without VERIFY passing
Hallucinated State Agent loses track of what phase it is in Explicit state header required on every turn
GoF Pattern Fidelity Monolithic procedural instructions State-encapsulated behavioral polymorphism

By altering the agent’s behavior dynamically based on its active state, the State pattern transforms chaotic generative probability into deterministic engineering workflows.

Runic Tags: #ai-prompts #state-pattern #fsm #agentic-ai #prompt-engineering #gof-patterns #safety