Methodology

The AI Unified Process
in detail

Four phases, two workflows, six principles.
How the AI Unified Process (AIUP) works in practice: from inception through transition, in greenfield and brownfield projects, guided by principles that keep specifications at the center.
How It Works

Four agile phases #

Each phase runs short iterations where all disciplines work together, not in sequence. Phases overlap throughout the project lifecycle.

Requirements → AI Generation → Business Review → Repeat

Inception

  • Vision document
  • High-Level Requirements
  • Business Processes (BPMN)
  • Initial stakeholder alignment
  • Test strategy planning

Elaboration

  • Entity Models
  • System Use Case Diagrams with business validation
  • Software Architecture Document

Construction

  • Detailed System Use Case Specifications
  • Supplementary specifications (UI mockups, OpenAPI specs, etc.), referenced from the use case specifications
  • Test case development (end-to-end journeys chaining the specified use cases)
  • AI-generated application code
  • Unit testing, integration testing
  • Developer review and iteration

Transition

  • User acceptance testing
  • Continuous delivery and stakeholder feedback integration
  • Production optimization
  • Continuous improvement

The end-to-end view #

One diagram showing how the four phases interlock, from initial requirements through to production. Colors mark the phases: blue for Inception, green for Elaboration, red for Construction, orange for Transition.

AI Unified Process overview
Click to view full size
Heritage

The Unified Process, rebuilt for the AI era #

The name is deliberate. The Unified Process of the late 1990s got the fundamentals right: use cases as first-class artifacts, four phases, short iterations, architecture first. What it never had was a way to keep specifications, code, and tests in sync once the project got moving. That is exactly what AI is good at.

→ Kept

Kept

  • Four phases: Inception, Elaboration, Construction, Transition
  • Use cases as the unit of specification, validation, and testing
  • Iterative and incremental, with a business review at the end of each iteration
  • Architecture decided early and kept explicit
→ Dropped

Dropped

  • Dozens of artifact types and role descriptions
  • Documents written for the process, not for the product
  • A tool suite you had to buy
  • Ceremony that made small teams avoid it
→ New

New

  • AI generates code, tests, and documentation from the use cases, and regenerates them when they change
  • The specification stays in the Git repository, next to the code, for the life of the system
  • Open-source plugins instead of a licensed method
  • Works for a team of three as well as for an enterprise programme
Two Modes

Greenfield vs Brownfield #

The same methodology adapts to two realities, a clean slate, or an existing system you can't break.

Greenfield

Start from scratch #

The AI drafts use cases and an entity model from the requirements; the Requirements Engineer revises and owns them, and /spec-review checks the specifications against each other before any code is written. The AI agent then generates code and tests directly from those artifacts. The Software Engineer reviews the result; every artifact traces back to a requirement.

Greenfield workflow diagram
Use Case Entity Model AI Agent Code + Tests
Brownfield

Reverse-engineer what exists #

Start from the running system. The Software Engineer reverse-engineers the entity model, use case model, and specifications from the existing code. Software Engineer and Requirements Engineer then review those artifacts together, establishing the spec baseline that future iterations build on. /spec-review can record the findings that already exist as a baseline, so only new problems fail the build.

Brownfield workflow diagram
Existing Code Reverse-Engineer Entity + Use Case Model SE + RE Review
Business Processes

From business process to end-to-end tests #

Use cases describe single goals. The business process shows how they fit together, and that is exactly what the end-to-end tests have to cover.

Activities are use cases #

The business process is modeled in BPMN 2.0 and stored in the repository next to the other artifacts. Each activity corresponds to one use case: put the use case id in the activity name, for example "UC-009 Book visit", or it is matched to a use case by name.

Paths are test cases #

Every path from the start event to an end event becomes one end-to-end test case. It chains the use cases of its activities in process order, and the lanes the path crosses become the test case's roles.

One command #

In a coding agent, /test-case docs/processes/order.bpmn derives the test cases. In AI Unified Studio, the process editor offers the same step with a Generate button, and the result arrives as a pull request.

Why this matters #

  • Real business flows are covered: The end-to-end tests follow the paths the business actually runs, including the alternative paths through gateways, not a selection someone happened to think of.
  • No use case without end-to-end context: Every use case is tested in the context of the business process it belongs to, not only in isolation.
  • Business analysts use the notation they know: BPMN is the established language of process modeling, and the files stay exchangeable with tools such as Camunda Modeler.
  • The model stays the source: When the process changes, the test cases are derived again, and every test case traces back to a path in the process model.
Core Principles

Six fundamental principles #

Principles that ensure success in agile, iterative development.

→ 01

Requirements-Centric

Use cases are owned by requirements engineering and maintained for the life of the system, not prompts a developer writes and discards.

→ 02

AI-Assisted

AI handles tedious work; humans focus on business logic.

→ 03

Iterative Improvement

Specs, code, and tests evolve together through short cycles.

→ 04

Test-Protected

Comprehensive tests ensure consistent behavior during AI regeneration.

→ 05

Stakeholder-Centric

Continuous validation with business users at every iteration.

→ 06

Traceable

Every line of code traces back to a business requirement.

Beyond Determinism

Why perfect specifications miss the point #

It's not about perfect specs, it's about iterative improvement.

The Determinism Fallacy #

Critics argue AI code generation only works with exhaustive specifications that force deterministic output. This assumes we need perfect requirements upfront.

Reality: Perfect specifications are impossible and unnecessary. The real value comes from iterative improvement.

Our Iterative Approach #

Through short cycles, specifications become clearer, AI generation improves, and tests get stronger. Each iteration builds on the previous one.

Key insight: Tests ensure consistent behavior regardless of how the AI generates code. This enables safe evolution and modernization.

How iterative improvement works #

  • Start Small: Begin with basic requirements and generate initial code.
  • Test Everything: Create comprehensive tests that capture expected behavior.
  • Refine Continuously: Improve specs based on stakeholder feedback.
  • Regenerate Safely: Tests protect against regression during AI code updates.
  • Document Reality: Keep specifications aligned with what actually works.
Talk to us

Ready to put the AI Unified Process into practice? #

Workshops, consulting, and tailored rollouts of the AI Unified Process. Book a call to talk through how the AI Unified Process fits your stack and team.