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 |
|
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.yamlfor structured consumer repository alignment reviews. - Added
infospace/agent/templates/consumer-alignment-workplan.template.mdfor repo-local alignment workplans. - Registered the review kit, schema, and template as indexed artifacts and retrieval briefs.
- Added
review-kitandalignment-templateCLI commands plus/review-kitand/alignment-templateAPI 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.