Files
info-tech-canon/workplans/ITC-WP-0011-canon-consumer-alignment-review-kit.md

4.5 KiB

id, type, title, domain, repo, status, priority, created, updated, depends_on_workplans, state_hub_workstream_id
id type title domain repo status priority created updated depends_on_workplans state_hub_workstream_id
ITC-WP-0011 workplan Canon Consumer Alignment Review Kit canon info-tech-canon finished high 2026-05-23 2026-05-23
ITC-WP-0005
ITC-WP-0006
ITC-WP-0007
ITC-WP-0008
ITC-WP-0009
ITC-WP-0010
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

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

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

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

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

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.