generated from coulomb/repo-seed
141 lines
4.5 KiB
Markdown
141 lines
4.5 KiB
Markdown
---
|
|
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.
|