---
id: change/bcquality/182
type: change
title: "#182 Add machine-readable review orchestration contract"
summary: BCQuality now generates a deterministic, machine-readable skill index from review frontmatter and validates review composition through schemas and CI checks.
tier: official
language: en
tags:
  - feature
  - main
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-08T02:05:14.057Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-change: 1
  input_hash: b74967bc5b7a454eae19d6a1250199afd869f064
evidence:
  - kind: code
    url: https://github.com/microsoft/BCQuality/pull/182
    title: "microsoft/BCQuality#182: Add machine-readable review orchestration contract"
    date: "2026-09-15"
    commit: b74967bc5b7a454eae19d6a1250199afd869f064
    t: null
    quote: BC-ALAgents needs a stable contract that defines exactly which review leaves exist and their required order.
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes: []
number: 182
repo: microsoft/BCQuality
source_id: bcquality-prs
url: https://github.com/microsoft/BCQuality/pull/182
kind: pr
base_branch: main
major: null
merged_at: "2026-09-15T08:27:40Z"
author: dayland
author_type: User
community_contribution: false
labels: []
change_class: code
change_kind: feature
behavior_change: false
breaking: false
files:
  count: 8
  additions: 803
  deletions: 3
  al: 2
apps: []
objects_touched: []
objects_unjoined:
  - path: microsoft/skills/review/al-code-review.md
    status: modified
    reason: not-in-snapshot
  - path: skills/do.md
    status: modified
    reason: not-in-snapshot
obsoletions: []
backports: []
fixes_issues: []
work_items: []
systems:
  - development
  - copilot
quote: BC-ALAgents needs a stable contract that defines exactly which review leaves exist and their required order.
joined_against:
  major: null
  commit: null
---

# #182 Add machine-readable review orchestration contract

> BCQuality now generates a deterministic, machine-readable skill index from review frontmatter and validates review composition through schemas and CI checks.

[Pull request](https://github.com/microsoft/BCQuality/pull/182) · merged into `main` on 2026-09-15 by dayland · 8 files (+803 -3), 2 AL · feature · tier official · reviewed (checked by Opus)

## What changed

- Generates versioned skill index from action-skill frontmatter for stable review orchestration
- Adds JSON schemas for skill index and findings reports to define the review contract
- Validates flat review structure including leaf IDs, paths, ordering, and output contracts in CI
- Includes generator tests and repository validation without modifying review knowledge
- Enables BC-ALAgents to consume a stable, mechanically-owned orchestration contract

## AL objects touched

- `microsoft/skills/review/al-code-review.md`: modified, not in the BC? snapshot
- `skills/do.md`: modified, not in the BC? snapshot

## Context

- Systems: development, copilot
- From the description: "BC-ALAgents needs a stable contract that defines exactly which review leaves exist and their required order."

Source: metadata of a merged pull request in microsoft/BCQuality (bcquality): title, labels, changed paths and counts, with a summary in our words. No source text and no description beyond one short quote (D10, D61).