ccpe-system/.codex/skills/ccpe-forge/templates/ccpe-model-card.md

479 lines
5.2 KiB
Markdown

---
artifact_type: model-card
model_name:
model_id:
aliases:
author:
version:
created:
updated:
status: candidate
source_material:
model_type:
layer:
related_models:
related_agents:
related_skills:
related_runtimes:
based_on: CCPE System
---
# {Model Name}
## 1. Model Overview
### 1.1 One-Sentence Definition
<!-- Define the model in one precise sentence. -->
### 1.2 Short Description
<!-- Briefly explain what the model does and why it matters. -->
### 1.3 Model Type
Use one or more:
```text
foundational
intermediate
applied
workflow-model
implicit-extracted
candidate
deprecated
```
### 1.4 Layer
Use one or more:
```text
L0: Foundational Assumption
L1: Foundational Model
L2: Intermediate Model
L3: Applied Model
L4: Workflow / Procedure Model
L5: Output / Evaluation Lens
```
## 2. Source Material
### 2.1 Primary Source
```text
title:
path:
author:
date:
source_type:
```
### 2.2 Secondary Sources
```text
-
-
-
```
### 2.3 Extraction Notes
<!-- If extracted from long-form writing, describe how this model was identified. -->
### 2.4 Confidence
Use one:
```text
high
medium
low
```
## 3. Core Problem
<!-- What problem does this model solve? -->
### 3.1 Problem Statement
### 3.2 Why This Problem Matters
### 3.3 What Existing Thinking Misses
<!-- Optional: what does this model see that ordinary analysis misses? -->
## 4. Scope
### 4.1 Applies To
```text
-
-
-
```
### 4.2 Best Used When
```text
-
-
-
```
### 4.3 Non-Scope
```text
-
-
-
```
### 4.4 Boundary Conditions
<!-- Under what conditions does the model stop being reliable? -->
## 5. Core Assumptions
```text
1.
2.
3.
```
For each assumption, clarify:
```text
assumption:
why it matters:
what would challenge it:
```
## 6. Core Mechanism
<!-- This is the heart of the Model Card. -->
### 6.1 Mechanism Summary
<!-- Explain how the model generates explanation, insight, prediction, compression, or evaluation. -->
### 6.2 Key Variables
```text
- variable:
meaning:
role in model:
```
### 6.3 Causal / Generative Logic
<!-- What causes what? What transforms what? What filters what? What compresses what? -->
### 6.4 Model Dynamics
<!-- If the model describes a process, feedback loop, or transformation, describe it here. -->
## 7. Procedure / Operating Logic
### 7.1 Procedure
```text
1.
2.
3.
4.
5.
```
### 7.2 If No Fixed Procedure
<!-- Describe the operating logic instead. -->
### 7.3 Decision Points
```text
- decision point:
criteria:
possible outcomes:
```
## 8. Inputs
### 8.1 Valid Inputs
```text
-
-
-
```
### 8.2 Poor Inputs
```text
-
-
-
```
### 8.3 Required Context
```text
-
-
-
```
## 9. Outputs
### 9.1 Output Types
```text
-
-
-
```
### 9.2 Output Format
<!-- If the model tends to produce a specific kind of report, diagnosis, question set, or compressed structure, describe it here. -->
### 9.3 Good Output Criteria
```text
-
-
-
```
## 10. Failure Modes
### 10.1 Common Failure Modes
```text
1.
2.
3.
```
### 10.2 Overuse Risks
<!-- What happens when this model is applied too broadly? -->
### 10.3 Misuse Risks
<!-- What happens when the model is used incorrectly? -->
### 10.4 Degeneration Pattern
<!-- What does this model become when it loses discipline? -->
Example:
```text
A causal model may degenerate into conspiracy-style explanation if it cannot define what would falsify it.
```
## 11. Falsification Boundary
### 11.1 What Would Challenge This Model?
```text
-
-
-
```
### 11.2 What Should Not Happen If the Model Is Correct?
```text
-
-
-
```
### 11.3 What Is Outside the Model's Explanatory Power?
```text
-
-
-
```
### 11.4 Weak Falsification Warning
<!-- If falsification boundary is currently weak, mark it clearly. -->
## 12. Distinctions
### 12.1 Different From
```text
- nearby concept:
distinction:
```
### 12.2 Not Equivalent To
```text
-
-
-
```
### 12.3 Common Confusions
```text
-
-
-
```
## 13. Related Models
### 13.1 Parent Models
```text
-
-
```
### 13.2 Child Models
```text
-
-
```
### 13.3 Sibling Models
```text
-
-
```
### 13.4 Overlapping Models
```text
-
-
```
### 13.5 Conflicting Models
```text
-
-
```
## 14. Related Agents
```text
- agent_id:
path:
usage:
```
## 15. Related Skills
```text
- skill_id:
path:
usage:
```
## 16. Runtime Usage
```text
- runtime_id:
path:
usage:
```
## 17. Examples
### 17.1 Example Input
```text
```
### 17.2 Model Application
```text
```
### 17.3 Example Output
```text
```
### 17.4 Failure Example
```text
```
## 18. Evaluation Criteria
Use this checklist when judging whether the model was applied well:
```text
Core problem addressed?
Scope respected?
Assumptions made explicit?
Mechanism applied correctly?
Failure modes avoided?
Falsification boundary preserved?
Output useful?
Original conceptual force preserved?
```
## 19. Conversion Opportunities
### 19.1 Possible Skills
```text
-
-
```
### 19.2 Possible Agents
```text
-
-
```
### 19.3 Possible Runtimes
```text
-
-
```
## 20. Version Notes
```text
v0.1:
- Initial candidate Model Card.
```
## 21. Review Status
Use one:
```text
needs-source-check
needs-user-confirmation
needs-scope-review
needs-falsification-boundary
needs-merge-review
reviewed
```
## 22. Open Questions
```text
1.
2.
3.
```