← Back to directory

03-idiosyncrasy-engines-workflows-and-mvp.md

archive/architecture-sources/03-idiosyncrasy-engines-workflows-and-mvp.md · 9.1 KB · 2026-11-02 12:48

Idiosyncrasy — Initial Engines, Workflows & MVP

Provisional v0.2 — September 2026

1. Development strategy

Build Idiosyncrasy from the bottom up.

Do not start by building a large collection of disconnected business modules.

First create the reusable platform engines. Then use them to build the first visible business capabilities.

The MVP should prove the platform's central thesis:

> A business can be modelled once, and multiple useful applications and workflows can operate against that model.

2. Foundational data rule

Before the engines below are implemented, the MVP must establish the universal id + type + value primitive. This primitive applies to all persistent and addressable data in the platform.

The MVP must not create separate data models for CRM records, knowledge items, workflows, events, configuration, business-model definitions, UI definitions, relationships or other capability-specific concepts. All such concepts are represented as typed addressable objects using the same primitive.

Type definitions provide structure and validation; relationships provide graph connectivity; engines provide reusable behaviour. This separation is fundamental to Idiosyncrasy's continuous extensibility.

A new business concept should normally require a new type/configuration, not a database schema change. A new engine is justified only when genuinely new reusable execution behaviour is required.

2.1 Retrieval architecture requirement

The MVP must establish structured retrieval as a platform capability, not as an AI-only search feature. The type property of every universal object is a first-class indexing and retrieval dimension. Retrieval must use object type to narrow candidate sets before expensive semantic/vector retrieval.

The retrieval system should also exploit relationships, state, time, provenance, ownership, permissions and other deterministic characteristics where available. Semantic retrieval should operate over the already-constrained candidate set whenever possible.

This prevents the platform from treating the Business Graph as an undifferentiated corpus and provides a scalable path as the number and variety of object types grows.

3. Initial engine priority

Phase 1 — Foundation

Identity/Permission Engine

Required for:

Object/Data Engine

Required for:

Relationship Engine

Required for:

Event Engine

Required for:

Workflow Engine

Required for:

Phase 2 — Knowledge and interface

Knowledge Engine

Required for:

View/UI Engine

Required for:

Content Engine

Required for:

Phase 3 — Business operation

Communication Engine

Required for:

Integration Engine

Required for:

Analytics Engine

Required for:

Phase 4 — Intelligence

AI/Intelligence Layer

Required for:

Evolution/Optimisation Layer

Initially lightweight; progressively expanded.

4. Initial business capabilities

The MVP should not attempt to finish every module.

It should prove a representative cross-section.

Recommended first capabilities:

Business Core

CRM

Workflow

Knowledge

CMS

Marketing

These capabilities must share the same underlying id + type + value objects and engines. No capability may create a parallel foundational data model.

5. Example cross-system workflow

A useful MVP demonstration:

> Website enquiry submitted

1. Form creates Enquiry object. 2. Enquiry relates to Person/Organisation. 3. Event enquiry.received is emitted. 4. Workflow evaluates enquiry. 5. Customer record is created or matched. 6. Sales opportunity is created. 7. Task is assigned. 8. Confirmation email is sent. 9. Interaction is recorded. 10. Knowledge can be attached if useful. 11. Dashboard metrics update. 12. AI may optionally summarise or classify the enquiry.

This single workflow demonstrates the value of a shared platform.

6. Knowledge workflow

Example:

> User uploads a PDF containing the company's pricing policy.

1. Document object is created. 2. Knowledge Engine extracts/indexes content. 3. Knowledge item is associated with the pricing policy. 4. Source and provenance are recorded. 5. AI can answer questions using the authorised knowledge. 6. Workflow rules can reference the policy where appropriate. 7. When the policy changes, the old knowledge remains historically identifiable.

7. Self-optimisation workflow

Example:

1. System observes repeated manual actions. 2. Evolution layer detects a pattern. 3. Pattern is assessed against permissions and thresholds. 4. Idiosyncrasy proposes an optimisation. 5. User reviews the proposed change. 6. User approves or rejects it. 7. If approved, configuration is updated. 8. System measures the result. 9. Outcome becomes part of the business knowledge/history.

8. Future capability creation

Suppose a customer requests equipment servicing.

First ask:

> Can this be represented using existing Objects + Relationships + Workflows + Views?

If yes, create:

plus workflows and views.

No new engine is necessary.

If a large number of businesses later require specialist service scheduling, route optimisation and technician dispatch, a reusable Service Management capability may be introduced.

Only if the underlying behaviour cannot reasonably be supported by existing engines should a new engine be considered.

9. Human-operated first

Every major capability should be capable of operating without AI before AI is deeply integrated into it.

For example:

Marketing

First build:

Then add AI:

CMS

First build:

Then add AI:

Workflows

First build:

Then add AI:

This keeps the platform useful and reliable independently of AI.

10. MVP success criteria

The MVP is successful if it demonstrates that:

1. A business can be represented without bespoke application code. 2. All persistent/addressable platform data uses the same id + type + value primitive. 3. Objects and relationships are reusable across capabilities. 4. Workflows execute deterministically. 5. Knowledge can exist outside structured data. 6. Knowledge can be related to business objects. 7. Interfaces can be generated/configured from the business model. 8. A new capability can be assembled from existing engines. 9. AI can assist without being required. 10. The system can suggest improvements. 11. Configuration remains readable and editable by humans and AI.

11. What not to build initially

Avoid:

The first objective is to prove the platform architecture.

12. Long-term expansion model

The product should grow in this direction:

Foundation → Business Model → Knowledge → Workflows → Interfaces → Core business capabilities → Integrations → AI assistance → Optimisation → New capabilities → New reusable engines where genuinely necessary

The platform becomes more capable for every customer without becoming architecturally dependent on any individual customer.