noa-summary-udm¶
noa-summary-udm0.1.0noneTags: noa notice-of-award grant-award-summary post-award compliance financial udm structured-extraction json
Audience: sponsored-programs-staff, post-award-teams, ingest-pipelines
Manifestations in repo: prompt.md
JSON extraction contract for a federal Notice of Award (NoA). Extracts award
identification, key personnel and federal contacts, financial terms, periods of
performance, reporting deadlines, and compliance/administrative obligations into
a single structured JSON object (see schema.json).
- Input: full text of a federal Notice of Award / agreement.
- Output: one JSON object conforming to
schema.json(no prose). - Contract scope: repo-local, UDM-aligned. Not the shared
ui-insight/AI4RA-UDMcontract.
The end-user-facing Markdown Grant Award Summary is produced by the
workflows/noa-summary Vandalizer workflow, which
reads the same source document. This component is the JSON-emitting contract for
tooling and evaluation.
See prompt.md for the extraction prompt and CHANGELOG.md
for version history.
Contract scope¶
-
Output format:
json_object -
Contract scope:
shared_udm_semantics_repo_local_schema -
Validation surfaces:
json_schema -
Schema entrypoints:
# -
Notes: Repo-local Notice-of-Award summary contract. Award identification, key personnel and federal contacts, financial terms, periods of performance, reporting deadlines, and compliance/administrative obligations. Scalars resolve cleanly to UDM Award and Personnel; the summary shape itself is repo-local.
-
Machine-readable catalog entry:
component_catalog.json
Triad integration¶
-
UDM alignment:
shared_udm_semantics_repo_local_schema— award_number and pi_name resolve to UDM Award.Federal_Award_ID and Personnel.Full_Name; financial scalars feed UDM AwardBudget; the five-part summary shape is repo-local. -
Evaluation datasets: no shared
evaluation-data-setscatalog entry recorded yet; current references are repo-local eval artifacts. -
Harness notes: Validate JSON outputs against schema.json. The companion top-level workflows/noa-summary Vandalizer workflow implements a five-part Markdown Grant Award Summary deliverable from the same source document via prompt_inline tasks; this component's prompt.md is the JSON contract.
Prompt body¶
Source: prompt.md.
Show prompt
NOA Summary — UDM JSON¶
Purpose: Extract award identification, key personnel and federal contacts, financial terms, periods of performance, reporting deadlines, and compliance/administrative obligations from a federal Notice of Award (NoA) into a single structured JSON object that downstream tooling can use to drive a post-award grant award summary.
Expected input: Full text of a federal Notice of Award / agreement.
Expected output: A single JSON object that validates against
schema.json. No prose, no markdown outside the JSON.
When to use this contract¶
Use this contract when a machine-readable extraction of a Notice of Award is
needed — e.g. to populate a post-award record, drive a reporting calendar, or
feed an evaluation harness. The end-user-facing Markdown deliverable is produced
by the workflows/noa-summary Vandalizer workflow, which reads the same source
document; this component is the JSON-emitting contract used by tooling.
Rules¶
- Extract every fact from the NoA itself. Quote dollar amounts and dates
verbatim. Never invent values, names, or phone numbers.
- The project lead may appear under any PI synonym (PI, Contact PI, Project
Director, PD, Grantee Project Director, Recipient Project Manager, RPM).
- Use
nullfor any field the document does not state.
Output¶
Emit exactly one JSON object conforming to schema.json. No preamble, no
markdown fences.
Output schema¶
Source: schema.json.
Show schema.json
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "NOA Summary (UDM)",
"description": "Structured extraction of a federal Notice of Award for a post-award grant award summary.",
"type": "object",
"additionalProperties": false,
"properties": {
"award_number": {
"type": [
"string",
"null"
],
"description": "Federal Award Identification Number (FAIN) / award number."
},
"agency": {
"type": [
"string",
"null"
],
"description": "Awarding agency / institute."
},
"program_title": {
"type": [
"string",
"null"
]
},
"award_type": {
"type": [
"string",
"null"
],
"description": "New / Renewal / Continuation / Revision."
},
"is_rd": {
"type": [
"boolean",
"null"
],
"description": "Whether the award is research & development."
},
"pi_name": {
"type": [
"string",
"null"
],
"description": "Principal Investigator (any PI synonym)."
},
"federal_contacts": {
"type": "array",
"description": "Named federal/administrative contacts (program officer, grants management officer, authorized official).",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"role": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
}
},
"required": [
"role"
]
}
},
"total_federal_award_amount": {
"type": [
"string",
"null"
]
},
"current_budget_period_amount": {
"type": [
"string",
"null"
]
},
"direct_costs": {
"type": [
"string",
"null"
]
},
"indirect_costs": {
"type": [
"string",
"null"
]
},
"indirect_rate_and_base": {
"type": [
"string",
"null"
]
},
"cost_sharing": {
"type": [
"string",
"null"
]
},
"current_budget_period": {
"type": [
"string",
"null"
],
"description": "Start/end dates of the current budget period."
},
"total_project_period": {
"type": [
"string",
"null"
],
"description": "Start/end dates of the total project period."
},
"future_year_funding": {
"type": [
"string",
"null"
]
},
"financial_restrictions": {
"type": "array",
"items": {
"type": "string"
}
},
"reporting_requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"critical_deadlines": {
"type": "array",
"items": {
"type": "string"
}
},
"prior_approval_requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"compliance_requirements": {
"type": "array",
"items": {
"type": "string"
}
},
"special_terms_and_conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"subawards_included": {
"type": [
"boolean",
"null"
]
},
"partner_institutions": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"award_number",
"agency",
"pi_name",
"total_federal_award_amount",
"total_project_period"
]
}
Changelog¶
Source: CHANGELOG.md.
All notable changes to this component are documented here. Versions follow
semver and match the version in prompt.md frontmatter.
0.1.0 — 2026-07-15¶
- Initial NOA Summary UDM extraction contract: award identification, key
personnel and federal contacts, financial terms, periods of performance,
reporting deadlines, and compliance/administrative obligations. Companion to
the
workflows/noa-summaryVandalizer workflow.