---
schema: formation.doc/v0.1
kind: doc
visibility: public
canonical_url: https://topologyindex.com/docs/schemas/domain_findings/v0.1.md
document_kind: domain_findings
document_schema: formation.domain_findings/v0.1
path: /docs/schemas/domain_findings/v0.1.md
product_api_version: v1
schema_version: v0.1
title: formation.domain_findings/v0.1
---

# formation.domain_findings/v0.1

Frontmatter fields of a `domain_findings` page. This service publishes these pages and never
accepts one, so the schema is a promise about what it serves: its tests check every page
against it. Prose in the body explains; the frontmatter is what to read.

## Fields

- `schema` (required): exactly `formation.domain_findings/v0.1`
- `kind` (required): exactly `domain_findings`
- `visibility` (required): exactly `public`
- `path` (required): resource path, pattern `^\/[A-Za-z0-9._~/-]{0,255}$`, at most 256 characters
- `canonical_url` (required): https URL, pattern `^https:\/\/[A-Za-z0-9.-]+(?:\/\S*)?$`, at most 512 characters
- `product_api_version` (required): API version, pattern `^v\d{1,4}$`, at most 5 characters
- `schema_version` (required): schema version, pattern `^v\d{1,4}\.\d{1,4}$`, at most 11 characters
- `title` (required): title, pattern `^[^\p{Cc}]+$`, at most 200 characters
- `description` (required): description, pattern `^[^\p{Cc}]+$`, at most 400 characters
- `domain` (required): one of `coding`, `research`, `documents`, `reasoning`, `evaluation`, `operations`, `security`. The task domain whose findings this page gives in words.
- `findings` (required): array of 0 to 128 items, each map (fields listed below). Published studies whose findings are tagged with the domain, one entry per source, in pattern vocabulary order of the first pattern page that cites it. Never ordered by direction, and never a count of evidence.
- `findings[].source_id` (required): source identifier, pattern `^(?:arxiv:\d{4}\.\d{4,5}|web:[a-z0-9.-]+(?:\/[A-Za-z0-9._~-]+)+)$`, at most 256 characters. Canonical identifier of the source, as on the pattern pages (`published_findings[].source_id`).
- `findings[].url` (required): https URL, pattern `^https:\/\/[A-Za-z0-9.-]+(?:\/\S*)?$`, at most 512 characters
- `findings[].citations` (required): array of 1 to 24 items, each map (fields listed below). Each pattern page that cites the source with a finding tagged with the domain.
- `findings[].citations[].pattern` (required): null or one of `single_agent`, `fan_out`, `map_reduce`, `independent_workers`, `lane_swarm`, `supervisor`, `planner_worker`, `role_pipeline`, `hierarchical_delegation`, `blackboard`, `shared_ledger`, `mailbox_network`, `implement_review`, `critic_loop`, `council`, `debate`, `dynamic_spawning`, `coordinator_election`, `adaptive_routing`, `tree_search`, `architecture_search`, `successor_handoff`, `signed_coordination`. The pattern page the finding is filed under; null for a general finding about multi-agent systems on `/patterns/index.md`.
- `findings[].citations[].direction` (required): one of `helped`, `no_clear_gain`, `hurt`, `mixed`, `not_tested`. How that pattern fared against `compared_against`, as the source reports it: `helped`, `no_clear_gain`, `hurt`, `mixed`, `not_tested`, defined at `/docs/schemas/pattern/v0.1.md`.
- `findings[].citations[].compared_against` (required): comparison, pattern `^[^\p{Cc}]+$`, at most 200 characters
- `hostile_input` (optional): array of 0 to 128 items, each map (fields listed below). On the security pages only: studies of attacks on multi-agent systems through the content agents read. A risk to weigh, not a finding about a pattern doing security work.
- `hostile_input[].source_id` (required): source identifier, pattern `^(?:arxiv:\d{4}\.\d{4,5}|web:[a-z0-9.-]+(?:\/[A-Za-z0-9._~-]+)+)$`, at most 256 characters
- `hostile_input[].url` (required): https URL, pattern `^https:\/\/[A-Za-z0-9.-]+(?:\/\S*)?$`, at most 512 characters
- `hostile_input[].citations` (required): array of 1 to 24 items, each map (fields listed below)
- `hostile_input[].citations[].pattern` (required): null or one of `single_agent`, `fan_out`, `map_reduce`, `independent_workers`, `lane_swarm`, `supervisor`, `planner_worker`, `role_pipeline`, `hierarchical_delegation`, `blackboard`, `shared_ledger`, `mailbox_network`, `implement_review`, `critic_loop`, `council`, `debate`, `dynamic_spawning`, `coordinator_election`, `adaptive_routing`, `tree_search`, `architecture_search`, `successor_handoff`, `signed_coordination`
- `hostile_input[].citations[].direction` (required): one of `helped`, `no_clear_gain`, `hurt`, `mixed`, `not_tested`
- `hostile_input[].citations[].compared_against` (required): comparison, pattern `^[^\p{Cc}]+$`, at most 200 characters
- `domain_page` (required): resource path, pattern `^\/[A-Za-z0-9._~/-]{0,255}$`, at most 256 characters. The domain page (the lens) these findings belong to.
- `pattern_index` (required): resource path, pattern `^\/[A-Za-z0-9._~/-]{0,255}$`, at most 256 characters