479 lines
5.2 KiB
Markdown
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.
|
|
```
|