Product guides

Product guides

Practical guides to connect evidence, understand relationships, record intent, and review change.

Start with your project brain, turn evidence into a roadmap and cycles, listen through community feature voting, and ask your project agent for a grounded next step. The architecture guides below help you inspect the system behind those decisions.

A shared example

The guides use an API that delegates authentication to a gateway. The design is acceptable only while the gateway remains the route for all external requests. A later direct route changes that condition.

A small system, five ways to understand it

Follow the relationship.

Fictional example
Gateway to application to databaseThe gateway calls the API. The API reads the database. A public route reaches the API directly.InternetCALLSREADSNEW PUBLIC ROUTEAPI gatewayAuthentication boundaryObservedApplication APIApplication serviceObservedApplication dataPrivate databaseObserved3 SYSTEM ENTITIES · CLOUD EVIDENCE PRESENT

A public route reaches the API directly.

Entities are the things. Relationships explain the system.

Select an entity to read what connects to it. An arrow has a direction and a meaning; it is more than a line between two boxes.

Application API → reads from → Application data

The service handles application requests and reads from the database. Authentication is delegated to the gateway by a human decision.

Evidence
server/database.py:24 · database client
Recorded confidence
96% · code reference and connection configuration agree

Illustrative records and dates only. These controls do not connect sources or change a workspace.

Read the map guide

All records in this example are fictional. Your workspace derives its map from the sources you actually connect and keeps human decisions separate from observed facts.