diff --git a/workplans/ITC-WP-0011-canon-consumer-alignment-review-kit.md b/workplans/ITC-WP-0011-canon-consumer-alignment-review-kit.md new file mode 100644 index 0000000..87c83c7 --- /dev/null +++ b/workplans/ITC-WP-0011-canon-consumer-alignment-review-kit.md @@ -0,0 +1,123 @@ +--- +id: ITC-WP-0011 +type: workplan +title: "Canon Consumer Alignment Review Kit" +domain: canon +repo: info-tech-canon +status: proposed +priority: high +created: "2026-05-23" +updated: "2026-05-23" +depends_on_workplans: + - ITC-WP-0005 + - ITC-WP-0006 + - ITC-WP-0007 + - ITC-WP-0008 + - ITC-WP-0009 + - ITC-WP-0010 +state_hub_workstream_id: "86df9550-c49b-471d-b472-040a1626efc4" +--- + +# ITC-WP-0011 - Canon Consumer Alignment Review Kit + +## Goal + +Create a reusable review kit that makes it easy for humans and agents to map a +consumer repository against InfoTechCanon models, standards, profiles, +benchmarks, and evaluation packs, then produce repo-local workplans for better +alignment. + +## Intent + +The canon is rich enough for pilot repo reviews, but repeated reviews still +require too much judgment to choose surfaces, ask consistent questions, score +fit, and turn gaps into actionable work. This workplan should make canon use +operational: quick to load, structured to apply, and explicit about which work +belongs in the consumer repo versus which pressure should feed back into the +canon. + +Consumer alignment workplans produced from this kit should live in the consumer +repositories. This repo should provide the reusable kit, schemas, templates, +and service surfaces. + +## Tasks + +### T01 - Review workflow and intake protocol + +```task +id: ITC-WP-0011-T01 +status: todo +priority: high +state_hub_task_id: "0cc9582b-e0c6-4f71-a5b8-51a65a9a741b" +``` + +- Define the standard review flow: repo intake, purpose/context capture, canon + surface selection, mapping, evidence, gap analysis, and workplan proposals. +- Include explicit handling for INTENT, SCOPE, PURPOSES, consumers, evidence, + governance state, and canon pressure. + +### T02 - Alignment review schema and scorecard + +```task +id: ITC-WP-0011-T02 +status: todo +priority: high +state_hub_task_id: "0318d67e-0e67-4ba8-9d6f-a425959b1060" +``` + +- Create a machine-readable alignment review shape for repo assessments. +- Define scorecard dimensions for fit, gaps, conflicts, evidence quality, + implementation priority, canon pressure, and consumer-repo workplan readiness. + +### T03 - Model and standard selection guide + +```task +id: ITC-WP-0011-T03 +status: todo +priority: high +state_hub_task_id: "d7074e43-02c6-4cd3-b4e7-a86271b0c2fa" +``` + +- Create a guide that helps agents choose the relevant canon surfaces for a + repo review. +- Cover the model and standard selection logic for Access Control, + Organization, Governance, Security, Data, Landscape, DevSecOps, Network, + Observability, Task, Tagging, CARING, PURPOSES, and the small-saas profile. + +### T04 - Consumer workplan templates + +```task +id: ITC-WP-0011-T04 +status: todo +priority: high +state_hub_task_id: "fd7d60e9-cf83-41f7-84bc-ece4f66530e9" +``` + +- Provide reusable templates for repo-local alignment workplans. +- Include sections for current fit, target alignment, migration steps, + validation, open questions, and canon feedback. + +### T05 - CLI, JSON, API, and retrieval surface + +```task +id: ITC-WP-0011-T05 +status: todo +priority: medium +state_hub_task_id: "50f29030-4558-4c6b-a60b-16b7c560d153" +``` + +- Expose the review kit through the existing CLI, JSON service functions, + retrieval index, and local API. +- Add validation that required review-kit artifacts, schema fields, scorecard + dimensions, and templates are present. + +## Acceptance + +- A reviewer can start from an unknown repository and quickly determine which + canon surfaces to use. +- Alignment review outputs are structured enough for CLI/API use and for + repeatable agent work. +- Repo-local workplan proposals can be generated without mixing consumer work + into the canon repo. +- Canon pressure is captured explicitly as feedback or proposed canon work, not + as silent standard drift. diff --git a/workplans/index.yaml b/workplans/index.yaml index e99b21f..b30195e 100644 --- a/workplans/index.yaml +++ b/workplans/index.yaml @@ -146,3 +146,22 @@ workplans: - distinct benchmark workspace - Kubernetes RBAC assimilation - CARING validation stress test + + - id: ITC-WP-0011 + title: Canon Consumer Alignment Review Kit + status: proposed + priority: high + path: workplans/ITC-WP-0011-canon-consumer-alignment-review-kit.md + depends_on: + - ITC-WP-0005 + - ITC-WP-0006 + - ITC-WP-0007 + - ITC-WP-0008 + - ITC-WP-0009 + - ITC-WP-0010 + produces: + - repo alignment review workflow + - alignment review schema and scorecard + - model and standard selection guide + - consumer workplan templates + - CLI JSON API review-kit surface