ccpe-system/workbench/raw/README.md

210 lines
2.8 KiB
Markdown

# Workbench Raw
## 1. Purpose
This directory stores unprocessed source material.
Use it as the intake area for CCPE Forge.
Materials in this directory are not yet canonical.
They may include:
```text
Old prompts
Old CCPE 2.0 agents
Custom GPT / Gem instructions
Agent drafts
Skill drafts
Runtime drafts
Long-form essays
Article drafts
Notes
Model descriptions
Conversation exports
Committee workflow descriptions
```
## 2. Typical Use
Place raw material here before asking CCPE Forge to process it.
Examples:
```text
workbench/raw/cognitive-imaging-specialist-v1.1.md
workbench/raw/zhangliao-red-team-old.md
workbench/raw/modeling-committee-notes.md
workbench/raw/article-cognitive-prism.md
```
## 3. Processing Modes
Raw files may be processed with:
```text
Creator Mode
Auditor Mode
Refactor Mode
Model Mining Mode
```
Use:
```text
Auditor Mode
```
for existing prompts, agents, skills, or workflows.
Use:
```text
Model Mining Mode
```
for articles, essays, and model-heavy notes.
Use:
```text
Creator Mode
```
when a raw file is a creation brief or new artifact request.
Use:
```text
Refactor Mode
```
only after an audit or classification pass.
## 4. Raw File Rules
Raw files should not be edited destructively.
Preserve original versions.
If a file must be cleaned or normalized, create a processed copy in:
```text
workbench/analysis/
```
or:
```text
workbench/upgraded/
```
Do not overwrite the original raw file unless explicitly instructed.
## 5. Suggested Metadata
When possible, add a short header to raw files:
```yaml
---
source_type:
author:
created:
uploaded:
status: raw
intended_processing:
notes:
---
```
Possible `source_type` values:
```text
old-agent
old-prompt
article
essay
note
workflow
skill-draft
runtime-draft
conversation-export
model-description
```
Possible `intended_processing` values:
```text
audit
refactor
model-mining
creation
classification
```
## 6. Naming Convention
Use lowercase kebab-case.
Recommended patterns:
```text
{name}-old.md
{name}-v1.md
{name}-source.md
{article-title}.md
{agent-name}-raw.md
```
Examples:
```text
cognitive-imaging-specialist-v1-1.md
zhangliao-red-team-old.md
giant-cognition-source-essay.md
review-committee-raw-workflow.md
```
## 7. Promotion Path
Raw material usually flows like this:
```text
workbench/raw/
→ workbench/analysis/
→ workbench/upgraded/
→ canonical directory
```
Canonical directories include:
```text
agents/
skills/
runtimes/
model-cards/
model-index/
```
## 8. Do Not Store Here
Do not store finalized canonical artifacts here.
Do not store files that should already live in:
```text
agents/
skills/
runtimes/
model-cards/
model-index/
```
This directory is for intake, not long-term organization.
## 9. Final Rule
Treat this directory as the darkroom entry tray.
Everything here is raw material awaiting classification, extraction, audit, or transformation.