Generated agentic-system review
Type: types/type-spec.md
The compact public projection of one complete run, published under
kb/agentic-systems/reviews/<system-slug>.md. It is generated from the
run's retained set and pins the set’s manifest, so a reader can verify
and open the exact analysis from a clean checkout. It is not hand-edited:
a correction goes through the method and a new run. Its frontmatter is
what publication checks, with the pin on the manifest.
Frontmatter
| Field | Required | Use |
|---|---|---|
type |
Yes | agentic-systems/types/generated-review.md |
description |
Yes | The overview's description: the synthesizer's one-sentence retrieval description of the system's mechanism and limits |
generated-by |
Yes | analyse-agentic-system |
analysis-run |
Yes | The producing run ID |
source-identity |
Yes | The stable source identity the set's Source register declares |
reviewed-revision |
Yes | The set's reviewed-boundary |
analysis-artifact |
Yes | kb/agentic-systems/reports/retained/<run-id>/ARTIFACT.yaml |
analysis-artifact-sha256 |
Yes | SHA-256 of the retained manifest's bytes |
Body
Code renders the body from the verified overview; no job writes it. It has four parts, in order:
# <System>, the run'ssystemparameter.- One evidence basis line, built from the overview's boundary fields: the evidence tier, the source identity, the reviewed revision and the analysis cutoff.
- The overview's Bounded synthesis, unchanged except for its links.
## Limitationswith the overview's Limitations.
Relative links in the overview resolve inside the set directory, so code
rewrites them to resolve from the review into the retained set under
kb/agentic-systems/reports/retained/<run-id>/. Absolute URLs and
anchor-only links stay as they are. The review therefore makes no claim
the set does not make, and the overview's contract for the Bounded
synthesis (no ranking, adoption advice, system-wide grade or transfer
recommendation) holds for the review too.
Template
---
type: agentic-systems/types/generated-review.md
description: "{one-sentence description}"
generated-by: analyse-agentic-system
analysis-run: AAS-YYYY-MM-DD-system-slug-nn
source-identity: {stable identity}
reviewed-revision: "{revision or capture label}"
analysis-artifact: kb/agentic-systems/reports/retained/{run-id}/ARTIFACT.yaml
analysis-artifact-sha256: "{sha256}"
---
# {System}
Evidence basis: {evidence-tier} analysis of `{source identity}` at `{reviewed-boundary}`, with an analysis cutoff of {analysis-cutoff}.
{The overview's Bounded synthesis, with its links rewritten.}
## Limitations
{The overview's Limitations.}