Building agentic systems with method, governance, and clarity.

The ADLC manifesto defines common principles for designing governed, tool-agnostic agentic systems driven by an explicit lifecycle.

A design pact for solid agentic systems

Purpose

Define common principles for building agents and agentic systems in a consistent and scalable way.

Guardrail

The lifecycle works only when requirements pass a clear and shared quality gate.

Focus

Reuse, orchestration, tool independence, and governed change.

SDLC Extension

ADLC is designed as an extension of the SDLC. It preserves the discipline of the software lifecycle while expanding it to cover the specific needs of agentic systems, including governance, orchestration, human-in-the-loop control, and continuous operational improvement.

Positioning

We affirm that agentic delivery must be governed end to end. Security, runtime monitoring, and operational control are necessary, but they are not sufficient on their own. ADLC begins with requirements quality and extends through orchestration, human checkpoints, traceability, and continuous operational improvement.

Three simple rules to guide every decision

01

Start from validated requirements

Every initiative starts from requirements that are verified, understandable, and mature enough to reduce ambiguity and rework.

02

Ensure reuse and orchestration

Components, agents, and capabilities should be designed to be reused, connected, and orchestrated over time.

03

Remain independent from tools

Tools help, but they should not dictate the architecture: process and governance come before the tool.

Requirements Quality Gate

Before implementation, the customer must have a dedicated requirements quality gate agent. It is fundamental for entering the ADLC because it helps write requirements as clearly as possible, so they become complete, coherent, traceable, and ready for execution.

Human presence is required here to confirm scope, intent, business meaning, and approval before the lifecycle can start.

From requirements to operations, in a continuous cycle

0

Requirements Quality Gate

Entry into the ADLC starts only when a dedicated quality gate agent has helped the customer shape requirements that are validated, traceable, and clear enough to guide implementation, testing, governance, and delivery without ambiguity.

Human in the loop: mandatory approval of requirements quality and intent.

1

Implement

Turn approved requirements into concrete capabilities, services, prompts, workflows, integrations, and reusable components. This is the stage where intent becomes a real solution, structured in a way that can be reviewed, tested, governed, and evolved over time without losing architectural coherence.

2

Review

Review the solution for quality, consistency, security, maintainability, and alignment with manifesto principles before advancing toward validation.

Human in the loop: expert review, risk judgment, and decision to proceed.

3

Test

Validate expected behavior, edge cases, failure modes, reliability, and operational readiness through structured test evidence and measurable acceptance criteria.

4

Deploy

Release in a controlled, observable, and repeatable way, with rollback options, release notes, ownership, and deployment evidence clearly defined.

Human in the loop: release authorization and accountability for go-live.

5

Operate

Operate the solution using monitoring, alerts, runbooks, support flows, and governance checkpoints that keep the system reliable in real conditions.

Human in the loop: incident handling, escalation, and governance oversight in production.

6

Improve

Improve continuously based on production feedback, incidents, analytics, user insight, and delivery learnings that reveal what should be refined next.

7

Orchestrate

Coordinate agents, flows, policies, and reusable capabilities in a composable ecosystem that scales beyond isolated implementations.

What each phase must produce to be governable in practice

Entry Conditions

Validated requirements, explicit business intent, named ownership, and a passed quality gate before any build activity starts.

Evidence Model

Each phase must leave traceable outputs: decisions, test evidence, approvals, release notes, operational signals, and improvement actions.

Stage Primary Output Human Checkpoint Evidence or Governance Need
0. Requirements Quality Gate Clarified requirements, acceptance criteria, business intent, traceability links Explicit approval that requirements are clear enough to enter the ADLC Requirements must be complete, coherent, and ready for execution
1. Implement Services, prompts, agents, workflows, integrations, reusable components Not mandatory as a formal gate in this phase Architecture remains reviewable, testable, and ready for controlled evolution
2. Review Review evidence, risk assessment, design corrections, readiness decision Accountable judgment on quality, security, and fitness to proceed Quality and risk must be evaluated before moving forward
3. Test Test evidence, acceptance validation, reliability checks, known issues Optional depending on context, but escalation remains available Behavior must be measured, not assumed, before deployment
4. Deploy Release notes, deployment evidence, rollback plan, ownership, go-live record Formal release authorization and responsibility for production entry Deployment must be controlled, repeatable, and auditable
5. Operate Monitoring signals, incidents, runbooks, operational decisions, governance logs Production oversight, escalation handling, and accountable intervention Live operations must remain observable and governable
6. Improve Improvement backlog, lessons learned, policy updates, refinement priorities Not a mandatory gate, but accountable prioritization is expected Live evidence must feed the next iteration instead of remaining isolated
7. Orchestrate Shared flows, coordination rules, reusable capabilities, policy alignment Human oversight depends on scope and impact of orchestration changes Orchestration must scale the system coherently across teams and iterations

How the lifecycle behaves as a governed infinite loop

In practice, ADLC is not a one-way pipeline. Teams enter through a requirements quality gate, move through delivery, and then loop back through operations, improvement, and orchestration to refine the next iteration.

  • Requirements enter only after a dedicated quality gate and human approval.
  • Implementation, review, and test transform intent into a governed solution.
  • Deploy and operate create live evidence, not just release output.
  • Improve and orchestrate feed the next cycle with learning, reuse, and coordination.
Human in the loop checkpoint

Controls that are mandatory to enter and govern the ADLC

Governance

Human in the Loop

Human oversight is a mandatory control layer in the ADLC, especially when approving requirements, validating quality, authorizing releases, and governing production behavior.

Agents accelerate and structure the work, but accountable human decisions remain explicit at the critical checkpoints.

Entry Control

Requirements Quality Gate

The ADLC cannot start without a quality gate that ensures requirements are clear, complete, traceable, and meaningful from a business perspective.

This gate is fundamental because it determines whether implementation should begin at all.

Reusable capabilities that support the full ADLC

Knowledge Base

Documentation Agent

Creates and updates documentation directly in the official doc base, such as Confluence and similar platforms.

Owns ADRs, runbooks, onboarding pages, architecture notes, FAQs, and process documentation tied to real delivery events.

Delivery Flow

PR Governance Agent

Supports pull requests end-to-end by summarizing changes, checking policy, highlighting risk, and proposing reviewers.

Helps keep reviews consistent, traceable, and aligned with shared engineering guardrails.

Communication

Release Notes Agent

Generates release notes from merged work, grouping features, fixes, breaking changes, migrations, and operational notes.

Produces both technical and business-friendly summaries for internal and external communication.

Alignment

Knowledge Sync Agent

Detects gaps between code, tickets, releases, and documentation, then proposes or performs the missing updates.

Keeps the delivery reality and the knowledge base aligned over time.

Governance

Compliance and Traceability Agent

Links requirements, implementations, tests, documentation, and releases into an auditable chain of evidence.

Supports quality gates, reviews, and governance checkpoints across the lifecycle.

Operations

Operational Readiness Agent

Checks that each release is backed by runbooks, ownership, rollback guidance, alerts, and operational readiness evidence.

Helps teams move from deployment to stable operation with fewer blind spots.

  • Tool-agnostic lifecycle
  • Continuous improvement
  • Governed execution

A framework that is simple to explain, readable even for people outside the technical detail, yet structured enough to guide delivery and governance.