ccpe-system/workbench/raw/README.md

2.8 KiB

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:

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:

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:

Creator Mode
Auditor Mode
Refactor Mode
Model Mining Mode

Use:

Auditor Mode

for existing prompts, agents, skills, or workflows.

Use:

Model Mining Mode

for articles, essays, and model-heavy notes.

Use:

Creator Mode

when a raw file is a creation brief or new artifact request.

Use:

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:

workbench/analysis/

or:

workbench/upgraded/

Do not overwrite the original raw file unless explicitly instructed.

5. Suggested Metadata

When possible, add a short header to raw files:

---
source_type:
author:
created:
uploaded:
status: raw
intended_processing:
notes:
---

Possible source_type values:

old-agent
old-prompt
article
essay
note
workflow
skill-draft
runtime-draft
conversation-export
model-description

Possible intended_processing values:

audit
refactor
model-mining
creation
classification

6. Naming Convention

Use lowercase kebab-case.

Recommended patterns:

{name}-old.md
{name}-v1.md
{name}-source.md
{article-title}.md
{agent-name}-raw.md

Examples:

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:

workbench/raw/
→ workbench/analysis/
→ workbench/upgraded/
→ canonical directory

Canonical directories include:

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:

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.