generated from coulomb/repo-seed
110 lines
2.1 KiB
Markdown
110 lines
2.1 KiB
Markdown
---
|
|
id: ITC-WP-0003
|
|
type: workplan
|
|
title: "Validation Indexes And Generated Views"
|
|
repo: info-tech-canon
|
|
status: planned
|
|
priority: high
|
|
created: "2026-05-23"
|
|
updated: "2026-05-23"
|
|
depends_on_workplans:
|
|
- ITC-WP-0001
|
|
- ITC-WP-0002
|
|
---
|
|
|
|
# ITC-WP-0003 - Validation Indexes And Generated Views
|
|
|
|
## Goal
|
|
|
|
Add repeatable validation, schema stubs, indexes, and generated views so the
|
|
canon can be maintained by humans and consumed by tools.
|
|
|
|
## Intent
|
|
|
|
The first validation pass should be useful before it is complete. Missing
|
|
optional artifacts should be warnings. Broken required paths and manifest
|
|
inconsistencies should fail visibly.
|
|
|
|
## Tasks
|
|
|
|
### T01 - Make targets
|
|
|
|
```task
|
|
id: ITC-WP-0003-T01
|
|
status: planned
|
|
priority: high
|
|
```
|
|
|
|
- Add `make validate`.
|
|
- Add `make index`.
|
|
- Add `make tree`.
|
|
- Add `make agent-briefs`.
|
|
|
|
### T02 - Structural validation
|
|
|
|
```task
|
|
id: ITC-WP-0003-T02
|
|
status: planned
|
|
priority: high
|
|
```
|
|
|
|
- Check required top-level files.
|
|
- Check required `infospace/` directories.
|
|
- Check `canon.yaml` paths.
|
|
- Check `infospace/artifacts/index.yaml`.
|
|
- Warn about missing optional agent briefs, concepts, mappings, and examples.
|
|
|
|
### T03 - Schemas
|
|
|
|
```task
|
|
id: ITC-WP-0003-T03
|
|
status: planned
|
|
priority: high
|
|
```
|
|
|
|
- Add minimal schemas for:
|
|
- standard
|
|
- concept
|
|
- mapping
|
|
- profile
|
|
- assimilation
|
|
- interface card
|
|
- agent brief
|
|
- workplan
|
|
|
|
### T04 - Generated views
|
|
|
|
```task
|
|
id: ITC-WP-0003-T04
|
|
status: planned
|
|
priority: high
|
|
```
|
|
|
|
- Generate `views/by-standard.md`.
|
|
- Generate `views/by-concept.md`.
|
|
- Generate `views/by-profile.md`.
|
|
- Generate `views/by-mapping-target.md`.
|
|
- Generate `views/kernel-overview.md`.
|
|
- Mark generated files clearly.
|
|
|
|
### T05 - Ownership and duplication checks
|
|
|
|
```task
|
|
id: ITC-WP-0003-T05
|
|
status: planned
|
|
priority: medium
|
|
```
|
|
|
|
- Create a first concept ownership index.
|
|
- Detect duplicate concept candidates.
|
|
- Produce a cross-standard import matrix.
|
|
- Report unresolved ownership conflicts.
|
|
|
|
## Acceptance
|
|
|
|
- `make validate` is the primary confidence command.
|
|
- Validation produces machine-readable output.
|
|
- Generated views can be refreshed deterministically.
|
|
- Concept ownership can be inspected even before all concept pages exist.
|
|
|