The build journal

From day one.
Still building.

A chronological record of how a small ideation experiment is becoming an AI-native platform — including the foundations and changes of ambition that made the next step possible.

24documented
build days
01 The story so far
01
Day one

From a blank repository to a working ideas product

The first version established the basic loop: capture ideas, develop them with AI, compare possibilities and turn the strongest thinking into a roadmap.

  • Created the application and API structure
  • Built ideas, comparison and roadmap experiences
  • Connected generated API clients
  • Explored early visual directions
The decision was to build the whole learning loop, not just another suggestion box.
02
Day two

Making comparison useful, not just interesting

The focus moved to evidence and decisions: stronger comparison flows, relationship data and results that could leave the system as a useful CSV.

  • Expanded the comparison engine
  • Added CSV export from results
  • Introduced record relationships
  • Regenerated schemas and API clients
A product becomes more credible when users can take the result away and do something with it.
03
Day three

Context, agents and the first real architecture

The ideas tool started becoming a platform. Agents gained clearer responsibilities, comparisons became transitive and context could travel with ideas.

  • Refined chief and ideation agents
  • Added context management
  • Protected graphs from circular failures
  • Documented the architecture and migration
The project stopped looking like one feature and started looking like a system.
04
Measuring the machines

Making AI usage visible

The platform began recording model consumption and exposing usage to administrators.

  • Added AI usage events
  • Captured Anthropic consumption
  • Created usage APIs
  • Extended administration views
Autonomy without measurement is a creative way to lose control of a budget.
05
Organising access

From individual users to real organisations

The system gained organisation membership, audit events and a more repeatable deployment model.

  • Built organisation access
  • Added audit events
  • Expanded workspace navigation
  • Hardened Docker deployment
The platform must know who you are and which hat you are wearing.
06
Richer records

Profiles, attributes and fields that fit the work

Profiles, custom attributes and numeric fields made the model less rigid.

  • Added user profiles
  • Created custom attributes
  • Added numeric inputs
  • Connected profile context
Not everybody’s data looks exactly like yours.
07
Guardrails

Stopping accidental work from disappearing

Editing flows gained draft states and warnings before unfinished changes were discarded.

  • Added unsaved-change guards
  • Connected navigation warnings
  • Clarified save behaviour
  • Made drafts explicit
A tiny warning can save a large amount of inventive vocabulary.
08
Showing the answer

A reusable visualisation layer

A shared presentation model separated the meaning of data from how it was displayed.

  • Created a visualisation library
  • Defined presentation controls
  • Separated data from output
  • Prepared reusable views
The best visualisation makes a complicated relationship obvious.
09
Making views recognisable

Presentation became part of the model

Presentation language and icon treatment made configurable views feel deliberate.

  • Added presentation iconography
  • Aligned view types
  • Improved output cues
  • Prepared multiple modes
Configurable does not have to mean visually anonymous.
10
Context everywhere

Records learned how to explain themselves

Generic headings, formatting and relationship panels gave every object consistent context.

  • Built relationship panels
  • Added context headings
  • Centralised formatting
  • Reduced idea-specific code
A record’s relationships are usually where the story lives.
11
The model editor

Letting the platform describe new products

Model services and drag-and-drop editors replaced more hard-coded ideation behaviour.

  • Added metadata services
  • Built designer foundations
  • Created shared model hooks
  • Refined agent roles
The platform began learning how to assemble an answer.
12
Work that comes back

Workflow notifications arrived

Scheduled notifications made approvals and outstanding work visible and actionable.

  • Created notification scheduling
  • Added notification APIs
  • Built the notification workspace
  • Connected workflow states
A quiet workflow is often not finished; it is merely lost.
13
The platform turn

Replacing fixed screens with configurable building blocks

Objects, fields, collections, relationships and visualisations became reusable platform capabilities rather than code tied to ideas alone.

  • Created metadata-driven object models
  • Built design-system foundations
  • Added organisation and workspace concepts
  • Introduced configurable views
The ambition changed from building one app to building the machinery that can create many useful apps.
14
Designing the work

Views, workflows and a platform people can shape

Page designers, view builders, workflow approvals, notifications and administration moved into the product itself.

  • Built page and view designers
  • Added workflows and approvals
  • Introduced platform blueprints
  • Expanded user and usage administration
Configuration only becomes a product when it is understandable, previewable and safe to change.
15
Today’s direction

Building the organisation that builds the platform

User requests can enter a structured queue and specialist agents can investigate, plan, build and test changes inside a controlled environment.

  • Added scheduled Codex work
  • Separated agent responsibilities
  • Introduced controlled approvals
  • Connected demand to enhancement work
The goal is an organisation of agents with clear jobs, bounded authority and evidence at every hand-off.
16
Opening the workshop

Giving the work a public home — and a safe route back to it

Product Agility gained its public story, a more balanced visual identity and an approval-gated publishing loop that can turn each day’s work into a useful Build Notes update.

  • Created responsive .co.uk and .app holding sites
  • Rebalanced the logo and tuned the branded Poppins typography
  • Put an AI-scheduled daily Build Notes agent live and completed its first scheduled review
  • Published through isolated FTPS with explicit approval required for every release
