The approved form-service account retains every submission for 30 days, and storage cannot be disabled on the approved plan. The required account inspection found this before the form was connected.
Work with ADEL
Follow one small production-ready project from an empty workspace to a working, verified result.
Follow one person and a capable coding agent as they apply the ADEL Framework to turn an empty workspace into a complete five-page marketing website. You will see what they ask, what the agent produces, what the person reviews, and what the project keeps as the work moves from an initial idea to a verified result.
Follow a complete project, from the first conversation to an accepted website.
This page applies the ADEL Framework to one project using a coding agent—an AI tool that can inspect a project, create and change files, and run checks. Before continuing, you should be familiar with the Framework’s basic model, layers, lifecycle, responsible layers and approvers.
Read the ADEL Framework before continuing with this walkthrough.This is one practical application of the ADEL Framework, not a required process for every project. Its sequence, prompts and filenames are choices made for this example; the Framework remains the source of truth for what ADEL requires.
Follow a complete marketing website from its initial idea to a verified and accepted result.
- Scenario
- A five-page corporate marketing website for the fictional Momentum & Balance Advisory, with a working contact form.
- Participants
- One delivery person works with one coding agent; the client owns business commitments and final acceptance.
- Journey
- The project moves from intent and requirements through design and implementation. A conflict found during implementation sends each affected decision back to its responsible layer and approver before the work continues to verification and closure.
- Result
- A complete production-ready build, supported by verification evidence and accepted by the client.
Ten parts, in the order this project needed them. Not a wizard, and not a sequence every project must repeat — a smaller project would collapse several of these, and a larger one would need more than the walkthrough shows.
Each part shows what the project already knows, an action for the agent, an illustrative result, the human review or decision and the project knowledge carried forward. Open the deeper explanation when you want to see the reasoning and its ADEL mapping.
Where the project’s risk, legal, contract or audit requirements and relevant policy do not require more, the walkthrough deliberately avoids extra records, checkpoints and approvals.
From generated software to a result the project can maintain and verify.
Describing what you want and letting an agent generate working software is genuinely effective — for exploration, for prototypes, for small things you can hold in your head. This walkthrough does not argue against that. It shows what changes when the result has to be changed, maintained, explained, handed over, or trusted.
A real sequence that can produce useful software quickly.
Project qualities that make the result maintainable, explainable and verifiable.
- Clear intent
- Project knowledge recorded for future work
- Important decisions that survive
- A manageable piece of work
- Clear boundaries for the agent
- Evidence of what actually works
- A result that can be confidently closed
The left box is a sequence. The right box is not another workflow or lifecycle; it shows qualities the project gains as ADEL is applied. The agent can still perform the implementation—the project simply no longer depends on the original conversation alone.
Marketing Website for Momentum & Balance Advisory
A public website that explains the firm’s services, establishes credibility with prospective clients, and lets a visitor start a conversation. Five pages and a contact form.
Momentum & Balance Advisory
Momentum & Balance is a forty-person business advisory firm with no in-house designer or engineering team. Its name reflects its purpose: helping clients build momentum without losing operational balance. Most new work comes through referrals, but prospective clients still visit its website before deciding whether to make contact.
- What the firm does
- Advises growing, owner-led companies on business strategy, operations and organisational change.
- Who the website serves
- Business leaders evaluating whether Momentum & Balance is the right adviser for an upcoming change or growth initiative.
- Why the project exists
- The existing website describes services the firm no longer offers and does not give prospective clients a clear way to start a conversation.
- What already exists
- A logo, two brand colours and draft page content. There is no complete design system or reusable website implementation.
- Who approves client decisions
- The partners approve business commitments. One designated client partner gives final acceptance. The office manager coordinates content and receives enquiries through the shared inbox.
Momentum & Balance Advisory and everyone described in this walkthrough are fictional. Any resemblance to an actual company or person is coincidental.
This is an ADEL delivery walkthrough, not a website-building tutorial. The website is simple enough to follow, while its contact form introduces real decisions about personal data, external services, accessibility, deployment and evidence. Those decisions — and how the person and agent handle them — are the focus.
The client sets direction. You coordinate delivery. The coding agent performs most of the implementation.
In this scenario, the coding agent is the primary way the software gets written. Almost all investigation, implementation and tests come from natural-language instruction rather than someone typing the code directly. Agentic coding is the primary implementation method here, not an assistant alongside a developer who writes most of the code.
ADEL provides the structure around that arrangement: lasting project knowledge, clear rules for who may decide, review by people for important decisions and evidence before acceptance.
The reviews, approvals and stop conditions shown later are choices for this walkthrough and this setup, not additional ADEL requirements. On another project, responsibilities may be split among different people, and the same project knowledge may live in different records or systems.
Work moves toward implementation. Questions, proposed decisions, findings and evidence move back to the person who holds the relevant responsibility.
The client
What business decisions remain with the client?
- Sets the business outcome and supplies the content
- Owns commitments the firm makes to its clients
- Approves recurring costs and production deployment
- Reviews the result and gives final business acceptance
Business intent, content and commitments
Questions, options and evidence
You
What are you responsible for coordinating and deciding?
- Coordinates the work and turns client intent into bounded delivery
- Sets technical direction within the agreed intent and principles
- Reviews proposals, implementation and evidence
- Approves technical decisions within their decision authority or asks the relevant approver
Project knowledge, bounded work and the decisions the agent may make
Proposals, findings and evidence
The coding agent
What can the agent execute, and when must it stop?
- Investigates the project and proposes options
- Implements and tests the bounded work
- Makes local, reversible choices within its decision authority
- Reports findings and stops before making a decision it is not allowed to make
This small project does not assign the following responsibilities to separate specialists. That does not make those concerns optional, and ADEL does not replace specialist expertise. The delivery person and agent handle only what falls within their competence and established boundaries. If the work requires specialist judgment, they stop and seek it.
- No dedicated designerThe agent proposes layouts, you review them against the brief and accessibility expectations, and the client confirms that they fit the firm.
- No separate quality-assurance (QA) functionThe agent performs checks and produces evidence; you review that evidence and direct any additional verification.
- No platform or operations teamDeployment assumptions are established during System Design, while production deployment remains a separately approved action.
- No second engineerYou perform the proportionate technical review. A more consequential project may require independent review.
- No privacy or accessibility specialistThis example handles limited, defined concerns. Specialist input is still required if its legal, contract or audit requirements—or its risks—exceed the participants’ competence.
The point is not that one person can replace every specialist. The project makes missing expertise visible, and the work stops until a suitable specialist can advise or decide.
With more people, the same ADEL responsibilities still apply. What may change is how much project knowledge is recorded, who performs, reviews or approves the work, and where each source of truth is kept. The brief, design decisions, implementation and review may involve different people, and “ask me” becomes “ask the approver for that decision.” ADEL assigns decisions to layers rather than job titles; your organization assigns people to those responsibilities. As the team grows, coordination and handoffs matter more—a bigger prompt does not solve that.
This walkthrough uses a coding environment with an AI agent that can inspect the project, create and change files, and run checks. The ADEL responsibilities and reasoning demonstrated here do not depend on a particular editor, agent, model, language or platform; the same concerns still apply when the tools differ.
Give the agent room to deliver. Keep consequential decisions with people.
Agentic work can fail at either extreme: the agent can be given responsibility it cannot hold, or it can be denied enough freedom to be useful. This walkthrough uses the middle position.
Unattended generation
The agent controls the project
The agent decides scope, architecture, dependencies, and when the work is complete. The human is left reviewing a finished change they did not follow. Responsibility has effectively been handed to a system that cannot take it.
Bounded autonomy
The agent executes within boundaries
The agent has enough decision authority and project knowledge to finish meaningful work on its own, with clear conditions for when it must stop. People retain responsibility for intent, important decisions, risk and acceptance.
Micromanagement
The human controls every action
Permission for every file, every line, every command. The agent produces nothing you did not already specify, and the review effort exceeds the work.
In this project, the agent can design options, scaffold the application, build all five pages, implement the form, write tests and run checks. It stops when the work would change product intent, a governing commitment, an important design decision, cost or the decision to deploy.
The walkthrough follows ADEL’s delivery lifecycle. It does not create another one.
The Framework defines seven lifecycle steps. This walkthrough follows those same steps, but sometimes gives one step more than one walkthrough part so the work is easier to see in practice.
The same parts also work with ADEL’s layers and Agent execution overlay. The lifecycle-step table shows when the work happens; the view below shows which layer or Agent execution overlay is responsible for the information or decision.
Governance and agent instructions are not additional lifecycle steps. This walkthrough establishes them in parts 03 and 05, then uses them throughout the work that follows.
Read this list in walkthrough order. Each row names the ADEL layer or Agent execution overlay responsible for the main information or decision in that part. A part can involve more than one layer and the Agent execution overlay. Later parts continue to use sources of truth created earlier even when they do not change them.
Product Definition — Initial intent is established.
Product Definition — The product brief becomes the source of truth for requirements.
Governance — Principles and rules for who may decide are established.
System Design — The approved design is established.
Agent execution overlayOverlay — Agent instructions are established for later agent work.
Delivery Planning — The work is organised.
Execution — The clearly scoped work item is prepared.
Execution — The site is implemented within the agreed boundaries.
Execution — The conflict is surfaced and affected implementation stops.
Governance — The governing principle is confirmed by its approver.
System Design — The submission design is revised.
Delivery Planning — Downstream delivery plan and work item are reconciled.
Execution — Implementation resumes using the updated decisions and records.
Agent execution overlayOverlay — New stable required check commands are added to the agent instructions.
Assurance — The delivered result is evaluated and a defect is found.
Execution — The bounded implementation defect is corrected.
Assurance — The affected expectations are evaluated again against the revised build.
Assurance — Verification evidence, required acceptance and final project state are reconciled for closure.
ADEL feedback returns only as far as the decision that changed. Part 08 demonstrates that feedback during implementation because that is where this example encounters it. The same kind of return can happen elsewhere in the lifecycle; it is not an additional lifecycle step.
Framework → the delivery lifecycle↗You now have the project, responsibilities and Framework mapping needed to follow the example.
Begin with part 0101Start with the idea
You have an intention and an empty workspace.
Nothing about the project is written down. The repository is empty, and the coding agent knows only what you include in the first message. Without clarification, it may treat unconfirmed details in that message as project requirements.
Work out who this is for, what it has to achieve, what you are assuming, and what nobody has decided yet — and write down the answers.
Action
prompt · establish intent
I want to build a corporate marketing website for Momentum & Balance Advisory, a professional services firm of about forty people. It should explain what the firm does, establish credibility with prospective clients, and let a visitor start a conversation. Before any code or scaffolding, help me establish the initial intent. Ask the smallest useful set of questions whose answers would materially change the intended users, outcome, scope, important constraints, or what success means. Do not ask about implementation, technology, or architecture yet. If something is genuinely unknown, leave it open rather than inventing an answer. Stop and wait for my answers before producing the summary. After I answer, summarise back: Intended users Who this is for, and any audience explicitly excluded. Outcome What this needs to achieve for the firm. Confirmed scope What we have actually agreed is included. Proposed exclusions Anything you think should stay out of scope. Mark these as proposals for my confirmation, not decisions. Confirmed facts Important information I provided. Assumptions and inferences Anything you inferred rather than learned from me. Open questions Information that is still genuinely undecided or unknown. Initial success What observable result would indicate that this project is useful. Keep the summary concise. Stop again so I can correct or confirm the summary. After I confirm it, save the agreed version to docs/product/intent.md. Creating that note is the only workspace change to make at this stage. Do not scaffold the project, choose a stack, propose architecture, or write implementation code yet.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
Before I write anything, I need to understand the business behind the site. These are the five answers most likely to change the audience, scope, and definition of success:
- Services and niche — What does Momentum & Balance advise on, and which kinds of companies or business situations are the best fit?
- Primary audience — Who usually evaluates or buys those services? Are existing clients, prospective employees, or other visitors also important for this release?
- Credibility — What proof can the site use: partner biographies, credentials, case studies, client names, testimonials, publications, or something else? Is any of it unavailable or confidential?
- First-release scope — Which pages or capabilities do you already consider essential, and how should a visitor start a conversation?
- Success and constraints — What observable result would make the site useful, and are there any known content, brand, timing, regulatory, or approval constraints?
- Momentum & Balance advises growing, owner-led companies on business strategy, operational improvement, and organisational change. Its best-fit clients are usually established companies preparing for growth or a significant change.
- The main readers are founders, CEOs, and operations leaders evaluating the firm after a referral. Existing clients and job seekers may visit, but the first release does not need to be designed around them.
- We can publish partner biographies, credentials, service descriptions, and anonymised examples of past work. We cannot name clients or publish testimonials at this stage.
- The first release needs Home, Services, Approach, About, and Contact. A general contact form should send enquiries to the office manager through the firm’s shared inbox. No booking flow or direct partner contact details.
- The current site still describes services the firm no longer offers and gives visitors no clear next step. A useful result is that a referred prospect can quickly understand the current work and send a relevant enquiry. The partners will supply and approve the copy. We have a logo and two brand colours, but no complete design system. The site will be public with no login. There is no confirmed launch date or hosting decision yet.
- Intended users — primarily founders, CEOs, and operations leaders at growing, owner-led companies who are evaluating the firm after a referral. Existing clients and job seekers are secondary audiences, not design priorities for this release.
- Outcome — replace an unclear public presence with a credible explanation of the firm’s strategy, operations, and organisational-change work, then give a qualified prospect a simple way to enquire.
- Confirmed scope — five public pages: Home, Services, Approach, About, and Contact. One general contact form sends enquiries to the shared inbox for the office manager.
- Credibility available — partner biographies and credentials, service descriptions, and anonymised examples. Client names and testimonials cannot be published.
- Proposed exclusions — no blog or insights publishing, client portal, recruitment section, booking flow, multiple languages, content management system (CMS), or direct partner contact details. Please confirm or amend these.
- Confirmed facts — partner-supplied and partner-approved copy; an existing logo and two brand colours; public access with no login.
- Assumptions and inferences — the proposed exclusions are not confirmed until you accept them. No other inference is being treated as a project fact.
- Open questions — hosting, launch date, analytics, and any sector-specific content or compliance review are not yet decided.
- Initial success — a referred prospect can identify that the firm fits their situation, understand how it helps, and submit a relevant enquiry that reaches the shared inbox.
That is accurate. Confirm the proposed exclusions and keep the remaining questions open. Save the intent note.
Done — I created docs/product/intent.md from the confirmed summary. Hosting, launch timing, analytics, and any sector-specific review remain open. I did not scaffold the site or make technical decisions.
The confirmed intent preserved for the next part of the work.
After you confirm the summary, the coding agent saves the agreed answers in a Markdown file. Part 02 will use this file when preparing the product brief. The filename and location shown here are choices made for this example project.
# Initial project intent ## Problem The current website describes services the firm no longer offers and gives prospective clients no clear next step. ## Intended users The primary audience is founders, CEOs, and operations leaders at growing, owner-led companies who are evaluating Momentum & Balance after a referral. Existing clients and job seekers may visit but are not priorities for the first release. ## Outcome Give prospective clients a credible, current explanation of the firm’s work in business strategy, operational improvement, and organisational change, then provide a clear way to start a conversation. ## Confirmed scope - Home, Services, Approach, About, and Contact pages - One general contact form that sends enquiries to the shared inbox for the office manager - Partner biographies and credentials, service descriptions, and anonymised examples of past work - Copy supplied and approved by the partners - Visual direction based on the existing logo and two brand colours - Public access with no login ## Exclusions No blog or insights publishing, client portal, recruitment section, booking flow, multiple languages, content management system (CMS), direct partner contact details, named clients, or testimonials. ## Assumptions and inferences No unconfirmed assumption or inference is being treated as a project fact. ## Open questions Hosting, launch date, analytics, and any sector-specific content or compliance review are not yet decided. ## Initial success A referred prospect can identify that the firm fits their situation, understand how it can help, and submit a relevant enquiry that reaches the shared inbox.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Compare the agent’s summary with your answers. Does it preserve the current-site problem, the firm’s services, priority audience, usable credibility material, five-page scope and intended contact path accurately?
- Check the exclusions. Every item recorded as excluded should be something you explicitly confirmed, not a boundary the agent chose for you.
- Open docs/product/intent.md and compare it with the confirmed summary. The saved note should preserve the agreement without adding or dropping information.
- Confirm that hosting, launch date, analytics and any sector-specific review remain visibly open rather than being settled by assumption.
- Confirm that the intent note is the only workspace change. No stack, architecture, scaffold or implementation should exist yet.
After this part
What the project keeps
This file records the answers agreed in the conversation so they are available in part 02. It contains the intended audience, desired outcome, confirmed scope, assumptions and open questions. In this walkthrough it is saved at the path shown above, but ADEL does not prescribe this filename or directory. After part 02, the product brief becomes the source of truth for Product Definition.
- Conversation
Establishes the initial understanding
- intent.md
Working record created in part 01
- product-brief.md
Product Definition source of truth from part 02
Keep the intent note as project history. From part 02 onward, use the product brief for the current product requirements and decisions.
What this part does not add
Part 01 does not create the product brief or scaffold the website. The only saved project file is the intent note shown above. Its filename and location are examples used by this walkthrough; ADEL does not require this directory structure.
How this part applies ADEL
Why this part is needed
This website will be maintained after launch. Before any code is written, you and the client need to agree on who the site is for, what it should achieve, what belongs in the first release, and what remains undecided. Without those answers, the agent would have to make product decisions while implementing the site.
What to expect from the agent
- Asks only questions that could change the intended audience, outcome, scope, constraints, or definition of success.
- Lists confirmed facts separately from assumptions so you can correct or confirm each one.
- Records missing information as an open question instead of inventing an answer.
- Labels suggested exclusions as proposals and waits for you to confirm or change them.
This section defines Product Definition, the layer responsible for intended users, outcomes, scope and acceptance criteria.
Use this section to establish the project’s initial intent before design or implementation begins.
The initial intent is agreed, saved, and ready to be developed into the Product Definition in part 02.
Part 02 uses the intent note to prepare and confirm the project’s Product Definition.
02Define the product
The initial intent is saved, but the requirements and acceptance criteria are not yet defined.
You and the agent agree roughly on what the project is, but nothing yet states the expected behaviour clearly enough for someone else to judge whether it was delivered. Nothing defines what would make the result acceptable.
Produce a product brief containing the problem, users, outcomes, functional and non-functional requirements, constraints, acceptance criteria and exclusions. This walkthrough uses the brief as its Product Definition record; the Framework lists PRDs, product specifications, requirements documents and product-management systems as other possible records.
Action
prompt · product brief
Read docs/product/intent.md. First, review it against what this project's product brief will need to state. Identify: - anything important that is still unclear or missing - assumptions or inferences that have not been confirmed - questions whose answers would materially change the users, outcome, scope, requirements, constraints or acceptance criteria Ask only the smallest useful set of questions needed to resolve those points. Do not ask about architecture, technology, implementation, or delivery planning yet. Stop and wait for my answers. After I answer, draft a concise product brief using the intent note and my answers as input rather than copying the note. Cover: - the problem and intended users - required outcomes and initial success - confirmed scope - functional requirements - non-functional requirements - important constraints - acceptance criteria - explicit exclusions - assumptions and open questions that legitimately remain For this walkthrough, give the functional requirements (FR) and non-functional requirements (NFR) short, stable identifiers such as FR-01 and NFR-01. Do not create a separate requirements register. Keep the brief proportionate to a five-page marketing site. If a section would only repeat something obvious or add no useful information, leave it out. Do not make architecture, technology, implementation, or governance decisions in the product brief. Where something remains uncertain, state the uncertainty instead of resolving it silently. Clearly distinguish confirmed information from anything you inferred. Present the draft for my review and stop. After I confirm it, save the agreed brief to docs/product/product-brief.md.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
I reviewed docs/product/intent.md. It gives me the audience, services, first-release boundary, and available credibility material. Six product decisions are still open enough to change the requirements:
- Form fields and validation — Should the form collect name, email, company, and message? Is company optional? Should invalid input be caught in both the browser and the server, with errors beside the affected fields?
- Success and failure — After a successful enquiry, should the visitor stay on the Contact page with an in-page confirmation? If delivery fails, should that message be distinct from a validation error?
- Accessibility and viewport — Should Web Content Accessibility Guidelines (WCAG) 2.2 Level AA be a release requirement, and should the complete site remain usable from 360px width upward?
- Data handling — May the website or any form provider retain a copy of an enquiry after forwarding it to the shared inbox?
- Performance — You have not set a measurable target. May I require largest contentful paint (LCP) under 2.5 seconds, measured as the median of three Lighthouse mobile runs against a production preview, with the Lighthouse version and settings recorded?
- Release boundary — Do all proposed exclusions stand: no CMS, blog, client portal, recruitment section, booking, multiple languages, direct partner details, or launch analytics?
- Collect name, email, company, and message. Company may be optional. Validate in the browser and again on the server, and show field-level errors.
- Keep the visitor on the Contact page after success and show an in-page confirmation. Show a different message when delivery fails.
- Use WCAG 2.2 AA as a required acceptance target, and require the site to work from 360px upward.
- Forward enquiries to the shared inbox without retaining a copy on the website or in the form-handling path.
- Use the proposed LCP target and measurement conditions.
- All proposed exclusions stand for the first release.
- Eight functional requirements cover the five pages, navigation, approved service and credibility content, the form fields, validation, success and delivery-failure behaviour, and inbox delivery.
- Four non-functional requirements cover WCAG 2.2 AA, use from 360px upward, the confirmed LCP measurement, and the no-retention requirement.
- The first-release exclusions remain explicit. Hosting, launch date, and any sector-specific content or compliance review remain open.
- I have not made technology, architecture, or governance decisions.
The complete draft is shown below. I have not saved it yet; please review the wording, requirements, constraints, exclusions, and open questions before confirming it.
The complete draft, your confirmation, and the saved Product Definition.
# Product brief — Momentum & Balance Advisory website
## Problem
The current website describes services the firm no longer offers and gives a
prospective client no clear next step. A referred prospect needs an accurate,
credible account of the firm’s current work before deciding whether to make
contact.
## Intended users
The primary users are founders, CEOs, and operations leaders at growing,
owner-led companies who are evaluating Momentum & Balance after a referral.
Existing clients and job seekers may visit, but they are not priorities for
the first release.
## Required outcomes and initial success
The website must:
- explain the firm’s work in business strategy, operational improvement, and
organisational change
- establish credibility using material the partners can publish
- give a qualified prospect a clear way to send an enquiry
Initial success means a referred prospect can determine whether the firm fits
their situation, understand how it can help, and submit a relevant enquiry
that reaches the shared inbox. The first release does not use launch analytics
to measure this outcome.
## Confirmed scope
- Five public pages: Home, Services, Approach, About, and Contact
- Partner-approved descriptions of the three service areas and how the firm works
- Partner biographies and credentials, plus approved anonymised examples of past work
- Persistent navigation and a general contact form
- Existing logo and two brand colours as the starting visual material
- Public access with no login
## Functional requirements
FR-01 The site provides Home, Services, Approach, About, and Contact pages.
FR-02 Persistent navigation reaches all five pages from every page.
FR-03 Across the five pages, the approved content describes the three service
areas, the firm’s approach, partner biographies and credentials, and
anonymised examples of past work.
FR-04 The contact form collects name, email, message, and an optional company.
FR-05 Invalid input is rejected in the browser and on the server, with errors
shown beside the affected fields.
FR-06 After a successful submission, the visitor remains on the Contact page
and sees an in-page confirmation.
FR-07 A delivery failure is distinguishable from a validation error.
FR-08 A valid submission is delivered to the firm’s shared inbox.
## Non-functional requirements
NFR-01 All five pages and the form meet WCAG 2.2 AA.
NFR-02 The complete site is usable from a viewport width of 360px upward.
NFR-03 Largest contentful paint is below 2.5 seconds, measured as the median
of three Lighthouse mobile runs against a production preview. The
verification record states the Lighthouse version, profile, and build.
NFR-04 The website and its form-handling path do not retain a copy of an
enquiry after forwarding it to the approved receiving system.
## Product constraints
- The partners supply and approve the final copy.
- Client names and testimonials cannot be published.
- Only approved anonymised examples may be used.
- Hosting and production deployment are not decided in this brief.
## Acceptance criteria
The first release is acceptable when:
- all five pages are present, connected by persistent navigation, and contain
the approved service, approach, and credibility content
- a visitor can submit a valid enquiry and it reaches the shared inbox
- invalid input and delivery failures produce the specified messages
- the contact path does not retain submission content after forwarding
- the accessibility, viewport, and performance requirements have supporting evidence
## Explicit exclusions
No CMS, blog or insights publishing, client portal, recruitment section,
booking flow, multiple languages, direct partner contact details, named
clients, testimonials, or analytics configuration for the first release.
## Assumptions and open questions
No unconfirmed assumption is treated as a requirement.
The hosting provider and launch date are not yet decided. The partners also
need to decide whether the final copy requires sector-specific content or
compliance review before acceptance.A representative exchange, not tied to a particular coding tool
I reviewed the complete draft. It matches the decisions and does not introduce any unconfirmed requirement. Save it as the Product Definition source of truth.
Created docs/product/product-brief.md with stable requirement identifiers for later planning and verification. The intent note remains as earlier working history; the product brief now carries the current Product Definition.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Do the problem, intended users, required outcomes, initial success and confirmed scope accurately reflect the intent agreed in part 01?
- Does FR-03 include the approved service, approach and credibility material while respecting the restriction on client names and testimonials?
- Can someone who was not part of the conversation determine what FR-01 through FR-08 require, including the form fields, validation, success state, delivery-failure state and inbox delivery?
- Are NFR-01 through NFR-04 explicit and checkable? In particular, confirm the complete LCP measurement conditions and the no-retention boundary.
- Are the constraints, exclusions and remaining open questions accurate? Remove anything that was neither confirmed nor deliberately left open.
- Does the brief avoid architecture, technology, implementation and governance decisions?
- Is every important point in the intent note reflected or deliberately reconciled? From this point onward, the product brief is the Product Definition source of truth and the intent note is retained only as earlier input.
After this part
What the project keeps
This walkthrough uses one concise product brief as its Product Definition. For a project this size, it also carries the structured requirements often found in a product requirements document (PRD), so a separate PRD is not needed. Another project may use a PRD, product specification, requirements document, or product-management system instead.
This is the source of truth for what the project must achieve. Later work refers to it instead of restating the requirements, and part 09 verifies the implementation against it. The intent note may be kept as earlier working history, but it is no longer a source of truth.
What this part does not add
This part does not create a separate PRD, requirements register, traceability matrix, risk log or acceptance-criteria spreadsheet. The product brief carries the Product Definition in one place; another record is added only if later work creates a specific need for it.
How this part applies ADEL
Why this part is needed
Planning, design, implementation and verification need a shared statement of what the website must achieve. For this five-page site, the product brief only needs to define the users, outcomes, requirements, constraints, acceptance criteria and exclusions clearly enough for later work to use and verify.
What to expect from the agent
- Carries forward the confirmed business problem, audience, service scope, credibility material, intended outcome and initial success measure before it structures the requirements. The brief should refine the intent note, not reduce the project to the contact form.
- Writes requirements that are checkable. “The site must be fast” is too vague to verify; the confirmed target — largest contentful paint below 2.5 seconds, measured as the median of three Lighthouse mobile runs against a production preview with the version, profile and build recorded — gives part 09 a specific claim to evaluate.
- Gives the requirements later work will reference short, stable identifiers — FR-01, NFR-01 — because part 06 references them and part 09 evaluates them against evidence. This is a lightweight choice for this walkthrough, not an ADEL identifier scheme.
- Records the four non-functional requirements this project actually needs: WCAG 2.2 AA, usability from 360px upward, the confirmed performance measure, and no retention in the website or form-handling path. It does not turn implementation preferences into product requirements.
- States exclusions plainly. No content management system at launch. No client portal. No multi-language. No blog.
- Marks its own inferences instead of presenting them as your requirements, and keeps architecture, technology and governance choices out of the brief — those decisions belong to Governance or System Design, not Product Definition.
- Stops after the questions and waits. An agent that reviews and drafts in one pass may silently resolve its own open questions to finish the task, and those guesses arrive inside the Product Definition looking like decisions.
- Reconciles the intent note rather than restating it: anything still open is either resolved with you or carried into the brief as an open question, and nothing is silently dropped.
Defines the layer responsible for product intent, requirements, constraints and acceptance criteria.
Explains how to make the Product Definition sufficient for the work without documenting more than the project needs.
Provides a blank, adaptable Product Definition record. This walkthrough uses the smaller completed product brief above for the same responsibility.
The confirmed product brief now carries the project’s Product Definition. The intent note is retained only as the earlier input from part 01.
Part 03 records the project-wide principles and decision boundaries that the Product Definition and later work must follow.
03Establish governing principles and boundaries
The Product Definition exists, but project-wide principles and decision boundaries are not yet recorded.
The product brief is now the Product Definition source of truth. Before the project establishes its approved design, it needs project-wide principles and decision boundaries that later choices must follow. Some decisions may be delegated; others may require confirmation or approval. Those boundaries should not be invented during implementation.
Establish a concise Project principles record containing the project-wide principles, technical and operational constraints, decision authority and change rules that must hold across the project.
Action
prompt · governing principles
Read docs/product/product-brief.md. We are establishing the project's governing principles before moving on to system design. First, evaluate whether this project needs project-wide principles or boundaries in each of these areas: - proportional engineering and architectural complexity - protecting the agreed visitor outcome from unapproved feature growth - personal-data and security commitments - accessibility, responsive-use, and performance commitments - testing, evidence, and completion claims - technical and operational constraints - decision authority, exceptions, and changes to the Project principles Do not create a principle merely to fill a category. Identify only candidates that appear important enough to constrain the whole project rather than one feature or implementation choice. For each candidate, distinguish whether it is: - already confirmed by the product brief - a reasonable inference that still needs my confirmation - a legal, contract or audit requirement, or specialist issue, that should be verified rather than assumed Do not turn implementation preferences into governing principles. Do not invent legal, privacy, accessibility, security, architecture, or organizational requirements merely because they would be common practice. Ask the smallest useful set of questions needed to resolve the important governance decisions. If a decision belongs to the client or another approver rather than me, identify that instead of asking me to decide it. Stop and wait for my answers. After I answer, propose the complete set of principles, constraints, decision authority and change rules in language I can review. For every principle, state the rule, why it matters here, and what decisions or work it applies to. Stop so I can correct or confirm the proposed Project principles. After I confirm it, save the complete Project principles record to docs/governance/project-principles.md. Include only what needs to remain true across the project, such as: - purpose and scope - core principles - technical and operational constraints - decision authority - exceptions and changes - record status Use MUST, MUST NOT, and SHOULD only where the strength of the rule matters. Do not duplicate requirements from the product brief. Refer to it where appropriate. Do not make architecture, technology, or implementation decisions. Do not write agent instructions yet. Those will be derived later from these principles as agent instructions. If a proposed governing principle would change or contradict the current product brief, flag that explicitly instead of silently reconciling it. We will update the source of truth before proceeding. Do not create a separate complexity tracker, policy, checklist, or principle document unless the confirmed Project principles establish a specific need for one. Use the approved design or a relevant decision record to explain an important complexity choice.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
I reviewed the product brief across the proposed principle areas. Six candidates appear lasting enough to constrain the whole project. The product brief remains the source of truth for the measurable requirements; the Project principles would protect the commitments behind them. I have not found a reason for an authentication principle, a separate mobile application principle or a new complexity-tracking process.
- Complexity — Should the project require the smallest sufficient system and require important new dependencies, services, persistence or architectural layers to be justified in the design or a decision record?
- Outcome and scope — Must changes continue to support the agreed visitor journey, with any additional feature or changed outcome returning to Product Definition first?
- Data — Is no retention a project-wide client commitment covering collection, transmission, logging, storage and provider handling throughout the submission path?
- Accessibility and performance — Should accessible, responsive, and measurably performant delivery remain continuing project constraints, while the product brief retains the exact WCAG, viewport, and LCP targets?
- Evidence — Should the project prohibit describing work as satisfied or complete without evidence appropriate to the claim?
- Approvals and change — Who may change these principles, approve an exception, introduce a recurring service and authorize production deployment? Which ordinary technical decisions remain delegated?
- Yes. Keep complexity proportionate and require a project-specific reason for important additions. Use the design or decision record rather than creating a separate complexity tracker.
- Yes. The agreed visitor outcome takes priority over adding features. Changes to the outcome or scope must return to Product Definition.
- No retention is a client commitment and applies to the complete submission path, including logs and providers.
- Accessibility, responsive use, and measurable performance are continuing constraints. Keep the exact targets and measurement conditions in the product brief.
- Yes. Do not claim that work or a requirement is satisfied without evidence that actually evaluates it.
- Only the partners may amend the Project principles, approve an exception to them, change a client-facing data commitment, approve recurring service costs, or authorize production deployment. Other technical decisions are delegated to me within the product brief and Project principles.
- Proportional complexity — use the smallest system that satisfies the Product Definition and principles; justify important additions in the approved design or a decision record.
- Agreed visitor outcome — do not add features or change scope during lower-level work; return those decisions to Product Definition.
- Protect enquiry data throughout the submission path — collect only the confirmed fields and do not retain submission content anywhere in the forwarding path.
- Accessibility and responsive use — preserve the continuing commitment; use the product brief for its measurable targets.
- Measurable performance — preserve the confirmed performance expectation; use the product brief for the exact target and test conditions.
- Evidence before completion — support each satisfaction or completion claim with evidence appropriate to what it asserts.
- Technical and operational boundaries — no login or persistent submission store; partner approval for recurring services and production deployment.
- Exceptions and changes — only the partners approve exceptions or amend principles; lower-level conflicts stop and return to the responsible layer.
That captures the principles and decision authority correctly. Confirm them and save the complete Project principles record.
Created docs/governance/project-principles.md as the effective Project principles for this project. I did not choose a stack, submission architecture, or testing tool, and I did not create separate principle files or a complexity tracker.
The complete set of project-wide rules, boundaries, decision authority and change controls confirmed in the conversation.
# Project principles ## Purpose and scope These principles govern product, design, delivery, implementation, and verification decisions for the Momentum & Balance Advisory website. ## Core principles ### I. Proportional complexity Rule: The project MUST use the smallest system structure and operational footprint that can satisfy the Product Definition and the other governing principles. Important new dependencies, external services, persistent storage or architectural layers MUST have a project-specific reason recorded in the approved design or a relevant decision record. Why: One delivery person will maintain this small website. Unnecessary complexity adds maintenance and operating responsibility without improving the required outcome. Applies to: product proposals, System Design, delivery planning, implementation, and later changes. ### II. Preserve the agreed visitor outcome Rule: Design and implementation MUST support the primary visitor journey: understand the firm’s current services, establish credibility, and submit a relevant enquiry. Features outside the confirmed Product Definition MUST NOT be added during lower-level work. A proposed change to the required outcome or scope returns to Product Definition. Why: The first release is intentionally limited to the needs of referred prospective clients. Applies to: scope, content, design, work planning, and implementation decisions. ### III. Protect enquiry data throughout the submission path Rule: The website and its form-handling providers MUST NOT retain a copy of an enquiry after it has been forwarded to the approved receiving system. The path MUST collect only the fields confirmed in the Product Definition. A change affecting collection, transmission, logging, storage, retention, or provider handling requires review before implementation continues. Why: The firm has confirmed that non-retention is a commitment to its clients. Applies to: every component, service, environment, and provider in the contact-submission path. ### IV. Preserve accessibility and responsive use Rule: Changes MUST preserve the accessibility and viewport requirements defined in the Product Definition. A design or implementation decision MUST NOT weaken those requirements. Why: Accessibility and responsive use apply to the complete visitor experience rather than one page or task. Applies to: content, interaction design, System Design, implementation, and verification. ### V. Preserve measurable performance Rule: Design and implementation decisions MUST preserve the performance requirement defined in the Product Definition. A lower-level decision MUST NOT weaken its target or measurement conditions. Why: Performance affects whether prospective clients can use the site effectively and must remain measurable rather than aspirational. Applies to: System Design, implementation, dependency choices, content delivery, and verification. ### VI. Require evidence for completion claims Rule: The project MUST NOT describe a requirement, principle, or work item as satisfied without evidence appropriate to that claim. Automated checks MUST NOT be presented as evidence for behaviour or conditions they did not evaluate. Why: Implementation status and Assurance conclusions carry different meanings and must remain distinguishable. Applies to: implementation reports, reviews, verification, acceptance, and closure. ## Technical and operational constraints - The first release remains a public responsive website with no login. - The project MUST NOT introduce persistent submission storage. - New recurring external services require partner approval. - Production deployment requires explicit partner approval. - Technology and architecture choices belong in System Design unless they become project-wide constraints. ## Decision authority - Only the partners may amend these Project principles or approve an exception to them. - Only the partners may change a client-facing data commitment. - The partners approve recurring external-service costs and production deployment. - Other technical decisions are delegated to the delivery person while they remain within the Product Definition and these principles. ## Exceptions and changes A lower-level design, task or implementation decision MUST NOT silently override these principles. A proposed exception identifies the affected principle, the reason and the approver. An approved change is recorded through the project’s version history so the earlier rule and reason for changing it remain recoverable. A conflict returns to the layer responsible for the affected decision before work continues. ## Record status Status: Effective for this project Approver: Momentum & Balance partners
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Does every principle state a project-wide rule, a project-specific reason and where it applies? Remove any principle that is only a general aspiration.
- Do the proportional-complexity and visitor-outcome principles guide later choices without deciding the stack or duplicating individual feature requirements?
- Does the data principle cover collection, transmission, logging, storage, and retention without pretending the submission architecture has already been chosen?
- Do the accessibility, responsive-use and performance principles preserve the confirmed commitments while leaving their measurable targets in the product brief?
- Does the evidence principle prevent unsupported completion claims while leaving the actual verification methods to the work item and Assurance?
- Are approval boundaries limited to consequential decisions, and is the approver clear for each one?
- Does the record explain how conflicts, exceptions, and changes to the Project principles are handled and made recoverable?
- Could the delivery person still make routine technical decisions without repeatedly requesting approval?
This walkthrough established the initial Product Definition before its governing principles, because the product information makes it easier to write specific principles. If a confirmed principle changes the product’s scope, a requirement or its acceptance criteria, update the Product Definition before moving forward. Governance constrains the work; decisions made within the other layers should not quietly work around it.
After this part
Governance source of truth
This Project principles record functions as the project’s constitution. Other projects may use a charter, governance policy, or engineering-principles document for the same Governance source.
It contains the confirmed principles, technical and operational constraints, decision authority, and change process. Later work applies this record but does not silently reinterpret or override it.
Why these principles stay together
ADEL separates responsibilities, not necessarily files. These principles govern the same project, have the same approver, apply across the same delivery lifecycle and share one amendment process. They are also short enough to navigate in one project-principles record. Separate Governance sources become useful when a domain has a different record maintainer, organizational scope, regulatory policy, change schedule or enough detail to make the combined source difficult to use. If they are separated, they remain Governance sources, and the main project-principles record should link to them and explain which decisions each source controls.
How this part applies ADEL
Why this part is needed
The Project principles record turns the firm’s lasting commitments into rules that later product, design, delivery, implementation and verification decisions must respect. It can include engineering, architecture, quality, security, accessibility and testing principles when they genuinely apply across the project; it does not need a separate document for each category.
What to expect from the agent
- Reviews the relevant principle domains instead of assuming that Governance means only approval rules. It proposes engineering, architecture, data, accessibility, and assurance principles where the rule genuinely needs to persist across the project.
- Keeps each principle operational: the rule states what must remain true, the rationale explains why it matters to this project, and the scope states which decisions or work it constrains.
- Distinguishes a lasting principle from its layer-specific requirement or design. The Project principles can require accessibility, responsive use and measurable performance. Product Definition is responsible for the exact WCAG, viewport and LCP targets; System Design later decides how the system will meet them.
- Does not invent generic rules. Authentication at every layer would be irrelevant to this public site, and a new complexity-tracking process would be disproportionate. Important complexity is justified in the approved design or a decision record already used by the project.
- Separates what the brief confirms from what still needs approval, then presents the proposed Project principles for review before saving them as effective.
- Defines how conflicts, exceptions, and amendments are handled so a lower-level task cannot silently override Governance.
These principles constrain Product Definition, System Design, Delivery Planning, Execution and Assurance — and, later, the agent instructions derived from them.
Defines the layer responsible for lasting principles, constraints and decision authority.
Explains how Governance principles are established alongside the initial Product Definition.
Provides the blank structure used as a starting point for the completed Project principles above.
How the principles connect to later ADEL work
The lasting rule remains in Governance. Its measurable requirement, design, implementation, agent instruction or evidence belongs to the later ADEL layer responsible for that decision.
| Principle area | Governance establishes | Later ADEL responsibility |
|---|---|---|
| Engineering | Proportional complexity and any project-wide engineering constraint. | Repository conventions belong in the Agent execution overlay; the implementation and its tests are produced in step 6. |
| Architecture | Architectural boundaries that the project is not allowed to cross silently. | The concrete system structure and important architectural decisions belong to System Design and decision records in step 3. |
| Security and data | Project-wide data commitments, protections that allow no exceptions and who may approve changes to them. | Required product behaviour belongs to step 2, controls and data paths to step 3, implementation to step 6, and evidence to step 7. |
| Accessibility | The continuing commitment that later work must preserve. | Exact acceptance targets belong to step 2; design and implementation meet them in steps 3 and 6; Assurance evaluates them in step 7. |
| Performance | The rule that performance remains measurable and cannot be weakened silently. | The target and conditions belong to step 2, the technical approach to step 3, implementation to step 6, and measurement to step 7. |
| Testing and evidence | The rule that completion claims require evidence appropriate to the claim. | Test strategy belongs to step 3, work-specific checks to steps 4–5, tests and command results to step 6, and the verification conclusion to step 7. |
Splitting a principle into another Governance record changes where it is stored, not the ADEL layer responsible for it.
The confirmed Project principles record now carries six project-wide principles, the project’s technical and operational boundaries, decision authority and the process for exceptions and changes.
Part 04 prepares an approved design that satisfies the Product Definition and the governing principles.
04Design the solution
The requirements and governing principles are agreed, but the system structure and form-submission path are not.
The project has a Product Definition source of truth and confirmed project principles. There is still no code and no decision about how the contact form—the only part of this site with runtime behavior—will work.
Establish enough approved design to guide implementation: structure, routes, component boundaries, content model, the form-submission path, deployment assumptions and the architecture-relevant testing approach. Record the reason for important design decisions that later work may need to understand, using an architecture decision record (ADR) when a decision needs its own record.
Action
prompt · design options, then the design
Read docs/product/product-brief.md and docs/governance/project-principles.md. We are now establishing the approved design for this project. First, review those sources and identify any missing, conflicting, or unresolved information that would prevent a responsible design decision. Do not resolve a question about required product behaviour or a project-wide governing constraint by assumption. If one materially affects the design, say which of the two it is and which source should settle it, ask the smallest useful set of questions needed, and stop for my answer. If the earlier project knowledge is sufficient, propose a system design proportionate to this five-page marketing site. Cover: - page and route structure - important component boundaries - how page content is represented and maintained - the contact-form submission flow - deployment assumptions - the high-level testing and verification approach needed by the design This is a greenfield project, so the design also has to establish what we build it with. For each of the following, either name a choice and say why it fits this project, or state plainly that none is needed: - language - application or web framework - rendering model - styling approach - component or UI approach - animation approach - database or other persistence - content-management approach - server-side runtime behaviour - external services - hosting and deployment model - testing tooling - build, lint and type-checking tooling - package management assumptions, where relevant Prefer the smallest set that satisfies the requirements. Do not introduce a dependency because it is common; "none needed" is a legitimate and useful answer where the requirements do not call for one. Do not implement anything. For the contact-form submission path, present two or three viable approaches. For each, explain the consequences that matter here, including: - external services or dependencies introduced - operational responsibility - cost where it materially differs - where personal data is transmitted or stored - relevant failure behaviour - meaningful switching or reversal cost Check every option against the product brief and the governing principles. Do not present an option as viable if it violates them. Recommend an approach and explain why, but treat the recommendation as a proposal rather than an accepted decision. Also identify any other proposed design choice that you believe is important enough that its rationale should remain recoverable later. Do not create a decision record for routine or easily understood technology choices — the stack itself belongs in the design document, not in a record each. Stop and wait for my decisions. After I confirm the important choices, draft the approved design at docs/architecture/blueprint.md and create a decision record only for each confirmed important choice whose reason will matter to future work. Have the approved design reference the product-brief requirements it meets, and have each decision record reference the requirement or design section it affects, so the path from intent to implementation stays recoverable without a separate index. Do not change the product brief or the governing principles. If my decision would conflict with either, flag the conflict instead of silently reconciling it.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
I reviewed the product brief and the complete Project principles record. I found no conflict with an earlier decision. I applied the proportional-complexity principle by keeping one deployment unit, static content, local shared components, no CMS and no database. Most stack choices are local and reversible; the contact-submission path is the one important decision because it affects enquiry data, introduces an external dependency and recurring cost, and must support later verification.
- Third-party form service — lowest build and operating effort. Submission data passes through the provider, so its account settings and retention behaviour become part of the design. Switching later would require replacing the endpoint integration.
- Server route plus transactional email — more control over validation and the data path, but we would own runtime configuration, error handling, secret management, and ensuring request logs never capture message content.
- Hosted form embed — fastest to place, but gives the least control over validation, accessibility, visual consistency, and data handling. It is the weakest fit for the current requirements.
- Recommendation — use the form service for the lower operational burden, but only if the actual account can disable storage, enforce the required server validation, expose distinguishable responses, and deliver to the shared inbox. If those conditions cannot be confirmed, the option does not satisfy the Product Definition and Project principles.
The partners approved the recurring cost for managed hosting and the form service within the proposed budget. Their written approval is retained in the project correspondence titled “Initial hosting and form-service approval,” dated 7 September 2026. The no-retention commitment still applies. Within my delegated technical decision authority, choose the form service subject to the validation, response, delivery and retention prerequisites you identified. If the actual account does not satisfy them, stop.
Created docs/architecture/blueprint.md and ADR-001. The decision is conditional on the actual account satisfying the recorded validation, response, delivery, and retention prerequisites; accepting the design is not a claim that they already hold. Implementation must stop if the account behaves differently. No application code was created or changed.
The design summary, complete System blueprint, and complete ADR-001 produced from the confirmed decision.
A reader-friendly comparison of the accepted choices. This table explains the result but is not a source of truth.
| Design area | Accepted design | Why it fits |
|---|---|---|
| Language | TypeScript | Content-shaped code with a compile-time check; nothing here needs more. |
| Framework | Next.js | Five static routes from one deployment unit, with form delivery delegated to the approved external endpoint. |
| Rendering | Static pages | The page content does not change per request, and the initial form design does not add application server runtime. |
| Styling | Tailwind CSS | Two brand colours and a small shared visual system. No design system needed. |
| Components | Local shared components | A component library would be larger than the site. |
| Animation | None | CSS transitions cover the current design. Revisit if the design changes. |
| Database | None | Nothing is persisted — the governing principles forbid retaining submissions. |
| CMS | None | Five pages, content supplied once by the partners, edited in the repository. |
| Server-side runtime | None in the application | The form service receives the request, performs server-side validation, and forwards valid enquiries. |
| External services | One form-handling provider | The only external dependency. Its validation, delivery and retention behaviour are important—see ADR-001. |
| Hosting | Managed platform | No infrastructure for the firm to operate. |
| Testing | Vitest, Playwright | Unit checks for validation, one end-to-end pass for the form. |
| Build and checks | tsc, ESLint, framework build | Enough to make “it builds and passes” mean something. |
| Package management | npm with a committed lockfile | A simple, widely supported choice for one small application. |
Submit the Contact form directly to the third-party form service, conditional on confirming that the actual account enforces the required server-side validation and allows submission storage to be disabled. ADR-001 records those assumptions, the data path, alternatives, consequences, and stop conditions because the choice determines where personal data goes and introduces the project’s only external dependency. Nothing else in the table earns a record of its own.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Does the blueprint satisfy the Product Definition without changing or weakening its requirements?
- Does the design apply the Project principles, including proportional complexity, visitor outcome, enquiry-data protection, accessibility, responsive use, performance, and evidence before completion?
- Do the design summary and System blueprint describe the same structure?
- Do the blueprint and ADR-001 describe the same initial submission path — browser to form-service endpoint to shared inbox — without introducing an application server route?
- Does ADR-001 preserve the alternatives, approver, rationale, consequences, prerequisites and stop conditions for the important decision?
- Are server-side validation, distinguishable responses, inbox delivery, and disabled provider storage presented as prerequisites to verify during implementation rather than facts already established?
- Does the testing approach cover accessibility, performance, form behaviour, delivery, and retention evidence?
- Are separate decision records limited to important choices whose reason will be useful later, rather than routine stack and component choices?
After this part
Sources of truth for the approved design
The record of the approved design used in this walkthrough—elsewhere it may be called an architecture document, technical design or solution design.
The structure the implementation is expected to follow. Later work references the relevant parts of this approved design instead of restating the design in each work item.
A decision record for an important System Design choice. This walkthrough uses an ADR; another project may use a request for comments (RFC) or a decision-log entry.
It preserves the alternatives considered, the accepted choice, its consequences, and why it was chosen. Without that rationale, later work can see what the system does but not necessarily why that design exists.
These records define the approved design and preserve the reason for its important submission-path decision. They do not prove that the provider prerequisites have been met.
Why there is only one decision record
The blueprint records ordinary design choices such as Next.js, TypeScript, Tailwind CSS, static rendering, and local shared components. They do not need separate decision records because their rationale is straightforward and they are relatively easy to change. ADR-001 is separate because the form service changes the system boundary, introduces an external processor and recurring cost, affects personal-data handling, and can proceed only if specific provider prerequisites are met.
How this part applies ADEL
Why this part is needed
The agent compares design options against both the Product Definition and the Project principles. The chosen structure must remain proportionate, preserve the visitor outcome, protect enquiry data, and keep accessibility, performance, and verification possible. Choices that affect cost, data handling, operations, or long-term maintenance may also require approval.
What to expect from the agent
- Checks the Product Definition and Project principles for requirements, constraints, or unresolved questions that affect the design.
- Compares proportionate design options and explains their consequences, including complexity, operations, cost, data handling, failure behaviour, and reversal cost where relevant.
- Identifies which choices are important enough to require an approver’s decision rather than treating the agent’s recommendation as approval.
- Stops after presenting those choices and waits for the decision before finalising the design.
- Records the accepted system structure in the System blueprint without changing the Product Definition or Project principles.
- Records the alternatives, approver, reason, consequences, prerequisites and stop conditions for the important form-submission decision in ADR-001.
- Leaves implementation and conformance checks to later work. The comparison table explains the decision but is not a source of truth.
Defines the layer that turns product intent into an intended system structure and behaviour.
Explains why important design decisions record their reason, consequences and approver.
Shows how a proposed solution is checked against the affected decisions before implementation.
Provides blank structures for the completed System blueprint and ADR shown above.
The System blueprint now defines the structure implementation should follow, and ADR-001 preserves why the direct form-service path was accepted conditionally. The Product Definition and Project principles remain unchanged, no application code has been created, and implementation must verify the provider’s validation, response, delivery, and retention behaviour before connecting the form.
Part 05 adds agent instructions that tell the agent where to find the current project records and how to work within them.
05Establish how the agent works
The project decisions are recorded, but future agent sessions still need concise repository instructions for how to begin, work, validate, and stop.
The product brief, Project principles, System blueprint and ADR-001 hold the project decisions. They do not tell a coding agent every practical detail of working in the repository: where to begin, which commands are valid, which local conventions apply, when a decision is outside its decision authority or what to report when it finishes. This is the role of agent instructions.
Create a concise repository-level AGENTS.md that gives future coding agents practical instructions that remain available across work sessions without copying or replacing the project’s sources of truth.
Action
prompt · agent instructions
Inspect the current repository, then read these records for the limited purpose of drafting agent instructions: - docs/product/product-brief.md - docs/governance/project-principles.md - docs/architecture/blueprint.md - docs/architecture/decisions/adr-001.md Draft concise agent instructions for this walkthrough using AGENTS.md at the repository root. Its job is to help a coding agent navigate and work within the project, not to become another source of product, governance, or design truth. Include: - how to start from the assigned work item and locate relevant project knowledge - the repository paths future agents may need and when to consult them - development-environment instructions that are actually established - repository-wide implementation conventions that are actually established - testing and required check commands that actually exist - decision authority and stop conditions that affect an agent's work - any established pull-request or delivery instructions - the information a completion report should contain Do not imply that this file grants access or decision authority that the project rules and platform do not grant, and do not treat content the agent can read as an instruction merely because it is accessible. Point to sources of truth instead of copying their contents. Do not treat reading order as an order of decision priority. Decision authority comes from the source of truth or layer responsible for the decision, not from reading order. Do not invent coding conventions, required commands, repository structure, tooling, or workflow that does not yet exist. If something has not been established, mark it as not yet established and identify when the guidance should be updated. Do not review or reconcile the project records as a separate exercise. If a missing or conflicting instruction prevents you from writing unambiguous agent instructions, report that specific issue and identify the source that must settle it. Do not resolve it inside AGENTS.md. Keep AGENTS.md concise enough to function as a practical operating map rather than a duplicate knowledge base.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
I inspected the repository and read the existing records only to identify the agent instructions and source locations that AGENTS.md needs. The repository currently contains the project documents but no application, package scripts, work items, development commands, test commands or pull-request conventions, so I have kept those sections explicit and minimal.
- Tells future agents to start with the assigned work item and use its references to load only the project knowledge needed for that task.
- Maps the product brief, Project principles, System blueprint, and decision-record directory without repeating their contents.
- Records practical stop conditions for important scope, data-handling, cost and deployment changes.
- Defines the required completion report and distinguishes implementation evidence from the conclusion later made in Assurance.
- Marks development, testing, and delivery instructions as not yet established because the repository does not contain them yet.
- Clarifies that AGENTS.md does not grant tool access; the active platform and organisation controls still determine permissions.
The repository-level operating map created for future coding-agent sessions.
## Starting work - Begin with the assigned work item. - Follow its references to the product brief, project principles, system blueprint and relevant decision records. - Read only the additional information needed for the work item. - Inspect the affected repository area before making changes. ## Sources of truth - Product requirements and acceptance: docs/product/product-brief.md - Project principles and decision authority: docs/governance/project-principles.md - Approved system design: docs/architecture/blueprint.md - Important design decisions: docs/architecture/decisions/ ## Development environment Not yet established. Add the real setup and development commands after the application is created. ## Required checks No commands exist yet. Add the repository’s actual type-check, lint, test and build commands when they are available. ## Working boundaries - Implement only the assigned outcome. Do not change product scope or an accepted design inside an implementation work item. - Do not introduce an important dependency, external service, persistent store, architectural boundary or recurring cost without the required decision. - Follow the approved submission design. Stop if the provider prerequisites cannot be confirmed or the work would change how enquiry data is collected, transmitted, logged, stored, retained or processed. - Stop before requesting an exception to the project principles or deploying to production. - Report a missing or conflicting instruction instead of silently choosing which source of truth to override. - AGENTS.md does not grant permissions. Use only the access allowed by the active platform and organization controls. ## Completion report State what changed, which acceptance criteria it addresses, which required commands ran and their results, what was not verified, and any deviations or follow-up work. Report evidence without claiming an Assurance conclusion.
The development and validation sections are intentionally incomplete at this point because no application or commands exist. Part 07 updates them after the agent creates the application and can record commands that actually run.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Does every instruction explain how an agent should work, rather than redefining what the product or system must be?
- Are the repository paths accurate, and does the guide tell an agent when each source is relevant?
- Does it tell the agent to begin with its assigned work instead of reading every project record by default?
- Are all development, testing, and delivery commands real and runnable in the current repository? Remove or mark anything that has not yet been established.
- Are the operating boundaries consistent with the Project principles and ADR-001 without copying their full contents?
- Does it clearly say when the agent may continue, when it must stop and ask, and what it should include in its completion report?
- Does it distinguish agent instructions from permissions and controls enforced by the active coding platform?
- Is it short and direct enough for an agent to use repeatedly? Remove explanation that does not change an action.
After this part
Repository operating guide
The agent-instructions record used in this walkthrough. Other projects carry the same instructions in CLAUDE.md, Copilot instructions, Cursor rules or another agent-instructions file.
A lasting map for the agent. It points to sources of truth, carries repository-wide rules, lists required checks and explains when to stop and ask, without duplicating the sources it references.
This first version contains only instructions the project can support now. It should be updated as real development commands, testing steps, conventions, and delivery practices are established.
Why the first version is shorter than a typical AGENTS.md
An established repository may include package-navigation tips, development commands, test commands, lint rules, coding conventions, and pull-request instructions. None of those exist yet in this walkthrough. Adding plausible examples would make the guide look complete but give future agents false instructions. Part 07 updates the guide after the application and its actual commands exist.
How this part applies ADEL
Why this part is needed
AGENTS.md defines how an agent works in the repository; it does not define the product or grant permissions. A mature project guide may contain development commands, testing instructions, coding conventions and pull-request rules like the sample above. This project does not have an application or toolchain yet, so its first version can only record what is currently true. The drafting agent reads the existing records to locate the sources it should reference and to turn established decision authority and stop conditions into practical instructions. It is not being asked to reassess those decisions, and future agents should begin with their assigned work item and follow only the references relevant to that work.
What to expect from the agent
- Inspects the repository so the guide describes its actual structure, tooling, and workflow rather than a generic development setup.
- Reads the relevant project records while drafting so it can point to the correct sources and turn established decision authority and stop conditions into useful agent instructions. It does not reconsider or rewrite their decisions.
- Tells future agents to start with the assigned work item and follow its references. It does not require every agent to load every project document for every task.
- Uses pointers instead of copying the product brief, Project principles, System blueprint, or ADR. This keeps AGENTS.md from becoming a competing source of project truth.
- Includes only commands, conventions and workflow instructions that currently exist. Because the application has not been created, development and required check commands are explicitly pending until the repository establishes them.
- Defines when an agent must stop and ask, and what its completion report must include. These are agent instructions; the underlying decision authority remains in the Project principles and other sources of truth.
Describes the cross-cutting guidance that tells an agent how to operate within project boundaries.
Explains which agent instructions must remain available before an agent receives bounded implementation work.
Explains how an agent should find the sources of truth relevant to its current work item.
Provides a blank AGENTS.md structure that can be adapted to the repository’s actual rules and commands.
The repository now has a minimal AGENTS.md for future coding sessions. It tells an agent to begin with the assigned work, locate relevant project knowledge, stay within established decision boundaries and report its checks clearly. It intentionally contains no invented development, testing or pull-request instructions, and it changes how the agent works rather than changing any project decision.
Part 06 uses the current project knowledge to define the clearly scoped work item the agent will implement.
06Plan the implementation work
The project decisions are ready to use. The next step is to decide how the implementation should be divided and define exactly what the agent will build.
The product, governance, and design decisions are recorded, and AGENTS.md explains how an agent should work with them. Before implementation starts, those decisions need to be turned into reviewable work. For this project, that means answering two questions in order: should the website be one work item or several, and what must the approved work item contain?
Choose a proportionate work breakdown, confirm it, and create a clearly scoped work item that an agent can implement without making new product, governance, or design decisions.
Action
prompt · plan and prepare the implementation work
Read AGENTS.md and follow its references to the sources of truth that apply to this work. We are preparing implementation, not changing the product brief, the governing principles or the approved design. First, check whether the current project knowledge is sufficient to organize the work. If planning exposes a missing or conflicting requirement, governing principle, system-design decision or important architectural question, say which of those it is and which source of truth should settle it, instead of resolving it inside the plan. Then assess whether this project needs to be broken into more than one implementation work item at all. Consider: - whether there are independently meaningful outcomes - dependencies that require sequencing - separate risk boundaries - separate approvers - migration or rollout boundaries - work that could run in parallel - expectations that need independent verification - whether a single change would still be reviewable - the size and complexity of the implementation Do not split the work by page, by technical layer, by frontend and backend, by test type, or to reach some preferred task size. Split it only where one of the factors above makes separate delivery genuinely better. Recommend either a single clearly scoped work item or a sequence, and explain which factors drove the conclusion. Flag anything too broad to review confidently, and anything so fragmented that it no longer represents a meaningful outcome. Do not write code or invent new requirements, architecture, or implementation details merely to complete the plan. Stop and wait for my confirmation of the proposed work breakdown. Do not create the work item yet. After I confirm the work breakdown, prepare the agreed work item or items. In this walkthrough, record each one as a Task. A different project may already use an issue, ticket, story or another type of work item. Each work item should include: - the objective - the relevant requirement or outcome references - relevant governing principles - relevant approved design - relevant decision records - explicit in-scope and out-of-scope boundaries - dependencies or prerequisites - acceptance criteria - required checks - the evidence or completion information expected from the person or agent doing the work Production deployment stays outside the assignee's decision authority unless it is explicitly approved. Reference sources of truth rather than copying them. Do not settle new product, governing, system-design or delivery-scope decisions inside the work item. If required project knowledge is missing or conflicting, describe the gap and which source of truth should settle it, rather than filling it with an assumption.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
The project knowledge is sufficient to organise the work. I applied the planning factors from your prompt to this project; they support one clearly scoped work item rather than several. The pages and contact journey form one reviewable release, and accessibility and performance apply across it. ADR-001 has one provider-account prerequisite covering server validation, distinguishable responses, inbox delivery and disabled submission storage. Task 01 should carry that prerequisite and its stop conditions rather than assume they will pass.
- Use one clearly scoped work item for the complete website.
- The pages share one layout and quality expectations, so splitting by page would create handoffs without independent outcomes.
- Keep the submission path inside the same work item, with an explicit stop condition for any data-handling or external-service conflict.
I agree with one clearly scoped work item. Prepare Task 01, carry the provider-account check as a prerequisite, and keep production deployment outside it.
Created docs/delivery/tasks/task-01.md. It references the sources of truth, defines the scope and acceptance criteria, and keeps production deployment outside the assignee’s decision authority.
An illustrative conversation, an editorial summary of the planning recommendation, and the complete Task 01 prepared for implementation.
This table was organised for the walkthrough from the recommendation the agent reported. It is not a transcript or reconstruction of the agent’s internal reasoning. The agent did not ask these factors as questions, and another agent may analyse or present the decision differently. This is not a list of product requirements, a required response format, or a mandatory ADEL checklist.
| Factor supplied in the prompt | Agent’s finding for this project | Planning implication |
|---|---|---|
| Independently meaningful outcomes | The five pages and contact journey form one website release; individual pages are not useful releases on their own. | Keep them together. |
| Dependencies and sequencing | All pages share the same layout, content model, styles, and quality constraints. | Keep them in one work item. |
| Risk boundaries | The form provider is an important risk, but ADR-001 already defines a prerequisite and stop condition. | Carry the risk inside Task 01. |
| Decision authority | One delivery person handles implementation; partner decisions are already expressed as stop conditions. | No additional task is needed. |
| Migration or rollout boundaries | This is the first release and uses one deployment unit. | Keep one release task. |
| Parallel work | There is one person doing the work, so separate work items would not enable parallel delivery. | Keep one work item. |
| Independent verification | Accessibility, responsive use, and performance apply across the complete website. | Verify them across the same task. |
| Reviewability | Five routes, shared components, and one submission path remain understandable as one bounded change. | One work item remains reviewable. |
| Size and complexity | It is a small marketing site with five routes, shared components, and no application database. | One work item remains proportionate. |
Separate work items would add coordination without creating independent outcomes. Task 01 therefore covers the complete website. The form-service uncertainty remains visible as a prerequisite and stop condition inside the work item rather than becoming a disconnected work item.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Does the recommendation explain why one work item is appropriate using this project’s actual outcome, dependencies, risks, approvers, assignees and verification needs?
- Does Task 01 match the work breakdown you approved, without adding a second outcome or silently omitting part of the website?
- Can you trace every relevant functional and non-functional requirement into the task or its referenced sources?
- Are the in-scope and out-of-scope boundaries clear, with production deployment still outside the assignee’s decision authority?
- Does the provider-account prerequisite preserve ADR-001’s validation, response, delivery, and retention conditions without presenting them as already verified?
- Will the stop conditions prevent the agent from resolving a product, governance, design, external-service, or data-handling conflict inside implementation?
- Are the acceptance criteria observable, and does the expected evidence cover the checks that Assurance will need later?
After this part
Bounded implementation work
The work item used in this walkthrough. If your project already tracks work as tickets or issues, use those — ADEL does not require a separate task file.
Task 01 brings the approved scope and work-item-specific acceptance criteria together for implementation. Later Assurance checks both Task 01 and the sources of truth it references, so the work item cannot silently narrow or replace their expectations.
Task 01 is the record saved for the next implementation session. The planning analysis is shown here to explain why one work item was chosen; this project does not save it as a separate delivery-plan document.
Why Task 01 is enough for this project
Delivery Planning still happens in this part: the agent evaluates whether the website should be divided or sequenced, and you approve the recommendation to keep it as one work item. Because one person or agent can deliver the website as one release, there are no additional dependencies, assignees, schedules, migration stages or parallel workstreams to coordinate in a separate plan. Task 01 then carries the information needed for implementation. A more complex project may need a delivery plan, roadmap, sprint plan or issue board to record sequencing, assignees, dates and coordination alongside its individual work items.
How this part applies ADEL
Why this part is needed
The work-breakdown assessment and work-item preparation belong in one planning conversation. The agent first recommends whether to keep the website together or split it, then waits for confirmation before writing the work item. The prompt supplies factors such as outcomes, dependencies, risk, decision authority, rollout, parallel work, verification and reviewability. They are not questions the agent must ask one by one, and another capable agent may present its analysis differently. The table shown later is an editorial summary, not a view of the agent’s internal thought process. This project has one outcome, one person doing the work, one deployment unit and shared quality requirements, so one work item is clearer. The form-submission risk remains visible through a prerequisite and stop condition inside that work item.
What to expect from the agent
- Checks that the existing project knowledge is sufficient for planning and reports any blocking gap to the ADEL layer responsible for it.
- Evaluates whether separate outcomes, dependencies, risks, approvers, rollout boundaries, parallel assignees, verification needs or reviewability justify more than one work item.
- Recommends one work item for this project because the five pages and contact journey form one release, share one implementation structure, and are handled by one person.
- Waits for you to confirm that work breakdown before creating Task 01. The recommendation does not approve itself.
- References the requirements, Project principles, System blueprint, and ADR-001 instead of copying or changing them inside the task.
- Defines the implementation scope, exclusions, provider prerequisite, stop conditions, acceptance criteria, required checks, and completion report clearly enough for Part 07 to execute.
Defines the two ADEL responsibilities used here: organising the approved work and defining the bounded unit the agent will implement.
Explains how to turn project knowledge into a bounded, reviewable work item with explicit stop conditions.
Shows one optional structure for carrying scope, constraints, acceptance criteria and expected evidence.
The project now has one approved work item that is ready for implementation. Task 01 connects the complete website outcome to its requirements, governing constraints, design and important decision; defines what is included and excluded; carries the unresolved provider prerequisite and stop conditions; and states the acceptance criteria and evidence Part 07 must produce. No code or production deployment occurs in this part.
Part 07 gives Task 01 to the agent for implementation within the recorded boundaries.
07Build the site
Task 01 is ready, and the agent can now implement the approved scope.
Task 01 now gives the agent an approved objective, scope, constraints, acceptance criteria and expected evidence. AGENTS.md explains how to work in the repository, while the records referenced by the task remain the sources of truth for product, governance and design decisions. This is the first part of the walkthrough that creates application code.
Implement as much of Task 01 as the approved project knowledge allows, run the checks available in the new repository, stop before making any decision the work item does not allow and report completed, blocked, unverified and excluded work accurately.
Action
prompt · implement task 01
Implement docs/delivery/tasks/task-01.md. Follow AGENTS.md and the sources of truth referenced by the work item. Before changing anything, inspect the current repository state. Reuse existing patterns and conventions where they actually exist. If the project has not yet established a relevant implementation convention, make only the local, reversible choices needed for this work; do not invent a repository-wide rule. Implement the bounded outcome described by Task 01, and nothing beyond it. Do not introduce a dependency, external service, architectural boundary, or other important design change that is not already approved by the approved design and relevant decision records. If the work cannot be completed without changing required product behaviour, a governing constraint, the approved design, a delivery assumption, or another decision outside this work item's decision authority, stop there and report: - what you discovered - why the current project knowledge is insufficient or conflicting - which existing project decision or source of truth is affected - what work, if any, can still be completed safely within the existing scope Add the tests and run the required checks named by the work item. If this work establishes stable repository-wide required check commands that were previously unknown, update or propose an update to the agent instructions before the work is handed on for verification. Do not deploy to production or send a live enquiry through the firm’s production contact path. When the bounded work is complete, report: - what you changed - which acceptance criteria the implementation addresses - validation performed and its results - evidence produced - anything not validated or not verifiable in the current environment - relevant assumptions or limitations - deviations, risks, or follow-up work Do not claim the overall work is verified or accepted. Report the evidence; whoever assesses it will determine whether it is sufficient.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
Preflight complete. I found the documentation-only repository described in AGENTS.md and followed Task 01 to the product brief, Project principles, System Design, and ADR-001. The planned implementation stays within the visitor outcome and uses only the proportionate structure already accepted in the design. I’ll build the bounded site and check the provider-account prerequisite before connecting external delivery.
I’ve paused the provider integration at its stop condition. The actual account retains submissions for 30 days and cannot set retention to zero on the approved plan, which conflicts with the no-retention principle and invalidates ADR-001’s assumption. I continued only with work that does not depend on that choice; the five pages, form states, local validation, and tests are ready for review.
An illustrative end-of-session report showing what the agent implemented, what its local checks support, what remains unverified, and where Task 01 is blocked.
This is an illustrative report produced after the implementation session. It is not a live activity feed or a view of the agent’s internal reasoning. A completed marker means the agent reports that the item was implemented or that a named local command passed; it does not mean the requirement or Task 01 has been accepted.
- ✓Next.js + TypeScript project scaffolded; Tailwind configured with the two approved brand colours
- ✓Five routes implemented: Home, Services, Approach, About, and Contact (FR-01)
- ✓Shared layout, persistent navigation, and footer implemented (FR-02)
- ✓Approved service, approach, and credibility content implemented through typed local modules (FR-03)
- ✓Responsive layout implemented from 360px upward; full NFR-02 evaluation remains for Assurance
- ✓Contact form fields, browser validation, accessible field errors, and a shared validation contract implemented (FR-04 and the browser portion of FR-05)
- ✓In-page confirmation and distinguishable validation and delivery-failure states implemented and exercised with stubbed responses (FR-06 and the UI portion of FR-07)
- ✓Accessibility implementation added for NFR-01, including landmarks, labels, focus handling, and design-token contrast; complete WCAG evaluation remains for Assurance
- ✓Performance optimisation implemented; the production-preview Lighthouse evidence required by NFR-03 has not yet been collected
- ✓Unit tests added for validation; local end-to-end tests use controlled delivery responses
- ✓Type-check, lint, unit-test, stubbed end-to-end, and production-build commands reported passing for the current local implementation
- ✓Deployment configuration prepared for the approved hosting model
- ■Provider integration, provider-side validation for FR-05, live failure behaviour for FR-07, FR-08 inbox delivery, and NFR-04 retention conformance blocked by the provider conflict
- —Excluded features, persistent storage, and unapproved architectural additions not introduced
- —No live production enquiry sent and no production deployment performed
The blocked item is the correct use of Task 01’s stop condition, not a claim that the task is complete. Part 08 resolves the earlier decision before the affected implementation resumes. The new required check commands should also be added to AGENTS.md before Assurance relies on them.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Does the implementation remain within Task 01 and the System blueprint, including the initial design’s absence of an application server route?
- Does the report map Task 01 accurately by distinguishing implemented work, controlled or stubbed checks, blocked provider behaviour, and evidence still required from Assurance?
- Did the agent stop before connecting a provider that violates ADR-001’s retention prerequisite and continue only with work unaffected by that conflict?
- Were the reported type-check, lint, unit-test, end-to-end, and production-build commands actually run, and can you reproduce or independently inspect their results?
- Were excluded features, unapproved architectural changes, live production enquiries, and production deployment kept outside the work?
- Are the stable required check commands ready to be added to AGENTS.md, and does the report avoid claiming that accessibility, performance, delivery, retention or Task 01 as a whole has already been verified?
After this part
Implementation produced so far
The partial implementation, tests, tooling, and project configuration produced before the provider stop.
They preserve the completed portion of Task 01 while the task remains open. The tests and command results provide repeatable evidence for the behaviours they evaluate, but they do not establish that the blocked or unverified acceptance criteria have been satisfied.
The code and tests are retained, but Task 01 remains open. Part 08 must resolve the provider conflict and complete the affected acceptance criteria before Assurance evaluates the finished implementation.
Why implementation does not require approval after every change
Task 01 and the earlier project records already delegate routine, local implementation choices to the delivery person and agent. They can continue without requesting approval for each file or component. Approval becomes necessary when the work reaches a recorded boundary, as it does here when the provider conflicts with the no-retention principle and the accepted submission design.
How this part applies ADEL
Why this part is needed
The implementation prompt can stay concise because Task 01 and AGENTS.md direct the agent to the relevant project knowledge. The agent builds within that boundary, adds tests and reports what happened. Its status report is a claim about the implementation session, not a live view of its activity, a reconstruction of its internal reasoning or an Assurance conclusion. In this example the provider prerequisite fails, so the agent keeps Task 01 open, stops the affected integration and completes only the work that remains safe and independent.
What to expect from the agent
- Reads Task 01 and follows its references, then inspects the repository before changing it. Because no application exists, it creates only the scaffold, tooling, and local conventions needed for the approved design.
- Implements the five routes, shared components, approved content, responsive styling, accessible form interface, local validation, submission states, tests, and deployment configuration within the recorded scope.
- Inspects the actual provider account before connecting the form, as ADR-001 and Task 01 require.
- Stops the provider-dependent work when the account’s 30-day retention conflicts with the no-retention principle. It does not connect the service, change the principle, or choose a replacement architecture inside Execution.
- Continues only with work that is independent of that conflict and runs the repository’s new type-check, lint, unit-test, stubbed end-to-end, and production-build commands.
- Reports implementation claims against Task 01, distinguishes local or stubbed evidence from provider and production evidence, keeps blocked criteria open, and identifies the stable commands that AGENTS.md should carry before Assurance.
Defines Execution as the ADEL layer that implements bounded work and makes local implementation decisions within the approved project knowledge.
Distinguishes implementation and test results from the later Assurance judgement about whether the available evidence is sufficient.
Shows how the clearly scoped work item and project knowledge used across changes guide an implementation session.
Provides prompt patterns for executing defined work and reporting evidence without restating the project.
The site, form interface, tests, tooling, and deployment configuration are implemented, but Task 01 remains open. The agent reports its local checks and correctly stops before connecting a provider that violates ADR-001. Part 08 must resolve that conflict and complete the provider-dependent criteria before Assurance evaluates the finished result.
Part 08 resolves the provider conflict before implementation of the submission path continues.
08Resolve a conflict found during implementation
The approved form provider retains submissions, which conflicts with the project’s no-retention principle.
The site is partially implemented: the pages, navigation, responsive behaviour, browser validation, form states, tests, tooling, and deployment configuration are in place. The form has not been connected because the required account inspection revealed that the approved provider retains submissions for 30 days. That conflicts with the no-retention principle established in part 03 and invalidates a prerequisite of ADR-001. Task 01 remains open.
Recognize the finding, identify which decision it affects, stop only the work that requires a decision the agent cannot make, ask its approver to resolve it, update the affected records and then continue.
What happened
A representative exchange, not tied to a particular coding tool
I’ve stopped the provider integration. The actual account retains submissions for 30 days and cannot set retention to zero on its current plan. That conflicts with the no-retention principle and invalidates the assumption recorded in ADR-001. The completed pages, form behaviour, and local validation are unaffected.
What are the options, and what does each one cost?
- Change the no-retention commitment and accept 30-day provider storage — least implementation work, but only the firm’s partners may approve the change.
- Upgrade to a provider plan that can disable retention — added recurring cost and a setting that must remain controlled.
- Replace the provider with a Next.js server route backed by a transactional email API — more operational responsibility and another external-service cost requiring partner approval, but a data path designed not to persist submissions.
- Recommendation — keep the firm’s commitment and use the Next.js server route. The hosting platform may execute it as a serverless function, but the project records consistently describe the architectural boundary as a server route. It adds operational responsibility, while remaining the smallest viable option that preserves the Project principles. Application logging, infrastructure logging, provider retention, and inbox delivery still require verification.
How Part 07 leads into this decision
Part 07 did not produce five unrelated blockers. They all depend on the same rejected provider path. Part 08 changes that path and completes the affected implementation; Part 09 evaluates the resulting behaviour and evidence.
The approved account fails ADR-001’s retention prerequisite.
Replace the direct provider connection with the accepted Next.js server route and transactional email API.
ADR-001 expected the form service to enforce the server-side validation contract.
The Next.js server route now applies the shared validation contract before delivery.
Only stubbed UI states could be checked without a real submission path.
The route maps validation, delivery, and service failures to distinguishable responses that can be verified.
The unsuitable provider was deliberately left unconnected.
The revised design makes delivery through the transactional email API possible; Part 09 checks an identified test enquiry reaches the approved shared inbox.
The original provider retains submission content for 30 days.
The revised path avoids application storage and makes application logs, infrastructure logs, provider retention, and inbox delivery explicit Assurance evidence.
Choose how to resolve the provider conflict
Review the conflict and identify which decisions the agent cannot make before choosing a response. The approval note shows what must be recorded before the Action prompt can be sent; the accepted technical path appears afterward.
NFR-04 and Principle III require the form-handling path not to retain a copy after forwarding. ADR-001 allowed the direct provider path only if submission storage could be disabled, so its prerequisite has failed.
Do not continue the provider-dependent implementation. The agent cannot change the no-retention principle, approve a new recurring service cost or select an unrecorded replacement architecture inside Task 01. Work unaffected by the conflict may remain in place. Product Definition needs updating only if the intended product commitment or acceptance criteria change.
These three columns compare one viable response from each decision category: change the commitment, change the provider plan or change the technical path. They are presented together so you can compare what each response would change, who must approve it and its consequences. The agent produced them because you asked for options; they are illustrative rather than an ADEL-required or exhaustive list.
Accept 30-day retention and change the commitment
- What changes
- Project principles, NFR-04, and any related public commitment.
- Decision required
- The partners must approve the governing and product changes.
View consequencesHide details
Requires an intentional Governance change to the no-retention principle. Any Product Definition commitment or user-facing privacy notice that promises no retention must also be reconciled. Cheapest to build, and a promise the firm then has to keep publicly.
Upgrade to a plan where retention can be disabled
- What changes
- Provider plan, recurring cost, and an operational setting that must remain controlled.
- Decision required
- The partners approve the cost; the delivery person confirms the design remains acceptable.
View consequencesHide details
Intended to satisfy the governing principle, but changes cost and operational dependency. The existing provider decision may need updating or replacing if the paid-plan requirement is important to why the option is acceptable, and it leaves a provider setting that someone must not later change back.
Use a Next.js server route designed not to persist submission content
- What changes
- System blueprint, decision record, Task 01, implementation, and operational evidence.
- Decision required
- The partners approve the service cost; the delivery person selects the technical design.
View consequencesHide details
The route uses a transactional email API and may run as a serverless function on the hosting platform. It is designed to satisfy the governing principle, changes System Design, replaces ADR-001, and introduces secret management, error handling, and logging responsibilities. Platform logs can still retain submitted content unless they are configured and verified correctly.
The Project principles confirmed in Part 03 define the decision authority. The agent does not assign or invent it for this decision.
Confirm whether the no-retention principle remains in force and approve any new recurring service cost.
Select the technical approach within the confirmed Product Definition, Project principles and delegated decision authority.
Present the options and consequences, wait for the required approvals, then update the affected records and implement the accepted response.
Action
prompt · propagate the decision
Once you have decided, propagate it before resuming
We are keeping the no-retention governing principle and changing the technical approach. Before writing more implementation code, reconcile the project records with that decision. 1. Create ADR-002 for the new submission-path decision. Record: - what was discovered - which approved decisions or assumptions were affected - the viable options considered - their relevant consequences - the accepted decision and rationale - the requirement and design section it affects - that ADR-002 replaces ADR-001 Do not delete or rewrite ADR-001. 2. Update docs/architecture/blueprint.md so the approved design reflects the accepted Next.js server route and transactional email API. 3. Recheck the work breakdown against the revised design. State whether it introduces a separate outcome, dependency, assignee, rollout boundary, or verification need that changes the decision to use one work item. Do not create a separate delivery-plan document unless the revised work genuinely needs one. 4. Update docs/delivery/tasks/task-01.md so its references, boundaries, acceptance criteria, validation, and expected evidence match the updated System Design and ADR-002. 5. Make the intended no-retention boundary explicit in the revised design and work item: which application, infrastructure, delivery-provider and approved receiving system behaviours are in scope, and what evidence Assurance will need before conformance can be claimed. Do not present the design choice itself as proof. 6. Check the other sources of truth for anything that still assumes the replaced approach. Update only the sources actually affected by this decision, and tell me which ones changed and which did not need to change. Do not change the governing no-retention principle; that decision has been confirmed. If propagation reveals another missing or conflicting decision above this work, stop again, describe the decision and the source of truth it belongs to, and do not resolve it silently. Once the sources of truth agree again, continue the implementation against the updated work item. Rerun the relevant required check commands and add the stable repository-wide commands established by this work to AGENTS.md before handing the result to Assurance.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
The partners have confirmed that the no-retention commitment stays and approved the proposed recurring cost for the transactional email service. Under my delegated technical decision authority, I am choosing the Next.js server route. It preserves the commitment without relying on a plan-specific storage setting, gives the project a clearer validation and logging boundary, and remains proportionate for this site. Propagate the decision, complete the affected implementation and record the evidence still needed before claiming conformance.
- Created ADR-002 as replacing ADR-001, then updated the System blueprint. The Product Definition and Project principles did not change.
- Rechecked the work breakdown. The revised path adds operational responsibility but not a separate outcome, assignee, rollout, or verification boundary, so the project remains one work item. I updated Task 01 accordingly.
- Replaced the blocked provider integration with the accepted Next.js server route and transactional email API. The route enforces the shared validation contract, does not write submissions, and excludes request bodies from application logs.
- Repeated typecheck, lint, unit, end-to-end, and production-build checks; all passed for the revised implementation.
- Added the established required check commands to AGENTS.md.
- Recorded application persistence, infrastructure logging, delivery-provider retention, and delivery of an identified test enquiry as evidence Assurance must still evaluate before conformance can be claimed.
The approved response, complete ADR-002, revised System blueprint and Task 01 sections, completed implementation and remaining evidence needs.
A concise account of which records changed, which remained sources of truth without revision, and how implementation resumed. This summary does not replace the records it names.
The direct form-service account retains submissions for 30 days and cannot satisfy the approved no-retention boundary.
Change the commitment
Not selected because the partners confirmed that Principle III and NFR-04 remain in force.
Upgrade the provider plan
Not selected because it would continue to depend on a plan-specific storage setting that must remain controlled.
Use a Next.js server route
Selected after the partners approved the service cost. The delivery person chose it within delegated decision authority because it preserves the commitment, creates a clearer validation and logging boundary and remains proportionate.
Kept the no-retention principle in force.
Approved the recurring transactional-email service cost.
Chose the Next.js server route within delegated technical decision authority.
Recorded, applied and implemented the approved response.
The selection is not random: the Project principles determine who may decide, Principle III and NFR-04 constrain viable responses, ADR-001 supplies the failed prerequisite and the delivery person chooses among the remaining technical options within delegated decision authority.
- ✓ADR-002 created; ADR-001 marked replaced and retained as decision history
- ✓System blueprint updated with the Next.js server route, revised data boundary, operational responsibilities, and evidence needs
- ✓Delivery Planning rechecked; the revised design still fits one clearly scoped work item
- ✓Task 01 updated to reference ADR-002 and cover the revised path, logging, provider handling, and evidence
- ✓Next.js server route and transactional email integration implemented; relevant checks rerun
- ✓AGENTS.md updated with the established type-check, lint, test, and build commands
- —Product Definition unchanged because the intended outcome and requirements did not change
- —Project principles unchanged because the partners confirmed the existing no-retention commitment
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
Decisions and approvers
- Confirm that the actual account inspection supports the 30-day retention finding and that it violates ADR-001’s prerequisite and the no-retention principle.
- Confirm that only the provider-dependent work stopped and that unaffected implementation remained intact.
- Confirm that the partners decided the governing commitment and recurring cost, while the delivery person selected the technical approach within delegated decision authority.
Records and propagation
- Check that ADR-002 contains the discovery, alternatives, approvers, decision, consequences, affected requirements, evidence needs and replacement of ADR-001.
- Check that the System blueprint, ADR-002, and Task 01 describe the same Next.js server-route path and no-retention boundary.
- Confirm that Delivery Planning retained one work item and that the Product Definition and Project principles were correctly left unchanged.
Implementation and evidence
- Confirm that implementation finished against the updated task, the relevant checks were rerun and stable commands were added to AGENTS.md.
- Confirm that application storage, logging, provider retention, failure behaviour, and inbox delivery remain evidence for Assurance rather than facts proved by the design.
After this part
What changed in the project
This ledger shows the effect of the decision on the project’s records. A record changes only when the decision or project knowledge it carries has changed.
The intended outcome and requirements remain the same.
The partners confirm the existing no-retention commitment.
Retained as history; its conditional direct-provider path is no longer current.
Records the replacement path, approvers, reason, consequences and evidence needs.
Now defines the Next.js server route and revised data and operational boundaries.
The revised design still fits one clearly scoped work item; no separate plan is added.
References ADR-002 and carries the revised implementation and evidence requirements.
The server route is implemented and the relevant checks are rerun.
Receives the stable required check commands established during implementation.
How this part applies ADEL
Why this part is needed
The provider conflict cannot be resolved inside Task 01. The partners must confirm whether the no-retention principle still stands and approve any new recurring service cost; the delivery person may then choose the technical approach within the decision authority already delegated by the Project principles. Before the affected implementation resumes, the decision is recorded, the System blueprint is revised, the decision to use one work item is checked again, and Task 01 is updated. The Product Definition and Project principles remain unchanged because the intended outcome and governing commitment do not change.
What to expect from the agent
- Recognises that the provider behaviour contradicts a written prerequisite and governing commitment, rather than treating it as an implementation inconvenience.
- Stops only the provider-dependent work. It does not hide the conflict with a retention notice, change the principle, connect the unsuitable service, or invent a replacement architecture inside Task 01.
- Identifies the affected approvers and records, presents viable options with consequences, and waits for the partners’ principle and cost decisions and the delivery person’s technical choice within delegated decision authority.
- Creates ADR-002, preserves ADR-001 as replaced history, and revises the System blueprint before changing the implementation.
- Rechecks Delivery Planning and records that the revised path does not justify splitting the project, then updates Task 01 with the new references, boundaries, criteria, and evidence needs.
- Implements the Next.js server route, reruns the repository checks, and reports what those checks establish without claiming no-retention conformance.
- Adds the stable required check commands to AGENTS.md and leaves the application, infrastructure, delivery-provider and inbox evidence clearly identified for Assurance.
A discovery during Execution returns to each layer responsible for an affected decision, then proceeds forward through the affected work again.
Defines how conflicting statements are resolved through the layer responsible for the decision and its approver.
Shows why implementation discoveries can return work to the layers that own the affected decisions before execution resumes.
Explains how a discovery is traced to affected decisions and applied without rewriting unrelated project knowledge.
Provides the blank decision-record structure used for the completed replacement decision above.
How the discovery moved through ADEL
Return only as far as each affected decision requires. The work checks Governance because that is where the constraint lives, then revises System Design and the downstream work item—no further. The product commitment and the rest of the site are untouched.
The partners keep the no-retention principle and approve the new service cost; the delivery person selects the Next.js server route within delegated decision authority. ADR-002 replaces ADR-001, the System blueprint and Task 01 are updated, Delivery Planning confirms that one work item is still sufficient, implementation finishes against the revised design and AGENTS.md receives the stable required check commands. The product brief and Project principles remain unchanged, while application, logging, provider and inbox evidence remain for Assurance.
Part 09 verifies the completed implementation against the relevant requirements, principles, design decisions and task criteria.
09Verify the result
Implementation is complete, but the project still needs evidence that the agreed expectations were met.
The site is implemented, the retention conflict has been resolved and the agent has reported the checks it performed. That report is evidence from Execution, not yet an Assurance conclusion. The project still needs to determine whether the available evidence supports the relevant acceptance criteria, requirements, design decisions and governing constraints across the whole delivered scope.
Evaluate the completed Task 01 scope against the relevant requirements and acceptance criteria, identify the exact implementation state examined, gather more evidence where needed and state clearly what is verified, what failed, what is not yet verified and what could not be verified. Because Task 01 contains the complete first release, this verification covers the whole site.
Action
prompt · verification
Verify the completed Task 01 — the whole delivered site, not only the contact path. Start from docs/delivery/tasks/task-01.md and follow its references to the product brief, governing principles, approved design and relevant accepted decision records, including the current submission-path decision. First identify the expectations that actually apply to this work: - acceptance criteria in the work item - relevant requirements from the product brief - relevant approved design and accepted decision constraints - relevant governing principles - repository-wide required checks Identify the implementation state being evaluated — for example the commit, build, preview deployment and any important environment or configuration state. Reuse identities already carried by continuous integration (CI) or the hosting platform rather than duplicating them in the record. For each expectation, determine what evidence would be sufficient to evaluate it. Run the relevant required check commands defined in AGENTS.md and use the existing implementation and test evidence where it is relevant. For expectations not established by those checks, perform additional verification that is appropriate and possible in the current environment. For this form, that may include relevant checks for keyboard use, accessible labelling, error and success behaviour, narrow viewports, and the submission and data-handling path — but only where those checks correspond to an actual project expectation. Do not invent a check merely because it appears in this prompt. For each relevant requirement or acceptance criterion, record what the evidence shows: - Verified — available evidence supports the expectation - Failed — a required check ran and the expectation was not met - Not verified — the available evidence is incomplete, or the check was not performed - Unable to verify — verification could not be performed because a required environment, access, data, tool or other condition was unavailable Use the project's own terminology if it already has one; the distinctions are what matter. Record the failing check itself as the evidence. State the supporting evidence for every conclusion, and distinguish evidence from inference. Then give an overall result — Verified, Verified with findings, Failed, Not verified or Unable to verify. Record important findings, residual risks, limitations, and anything that could not be verified. Do not describe something as verified merely because it was implemented or because the implementation looks reasonable. If verification exposes a gap in a requirement, a governing constraint, the system design or the implementation, say which of those is affected and which source of truth should settle it — do not silently change the work during verification.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
First verification pass completed against preview build web-183. The automated checks passed, but the keyboard walkthrough found that focus moves behind the open mobile menu. NFR-01 and the related Task 01 acceptance criterion are Failed for this build. I recorded the finding and returned that bounded defect to Execution without changing the implementation during Assurance. The independent checks could remain as evidence for web-183, but the overall conclusion stayed pending until the defect was corrected and the affected checks were repeated.
Return that bounded defect to Execution. Fix the mobile-menu focus order, run the relevant implementation checks, create a new preview build, and then repeat the affected verification. Preserve the original finding.
Execution update: I constrained focus to the open menu, restored it to the trigger on close, added the regression case, and reran the relevant unit and end-to-end checks. They pass. The new preview is web-184 at revision 9c1f2ab.
Re-verification complete on web-184. The accessibility review now supports NFR-01, and all other relevant requirements and acceptance criteria remain supported by their evidence. The final result for web-184 is Verified. VER-01 still preserves the defect found on web-183, the correction made in Execution and the repeated checks. Production deployment remains outside the evaluated scope.
The preserved Assurance record, presented as an evidence mapping followed by the overall result and evaluated-scope boundary.
This table is an editorial view of the evidence recorded in VER-01. It helps the reader compare requirements, evidence and results; it is not a separate output file or project record.
| Expectation or Task 01 criterion | Evidence | Result |
|---|---|---|
| Project principle I · Proportional complexity | Design and dependency review: one deployment unit, no CMS or database; the only external service and revised route are justified in ADR-002 | Verified |
| Project principle II · Preserve the visitor outcome | Delivered-scope and repository review found only the five-page journey and contact behaviour defined in the product brief | Verified |
| Project principles · Decision authority | ADR-002 references the written partner approval for the replacement recurring service; deployment remains outside Task 01 | Verified |
| Project principle VI · Evidence for completion claims | Every relevant requirement, principle, design constraint and task criterion is mapped to identified evidence in VER-01 | Verified |
| AC-01 / FR-01–FR-02 · Routes and navigation | Playwright route and persistent-navigation checks passed on preview build web-184 at revision 9c1f2ab | Verified |
| AC-02 / FR-03 · Approved content and exclusions | Rendered-content comparison against the referenced partner-approved copy; repository review found no excluded feature | Verified |
| AC-03 / FR-04–FR-05 · Fields and validation | Vitest client/server validation suite, 24 cases; browser checks for accessible field-level errors | Verified |
| AC-04 / FR-06 and FR-08 · Confirmation and inbox delivery | End-to-end success-path pass; identified test enquiry sent from preview web-184 reached the approved shared inbox used for acceptance testing | Verified |
| AC-05 / FR-07 · Distinguishable failures | Integration and end-to-end passes for validation, delivery, and service-failure responses | Verified |
| AC-06 / NFR-04 / Principle III / ADR-002 · Application handling | Route review and storage scan found no persistence, request-body logging, or enquiry-field logging | Verified |
| AC-06 / NFR-04 / Principle III / ADR-002 · Infrastructure and provider handling | Redacted request-log probe, hosting logging-configuration export, and provider retention and account-configuration evidence | Verified |
| System blueprint / ADR-002 · Credential and deployment boundary | Repository and preview-configuration review confirmed the credential is protected outside source control and no production deployment was performed | Verified |
| AC-07 / NFR-01 / Principle IV · WCAG 2.2 AA | Review against the relevant WCAG 2.2 AA criteria using automated analysis, keyboard, screen-reader, contrast, content and structure checks on web-184; the web-183 focus defect was fixed and rechecked | Verified |
| AC-07 / NFR-02 / Principle IV · Usable from 360px | Manual checks at 360, 768, and 1280 pixels on web-184 | Verified |
| AC-08 / NFR-03 / Principle V · LCP under 2.5s | Three Lighthouse mobile runs per route; route medians ranged from 1.7 to 2.1 seconds, with the Lighthouse version, profile, and web-184 build recorded | Verified |
| AC-09 · Repository required checks | Type-check, lint, unit, end-to-end and production-build commands passed in the identified CI run for revision 9c1f2ab | Verified |
The complete Task 01 scope is supported by evidence for preview build web-184 at revision 9c1f2ab. The initial verification of web-183 found a mobile-menu focus-order defect. Execution corrected it, and Assurance repeated the affected checks against web-184. VER-01 preserves that history; the defect is resolved in the evaluated build, and no relevant requirement, acceptance criterion or limitation remains unresolved.
Production deployment is still outside Task 01 and was not performed. The record is explicit about that boundary: it verifies the approved production-ready build under the agreed environment, not a production release that does not yet exist.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Can every relevant acceptance criterion, requirement, governing constraint and design decision be traced to a verification result, or to a clear reason it does not apply?
- Review what failed, what is not yet verified, what could not be verified, and the findings and residual risks. Together they define what the project can actually claim. An approved exception does not change any of these results.
- Independently reproduce or inspect important evidence when confidence matters. A spot check can reveal problems with the report, but one successful sample does not verify the rest of it. Scale independent checking to the risk and consequence of the work.
- Does any finding contradict an approved requirement, governing principle, System Design decision or accepted decision record? If so, identify each affected decision and return it to the responsible layer rather than redefining it inside Assurance. A requirement met by a different internal method is not necessarily a change—it is only a Product Definition change if the required outcome itself changed.
After this part
What the project keeps
The preserved verification conclusion used in this walkthrough. It references the evidence supporting each result. Another project may keep the same conclusion on the work item, the pull request, a CI record or another source-of-truth location — ADEL requires sufficient evidence, not this particular file.
This walkthrough preserves a separate record because whole-site verification combines automated checks, manual observations, and evidence around a submission path whose design changed during implementation. A simpler change could keep the same conclusions on the work item or pull request. It makes the completion conclusion evidence-based rather than declarative, and records the evaluated state and any remaining uncertainty.
What this part does not add
Part 09 does not create a separate file for every check or copy raw CI, Lighthouse, accessibility, hosting, or provider output into the repository. VER-01 references those evidence sources. It also does not record client acceptance, close Task 01, create a central traceability table, or authorize production deployment. Acceptance and closure happen in Part 10, while production deployment remains a separately approved action.
How this part applies ADEL
Why this part is needed
Automated tests support only the behaviours and conditions they exercise. Verification therefore maps each relevant requirement, principle, design decision and work-item criterion to evidence. When the first verification run finds a focus-order defect, Execution corrects it and Assurance repeats the affected checks against the new build. The verification record identifies both builds and states whether any gaps remain.
What to expect from the agent
- Runs the defined required check commands and reports the actual result, referencing the CI run—the continuous-integration system that runs checks automatically—or another evidence source, rather than pasting raw output into the record.
- Identifies the revision, build and important environment configuration the evidence applies to, so a later reader can tell that the current implementation—not the replaced submission path—was evaluated.
- Maps each relevant requirement or acceptance criterion to the evidence that supports—or fails to support—it, so coverage is visible rather than asserted.
- Distinguishes evidence from inference. Automated tests, CI results, review, static analysis and measurement are all evidence; an agent that could not perform a check should say which condition was unavailable rather than reasoning its way to a conclusion.
- Does not invent certainty or gaps. If something could not be established, it says so; if every relevant requirement and acceptance criterion is supported, it records that plainly.
Verification. Part 10 covers closure — step 7 is not finished here.
Defines Assurance as the layer that evaluates evidence against the delivered change and explains that verification activity may happen throughout delivery.
Explains how claims are matched to evidence, findings are handled and affected checks are repeated.
Shows one optional structure for preserving what was checked, against which build and with what result.
VER-01 records a Verified result for preview build web-184 and preserves the defect found in web-183, its correction in Execution, and the repeated Assurance checks without treating the earlier failure as a current limitation.
Part 10 records client acceptance and confirms that the project records and direct references reflect the delivered result.
10Close the work
Verification supports completion; client acceptance and the final project record still need to be confirmed.
VER-01 records a Verified result for preview build web-184, and the retention discovery has already been reconciled through the Project principles, approved design, ADR-002 and Task 01. Task 01 is not closed yet: the client partner’s acceptance still needs to be confirmed and referenced, and the project needs one final check that its sources of truth and follow-up boundaries are current.
Confirm that the verification result supports completion, preserve the required client acceptance, close Task 01 and leave the project records consistent enough for the next piece of work to begin without relying on this conversation.
Action
prompt · close the work
Task 01 has completed verification. Read the current work item, VER-01, and the sources of truth it references. First, confirm whether the verification result supports closure. If VER-01 is Failed, Not verified, Unable to verify, or otherwise contains an unmet requirement, acceptance criterion or required check, determine whether closure is blocked. An exception permits closure only where project policy allows it and the approver accepts it. Rules that allow no exceptions must still be followed, and acceptance does not change the verification result. Where closure is blocked, stop and identify: - what prevents closure - which approver is needed - which existing project decision is unresolved, and which source of truth and approver should settle it Do not treat verification as client acceptance, and do not close work unless you are the approver or the approver has accepted it. If the result supports closure and the required acceptance has been given, record on Task 01 who accepted the work, the accepted build and revision, the date, and where the original acceptance evidence is retained. Do not copy the original correspondence into the task. Then prepare the project for its next piece of work. 1. Confirm that the sources of truth affected by this work are coherent and current. Update only a source whose project knowledge actually changed. 2. Check that ADR-001 remains clearly replaced by ADR-002, and that the current approved design and Task 01 reflect the accepted submission path. 3. Confirm that the path from intent to evidence is recoverable through the existing references: product brief → system design / decision record → work item → implementation → verification evidence Do not create a central traceability table merely for closure. Recommend a shared traceability view only if the direct references no longer make that path sufficiently clear. 4. Identify follow-up work, findings, or residual concerns that should survive this delivery. Route each one to the existing source of truth or work system that owns it. Do not create a new register or backlog just for this walkthrough. 5. Review AGENTS.md for any lesson from this work that represents a lasting, repository-wide operating rule. Propose a change only if the guidance truly generalises. Do not add an incident-specific note. 6. Produce concise closure notes stating: - what was delivered - the verification result and supporting record - the approver, where this project requires one - important decisions that shaped the result - remaining findings or follow-up work - whether any sources of truth were updated during closure Do not duplicate information that already has a source of truth.
One possible result after sending the prompt above
A representative exchange, not tied to a particular coding tool
VER-01 supports closing Task 01: every required expectation has evidence, and the repaired focus-order finding remains recorded. Production deployment was outside the task. I can confirm the evidence supports closure, but the client partner still needs to accept the business outcome.
The client partner confirmed in writing that preview build web-184 at revision 9c1f2ab satisfies the agreed outcome. The original communication is retained in the project correspondence titled “Website first-release acceptance,” dated 9 September 2026. Record that reference on Task 01 and close it. Production deployment remains a separate approved action.
I recorded the accepted build, client partner, acceptance date and project-correspondence reference on Task 01, then marked the task Closed. The sources of truth agree, ADR-001 remains replaced by ADR-002, and the direct references preserve the path from the product brief to VER-01. I did not deploy or create a separate sign-off or traceability document.
The client-acceptance reference, updated Task 01 closure section, and final reconciliation of the project’s approved project state.
The client partner accepts preview build web-184 at revision 9c1f2ab as the complete production-ready website. Task 01 references the original written acceptance retained in project correspondence; the agent conversation is not the evidence. Acceptance and verification remain distinct, and neither grants permission to deploy.
## Closure Status: Closed Closed on: 9 September 2026 ### Verification - Result: Verified - Record: docs/assurance/verification/VER-01.md - Evaluated build: web-184 - Revision: 9c1f2ab ### Client acceptance - Accepted by: Momentum & Balance client partner - Accepted scope: Preview build web-184 as the complete production-ready website defined by Task 01 - Accepted on: 9 September 2026 - Evidence: Written acceptance retained in project correspondence titled “Website first-release acceptance” The original client communication is the acceptance evidence. This task records where that evidence is retained; it does not copy the correspondence. ### Remaining boundary Production deployment was not included in Task 01 and has not been approved or performed. It remains a separate partner-approved action.
- —Product brief — current. Nothing the work changed
- —Project principles — current. The data principle was confirmed in part 08; no principle was amended
- —Approved design — current and consistent with the delivered submission path; no closure update needed
- —ADR-001 remains replaced and retained; ADR-002 remains current
- ✓Task 01 — acceptance reference recorded and status changed to Closed
- —AGENTS.md — current; no closure-specific or incident-specific guidance added
- —Production deployment remains a separately approved action
- —Central traceability table — not created. The direct references are sufficient
Task 01 is the only project record changed during closure. The other seven lines confirm that an existing source remains current or that a deliberately excluded action or record was not added.
Confirm before continuing
Review the result and resolve any concern before treating this part as complete.
- Does the verification result actually support closure, and has the client partner provided the required acceptance? Can a later reader use Task 01 to identify who accepted which build, when, and where the original evidence is retained?
- Could someone reconstruct why the form works this way from the repository alone, with no access to the conversation? That is the actual test of closure.
- Is the path from intent to evidence recoverable through the existing references? A break in it is where the next argument will start — but a gap is a reason to add a link, not automatically a reason to add an index.
- Are follow-ups recorded where the responsible person can find and act on them?
- Are the proposed AGENTS.md changes genuinely general? Resist the ones that are really just a note about this week.
Client acceptance confirms that the verified result satisfies the agreed business outcome and permits Task 01 to close. It does not alter VER-01, turn an unmet expectation into a verified one, or authorize production deployment. Those remain separate conclusions and decisions.
After this part
What the project keeps
The existing work item is updated; this is not a separate closure or sign-off file.
Task 01 records the Verified build, its reference to VER-01, the client partner’s acceptance and evidence reference, the production-deployment boundary, and its Closed status. The existing direct references already preserve the path from intent to evidence.
Product brief → System blueprint → ADR-002 → Task 01 → implementation → VER-01. The relevant records reference the project knowledge they depend on, so the path is already recoverable.
What this part does not add
Closure does not add a retrospective, lessons-learned register, central traceability table, separate closure record or ADEL-specific sign-off form. Existing project records are updated only where their lasting information changed. The original client acceptance remains in project correspondence and is referenced from Task 01 rather than copied into another approval file.
How this part applies ADEL
Why this part is needed
Before Task 01 closes, the delivery person confirms that VER-01 supports completion, the client partner has accepted the delivered outcome, changed project records are current and any follow-up work is recorded in the appropriate place. Existing direct references already connect the product brief, design, decisions, task, implementation and verification, so this project does not need a central traceability table.
What to expect from the agent
- Confirms that VER-01 supports completion without treating verification as client acceptance or approval.
- If acceptance is missing, stops and asks for it. If it is available, records the approver, accepted build, date and evidence location on Task 01 without copying the original correspondence.
- Writes a concise delivered-change summary connected to the relevant requirements, decisions, work item and verification record.
- Confirms that the traceability path is recoverable. It uses the existing direct references where they are sufficient and recommends a shared view only when they are not.
- Separates lasting follow-up work from scope expansion and routes each item to the responsible layer, Agent execution overlay or existing work system instead of creating a new catch-all record.
- Proposes a lasting agent instruction only when the lesson applies to future work. An AGENTS.md that adds one rule per incident becomes unreadable, and an unread guide helps nobody.
Closure. Part 09 covered verification; together they complete step 7.
Defines verification and closure as the final lifecycle step and keeps the approver’s decision distinct from the verification result.
Explains how direct references can preserve a recoverable path from intent through decisions, work and evidence.
Explains how records remain current, become historical or are replaced as the project changes.
Task 01 is Closed and records the Verified build, VER-01 and the location of the client partner’s written acceptance. The other project records remain current, and their existing references preserve the path from Product Definition to verification.
The website project is closed. Future work can use the current product brief, Project principles, System blueprint, ADR-002, AGENTS.md, Task 01 and VER-01 as its starting project knowledge.
What using ADEL changed in this project
This is a review of the walkthrough against a plausible conversation-only, ad hoc delivery—not a controlled experiment. A disciplined project using another method can achieve the same outcomes. The useful comparison is whether the project preserves intent, decision authority, decisions and evidence, rather than whether it uses the ADEL name.
Practical when scaled to the work
One person can follow this route with a capable coding agent, but the page is intentionally more explicit than a normal small project because it teaches each transition. In practice, the same information can live in shorter records or in tools the team already uses.
Credible, but deliberately curated
The questions, proposals, implementation reports and stop conditions are representative of a capable coding-agent session. Exact wording and results will vary by agent and repository. Editorial summaries and comparison tables explain observable work; they are not presented as the agent’s hidden reasoning.
Consistent with ADEL’s stated model
The walkthrough keeps the Framework above the example, distinguishes lifecycle steps from layers and the Agent execution overlay, assigns important decisions to responsible layers and approvers, routes findings back to the affected source of truth, separates implementation claims from verification and treats files as optional records rather than required ADEL files.
What the example contains
These counts describe what happened in this example. They are useful for checking completeness, but they are not targets that another project must copy.
8 functional and 4 non-functional requirements in the accepted product brief
including decision authority, data handling and proportional complexity
revised when the design changed, then verified and closed
ADR-001 retained as replaced history; ADR-002 remains current
one design conflict during implementation and one defect during verification
VER-01 preserves the final evidence and conclusion
ADEL-guided delivery and ad hoc delivery
The ad hoc column describes common risks when decisions remain only in prompts and chat history. It does not claim that every project outside ADEL will fail this way.
Starting a new agent session
The person may have to reconstruct the project history, or the agent may act from an incomplete summary.
Task 01 identifies the bounded work and points to the current Product Definition, principles, System Design, decisions and agent instructions.
Controlling scope and decision authority
A capable agent may make a plausible choice without knowing that the choice belongs to the client, delivery person or another approver.
The product brief defines the outcome, the principles assign decision authority and the work item states when the agent must stop.
Handling a failed assumption
The provider conflict could be patched locally, left unresolved or explained only in a transient conversation.
The agent stops the affected work; the approvers decide; ADR-002, the blueprint and Task 01 are updated before implementation resumes.
Claiming completion
“Tests pass” may be treated as proof that the product is acceptable even when requirements, live behaviour or client acceptance have not been checked.
The implementation report remains a claim from the person or agent doing the work. VER-01 evaluates the acceptance criteria and records the evidence separately.
Closing the work
The final state, accepted build and approval source may be difficult to recover later.
Written client acceptance stays in project correspondence and Task 01 references it before the work item is closed. Deployment remains a separate action.
What it improved
- Less dependence on one long conversation or one person’s memory
- Clearer limits on what the agent may decide and when it must stop
- Recoverable reasons for important decisions and later changes
- A direct path from requirements to work, evidence, acceptance and closure
- Less project knowledge loaded at once when the agent starts from the work item and follows only relevant references
What it cost
- Time spent clarifying intent and reviewing lasting project knowledge before implementation
- Ongoing maintenance when a decision, requirement or operating instruction changes
- More reading and prompt input than an unstructured one-shot task may need
- A risk of ceremony or stale documentation if records are copied mechanically rather than kept useful
- Human attention is still required for decisions outside the agent’s decision authority, evidence review and acceptance
Project knowledge and token use in this walkthrough
The 6,100-token figure below covers only the example messages written by the user. It is not an estimate for the whole workflow. A complete agent run also processes project records, repository files, generated code, command and test output, agent responses, revisions and verification evidence—often repeatedly across tool calls.
These three measurements use the actual prompt text on this page and a rough four-characters-per-token heuristic. They exclude every other part of the agent run and therefore must not be presented as total usage.
Estimated complete ADEL-guided workflow
A planning range for carrying this fictional project through all ten parts with a capable coding agent. It includes input project knowledge, agent output, relevant tool results, generated records and code, implementation revisions and verification. It is not a measured run or a billing estimate.
Potential additional ad hoc back-and-forth
A scenario estimate if missing or inconsistent project knowledge causes each of the five avoidable loops below once. Some projects will avoid these loops; others may repeat them.
Indicative total under that scenario
The complete-workflow range plus the estimated avoidable loops, assuming the ad hoc project still performs the same underlying delivery work. This illustrates exposure to rework; it does not predict that every project without ADEL will use this amount.
How the complete-workflow estimate was built
Questions and answers, intent note, product brief, requirements, review and refinement.
Project principles, option analysis, blueprint, ADR-001, approval evidence and review.
Source inspection, AGENTS.md, work-breakdown recommendation, Task 01 and review.
Scaffolding, dependency and configuration work, file inspection, code generation, tests, command output, debugging and status reporting.
Provider inspection, options, human decision, ADR-002, blueprint and task updates, and affected reimplementation.
Evidence collection, failed-check correction, VER-01, client-acceptance reference and task closure.
- Ten substantive agent sessions or equivalent restarts, corresponding to the ten walkthrough parts
- Selective loading of the work item and relevant sources of truth rather than the entire repository every time
- One small five-page Next.js application with one form integration, not a large production system
- One important design conflict, one verification defect and the revisions already shown in the walkthrough
- Normal command output is summarized or filtered; enormous raw build logs are not repeatedly added to the agent input
Downloading Next.js packages does not itself consume model tokens: the package bytes move between the registry and the development environment. Tokens are used when the agent writes commands, reads package metadata or generated files, receives installation and build output, diagnoses errors, and changes the project in response.
Potential back-and-forth without consistent project knowledge
The following scenario produces the additional 180k–570k range shown above. It assumes each loop happens once; it is not a fixed penalty for working without ADEL.
Several later sessions reload broad history or ask the person to restate scope, decisions and constraints.
Additional exchanges are needed because success, exclusions or decision authority were not settled in a usable source.
The agent implements a plausible but unapproved scope or submission path, then must inspect and change it again.
Participants revisit alternatives, approvers and reasons because the original choice was left only in conversation.
Checks are rerun or evidence is rebuilt because the evaluated state and expected proof were not agreed beforehand.
ADEL is not guaranteed to use fewer tokens. On a clear one-session change with no ambiguity or rework, an ad hoc approach may use less because it records less project knowledge. ADEL may save tokens when those records prevent repetition or a wrong turn. The ranges above are deliberately broad because model, context-window strategy, caching, tool verbosity and retry count can change usage substantially.
Start with the clearly scoped work item, load the sources it directly references and follow additional links only when the current decision or check needs them. The goal is enough consistent project knowledge—not the largest possible prompt and not the smallest possible token count.
Copy the reasoning, not the file list.
This walkthrough used a product brief, Project principles, a System blueprint, agent instructions, one clearly scoped work item, decision records for important choices, implementation and tests, and a verification record. These are the records chosen for this example, not a required ADEL package. Direct references were sufficient for traceability, so this project did not add a separate work-breakdown file or central traceability table.
Product intent and requirements · governing principles · approved design · agent instructions · one clearly scoped work item · decision records where an important choice arose · implementation and tests · verification record
May additionally require deeper system design, formal risk or security records, API and interface contracts, operational documentation, controlled release evidence or controlled traceability—when the system’s risk, legal, contract or audit requirements, complexity or operating model creates that need
No separate risk record, API contract, operational runbook or release-evidence record was added here because this walkthrough did not create a need for one. A real project’s specialist, organizational, legal, contract or audit requirements may require additional records regardless of its size.
The Framework defines the responsibility. Create a separate record only when it adds value.
For this project, ADEL’s clearest gain is not the number of files or an assumed token saving. It is the recoverable chain from intent to decision authority, design, bounded work, implementation, discovery, verification and acceptance. The corresponding cost is maintaining that chain at a level proportionate to the project.
A vague idea became a complete, verified and accepted production-ready website, supported by the project knowledge needed to understand and maintain it.
The agent did a substantial amount of the work. It proposed designs, made local implementation choices within its decision authority, produced tests and evidence and reported a conflict when it reached a decision it was not allowed to make. It did not silently redefine scope, Governance or System Design, and it did not convert its own completion claim into acceptance. That division is the point: enough decision authority to be useful, clear conditions for stopping and important decisions remaining with their approvers.