Operations and Governance
Description
Section titled “Description”An agentic development system becomes real only when it can be operated, inspected, and governed after day 1. The challenge is not merely generating code, but running a persistent delivery system that exposes state, supports migration, and gives operators enough leverage to intervene without destroying auditability.
Day 2 Operations
Section titled “Day 2 Operations”Operators should be able to ask the running system what it is doing right now.
- Which agents are active, blocked, idle, or waiting on review?
- Which issues or plans are currently assigned to each agent?
- Which environments, branches, and repositories are being touched?
- Which tests, deployments, or migrations are in progress?
- Which runs are consuming unusual time or budget?
Those queries need to work across fleets rather than only within a single session transcript.
Large Structural Change and Migration
Section titled “Large Structural Change and Migration”Agentic delivery is most valuable when handling change that exceeds one developer’s immediate context, but that same scale makes safety more important.
- Structural refactors should be testable in slices instead of one irreversible cutover.
- Existing manual or legacy systems should be migrated gradually with parallel run periods and rollback paths.
- Domain boundaries from DDD help decide where independent migrations can happen safely.
- TDD helps convert broad change into executable safety rails that agents and humans can both trust.
Operator Access
Section titled “Operator Access”Humans sometimes need direct runtime access, especially during incidents or ambiguous failures. That may include SSH access to a running agent, browsing workspace files, replaying a failed tool call, or adding missing context to get the system unstuck.
This access should be governed rather than hidden. It is better to support operator intervention explicitly and log it than to force ad hoc side channels outside the system of record.
Governance and Observability
Section titled “Governance and Observability”Governance requires a control plane that centralizes evidence.
- Centralized logging for prompts, tool calls, decisions, and outcomes.
- Tracing across issue intake, planning, execution, review, and deployment.
- AI gateway enforcement for model policy, rate limits, and provider abstraction.
- Virtual keys or delegated credentials instead of distributing raw long-lived secrets.
- Approval boundaries for high-risk repositories, environments, or change classes.
The objective is not surveillance for its own sake. It is the ability to explain behavior, enforce policy, and improve the system using real operational data.
Related Concepts
Section titled “Related Concepts”- Software Development - Parent concept for the full workflow.
- Execution and Feedback - Cloud execution becomes manageable only with operational visibility.
- End-to-End Orchestration - Control flow that governance mechanisms need to observe.
- Agentic Swarm - System-level context for fleet operations and policy.