Automation becomes useful when it knows not only how to publish, but when to stop and ask.
17
Teaching the platform to design

From a one-line idea to a governed blueprint

The Platform Builder learned to turn a short product brief into a compact, reviewable application blueprint — complete with objects, views, relationships and the gaps worth feeding back into the improvement loop.

  • Added AI-assisted brief expansion and blueprint drafting
  • Made generated views, including relationship networks, previewable before they are applied
  • Added validation, reusable templates, sample data and guarded recovery
  • Routed reusable capability gaps into a private Platform Improvement Lab for review
The useful trick is not asking AI to invent a whole product. It is giving it a bounded design job, then making every assumption visible.
18
Giving diagrams a language

Shapes, connectors and meaning — without locking the platform to a notation

The workspace engine gained a shared visual language for diagrams, so people, processes, products, data and architecture can be modelled clearly while the meaning remains portable underneath.

  • Added original shape libraries for everyday work, product, data, organisation, architecture, requirements, ideation and process modelling
  • Separated an object’s semantic type from its chosen shape and presentation icon
  • Translated relationship and cardinality metadata into arrows, diamonds and crow’s-foot connectors
  • Added searchable, scoped shape pickers and editable network diagrams with staged saves
A diagram becomes much more useful when its shapes are not just decoration, but a readable view of the model underneath.
19
Turning the model into a workspace

A process-modelling product built from the platform itself

The generic workspace engine was used to assemble a working process-modelling product, joining a searchable catalogue to record-backed diagrams that can be shaped without creating a separate application stack.

  • Created a reusable workspace blueprint for processes, activities, events and gateways
  • Added a diagram catalogue and a focused canvas for opening one model at a time
  • Enabled drag-and-drop creation or reuse of existing model elements
  • Added floating connectors, record and relationship inspectors, and guarded staged saves
The best proof of a platform is not another platform feature; it is a useful product assembled from the parts already there.
20
Making diagrams behave

From drawing shapes to configuring how work appears

Diagramming moved beyond a fixed canvas: object types gained native or card presentation, configurable icon placement and dedicated inspectors, while conditional forms learned to respond to the record in front of them.

  • Added native and card symbol modes with shape-appropriate proportions
  • Made node size, rotation and icon placement configurable and persistent
  • Added dedicated diagram-inspector forms and conditional field rules
  • Gave both public sites a clean branded browser-tab icon
Visual flexibility is useful when it is still driven by the model, rather than becoming a collection of one-off decoration.
21
From words to diagrams

Letting AI draw inside the rules

The platform gained a permissioned diagram generator that turns a plain-English request into a small, editable model using only the objects, connectors and published diagram types the user is allowed to access.

  • Created a shared catalogue for consistent process-event, activity and gateway notation
  • Added an AI Diagram Generator capability granted per workspace member
  • Constrained one cost-capped model call to allow-listed metadata without sending existing records
  • Used deterministic APIs to save records, relationships and geometry while metering usage
AI becomes easier to trust when it can be creative only inside a vocabulary and permission boundary the platform already understands.
22
Putting work in its place

Pools, lanes and rules that make a process readable

Process diagrams learned about responsibility as well as flow: participants can own lanes, lanes can contain work, and the canvas now protects the difference between a sequence inside a participant and a message crossing between them.

  • Added participant pools and nested responsibility lanes
  • Made containment structural rather than drawing it as another connector
  • Kept sequence flows inside participants and reserved message flows for crossing between them
  • Added canvas controls for creating and removing lanes while preserving the underlying records
A useful process model does more than show what happens next; it makes clear who is responsible when it does.
23
Tidying the canvas

Giving a complicated diagram some manners

The process canvas became a more practical place to work: layouts can be arranged, adjusted and reversed without losing the structure that makes pools, lanes and flows meaningful.

  • Added container-aware automatic arrangement with compact, balanced and spacious options
  • Introduced undo and redo for layout changes
  • Added multi-selection, alignment, distribution and position locking
  • Made process validation and unsaved changes clearer while editing
Automation is most useful when it does the tidying, but still lets you move the furniture afterwards.
24
Testing the whole journey

Giving the platform a customer with a clipboard

A repeatable customer-experience QA run tested the platform as real administrators and members would use it, carrying synthetic work through architecture, ideation, comparisons, diagrams and AI rather than checking each feature in isolation.

  • Ran 17 recorded customer journeys across Enterprise Architecture and Ideation workspaces
  • Created realistic synthetic records, relationships, comparisons and diagrams, then checked that saved work survived refresh and reopening
  • Captured a local evidence library with 20 screenshots and linked results back to a dedicated QA workspace
  • Turned failures into six traceable findings, including missing relationship controls and unreliable AI responses
A platform can pass every small technical check and still trip over the customer’s actual day. The clipboard is there to keep us honest.
02 What comes next

The notes continue as
the platform learns.

New entries will follow the work: what changed, why it mattered and what it taught me about building products with agents.

Visit the platform holding page ↗