generated from coulomb/repo-seed
83 lines
1.9 KiB
Markdown
83 lines
1.9 KiB
Markdown
---
|
|
id: ITC-WP-0005
|
|
type: workplan
|
|
title: "Retrieval Agent Briefs And Interface Cards"
|
|
repo: info-tech-canon
|
|
status: planned
|
|
priority: medium
|
|
created: "2026-05-23"
|
|
updated: "2026-05-23"
|
|
depends_on_workplans:
|
|
- ITC-WP-0003
|
|
- ITC-WP-0004
|
|
---
|
|
|
|
# ITC-WP-0005 - Retrieval Agent Briefs And Interface Cards
|
|
|
|
## Goal
|
|
|
|
Make InfoTechCanon retrievable and usable by agents, tools, and consumer
|
|
repositories without requiring them to read every full standard.
|
|
|
|
## Intent
|
|
|
|
The canon needs compact, source-linked retrieval artifacts that preserve the
|
|
important distinctions: Actor vs Subject vs Principal, Organization Role vs
|
|
AccessRole vs CARING role, Policy vs Control vs Evidence, and similar rules.
|
|
|
|
## Tasks
|
|
|
|
### T01 - Agent briefs
|
|
|
|
```task
|
|
id: ITC-WP-0005-T01
|
|
status: planned
|
|
priority: high
|
|
```
|
|
|
|
- Place the global agent brief under `infospace/agent/`.
|
|
- Add per-standard and per-model agent briefs.
|
|
- Validate that agent briefs point back to full source artifacts.
|
|
|
|
### T02 - Retrieval index
|
|
|
|
```task
|
|
id: ITC-WP-0005-T02
|
|
status: planned
|
|
priority: high
|
|
```
|
|
|
|
- Generate `infospace/agent/retrieval-index.md` and a JSON/YAML equivalent.
|
|
- Include stable IDs, canonical paths, summary, owned concepts, imports,
|
|
warnings, and common distinctions.
|
|
|
|
### T03 - Canon Interface Card template
|
|
|
|
```task
|
|
id: ITC-WP-0005-T03
|
|
status: planned
|
|
priority: medium
|
|
```
|
|
|
|
- Define a Canon Interface Card template.
|
|
- Include fields for owned concepts, produced concepts, consumed concepts,
|
|
implemented profiles, mappings, validation expectations, and consumer needs.
|
|
|
|
### T04 - Consumer brief templates
|
|
|
|
```task
|
|
id: ITC-WP-0005-T04
|
|
status: planned
|
|
priority: medium
|
|
```
|
|
|
|
- Create brief templates for user-engine, railiance-fabric, and repo-scoping.
|
|
- Keep actual adoption workplans in those repos.
|
|
|
|
## Acceptance
|
|
|
|
- Agents can start from compact briefs and retrieve full standards when needed.
|
|
- Interface Card templates are ready for first consumers.
|
|
- The retrieval index is generated and validated.
|
|
|