--- id: ITC-WP-0011 type: workplan title: "Canon Consumer Alignment Review Kit" domain: canon repo: info-tech-canon status: finished 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: done 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: done 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: done 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: done 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: done 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. ## Implementation Notes - Added `infospace/agent/review-kit/` with a review kit manifest, workflow, scorecard, and model/standard selection guide. - Added `infospace/schemas/alignment-review.schema.yaml` for structured consumer repository alignment reviews. - Added `infospace/agent/templates/consumer-alignment-workplan.template.md` for repo-local alignment workplans. - Registered the review kit, schema, and template as indexed artifacts and retrieval briefs. - Added `review-kit` and `alignment-template` CLI commands plus `/review-kit` and `/alignment-template` API endpoints. - Added structural validation for required review kit artifacts, phases, scorecard dimensions, model selection surfaces, schema fields, and template sections. - Regenerated agent briefs, indexes, tree views, and validation output.