144 lines
2.6 KiB
Markdown
144 lines
2.6 KiB
Markdown
# Workbench Upgraded
|
|
|
|
## 1. Purpose
|
|
|
|
This directory stores upgraded draft artifacts before they are promoted to canonical directories.
|
|
|
|
Files here are improved but not yet canonical.
|
|
|
|
Use this directory for:
|
|
|
|
```text
|
|
Refactored prompts
|
|
Upgraded Agent drafts
|
|
Extracted Skill drafts
|
|
Runtime drafts
|
|
Model Card drafts
|
|
Lite prompt drafts
|
|
Migration outputs
|
|
```
|
|
|
|
## 2. Typical Use
|
|
|
|
After Auditor Mode and Refactor Mode, place generated draft artifacts here.
|
|
|
|
Examples:
|
|
|
|
```text
|
|
workbench/upgraded/cognitive-imaging-specialist.prompt.md
|
|
workbench/upgraded/cognitive-imaging-specialist.agent.md
|
|
workbench/upgraded/cognitive-imaging.skill.md
|
|
workbench/upgraded/cognitive-imaging-model.md
|
|
```
|
|
|
|
After user review, promote these to canonical locations:
|
|
|
|
```text
|
|
agents/lite/
|
|
agents/agent-specs/
|
|
skills/
|
|
runtimes/
|
|
model-cards/
|
|
model-index/
|
|
```
|
|
|
|
## 3. Draft Status
|
|
|
|
All files in this directory should be treated as:
|
|
|
|
```text
|
|
draft
|
|
```
|
|
|
|
unless explicitly promoted.
|
|
|
|
Do not assume these files are final.
|
|
|
|
## 4. Recommended Metadata
|
|
|
|
```yaml
|
|
---
|
|
artifact_type:
|
|
source_path:
|
|
created:
|
|
updated:
|
|
status: draft
|
|
target_canonical_path:
|
|
review_status: needs-user-review
|
|
based_on: CCPE System
|
|
---
|
|
```
|
|
|
|
## 5. Promotion Rules
|
|
|
|
A draft may be promoted when:
|
|
|
|
```text
|
|
User has reviewed the file.
|
|
Classification is correct.
|
|
Output format is usable.
|
|
Model fidelity is preserved.
|
|
Human decision gates are clear.
|
|
No major structural blockers remain.
|
|
Target canonical path is confirmed.
|
|
```
|
|
|
|
## 6. Promotion Examples
|
|
|
|
```text
|
|
workbench/upgraded/cognitive-imaging-specialist.prompt.md
|
|
→ agents/lite/cognitive-imaging-specialist.prompt.md
|
|
|
|
workbench/upgraded/cognitive-imaging-specialist.agent.md
|
|
→ agents/agent-specs/cognitive-imaging-specialist.agent.md
|
|
|
|
workbench/upgraded/cognitive-imaging.skill.md
|
|
→ skills/cognitive/cognitive-imaging.skill.md
|
|
|
|
workbench/upgraded/cognitive-imaging-model.md
|
|
→ model-cards/intermediate/cognitive-imaging-model.md
|
|
```
|
|
|
|
## 7. Do Not Store Here
|
|
|
|
Do not store raw source files here.
|
|
|
|
Do not store analysis reports here.
|
|
|
|
Use:
|
|
|
|
```text
|
|
workbench/raw/
|
|
```
|
|
|
|
for raw source.
|
|
|
|
Use:
|
|
|
|
```text
|
|
workbench/analysis/
|
|
```
|
|
|
|
for diagnosis and planning.
|
|
|
|
## 8. Upgrade Bundle Pattern
|
|
|
|
For complex upgrades, group files by artifact name:
|
|
|
|
```text
|
|
workbench/upgraded/cognitive-imaging/
|
|
├── cognitive-imaging-specialist.prompt.md
|
|
├── cognitive-imaging-specialist.agent.md
|
|
├── cognitive-imaging.skill.md
|
|
├── cognitive-imaging-model.md
|
|
└── cognitive-imaging-upgrade-report.md
|
|
```
|
|
|
|
This pattern is useful for self-contained model-backed agents.
|
|
|
|
## 9. Final Rule
|
|
|
|
This directory is the staging area.
|
|
|
|
Nothing here is canonical until the user promotes it.
|