ccpe-system/model-index/model-usage-map.md

317 lines
4.0 KiB
Markdown

# Model Usage Map
## 1. Purpose
This file tracks where models are used.
It answers:
```text
Which Agents use this model?
Which Skills execute this model?
Which Runtimes orchestrate this model?
Which Prompt Cards embed this model?
Which Model Cards are unused?
Which models have many dependents and require careful versioning?
```
Usage mapping makes model maintenance possible.
If a model changes, this file helps identify what else should be reviewed.
## 2. Usage Categories
Track usage across:
```text
Agents
Prompt Cards
Skills
Runtimes
Committees
Reports
Templates
Knowledge Workflows
```
## 3. Mapping Format
Use this format:
```md
## {model-id}
### Model Name
### Status
### Prompt Cards
### Agents
### Skills
### Runtimes
### Committees
### Knowledge Workflows
### Notes
```
## 4. Initial Usage Map
## cognitive-imaging
### Model Name
认知显影 / Cognitive Imaging
### Status
```text
active
```
### Prompt Cards
```text
agents/lite/cognitive-imaging-practitioner.prompt.md
```
### Agents
```text
TBD
```
### Skills
```text
TBD
```
### Runtimes
```text
TBD
```
### Committees
```text
Article Review Committee (future candidate)
Modeling Committee (future candidate)
```
### Knowledge Workflows
```text
article-review-workflow
cognitive-model-pressure-test
```
### Notes
Currently active as:
```text
model-cards/intermediate/cognitive-imaging-model.md
agents/lite/cognitive-imaging-practitioner.prompt.md
```
Deferred future structure, only if scenario requires it:
```text
CCPE-Skill for Codex invocation
CCPE-Agent for stable committee membership
CCPE-Runtime node for article review committee orchestration
```
## giant-cognition
### Model Name
巨人认知 / Giant Cognition
### Status
```text
candidate
```
### Prompt Cards
```text
agents/lite/giant-cognition.prompt.md
```
### Agents
```text
TBD
```
### Skills
```text
TBD
```
### Runtimes
```text
TBD
```
### Committees
Potential:
```text
Review Committee
```
### Knowledge Workflows
```text
article-review-workflow
argument-review-workflow
deep-writing-review
```
### Notes
Currently documented as:
```text
model-cards/applied/giant-cognition-model.md
agents/lite/giant-cognition.prompt.md
```
Layer decision:
```text
CCPE-Lite: yes
Model Card: yes
CCPE-Skill: deferred
CCPE-Agent Spec: deferred
CCPE-Runtime: deferred
```
The model is used as an application-oriented cognitive review model. It should not yet be expanded into a formal Agent Spec or Runtime until the review committee scenario is clearer.
## cognitive-prism
### Model Name
认知棱镜 / Cognitive Prism
### Status
```text
candidate
```
### Prompt Cards
```text
TBD
```
### Agents
```text
TBD
```
### Skills
```text
TBD
```
### Runtimes
```text
TBD
```
### Committees
Potential:
```text
Review Committee
```
### Knowledge Workflows
```text
TBD
```
### Notes
Requires source review and Model Mining.
## 5. Usage Review Checklist
When adding usage, check:
```text
Is this model actually used, or merely related?
Is it embedded directly in a Prompt Card?
Is it referenced by an Agent Spec?
Is it executed by a Skill?
Is it orchestrated by a Runtime?
Is the usage active, candidate, or planned?
```
## 6. Maintenance Rules
When a Model Card changes:
```text
1. Check related Prompt Cards.
2. Check related Agent Specs.
3. Check related Skills.
4. Check related Runtimes.
5. Update usage notes.
6. Mark affected artifacts for review if needed.
```
## 7. High-Impact Model Rule
If many artifacts depend on a model, mark it as high-impact.
High-impact models require:
```text
Careful versioning
User approval before major changes
Migration notes
Affected artifact review
```
## 8. Unused Model Rule
If a model has no usage, decide whether it is:
```text
A theoretical asset
A future candidate
A deprecated model
An extraction artifact
A model awaiting Skill or Agent conversion
```
Do not delete unused models automatically.
## 9. Final Rule
A model library becomes powerful when models are not only stored, but connected.
Usage mapping turns isolated ideas into operational cognitive infrastructure.