1. Understand your system
The objective is to define the smallest complete boundary within which a material outcome can be reconstructed. Start with user and service outcomes, then follow the components that influence them.
1. Describe the service
Record:
- intended and explicitly prohibited uses;
- users, affected parties, and service owners;
- outputs, recommendations, decisions, and external actions;
- the consequences of incorrect output, delay, disclosure, or unintended action;
- expected human review and fallback paths; and
- production environments and operating hours.
Use the system profile as the working record.
2. Draw the execution boundary
Show the main path and control points:
User / channel
→ application and identity
→ prompt / policy / orchestration
→ model
→ retrieval / memory
→ tools / APIs / other agents
→ guardrails and human approval
→ response or external action
→ telemetry pipeline and evidence stores
Include asynchronous work, queues, scheduled jobs, retries, callbacks, and human handovers. These are common places for trace context and accountability to be lost.
3. Inventory changeable artefacts
| Artefact | Minimum information |
|---|---|
| Model | provider, model ID/version, endpoint, parameters, deployment environment |
| Prompt/instruction | stable ID, version/hash, owner, approval status |
| Policy/guardrail | policy ID/version, decision categories, enforcement point |
| Retrieval source | collection/index ID, content owner, classification, refresh process |
| Memory | type, owner, scope, write/read controls, retention |
| Tool/API | tool ID, operation, allowed scope, credentials, side effects |
| Agent | agent ID/version, delegated capabilities, parent/child relationships |
This inventory supports ORF-AGT-12, ORF-AGT-13, and ORF-GOV-03 later in the lifecycle.
4. Map representative journeys
Choose at least:
- a normal successful journey;
- an expected refusal or safe failure;
- a downstream timeout or partial failure;
- a malicious or out-of-scope request; and
- for action-taking systems, an approval, tool execution, and recovery journey.
For each journey, identify the events needed to answer:
- What did the user ask?
- What system version handled it?
- What context or knowledge was used?
- What decisions, refusals, or approvals occurred?
- Which tools ran, under which identity, and with what result?
- What did the user receive, and did any external state change?
5. Identify material failure scenarios
| Failure | Potential impact | Evidence needed |
|---|---|---|
| Incorrect or ungrounded answer | user acts on false information | prompt/output reference, sources, model/prompt version, evaluation label |
| Runaway tool loop | cost, denial of service, repeated external action | task tree, call count, retries, circuit-breaker decision |
| Lost tool response after successful action | duplicated or unknown external state | idempotency key, tool result, callback, retry lineage |
| Sensitive data in output or log | privacy/confidentiality breach | policy decision, detection event, trace reference, access audit |
| Silent regression after change | degraded quality or safety | change record, before/after metrics, rollout cohort |
6. Establish ownership
Assign owners for the service, application, model/prompt, retrieval data, tools, telemetry platform, security/privacy response, operations, and risk acceptance.
Deliverables
- completed system profile;
- architecture and data-flow diagram;
- component and artefact inventory;
- representative journey maps;
- initial failure-scenario list; and
- named owners.
Common mistakes
- treating only the model API as the system boundary;
- omitting human review, asynchronous callbacks, or external side effects;
- using tool names without recording the operations and privileges they expose;
- failing to distinguish model output from the final content shown to the user; and
- assuming existing application logs contain enough context to reconstruct an AI interaction.
Done when: another engineer can use the profile and diagram to follow a user request through every component that materially affects its outcome.
Next: Determine risk and scope