# 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.