{
  "schema_version": 1,
  "title": "IT practice assets",
  "version": "1.0",
  "edition": "September 2026",
  "catalogue_url": "https://architectureportal.org/downloads/architecture-practice/1.0/catalogue.json",
  "edition_url": "https://architectureportal.org/downloads/architecture-practice/1.0/edition.md",
  "groups": [
    {
      "key": "governance",
      "title": "Generic governance assets for IT",
      "page_url": "https://architectureportal.org/assets/governance"
    },
    {
      "key": "delivery-qa",
      "title": "Generic delivery and QA assets",
      "page_url": "https://architectureportal.org/assets/delivery-qa"
    },
    {
      "key": "support",
      "title": "Generic support assets",
      "page_url": "https://architectureportal.org/assets/support"
    }
  ],
  "assets": [
    {
      "id": "AP-DQA-01",
      "category": "delivery-qa",
      "title": "Requirements versus plans",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Find requirements that a delivery plan omits, changes or cannot yet substantiate.",
      "search_terms": [
        "requirement coverage",
        "plan alignment",
        "gap analysis",
        "traceability matrix"
      ],
      "asaf_aspects": [
        "Purpose",
        "Process",
        "Information",
        "Systems",
        "Management"
      ],
      "process_areas": [
        "Visioning",
        "Transforming",
        "Governing"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Requirements and accepted scope at a stated version.",
        "Delivery plan, design, backlog and dependencies.",
        "Proposed acceptance checks, constraints and decision owners."
      ],
      "expected_outputs": [
        "Coverage table: requirement/source; planned work; dependency; proposed check; coverage finding; open decision/owner.",
        "A short list of contradictions, omissions and extra scope."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/delivery-qa#requirements-versus-plans",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-dqa-01-requirements-versus-plans.md"
    },
    {
      "id": "AP-DQA-02",
      "category": "delivery-qa",
      "title": "Meaningful tests",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Choose checks that can reveal a consequential failure in the proposed change.",
      "search_terms": [
        "test strategy",
        "regression tests",
        "acceptance tests",
        "risk based testing",
        "test evidence"
      ],
      "asaf_aspects": [
        "Systems",
        "Metrics",
        "Technology",
        "Security"
      ],
      "process_areas": [
        "Transforming",
        "Governing"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Change, affected requirements/contracts and identified failure risks.",
        "Existing checks, results and source/build/test identities.",
        "Execution environment and practical limits."
      ],
      "expected_outputs": [
        "Check plan: risk; requirement; level; input; expected result; decisive failure; relevant identity; retained/new result.",
        "Untested risks and why the chosen checks are proportionate."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/delivery-qa#meaningful-tests",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-dqa-02-meaningful-tests.md"
    },
    {
      "id": "AP-DQA-03",
      "category": "delivery-qa",
      "title": "Independent review",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Challenge a proposed change against its requirements and accepted decisions.",
      "search_terms": [
        "peer review",
        "PR review",
        "pull request review",
        "clean context review",
        "second review"
      ],
      "asaf_aspects": [
        "Management",
        "Systems",
        "Security",
        "Information"
      ],
      "process_areas": [
        "Governing",
        "Transforming"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Change/diff at an identified revision.",
        "Requirements, accepted decisions, contracts and relevant check results.",
        "Reviewer remit, scope and material excluded from the review."
      ],
      "expected_outputs": [
        "Prioritised findings with locations and source references, or a scoped no-findings statement.",
        "Coverage, uncertainties and questions for the original author/reviewer."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/delivery-qa#independent-review",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-dqa-03-independent-review.md"
    },
    {
      "id": "AP-DQA-04",
      "category": "delivery-qa",
      "title": "Explicit execution/result state",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Describe what was requested, attempted and established without hiding incomplete or unknown outcomes.",
      "search_terms": [
        "execution status",
        "result status",
        "unknown outcome",
        "pending work",
        "receipt",
        "completion reporting"
      ],
      "asaf_aspects": [
        "Systems",
        "Information",
        "Technology",
        "Management"
      ],
      "process_areas": [
        "Transforming",
        "Operating",
        "Governing"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Task/operation identity, target, input versions and authority.",
        "Execution records, responses, receipts and current-state observations.",
        "Contract for acceptance, status lookup, retry and reconciliation."
      ],
      "expected_outputs": [
        "State record: operation/input identity; intended outcome; attempts; observed result; accepted result; unresolved state; next permitted check.",
        "Distinct local, hosted, deployed and published labels where relevant."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/delivery-qa#explicit-execution-result-state",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-dqa-04-explicit-execution-result-state.md"
    },
    {
      "id": "AP-GOV-01",
      "category": "governance",
      "title": "Evidence/principle comparison",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Compare a proposed IT change with the principles that actually apply to it.",
      "search_terms": [
        "principle check",
        "policy comparison",
        "architecture conformance",
        "traceability"
      ],
      "asaf_aspects": [
        "Management",
        "Purpose",
        "Security",
        "Systems"
      ],
      "process_areas": [
        "Governing",
        "Transforming"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Proposed change and scope.",
        "Accepted principles, their owners and applicability.",
        "Design records, configuration or test results with versions.",
        "Existing exceptions and the person authorised to decide."
      ],
      "expected_outputs": [
        "Comparison rows: principle/version; applicability; proposal location; source/reference; finding; limitation; proposed response; decision owner.",
        "An explicit list of unresolved questions and exceptions. No generated approval."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/governance#evidence-principle-comparison",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-gov-01-evidence-principle-comparison.md"
    },
    {
      "id": "AP-GOV-02",
      "category": "governance",
      "title": "Ownership",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Establish who owns the work, the information and the decisions affected by an IT change.",
      "search_terms": [
        "responsibility",
        "decision rights",
        "authority map",
        "escalation"
      ],
      "asaf_aspects": [
        "Structure",
        "Management",
        "Information",
        "Supplier"
      ],
      "process_areas": [
        "Governing",
        "Operating",
        "Transforming"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Service scope, components, dependencies and affected information.",
        "Recorded responsibilities, delegated authority and supplier commitments.",
        "The particular decision or operational action under consideration."
      ],
      "expected_outputs": [
        "Responsibility map: role/team; responsibility; decision/action; authority source; handover/cover; unresolved issue.",
        "Questions about missing or conflicting authority."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/governance#ownership",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-gov-02-ownership.md"
    },
    {
      "id": "AP-GOV-03",
      "category": "governance",
      "title": "Guidance supersession",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Prepare a change to guidance while retaining the reasons and status of earlier decisions.",
      "search_terms": [
        "ADR",
        "architecture decision record",
        "replace guidance",
        "deprecated decision",
        "superseded decision"
      ],
      "asaf_aspects": [
        "Management",
        "Information",
        "Systems"
      ],
      "process_areas": [
        "Governing",
        "Transforming"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Current guidance/decision and version.",
        "New findings, proposed scope and alternatives.",
        "Decision owner, acceptance procedure and local status/link conventions."
      ],
      "expected_outputs": [
        "Proposed decision/guidance text with source links and unresolved questions.",
        "Transition and communication plan; proposed history/status updates for the authorised owner."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/governance#guidance-supersession",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-gov-03-guidance-supersession.md"
    },
    {
      "id": "AP-GOV-04",
      "category": "governance",
      "title": "Release preparation",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Bring together the information needed to decide whether a particular IT change can enter use.",
      "search_terms": [
        "release readiness",
        "operational readiness review",
        "ORR",
        "service transition",
        "deployment preparation"
      ],
      "asaf_aspects": [
        "Management",
        "Technology",
        "Systems",
        "Security",
        "Structure",
        "Supplier",
        "Finance"
      ],
      "process_areas": [
        "Transforming",
        "Governing",
        "Operating"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Candidate revision, package/configuration identities and target environment.",
        "Acceptance criteria and actual check results tied to their inputs.",
        "Owners, access, cover, suppliers, funding and unfinished work.",
        "Recovery, reconciliation, verification and publication/deployment authority."
      ],
      "expected_outputs": [
        "Readiness table with criterion, expected outcome, actual result, input identity, owner and open decision.",
        "Recovery/reconciliation plan and a recommendation with explicit remaining conditions."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/governance#release-preparation",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-gov-04-release-preparation.md"
    },
    {
      "id": "AP-GOV-05",
      "category": "governance",
      "title": "Warning handling",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Decide what an observed warning means and what response is justified.",
      "search_terms": [
        "alerts",
        "advisory warning",
        "warning triage",
        "exception handling",
        "quota warning"
      ],
      "asaf_aspects": [
        "Management",
        "Technology",
        "Security",
        "Metrics",
        "Supplier"
      ],
      "process_areas": [
        "Operating",
        "Governing"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Warning text, source, time, target and current environment.",
        "Relevant thresholds, service criteria and current state.",
        "Existing response policy, permitted actions and responsible owner."
      ],
      "expected_outputs": [
        "Warning record: exact observation; interpretation; source support; affected outcome; owner; proposed response; verification; unresolved questions."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/governance#warning-handling",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-gov-05-warning-handling.md"
    },
    {
      "id": "AP-SUP-01",
      "category": "support",
      "title": "Acceptance criteria",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Define observable outcomes and the checks needed to accept a service or support change.",
      "search_terms": [
        "service acceptance",
        "definition of done",
        "service level objective",
        "SLO",
        "success criteria"
      ],
      "asaf_aspects": [
        "Metrics",
        "Purpose",
        "Process",
        "Structure",
        "Management"
      ],
      "process_areas": [
        "Visioning",
        "Transforming",
        "Operating",
        "Governing"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Service/change scope, users, operating conditions and intended outcomes.",
        "Quality requirements, failure scenarios and constraints.",
        "Observation sources, check environment and acceptance owner."
      ],
      "expected_outputs": [
        "Acceptance table with expected and actual results in separate fields.",
        "Unresolved targets, missing observations and decision owner."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/support#acceptance-criteria",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-sup-01-acceptance-criteria.md"
    },
    {
      "id": "AP-SUP-02",
      "category": "support",
      "title": "Read-only diagnosis",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Establish the observed service position without changing it during investigation.",
      "search_terms": [
        "incident triage",
        "diagnostic investigation",
        "read only investigation",
        "symptom timeline",
        "observability"
      ],
      "asaf_aspects": [
        "Technology",
        "Systems",
        "Information",
        "Security"
      ],
      "process_areas": [
        "Operating"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Incident/symptom, affected scope and observation window.",
        "Authorised read tools, logs, metrics, traces and case/operation records.",
        "Sensitive-data handling rules, source clocks and collection limits."
      ],
      "expected_outputs": [
        "Source-linked timeline and symptom/current-state summary.",
        "Collection limits, missing observations and proposed next read checks."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/support#read-only-diagnosis",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-sup-02-read-only-diagnosis.md"
    },
    {
      "id": "AP-SUP-03",
      "category": "support",
      "title": "Causal uncertainty",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Assess possible causes while retaining missing information and competing explanations.",
      "search_terms": [
        "root cause analysis",
        "RCA",
        "competing hypotheses",
        "causal reasoning",
        "uncertain diagnosis"
      ],
      "asaf_aspects": [
        "Systems",
        "Technology",
        "Metrics",
        "Information"
      ],
      "process_areas": [
        "Operating",
        "Governing"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Sourced observations and timeline, with environment and clock limits.",
        "Known dependency records, their scope, completeness and date.",
        "Relevant changes, baselines and any prior explanation."
      ],
      "expected_outputs": [
        "Hypothesis table: explanation; supporting/contradicting observations; assumptions; status; check that could distinguish explanations.",
        "A conclusion proportionate to what is established and explicitly unresolved."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/support#causal-uncertainty",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-sup-03-causal-uncertainty.md"
    },
    {
      "id": "AP-SUP-04",
      "category": "support",
      "title": "Runbook validation",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "A runbook records the steps for a known service task. Check whether that procedure is suitable for the actual target and current conditions.",
      "search_terms": [
        "operating procedure",
        "recovery procedure",
        "runbook readiness",
        "remediation validation",
        "stop conditions"
      ],
      "asaf_aspects": [
        "Technology",
        "Systems",
        "Security",
        "Structure",
        "Supplier"
      ],
      "process_areas": [
        "Operating",
        "Governing"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Runbook, edition, owner and intended task.",
        "Current target/environment, configuration and prerequisite observations.",
        "Permitted action scope, dependencies, recovery and verification rules."
      ],
      "expected_outputs": [
        "Step/prerequisite validation with current sources and suitability findings.",
        "Effects, stop conditions, verification/reconciliation plan and unresolved decisions."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/support#runbook-validation",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-sup-04-runbook-validation.md"
    },
    {
      "id": "AP-SUP-05",
      "category": "support",
      "title": "Honest measures",
      "version": "1.0",
      "edition": "September 2026",
      "purpose": "Use measures that describe the outcome and cost relevant to a decision.",
      "search_terms": [
        "measurement definitions",
        "service metrics",
        "cost per outcome",
        "token economics",
        "FinOps",
        "AI productivity",
        "error budget"
      ],
      "asaf_aspects": [
        "Metrics",
        "Finance",
        "Purpose",
        "Management"
      ],
      "process_areas": [
        "Operating",
        "Governing",
        "Transforming"
      ],
      "forms": [
        "human-task-brief",
        "ai-prompt-template"
      ],
      "required_inputs": [
        "Decision and intended outcome.",
        "Raw observations, workload/period, versions and collection method.",
        "Targets, exclusions, costs, review effort and missing data."
      ],
      "expected_outputs": [
        "Measure definitions and observed values with denominators, sources and limitations.",
        "Interpretation tied to the decision, possible distortions and proposed better observations."
      ],
      "permitted_mode": "Read-only analysis and draft outputs",
      "page_url": "https://architectureportal.org/assets/support#honest-measures",
      "download_url": "https://architectureportal.org/downloads/architecture-practice/1.0/ap-sup-05-honest-measures.md"
    }
  ]
}