From 0721f81127e5911f7ca2c72392744bf904a353d7 Mon Sep 17 00:00:00 2001 From: wantsong Date: Mon, 15 Jun 2026 12:02:21 +0800 Subject: [PATCH] rebuild: initialize writing workbench --- README.md | 87 ++++--- WORKBENCH.md | 157 +++++-------- ccpe-consumption/runtime-links.md | 27 --- docs/capability-requests.md | 31 +++ docs/context-handoff.md | 163 ------------- docs/invocation-policy.md | 52 +++++ docs/operating-playbook.md | 216 +++++------------- docs/project-lifecycle.md | 41 ++++ .../2026-06-15-rebuild-writing-workbench.md | 91 ++++++++ indexes/active-projects.md | 13 -- indexes/ccpe-consumption-map.md | 14 -- indexes/completed-projects.md | 12 - indexes/extracted-models.md | 16 -- .../agents => projects}/.gitkeep | 0 projects/abandoned/.gitkeep | 1 - projects/active/.gitkeep | 1 - projects/completed/.gitkeep | 1 - .../ccpe}/.gitkeep | 0 .../skills-vault}/.gitkeep | 0 templates/.gitkeep | 1 - .../article-project/PROJECT_STRUCTURE.md | 110 +++------ templates/article-project/decision-log.md | 7 + templates/article-project/project.md | 23 ++ .../skeleton/00-creation-plan/context-pack.md | 23 -- .../00-creation-plan/creative-brief.md | 19 -- .../00-creation-plan/series-position.md | 11 - .../00-creation-plan/sessions/.gitkeep | 1 - .../00-creation-plan/writer-selection.md | 14 -- .../main-writer-sessions/.gitkeep | 1 - .../01-positioning/positioning-final.md | 16 -- .../skeleton/01-positioning/premise.md | 13 -- .../skeleton/02-outline/appendix-outline.md | 9 - .../02-outline/context-packs/.gitkeep | 1 - .../02-outline/main-writer-sessions/.gitkeep | 1 - .../02-outline/outlines/outline-final.md | 16 -- .../02-outline/outlines/outline-v1.md | 13 -- .../02-outline/outlines/outline-v2.md | 15 -- .../round-01/cognitive-imaging/report.md | 15 -- .../round-01/cognitive-imaging/session.md | 3 - .../round-01/giant-cognition/report.md | 15 -- .../round-01/giant-cognition/session.md | 3 - .../review-rounds/round-01/repair-request.md | 13 -- .../review-rounds/round-01/review-brief.md | 16 -- .../review-rounds/round-01/synthesis.md | 11 - .../round-01/zhang-liao/report.md | 15 -- .../round-01/zhang-liao/session.md | 3 - .../skeleton/03-drafting/chapters/.gitkeep | 1 - .../03-drafting/context-packs/.gitkeep | 1 - .../skeleton/03-drafting/full-draft.md | 7 - .../skeleton/03-drafting/sessions/.gitkeep | 1 - .../skeleton/04-draft-review/full-revised.md | 7 - .../04-draft-review/review-rounds/.gitkeep | 1 - .../skeleton/04-draft-review/revision-plan.md | 11 - .../skeleton/05-appendix/appendix-draft.md | 5 - .../skeleton/05-appendix/appendix-final.md | 5 - .../skeleton/05-appendix/sessions/.gitkeep | 1 - .../skeleton/06-metadata/image-prompt.md | 7 - .../skeleton/06-metadata/image-url.md | 7 - .../skeleton/06-metadata/metadata-draft.md | 13 -- .../skeleton/06-metadata/metadata-final.md | 17 -- .../skeleton/06-metadata/metadata-session.md | 3 - .../skeleton/07-tribunal/README.md | 11 - .../08-model-writing/destination-map.md | 12 - .../08-model-writing/extraction-brief.md | 14 -- .../skeleton/08-model-writing/model-draft.md | 13 -- .../skeleton/08-model-writing/model-final.md | 21 -- .../08-model-writing/sessions/.gitkeep | 1 - templates/article-project/skeleton/project.md | 29 --- .../article-project/skeleton/publish/final.md | 9 - .../article-project/skeleton/source-map.md | 15 -- templates/article-project/skeleton/status.md | 19 -- templates/article-project/source-map.md | 20 ++ templates/article-project/status.md | 17 ++ templates/context-pack.md | 24 -- templates/human-model-document.md | 22 -- templates/metadata-request.md | 18 -- templates/project.md | 24 -- templates/requirements/ccpe-request.md | 24 ++ .../requirements/skills-vault-request.md | 22 ++ templates/review-brief.md | 17 -- templates/review-report.md | 16 -- templates/source-map.md | 14 -- 82 files changed, 516 insertions(+), 1244 deletions(-) delete mode 100644 ccpe-consumption/runtime-links.md create mode 100644 docs/capability-requests.md delete mode 100644 docs/context-handoff.md create mode 100644 docs/invocation-policy.md create mode 100644 docs/project-lifecycle.md create mode 100644 docs/superpowers/plans/2026-06-15-rebuild-writing-workbench.md delete mode 100644 indexes/active-projects.md delete mode 100644 indexes/ccpe-consumption-map.md delete mode 100644 indexes/completed-projects.md delete mode 100644 indexes/extracted-models.md rename {ccpe-consumption/agents => projects}/.gitkeep (100%) delete mode 100644 projects/abandoned/.gitkeep delete mode 100644 projects/active/.gitkeep delete mode 100644 projects/completed/.gitkeep rename {ccpe-consumption/model-cards => requirements/ccpe}/.gitkeep (100%) rename {ccpe-consumption/skills => requirements/skills-vault}/.gitkeep (100%) delete mode 100644 templates/.gitkeep create mode 100644 templates/article-project/decision-log.md create mode 100644 templates/article-project/project.md delete mode 100644 templates/article-project/skeleton/00-creation-plan/context-pack.md delete mode 100644 templates/article-project/skeleton/00-creation-plan/creative-brief.md delete mode 100644 templates/article-project/skeleton/00-creation-plan/series-position.md delete mode 100644 templates/article-project/skeleton/00-creation-plan/sessions/.gitkeep delete mode 100644 templates/article-project/skeleton/00-creation-plan/writer-selection.md delete mode 100644 templates/article-project/skeleton/01-positioning/main-writer-sessions/.gitkeep delete mode 100644 templates/article-project/skeleton/01-positioning/positioning-final.md delete mode 100644 templates/article-project/skeleton/01-positioning/premise.md delete mode 100644 templates/article-project/skeleton/02-outline/appendix-outline.md delete mode 100644 templates/article-project/skeleton/02-outline/context-packs/.gitkeep delete mode 100644 templates/article-project/skeleton/02-outline/main-writer-sessions/.gitkeep delete mode 100644 templates/article-project/skeleton/02-outline/outlines/outline-final.md delete mode 100644 templates/article-project/skeleton/02-outline/outlines/outline-v1.md delete mode 100644 templates/article-project/skeleton/02-outline/outlines/outline-v2.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/report.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/session.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/report.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/session.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/repair-request.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/review-brief.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/synthesis.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/report.md delete mode 100644 templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/session.md delete mode 100644 templates/article-project/skeleton/03-drafting/chapters/.gitkeep delete mode 100644 templates/article-project/skeleton/03-drafting/context-packs/.gitkeep delete mode 100644 templates/article-project/skeleton/03-drafting/full-draft.md delete mode 100644 templates/article-project/skeleton/03-drafting/sessions/.gitkeep delete mode 100644 templates/article-project/skeleton/04-draft-review/full-revised.md delete mode 100644 templates/article-project/skeleton/04-draft-review/review-rounds/.gitkeep delete mode 100644 templates/article-project/skeleton/04-draft-review/revision-plan.md delete mode 100644 templates/article-project/skeleton/05-appendix/appendix-draft.md delete mode 100644 templates/article-project/skeleton/05-appendix/appendix-final.md delete mode 100644 templates/article-project/skeleton/05-appendix/sessions/.gitkeep delete mode 100644 templates/article-project/skeleton/06-metadata/image-prompt.md delete mode 100644 templates/article-project/skeleton/06-metadata/image-url.md delete mode 100644 templates/article-project/skeleton/06-metadata/metadata-draft.md delete mode 100644 templates/article-project/skeleton/06-metadata/metadata-final.md delete mode 100644 templates/article-project/skeleton/06-metadata/metadata-session.md delete mode 100644 templates/article-project/skeleton/07-tribunal/README.md delete mode 100644 templates/article-project/skeleton/08-model-writing/destination-map.md delete mode 100644 templates/article-project/skeleton/08-model-writing/extraction-brief.md delete mode 100644 templates/article-project/skeleton/08-model-writing/model-draft.md delete mode 100644 templates/article-project/skeleton/08-model-writing/model-final.md delete mode 100644 templates/article-project/skeleton/08-model-writing/sessions/.gitkeep delete mode 100644 templates/article-project/skeleton/project.md delete mode 100644 templates/article-project/skeleton/publish/final.md delete mode 100644 templates/article-project/skeleton/source-map.md delete mode 100644 templates/article-project/skeleton/status.md create mode 100644 templates/article-project/source-map.md create mode 100644 templates/article-project/status.md delete mode 100644 templates/context-pack.md delete mode 100644 templates/human-model-document.md delete mode 100644 templates/metadata-request.md delete mode 100644 templates/project.md create mode 100644 templates/requirements/ccpe-request.md create mode 100644 templates/requirements/skills-vault-request.md delete mode 100644 templates/review-brief.md delete mode 100644 templates/review-report.md delete mode 100644 templates/source-map.md diff --git a/README.md b/README.md index 6e6b2c1..e023362 100644 --- a/README.md +++ b/README.md @@ -1,62 +1,59 @@ # Writing Workbench -Writing Workbench is the production workspace for deep article creation and human-facing model writing. +Writing Workbench is the local tool-calling and process-record workspace for article writing after a Web-generated initial outline already exists. -It is not the long-term knowledge archive and it is not the CCPE asset factory. +It is not the idea base, not the long-context material discussion space, and not an autonomous article production runtime. -## Position +## Current Position ```text -Knowledge Vault = source archive, formal essays, human model documents, historical discussions -Writing Workbench = active article production site and process record -CCPE System = AI cognitive asset engineering workspace -Delivery Systems = deployable external agentic products -Video Workbench = dimensional video output workspace, planned separately +knowledge-vault = upstream discussions, source materials, published essays, public-facing archive +writing-workbench = local project workspace for outline review, agent invocation, records, drafts +ccpe-system = expert agents, runtime protocols, model cards, governed cognitive assets +skills-vault = reusable automation skills and deterministic tools ``` +## Entry Rule + +A project starts here only when the user provides: + +- a Web-generated initial outline, normally version `1.0`; +- source paths for the article materials; +- the lead writer identity, such as `韩愈` or `蒙田`; +- an explicit instruction to create or continue the project. + +If there is no initial outline, do not create a Writing Workbench project. Continue discussion and material development in `knowledge-vault`. + ## Mission -This workspace manages articles after the user has decided that an idea should enter production. +This workspace helps the user save effort after the article has entered writing: -It preserves both final outputs and process records: +- register source paths in `source-map.md`; +- preserve the initial outline; +- prepare outline-review context under current context-window limits; +- compress or organize source materials without replacing the original sources; +- invoke real reviewer and writer sessions when the user explicitly names them; +- preserve complete `session.md` and final `report.md` records; +- preserve user decisions, reflections, outline versions, and draft sessions; +- create capability request tickets when required agents or skills are missing. -- creation plan -- source map -- context packs -- writer sessions -- outline versions -- review sessions and reports -- synthesis and repair requests -- draft chapters -- revised drafts -- appendix drafts -- metadata generation -- human-facing model writing -- publish-ready final article +## Hard Rules -## Boundaries +1. No initial outline, no project. +2. No user-named reviewer, no reviewer invocation. +3. No real sub-session, no formal reviewer or writer output. +4. No user decision, no stage advancement. +5. No full-article generation by default. +6. Missing capability creates a supplier ticket and pauses the project. -- New ideas and daily captures stay in `knowledge-vault/diary`. -- Viewpoint exploration and non-article discussions stay in `knowledge-vault/discussions`. -- Formal published essays are archived in `knowledge-vault/sayings`. -- Human-facing model documents are archived in `knowledge-vault/rules`. -- AI-facing Model Cards, Agent Specs, Skills, and Runtimes are maintained in `ccpe-system`. -- Writing Workbench consumes CCPE assets but does not redefine them. +## Directory Overview -## Starting A New Session - -In a new Codex session opened on this project, use: - -```md -Please read README.md, WORKBENCH.md, and docs/context-handoff.md first, then continue work on Writing Workbench according to those conventions. +```text +docs/ Operating rules for this workspace +projects/ Article project workspaces, one folder per article +requirements/ccpe/ Supplier tickets for CCPE agents/runtimes/model assets +requirements/skills-vault/ Supplier tickets for automation skills +templates/ Project and requirement templates ``` -## Operating A Project - -Use `docs/operating-playbook.md` for the practical project workflow: - -- when to start a project -- how to create a project folder -- which files must be filled first -- how to manage context packs, sessions, review rounds, and indexes -- how to keep CCPE System as the canonical asset source +Old pre-rebuild scaffold assumptions were discarded on 2026-06-15. The current model is: the user brings a Web outline and source paths; Codex helps compress, invoke, record, and organize, but does not decide how the article proceeds. diff --git a/WORKBENCH.md b/WORKBENCH.md index 69716fa..83c3a00 100644 --- a/WORKBENCH.md +++ b/WORKBENCH.md @@ -1,134 +1,89 @@ # WORKBENCH.md -## 1. Workspace Identity +## 1. Identity -This project is the article production workspace. +Writing Workbench is the user's local writing operations room. -It is a stage and process black box for deep writing. It records how an article moves from selected idea to final published text, while keeping the original knowledge archive and CCPE asset factory separate. +The user remains the director. The workspace records and assists the process, but it does not decide which reviewer to call, whether a review round is enough, whether a writer should revise, or whether drafting should begin. -## 2. Operating Principle - -Preserve process as a first-class artifact. - -The user values not only final drafts but also the discussion, review, synthesis, repair, and decision trail that produced them. Do not collapse multi-round writing or review work into a single final file unless explicitly asked. - -## 3. Project Lifecycle - -Ideas normally begin outside this workspace: +## 2. Default Workflow ```text -knowledge-vault/diary -knowledge-vault/discussions -knowledge-vault/sources -knowledge-vault/sayings -knowledge-vault/rules +Web source discussion + -> Web initial outline v1.0 + -> Writing Workbench project + -> outline review preparation + -> user-named reviewer sessions + -> user reflection and decision + -> user-directed lead writer repair + -> outline v2.0 / v3.0 / ... + -> user-directed drafting by section or chapter + -> local draft preservation + -> user-maintained publication in knowledge-vault ``` -A project enters Writing Workbench only after the user decides to write. +## 3. Project Folders -Each active article should use a stable project id: +Projects live directly under `projects/`. + +Do not split projects into `active`, `completed`, or `abandoned` folders by default. Writing projects are not software tickets; state belongs in `status.md`, `decision-log.md`, and stage folders. + +Use stable folder names: ```text -projects/active/YYYY-MM-DD-aNNN-temp-slug/ +projects/YYYY-MM-DD-short-slug/ ``` -Do not rename the project folder every time the article title changes. Store title changes in `project.md` and final title metadata in `publish/final.md`. +## 4. Two Modes -## 4. Canonical Article Project Structure +### Execution Mode -Use `templates/article-project/PROJECT_STRUCTURE.md` as the expansion guide when creating a full project. +Use existing agents, skills, and files to complete work for the current article project. -For a copyable starting point, use: +Execution mode may: + +- prepare source digests; +- create review briefs; +- invoke user-named reviewers or writers through real sub-sessions; +- record sessions and reports; +- prepare synthesis files for the user; +- update status and decision logs. + +Execution mode must not invent missing expert output. + +### Capability-Request Mode + +When an agent, skill, or runtime is missing, create a supplier ticket and pause the current project. + +Tickets go to: ```text -templates/article-project/skeleton/ +requirements/ccpe/ +requirements/skills-vault/ ``` -Top-level project files: +CCPE supplies expert agents, runtime rules, model cards, and governed cognitive assets. -- `project.md`: stable project identity, temporary title, final title when known, phase, status -- `source-map.md`: source files from Knowledge Vault and other repositories -- `status.md`: current phase, open decisions, next actions +Skills-vault supplies deterministic automation tools, scripts, and installable skills. -Main stages: +## 5. Source Policy -- `00-creation-plan/` -- `01-positioning/` -- `02-outline/` -- `03-drafting/` -- `04-draft-review/` -- `05-appendix/` -- `06-metadata/` -- `07-tribunal/` -- `08-model-writing/` -- `publish/` +Original discussions, reports, past articles, and finished public essays remain in `knowledge-vault`. -## 5. Session And Thread Policy +Writing Workbench stores article-facing derived materials inside the project, but `source-map.md` must point back to the authoritative originals. -Use files as shared state. +Derived material files are working aids, not source of truth. -Separate Codex sessions or background threads may be used for writers and reviewers, but their long conversation history should not be copied wholesale back into the orchestrator session. +## 6. Invocation Policy -Preferred flow: +Formal reviewer and writer outputs require real invocation. -```text -orchestrator session - prepares context-pack - dispatches writer or reviewer session - receives session.md and report.md - reads only the necessary report/synthesis - asks the user for decision when needed -``` +The controller session may prepare context, launch or coordinate sub-sessions, summarize returned outputs, and ask the user for decisions. It may not role-play a reviewer or writer and label that result formal. -For each review role, preserve: +## 7. Drafting Policy -- `session.md`: discussion/process record -- `report.md`: final review result +Full-article generation is prohibited by default. -The orchestrator should consume reports and synthesis files, not every full session transcript. +Drafting happens only when the user gives an explicit instruction. The unit of drafting is determined by the user and the lead writer's established prompt behavior, usually section or chapter level. -## 6. Context Pack Policy - -Do not feed every source file by default. - -Prepare task-specific context packs: - -- `context-pack-lite.md`: article goal, current outline/draft, core claims -- `context-pack-standard.md`: lite pack plus selected material summaries and key source links -- `context-pack-deep.md`: standard pack plus long source excerpts, historical essays, or Deep Research - -Use the smallest pack that lets the role do useful work. - -## 7. CCPE Consumption - -Writing Workbench consumes CCPE assets from: - -```text -C:\Users\wangq\Documents\Codex\ccpe-system -``` - -Examples: - -- main writer agents -- Zhang Liao red-team agent -- Cognitive Imaging -- Giant Cognition -- metadata agent -- context-pack builder skill -- review synthesis skill -- repair request builder skill -- Article Production Orchestrator -- Outline Review Runtime - -Do not duplicate the full canonical CCPE asset inside this workspace. Add thin notes in `ccpe-consumption/` that point to the canonical source and explain how this workspace uses it. - -## 8. Archive Policy - -When an article is completed: - -- keep full process records in `projects/completed/` -- archive final essay in `knowledge-vault/sayings` -- archive human model documents in `knowledge-vault/rules` -- promote AI-facing model cards or runtime assets through `ccpe-system` only when mature enough - -When a project is abandoned, move it to `projects/abandoned/` and preserve the reason in `status.md`. +Writer sessions may introduce new examples or cases beyond the source materials when the task calls for it, but such additions should be marked in the session or draft notes. diff --git a/ccpe-consumption/runtime-links.md b/ccpe-consumption/runtime-links.md deleted file mode 100644 index 9782273..0000000 --- a/ccpe-consumption/runtime-links.md +++ /dev/null @@ -1,27 +0,0 @@ -# CCPE Runtime Links - -This file records how Writing Workbench consumes CCPE System assets. - -Canonical CCPE workspace: - -```text -C:\Users\wangq\Documents\Codex\ccpe-system -``` - -## Planned Assets - -| Asset | Type | Status | Notes | -| --- | --- | --- | --- | -| Article Production Orchestrator | Agent Spec | planned | Total writing process coordinator | -| Outline Review Runtime | Runtime | planned | First runtime to build and validate | -| Context Pack Builder | Skill | planned | Builds role-specific context packs | -| Review Synthesis | Skill | planned | Synthesizes multiple review reports | -| Repair Request Builder | Skill | planned | Turns review synthesis into writer repair instructions | -| Cognitive Imaging | Lite / Model Card | existing in CCPE | Use as review actor where applicable | -| Giant Cognition | Lite / Model Card | existing in CCPE | Use as review actor where applicable | -| Zhang Liao | Lite / Agent | planned | Red-team and constructive Socratic reviewer | - -## Policy - -Do not copy canonical CCPE artifacts here. Record links, usage notes, and task-specific adapters only. - diff --git a/docs/capability-requests.md b/docs/capability-requests.md new file mode 100644 index 0000000..a9f26e7 --- /dev/null +++ b/docs/capability-requests.md @@ -0,0 +1,31 @@ +# Capability Requests + +Writing Workbench is a consumer of capabilities, not their source of truth. + +## CCPE Requests + +Use `requirements/ccpe/` when the missing capability is: + +- expert agent; +- writer or reviewer prompt; +- runtime protocol; +- invocation rule; +- model card; +- evaluation or governance method. + +## Skills-Vault Requests + +Use `requirements/skills-vault/` when the missing capability is: + +- deterministic file transformation; +- source splitter; +- markdown formatter; +- report exporter; +- citation checker; +- repeatable CLI or script-backed automation. + +## Ticket Rule + +A ticket should be enough for the supplier project to build the capability without rereading the whole article project. + +Do not implement supplier capabilities inside Writing Workbench. diff --git a/docs/context-handoff.md b/docs/context-handoff.md deleted file mode 100644 index 8a3f541..0000000 --- a/docs/context-handoff.md +++ /dev/null @@ -1,163 +0,0 @@ -# Writing Workbench Context Handoff - -This document preserves the working agreements that led to this workspace. It exists so future Codex sessions do not depend on copied chat history. - -## Confirmed Architecture - -```text -Knowledge Vault = mine and archive -Writing Workbench = article production stage and process record -CCPE System = actor, skill, model, and runtime factory -Delivery Systems = deployable external agentic systems -Video Workbench = future dimensional video output workspace -``` - -The user described the metaphor this way: - -```text -Knowledge Vault provides the script material. -Writing Workbench is the stage. -CCPE System provides actors, skills, model cards, and runtime protocols. -The user remains the final director, editor, and decision gate. -``` - -## Knowledge Vault Status - -`C:\Users\wangq\Documents\Codex\knowledge-vault` has been established and migrated except for some work assets. - -Important directories: - -- `diary/`: daily or irregular captures from phone and PC -- `discussions/`: viewpoint base camp and historical process archive -- `sayings/`: formal essays -- `rules/`: human-facing model documents and writing rules -- `prompts/`: legacy and current prompt assets -- `sources/`: Deep Research, reading notes, excerpts, clipped articles, references -- `indexes/`: maintained mostly by Codex on request -- `templates/`: human-facing document templates - -Writing Workbench should not recreate diary or generic discussion intake. - -## Writing Workbench Role - -This workspace begins only after the user decides to turn an idea into an article. - -It should preserve the full production trail: - -1. creation plan -2. positioning -3. outline generation and review -4. drafting -5. draft review -6. appendix generation -7. metadata generation -8. optional tribunal -9. human-facing model writing -10. publish package - -The current scaffold intentionally leaves the first project empty. A real article project should be created under: - -```text -projects/active/YYYY-MM-DD-aNNN-temp-slug/ -``` - -## Process Record Principle - -The user's prior workflow retained discussion transcripts because single-agent workflows often lost coherence without them. Agentic Engineering should reduce copy-paste burden, but it should not discard process records. - -For each writer or reviewer interaction: - -- `session.md` records the discussion process -- `report.md` records the final result -- orchestrator reads reports and synthesis, not every full transcript - -## Session Mechanism - -Use separate sessions or background threads when context isolation is useful. - -Recommended pattern: - -```text -Article Production Orchestrator - prepares context packs - dispatches writer/reviewer sessions - receives written outputs - synthesizes reports - asks user for decisions -``` - -Continuity should be file-based, not conversation-context-based. - -## Runtime Roadmap For CCPE System - -The next CCPE work should be done in: - -```text -C:\Users\wangq\Documents\Codex\ccpe-system -``` - -Recommended build sequence: - -1. Upgrade and verify key single-agent experts as CCPE-Lite. -2. Run Scenario Probe before upgrading any Lite into Agent Spec or Skill. -3. Preserve useful Lite artifacts instead of forcing every actor into Agent/Skill/Runtime. -4. Build `Article Production Orchestrator` as an Agent Spec. -5. Build `Outline Review Runtime` first, because outline review is the most expensive and failure-prone stage. -6. Add small reusable Skills only where real workflow demand exists: - - context-pack builder - - review dispatcher - - review synthesis - - repair request builder - - source-map builder - - metadata generator -7. Validate with a trial article project in Writing Workbench. -8. Only after the outline runtime stabilizes, expand to the full article production runtime. -9. Add Tribunal and Modeling Committee later as sub-runtimes with their own coordinators. - -Important prior CCPE rule: - -```text -Scenario-first layering: -decide Lite / Agent Spec / Skill / Runtime / Model Card based on actual use scenario, not on a desire to over-engineer. -``` - -## Controller Model - -Before Tribunal and Modeling Committee are added, use one primary controller: - -```text -Article Production Orchestrator -``` - -Later, use: - -```text -Article Production Orchestrator = total project coordinator -Tribunal Presiding Agent = sub-controller for tribunal judgment -Modeling Committee Facilitator = sub-controller for human model document production -``` - -Sub-controllers are needed when target outputs, decision criteria, role sets, context isolation, risk boundary, or rhythm differ substantially. - -## Future Video Workbench - -A future sibling project should be created for dimensional output: - -```text -C:\Users\wangq\Documents\Codex\video-workbench -``` - -It should handle: - -- series architecture -- angle proposals -- video outline -- storyboard logic -- voiceover -- image prompts -- image/audio assets -- editing notes -- publishing copy - -It should not be folded into Writing Workbench. - diff --git a/docs/invocation-policy.md b/docs/invocation-policy.md new file mode 100644 index 0000000..5186ea9 --- /dev/null +++ b/docs/invocation-policy.md @@ -0,0 +1,52 @@ +# Invocation Policy + +## Formal Output Requires Real Invocation + +Formal output includes: + +- reviewer report; +- lead writer outline repair; +- lead writer draft; +- specialist analysis used for a user decision. + +Formal output must come from a real sub-session, thread, tool invocation, or explicitly approved external execution path. + +## Controller May Do + +The controller session may: + +- prepare context packs; +- create review briefs; +- route source files; +- launch or coordinate sub-sessions; +- summarize returned formal outputs; +- update project records; +- ask the user for decisions. + +## Controller Must Not Do + +The controller session must not: + +- impersonate a reviewer or lead writer; +- create a formal report without real invocation; +- treat a prompt draft as an executed report; +- advance the project after its own recommendation; +- hide uncertainty about missing capability. + +## Missing Capability + +If a required agent, skill, or runtime is unavailable: + +1. Create a supplier ticket in `requirements/ccpe/` or `requirements/skills-vault/`. +2. Set project state to `blocked_waiting_capability`. +3. Stop until the user confirms the capability is ready. + +## Simulation + +Simulation is allowed only for planning and must be labeled: + +```yaml +simulation_only: true +formal_output: false +excluded_from_synthesis: true +``` diff --git a/docs/operating-playbook.md b/docs/operating-playbook.md index 2e1bb46..67aca97 100644 --- a/docs/operating-playbook.md +++ b/docs/operating-playbook.md @@ -1,206 +1,104 @@ -# Writing Workbench Operating Playbook +# Operating Playbook -This playbook explains how to run an article project inside Writing Workbench. +## 1. Start A Project -It is the operational layer between the workspace principles in `WORKBENCH.md` and the concrete project files under `projects/active/`. +Start a project only when the user has a Web-generated initial outline. -## 1. When To Start A Project +Minimum inputs: -Start a Writing Workbench project only after the user has decided that an idea should enter article production. +- lead writer identity; +- initial outline path or pasted outline; +- source material paths; +- working slug; +- the user's instruction to create the project. -Do not use this workspace for: +If the user only has source materials or open discussion, stop and keep the work in `knowledge-vault`. -- raw diary capture -- open-ended viewpoint exploration -- generic source archiving -- canonical CCPE asset creation -- video production planning +## 2. Create The Folder -Those belong in Knowledge Vault, CCPE System, or the future Video Workbench. - -## 2. Project ID - -Use this folder pattern: +Use: ```text -projects/active/YYYY-MM-DD-aNNN-temp-slug/ +projects/YYYY-MM-DD-short-slug/ ``` -Rules: +Copy or create the project files from `templates/article-project/PROJECT_STRUCTURE.md`. -- `YYYY-MM-DD` is the project creation date. -- `aNNN` is a local article counter for that day. -- `temp-slug` is a stable working slug, not the final title. -- Do not rename the folder when the article title changes. -- Store title changes in `project.md`. - -## 3. Creating A New Project - -1. Copy the skeleton: - -```powershell -Copy-Item -Recurse templates\article-project\skeleton projects\active\YYYY-MM-DD-aNNN-temp-slug -``` - -2. Fill these files first: +Fill these first: - `project.md` - `source-map.md` - `status.md` -- `00-creation-plan/creative-brief.md` +- `decision-log.md` +- `00-intake/initial-outline-v1.0.md` -3. Update `indexes/active-projects.md`. +## 3. Prepare For Outline Review -4. If CCPE assets are used, update: +The first operational stage is `outline-review-prep`. -- `indexes/ccpe-consumption-map.md` -- `ccpe-consumption/runtime-links.md` when a new reusable asset relationship is discovered +Material processing is a subtask of outline review preparation. It exists because context windows are limited, not because the article has not entered writing. -## 4. Minimum Viable Project State +For each source, decide the processing method from the source type: -A project is ready for article work when these files are no longer blank: +- `思想考古报告` or already coherent report: preserve mostly intact or lightly annotate. +- long discussion: compress around article-relevant claims while preserving unused possibilities. +- past article: extract relevant arguments, examples, concepts, and style constraints. +- metadata or writing protocol: preserve as direct constraints. -- `project.md`: identity, intent, target article type, decision gates -- `source-map.md`: source locations and source policy -- `status.md`: current phase, open decisions, next actions -- `00-creation-plan/context-pack.md`: the smallest useful pack for the first writer or reviewer +Always keep source paths in `source-map.md`. -Do not dispatch writer or reviewer sessions before these files exist. +## 4. Review Rounds -## 5. Phase Flow +A review round starts only when the user names the reviewer or reviewers. -Use this default sequence: +Each reviewer gets: ```text -00-creation-plan -01-positioning -02-outline -03-drafting -04-draft-review -05-appendix -06-metadata -07-tribunal -08-model-writing -publish +02-outline-review/round-NN/reviewers//session.md +02-outline-review/round-NN/reviewers//report.md ``` -The user may skip optional stages, but record the decision in `status.md`. +The review brief may be prepared by the controller session, but the report must come from the real reviewer sub-session. -Required before drafting: +## 5. User Decision Gate -- positioning is stable enough to write -- outline has passed review or the user has explicitly accepted the risk -- required sources are listed in `source-map.md` -- the active context pack is available +After review, stop and wait for the user. -Required before publish: +The user may provide: -- final article exists in `publish/final.md` -- unresolved review issues are either fixed or explicitly waived -- metadata is complete when needed -- archive destinations are recorded +- reflection; +- accepted and rejected review points; +- direction for lead writer repair; +- instruction to run another review; +- instruction to draft a specific part. -## 6. Context Packs +Record these in `decision-log.md` and the relevant stage folder. -Use the smallest pack that can support the task. +## 6. Outline Repair -- `lite`: article goal, current artifact, core claims, constraints -- `standard`: lite pack plus source summaries and selected evidence -- `deep`: standard pack plus long excerpts, historical essays, or research material +Lead writer repair starts only after the user gives a repair instruction. -Do not paste every source file into a context pack. Reference source paths unless selected excerpts are necessary. +Versioning: -## 7. Sessions And Reports +- Web initial outline is `1.0`. +- First repaired outline starts at `2.0`. +- Major later revisions use `3.0`, `4.0`, and so on. +- Small local adjustments use `3.1`, `3.2`, and so on. -For each writer, reviewer, tribunal member, or modeling session, preserve both: +Review reports do not create outline versions by themselves. -- `session.md`: process record -- `report.md`: final result or decision-ready output +## 7. Drafting -The orchestrator should read reports, syntheses, and repair requests before reading full session records. +Do not generate a full article unless the user explicitly asks for that exact action. -Use full sessions only when: +Default drafting is section-level or chapter-level. Preserve the complete writer session and the resulting draft. -- the report is ambiguous -- a decision depends on reasoning history -- the user asks to inspect the process -- the next agent needs exact prior discussion details +If the writer introduces new cases outside source materials, mark them in `draft-notes.md` or the session record. -## 8. Review Rounds +## 8. Publication Boundary -Each review round should preserve: +Writing Workbench may keep a local full draft for revision. -- `review-brief.md` -- one folder per reviewer -- each reviewer folder with `session.md` and `report.md` -- `synthesis.md` -- `repair-request.md` +The publication copy and release metadata are maintained by the user in `knowledge-vault`, normally under `sayings/`. -The repair request should be addressed to the next writer or reviser. It should not be a generic list of review comments. - -## 9. Index Synchronization - -Update indexes as project state changes. - -Use `indexes/active-projects.md` when: - -- a project is created -- current phase changes -- next action changes -- lead writer or project status changes - -Use `indexes/completed-projects.md` when: - -- a project moves to `projects/completed/` -- final archive paths are known -- extracted model documents or CCPE improvement requests are known - -Use `indexes/ccpe-consumption-map.md` when: - -- a CCPE asset is used in a project -- an asset produces an output -- an issue or improvement request should be sent back to CCPE System - -Use `indexes/extracted-models.md` when: - -- the article produces a human-facing model document -- the model should be archived in Knowledge Vault -- the model has possible AI-facing Model Card potential - -## 10. CCPE Boundary - -Writing Workbench consumes CCPE assets. It does not redefine them. - -Allowed here: - -- canonical path references -- task-specific usage notes -- context packs for using an asset -- reports about asset issues -- improvement requests for CCPE System - -Not allowed here: - -- copied canonical Agent Specs -- copied canonical Model Cards -- copied canonical Skill definitions -- permanent forks of CCPE runtime protocols - -Trial article runs should wait until the required CCPE agents or Lite prompts are available in CCPE System, unless the user explicitly chooses a manual placeholder workflow. - -## 11. Completion And Archiving - -When an article is complete: - -1. Move the project folder from `projects/active/` to `projects/completed/`. -2. Keep all process records inside the completed project folder. -3. Archive the final essay to Knowledge Vault `sayings/`. -4. Archive human-facing model documents to Knowledge Vault `rules/`. -5. Promote AI-facing model assets only through CCPE System. -6. Update all relevant indexes. - -When a project is abandoned: - -1. Record the reason in `status.md`. -2. Move the project folder to `projects/abandoned/`. -3. Keep the process trail unless the user explicitly asks to remove it. +Record the intended or final `knowledge-vault` target path in `publish/knowledge-vault-target.md`. diff --git a/docs/project-lifecycle.md b/docs/project-lifecycle.md new file mode 100644 index 0000000..23474b4 --- /dev/null +++ b/docs/project-lifecycle.md @@ -0,0 +1,41 @@ +# Project Lifecycle + +## States + +Use `status.md` to record the current state. Do not infer state from folder location. + +Recommended states: + +```text +outline_review_prep +blocked_waiting_capability +blocked_waiting_user_decision +review_round +outline_repair +drafting +revision +local_complete +archived_by_user +``` + +States may repeat. For example, after several review rounds the user may add new materials and return to `outline_review_prep`. + +## Stage Folders + +```text +00-intake/ +01-materials/ +02-outline-review/ +03-outline-repair/ +04-drafting/ +05-revision/ +publish/ +``` + +These folders are working areas, not mandatory linear gates. + +## Advancement Rule + +The workspace may suggest next actions, but only the user advances the project. + +Avoid language such as "passed review" or "ready to draft" unless it is quoting the user's decision. diff --git a/docs/superpowers/plans/2026-06-15-rebuild-writing-workbench.md b/docs/superpowers/plans/2026-06-15-rebuild-writing-workbench.md new file mode 100644 index 0000000..c907db0 --- /dev/null +++ b/docs/superpowers/plans/2026-06-15-rebuild-writing-workbench.md @@ -0,0 +1,91 @@ +# Rebuild Writing Workbench Implementation Plan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Rebuild Writing Workbench as a local tool-calling and process-record workspace that starts from a Web-generated initial outline. + +**Architecture:** Preserve the existing Git repository identity and replace the old article-production-runtime scaffold with a smaller documentation and template system. Projects live directly under `projects/`; supplier needs are recorded under `requirements/ccpe/` or `requirements/skills-vault/`. + +**Tech Stack:** Markdown documentation, Git, Windows PowerShell for filesystem operations. + +--- + +### Task 1: Clear Old Workspace + +**Files:** +- Delete old workspace files and folders except `.git`. + +- [x] **Step 1: Verify workspace path** + +Run: `Resolve-Path .` + +Expected: `C:\Users\wangq\Documents\Codex\writing-workbench` + +- [x] **Step 2: Remove old files** + +Run a guarded PowerShell removal that refuses to operate outside the expected workspace. + +Expected: only `.git` remains. + +### Task 2: Create New Skeleton + +**Files:** +- Create: `docs/` +- Create: `projects/` +- Create: `requirements/ccpe/` +- Create: `requirements/skills-vault/` +- Create: `templates/article-project/` +- Create: `templates/requirements/` + +- [x] **Step 1: Create folders** + +Run: `New-Item -ItemType Directory -Force` for each target directory. + +Expected: all target directories exist. + +### Task 3: Write New Operating Documents + +**Files:** +- Create: `README.md` +- Create: `WORKBENCH.md` +- Create: `docs/operating-playbook.md` +- Create: `docs/project-lifecycle.md` +- Create: `docs/invocation-policy.md` +- Create: `docs/capability-requests.md` + +- [x] **Step 1: Write documents** + +Expected: documents define Web initial outline entry, user-directed advancement, real invocation policy, and capability-request pause behavior. + +### Task 4: Write Templates + +**Files:** +- Create: `templates/article-project/PROJECT_STRUCTURE.md` +- Create: `templates/article-project/project.md` +- Create: `templates/article-project/source-map.md` +- Create: `templates/article-project/status.md` +- Create: `templates/article-project/decision-log.md` +- Create: `templates/requirements/ccpe-request.md` +- Create: `templates/requirements/skills-vault-request.md` + +- [x] **Step 1: Write project and supplier templates** + +Expected: templates match the new workflow and do not include old active/completed/runtime assumptions. + +### Task 5: Verify + +**Files:** +- Inspect all created Markdown files. +- Inspect Git status. + +- [ ] **Step 1: List files** + +Run: `Get-ChildItem -Recurse -File` + +Expected: only rebuilt files are present outside `.git`. + +- [ ] **Step 2: Check Git status** + +Run: `git status --short` + +Expected: old tracked files are deleted and new rebuilt files are untracked or modified. diff --git a/indexes/active-projects.md b/indexes/active-projects.md deleted file mode 100644 index 9c1601a..0000000 --- a/indexes/active-projects.md +++ /dev/null @@ -1,13 +0,0 @@ -# Active Projects - -No active article projects yet. - -When adding a project, record: - -- project id -- temporary title -- current phase -- lead writer / style -- source-map path -- next action - diff --git a/indexes/ccpe-consumption-map.md b/indexes/ccpe-consumption-map.md deleted file mode 100644 index 1ca34f5..0000000 --- a/indexes/ccpe-consumption-map.md +++ /dev/null @@ -1,14 +0,0 @@ -# CCPE Consumption Map - -This index tracks which CCPE assets were used by Writing Workbench projects. - -Record: - -- project id -- stage -- CCPE asset -- canonical path -- output path -- issues found -- improvement requests for CCPE System - diff --git a/indexes/completed-projects.md b/indexes/completed-projects.md deleted file mode 100644 index fa80e7e..0000000 --- a/indexes/completed-projects.md +++ /dev/null @@ -1,12 +0,0 @@ -# Completed Projects - -No completed article projects yet. - -When completing a project, record: - -- project id -- final title -- final essay archive path in Knowledge Vault -- model documents extracted, if any -- CCPE assets triggered, if any - diff --git a/indexes/extracted-models.md b/indexes/extracted-models.md deleted file mode 100644 index ef34ae9..0000000 --- a/indexes/extracted-models.md +++ /dev/null @@ -1,16 +0,0 @@ -# Extracted Models - -This index tracks human-facing model documents produced from article projects. - -Final human-facing models should be archived in: - -```text -C:\Users\wangq\Documents\Codex\knowledge-vault\rules -``` - -AI-facing model cards should be promoted through: - -```text -C:\Users\wangq\Documents\Codex\ccpe-system\model-cards -``` - diff --git a/ccpe-consumption/agents/.gitkeep b/projects/.gitkeep similarity index 100% rename from ccpe-consumption/agents/.gitkeep rename to projects/.gitkeep diff --git a/projects/abandoned/.gitkeep b/projects/abandoned/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/projects/abandoned/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/projects/active/.gitkeep b/projects/active/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/projects/active/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/projects/completed/.gitkeep b/projects/completed/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/projects/completed/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/ccpe-consumption/model-cards/.gitkeep b/requirements/ccpe/.gitkeep similarity index 100% rename from ccpe-consumption/model-cards/.gitkeep rename to requirements/ccpe/.gitkeep diff --git a/ccpe-consumption/skills/.gitkeep b/requirements/skills-vault/.gitkeep similarity index 100% rename from ccpe-consumption/skills/.gitkeep rename to requirements/skills-vault/.gitkeep diff --git a/templates/.gitkeep b/templates/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/PROJECT_STRUCTURE.md b/templates/article-project/PROJECT_STRUCTURE.md index e98e211..731055a 100644 --- a/templates/article-project/PROJECT_STRUCTURE.md +++ b/templates/article-project/PROJECT_STRUCTURE.md @@ -1,95 +1,51 @@ # Article Project Structure -Use this structure when expanding a new active article project. - -The copyable project skeleton lives at: +Use this structure for article projects that enter Writing Workbench after a Web initial outline already exists. ```text -templates/article-project/skeleton/ -``` - -Create a project with: - -```powershell -Copy-Item -Recurse templates\article-project\skeleton projects\active\YYYY-MM-DD-aNNN-temp-slug -``` - -Then fill `project.md`, `source-map.md`, `status.md`, and `00-creation-plan/creative-brief.md` before dispatching writer or reviewer sessions. - -```text -YYYY-MM-DD-aNNN-temp-slug/ +YYYY-MM-DD-short-slug/ project.md source-map.md status.md + decision-log.md - 00-creation-plan/ - creative-brief.md - writer-selection.md - series-position.md - context-pack.md - sessions/ + 00-intake/ + initial-outline-v1.0.md + intake-note.md - 01-positioning/ - premise.md - main-writer-sessions/ - positioning-final.md + 01-materials/ + source-links.md + source-digests/ + compression-notes.md - 02-outline/ - context-packs/ - main-writer-sessions/ - outlines/ - outline-v1.md - outline-v2.md - outline-final.md - review-rounds/ - round-01/ - review-brief.md - cognitive-imaging/ + 02-outline-review/ + round-01/ + review-brief.md + reviewers/ + reviewer-id/ session.md report.md - zhang-liao/ - session.md - report.md - giant-cognition/ - session.md - report.md - synthesis.md - repair-request.md - appendix-outline.md + user-reflection.md + synthesis-for-writer.md - 03-drafting/ - context-packs/ - sessions/ - chapters/ - full-draft.md + 03-outline-repair/ + writer-session-v2.0/ + session.md + outline-v2.0.md + repair-notes.md - 04-draft-review/ - review-rounds/ - revision-plan.md - full-revised.md + 04-drafting/ + section-sessions/ + draft-v1.md + draft-notes.md - 05-appendix/ - sessions/ - appendix-draft.md - appendix-final.md - - 06-metadata/ - metadata-session.md - metadata-draft.md - image-prompt.md - image-url.md - metadata-final.md - - 07-tribunal/ - README.md - - 08-model-writing/ - extraction-brief.md - sessions/ - model-draft.md - model-final.md - destination-map.md + 05-revision/ + revision-sessions/ + draft-v2.md publish/ - final.md + local-final.md + knowledge-vault-target.md ``` + +Folders may be created as needed. Do not create empty stage files merely to satisfy the structure. diff --git a/templates/article-project/decision-log.md b/templates/article-project/decision-log.md new file mode 100644 index 0000000..472b1d7 --- /dev/null +++ b/templates/article-project/decision-log.md @@ -0,0 +1,7 @@ +# Decision Log + +Record user decisions that advance, pause, or redirect the project. + +| Date | Decision Owner | Decision | Inputs | Downstream Effect | +| --- | --- | --- | --- | --- | +| | user | | | | diff --git a/templates/article-project/project.md b/templates/article-project/project.md new file mode 100644 index 0000000..ed1073c --- /dev/null +++ b/templates/article-project/project.md @@ -0,0 +1,23 @@ +# Project + +```yaml +project_id: +created: +lead_writer: +writer_style: +working_title: +current_outline_version: "1.0" +status: outline_review_prep +``` + +## Purpose + +## Entry Inputs + +- Initial outline: +- Source map: +- Lead writer: + +## Current Boundary + +This project starts from an existing Web initial outline. It does not perform open-ended idea development. diff --git a/templates/article-project/skeleton/00-creation-plan/context-pack.md b/templates/article-project/skeleton/00-creation-plan/context-pack.md deleted file mode 100644 index bea73fe..0000000 --- a/templates/article-project/skeleton/00-creation-plan/context-pack.md +++ /dev/null @@ -1,23 +0,0 @@ -# Context Pack - -## Pack Type - -- lite - -## Task - -## Role Receiving This Pack - -## Current Artifact - -## Article Goal - -## Core Claims - -## Required Sources - -## Selected Evidence - -## Constraints - -## Output Request diff --git a/templates/article-project/skeleton/00-creation-plan/creative-brief.md b/templates/article-project/skeleton/00-creation-plan/creative-brief.md deleted file mode 100644 index ea991e2..0000000 --- a/templates/article-project/skeleton/00-creation-plan/creative-brief.md +++ /dev/null @@ -1,19 +0,0 @@ -# Creative Brief - -## Article Intention - -## Reader - -## Core Question - -## Core Claim - -## Desired Effect - -## Must Include - -## Must Avoid - -## Initial Sources - -## First Human Decision Needed diff --git a/templates/article-project/skeleton/00-creation-plan/series-position.md b/templates/article-project/skeleton/00-creation-plan/series-position.md deleted file mode 100644 index 2d45594..0000000 --- a/templates/article-project/skeleton/00-creation-plan/series-position.md +++ /dev/null @@ -1,11 +0,0 @@ -# Series Position - -## Series - -## Position In Series - -## Previous Related Articles - -## Next Possible Articles - -## Continuity Requirements diff --git a/templates/article-project/skeleton/00-creation-plan/sessions/.gitkeep b/templates/article-project/skeleton/00-creation-plan/sessions/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/00-creation-plan/sessions/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/00-creation-plan/writer-selection.md b/templates/article-project/skeleton/00-creation-plan/writer-selection.md deleted file mode 100644 index dfab33a..0000000 --- a/templates/article-project/skeleton/00-creation-plan/writer-selection.md +++ /dev/null @@ -1,14 +0,0 @@ -# Writer Selection - -## Candidate Writer Roles - -## Selected Lead Writer - -## Reason - -## Style Constraints - -## CCPE Asset Reference - -- Canonical path: -- Local usage note: diff --git a/templates/article-project/skeleton/01-positioning/main-writer-sessions/.gitkeep b/templates/article-project/skeleton/01-positioning/main-writer-sessions/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/01-positioning/main-writer-sessions/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/01-positioning/positioning-final.md b/templates/article-project/skeleton/01-positioning/positioning-final.md deleted file mode 100644 index f7ccc17..0000000 --- a/templates/article-project/skeleton/01-positioning/positioning-final.md +++ /dev/null @@ -1,16 +0,0 @@ -# Positioning Final - -## Final Premise - -## Target Reader - -## Main Claim - -## Supporting Claims - -## Article Boundary - -## Approved By User - -- Date: -- Notes: diff --git a/templates/article-project/skeleton/01-positioning/premise.md b/templates/article-project/skeleton/01-positioning/premise.md deleted file mode 100644 index 24b6f3a..0000000 --- a/templates/article-project/skeleton/01-positioning/premise.md +++ /dev/null @@ -1,13 +0,0 @@ -# Premise - -## Working Premise - -## Reader Problem - -## Article Promise - -## Central Tension - -## Boundary - -## Open Questions diff --git a/templates/article-project/skeleton/02-outline/appendix-outline.md b/templates/article-project/skeleton/02-outline/appendix-outline.md deleted file mode 100644 index 26d55ce..0000000 --- a/templates/article-project/skeleton/02-outline/appendix-outline.md +++ /dev/null @@ -1,9 +0,0 @@ -# Appendix Outline - -## Appendix Purpose - -## Candidate Sections - -## Relationship To Main Article - -## Open Questions diff --git a/templates/article-project/skeleton/02-outline/context-packs/.gitkeep b/templates/article-project/skeleton/02-outline/context-packs/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/02-outline/context-packs/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/02-outline/main-writer-sessions/.gitkeep b/templates/article-project/skeleton/02-outline/main-writer-sessions/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/02-outline/main-writer-sessions/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/02-outline/outlines/outline-final.md b/templates/article-project/skeleton/02-outline/outlines/outline-final.md deleted file mode 100644 index 2102ef2..0000000 --- a/templates/article-project/skeleton/02-outline/outlines/outline-final.md +++ /dev/null @@ -1,16 +0,0 @@ -# Outline Final - -## Final Title Candidate - -## Opening - -## Section Outline - -## Closing - -## Appendix Plan - -## User Approval - -- Date: -- Notes: diff --git a/templates/article-project/skeleton/02-outline/outlines/outline-v1.md b/templates/article-project/skeleton/02-outline/outlines/outline-v1.md deleted file mode 100644 index 04bd367..0000000 --- a/templates/article-project/skeleton/02-outline/outlines/outline-v1.md +++ /dev/null @@ -1,13 +0,0 @@ -# Outline V1 - -## Title Candidate - -## Opening - -## Section Outline - -## Closing - -## Appendix Need - -## Known Risks diff --git a/templates/article-project/skeleton/02-outline/outlines/outline-v2.md b/templates/article-project/skeleton/02-outline/outlines/outline-v2.md deleted file mode 100644 index 1faa82b..0000000 --- a/templates/article-project/skeleton/02-outline/outlines/outline-v2.md +++ /dev/null @@ -1,15 +0,0 @@ -# Outline V2 - -## Change Summary From V1 - -## Title Candidate - -## Opening - -## Section Outline - -## Closing - -## Appendix Need - -## Remaining Risks diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/report.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/report.md deleted file mode 100644 index 8b94c12..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/report.md +++ /dev/null @@ -1,15 +0,0 @@ -# Cognitive Imaging Report - -## Verdict - -## Strongest Parts - -## Critical Issues - -## Structural Risks - -## Missing Context Or Evidence - -## Repair Suggestions - -## Questions For User diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/session.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/session.md deleted file mode 100644 index 7830793..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/cognitive-imaging/session.md +++ /dev/null @@ -1,3 +0,0 @@ -# Cognitive Imaging Session - -## Process Record diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/report.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/report.md deleted file mode 100644 index 0473d04..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/report.md +++ /dev/null @@ -1,15 +0,0 @@ -# Giant Cognition Report - -## Verdict - -## Strongest Parts - -## Critical Issues - -## Structural Risks - -## Missing Context Or Evidence - -## Repair Suggestions - -## Questions For User diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/session.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/session.md deleted file mode 100644 index fa4aba5..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/giant-cognition/session.md +++ /dev/null @@ -1,3 +0,0 @@ -# Giant Cognition Session - -## Process Record diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/repair-request.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/repair-request.md deleted file mode 100644 index 4250e44..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/repair-request.md +++ /dev/null @@ -1,13 +0,0 @@ -# Repair Request - -## Addressed To - -## Repair Goal - -## Required Changes - -## Constraints - -## Evidence To Preserve - -## Output Request diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/review-brief.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/review-brief.md deleted file mode 100644 index f3e1de9..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/review-brief.md +++ /dev/null @@ -1,16 +0,0 @@ -# Review Brief - -## Review Target - -## Reviewer Role - -## Context Pack - -## Review Objectives - -## Known Concerns - -## Required Output - -- `session.md` for process record -- `report.md` for final review result diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/synthesis.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/synthesis.md deleted file mode 100644 index 4df5c16..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/synthesis.md +++ /dev/null @@ -1,11 +0,0 @@ -# Review Synthesis - -## Shared Findings - -## Conflicting Findings - -## Highest Priority Repairs - -## User Decisions Needed - -## Recommendation diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/report.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/report.md deleted file mode 100644 index 3f83a46..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/report.md +++ /dev/null @@ -1,15 +0,0 @@ -# Zhang Liao Report - -## Verdict - -## Strongest Parts - -## Critical Issues - -## Structural Risks - -## Missing Context Or Evidence - -## Repair Suggestions - -## Questions For User diff --git a/templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/session.md b/templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/session.md deleted file mode 100644 index 3727312..0000000 --- a/templates/article-project/skeleton/02-outline/review-rounds/round-01/zhang-liao/session.md +++ /dev/null @@ -1,3 +0,0 @@ -# Zhang Liao Session - -## Process Record diff --git a/templates/article-project/skeleton/03-drafting/chapters/.gitkeep b/templates/article-project/skeleton/03-drafting/chapters/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/03-drafting/chapters/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/03-drafting/context-packs/.gitkeep b/templates/article-project/skeleton/03-drafting/context-packs/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/03-drafting/context-packs/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/03-drafting/full-draft.md b/templates/article-project/skeleton/03-drafting/full-draft.md deleted file mode 100644 index c603ccc..0000000 --- a/templates/article-project/skeleton/03-drafting/full-draft.md +++ /dev/null @@ -1,7 +0,0 @@ -# Full Draft - -## Draft - -## Known Gaps - -## Writer Notes diff --git a/templates/article-project/skeleton/03-drafting/sessions/.gitkeep b/templates/article-project/skeleton/03-drafting/sessions/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/03-drafting/sessions/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/04-draft-review/full-revised.md b/templates/article-project/skeleton/04-draft-review/full-revised.md deleted file mode 100644 index d059629..0000000 --- a/templates/article-project/skeleton/04-draft-review/full-revised.md +++ /dev/null @@ -1,7 +0,0 @@ -# Full Revised Draft - -## Revised Draft - -## Change Notes - -## Remaining Risks diff --git a/templates/article-project/skeleton/04-draft-review/review-rounds/.gitkeep b/templates/article-project/skeleton/04-draft-review/review-rounds/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/04-draft-review/review-rounds/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/04-draft-review/revision-plan.md b/templates/article-project/skeleton/04-draft-review/revision-plan.md deleted file mode 100644 index c93a20c..0000000 --- a/templates/article-project/skeleton/04-draft-review/revision-plan.md +++ /dev/null @@ -1,11 +0,0 @@ -# Revision Plan - -## Review Inputs - -## Required Revisions - -## Optional Revisions - -## User Decisions - -## Revision Order diff --git a/templates/article-project/skeleton/05-appendix/appendix-draft.md b/templates/article-project/skeleton/05-appendix/appendix-draft.md deleted file mode 100644 index 0e2a01b..0000000 --- a/templates/article-project/skeleton/05-appendix/appendix-draft.md +++ /dev/null @@ -1,5 +0,0 @@ -# Appendix Draft - -## Draft - -## Notes diff --git a/templates/article-project/skeleton/05-appendix/appendix-final.md b/templates/article-project/skeleton/05-appendix/appendix-final.md deleted file mode 100644 index 65e0a7e..0000000 --- a/templates/article-project/skeleton/05-appendix/appendix-final.md +++ /dev/null @@ -1,5 +0,0 @@ -# Appendix Final - -## Final Appendix - -## Archive Notes diff --git a/templates/article-project/skeleton/05-appendix/sessions/.gitkeep b/templates/article-project/skeleton/05-appendix/sessions/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/05-appendix/sessions/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/06-metadata/image-prompt.md b/templates/article-project/skeleton/06-metadata/image-prompt.md deleted file mode 100644 index 60fda26..0000000 --- a/templates/article-project/skeleton/06-metadata/image-prompt.md +++ /dev/null @@ -1,7 +0,0 @@ -# Image Prompt - -## Prompt - -## Constraints - -## Negative Requirements diff --git a/templates/article-project/skeleton/06-metadata/image-url.md b/templates/article-project/skeleton/06-metadata/image-url.md deleted file mode 100644 index 3a603d0..0000000 --- a/templates/article-project/skeleton/06-metadata/image-url.md +++ /dev/null @@ -1,7 +0,0 @@ -# Image URL - -## Final Image URL - -## Source - -## License Or Usage Note diff --git a/templates/article-project/skeleton/06-metadata/metadata-draft.md b/templates/article-project/skeleton/06-metadata/metadata-draft.md deleted file mode 100644 index 17a8355..0000000 --- a/templates/article-project/skeleton/06-metadata/metadata-draft.md +++ /dev/null @@ -1,13 +0,0 @@ -# Metadata Draft - -## Title - -## Subtitle - -## Description - -## Keywords - -## Tags - -## Categories diff --git a/templates/article-project/skeleton/06-metadata/metadata-final.md b/templates/article-project/skeleton/06-metadata/metadata-final.md deleted file mode 100644 index d9b5dde..0000000 --- a/templates/article-project/skeleton/06-metadata/metadata-final.md +++ /dev/null @@ -1,17 +0,0 @@ -# Metadata Final - -## Title - -## Subtitle - -## Description - -## Keywords - -## Tags - -## Categories - -## Image Prompt - -## Image URL diff --git a/templates/article-project/skeleton/06-metadata/metadata-session.md b/templates/article-project/skeleton/06-metadata/metadata-session.md deleted file mode 100644 index 649adba..0000000 --- a/templates/article-project/skeleton/06-metadata/metadata-session.md +++ /dev/null @@ -1,3 +0,0 @@ -# Metadata Session - -## Process Record diff --git a/templates/article-project/skeleton/07-tribunal/README.md b/templates/article-project/skeleton/07-tribunal/README.md deleted file mode 100644 index 258610f..0000000 --- a/templates/article-project/skeleton/07-tribunal/README.md +++ /dev/null @@ -1,11 +0,0 @@ -# Tribunal - -Use this stage only when the article needs multi-role judgment beyond normal review. - -Do not run tribunal by default. Record the user decision in `status.md`. - -## Inputs - -## Roles - -## Outputs diff --git a/templates/article-project/skeleton/08-model-writing/destination-map.md b/templates/article-project/skeleton/08-model-writing/destination-map.md deleted file mode 100644 index 1b46a54..0000000 --- a/templates/article-project/skeleton/08-model-writing/destination-map.md +++ /dev/null @@ -1,12 +0,0 @@ -# Destination Map - -## Human-Facing Archive - -- Knowledge Vault path: - -## AI-Facing Promotion Candidate - -- CCPE System path: -- Promotion status: - -## Index Updates diff --git a/templates/article-project/skeleton/08-model-writing/extraction-brief.md b/templates/article-project/skeleton/08-model-writing/extraction-brief.md deleted file mode 100644 index 8f34a8d..0000000 --- a/templates/article-project/skeleton/08-model-writing/extraction-brief.md +++ /dev/null @@ -1,14 +0,0 @@ -# Extraction Brief - -## Source Article - -## Candidate Human Model - -## Extraction Goal - -## Boundary - -## Destination - -- Knowledge Vault rules path: -- CCPE System potential: diff --git a/templates/article-project/skeleton/08-model-writing/model-draft.md b/templates/article-project/skeleton/08-model-writing/model-draft.md deleted file mode 100644 index 1a241b2..0000000 --- a/templates/article-project/skeleton/08-model-writing/model-draft.md +++ /dev/null @@ -1,13 +0,0 @@ -# Model Draft - -## Model Name - -## Model Definition - -## Core Structure - -## Mechanism - -## Applicable Scenarios - -## Non-Applicable Scenarios diff --git a/templates/article-project/skeleton/08-model-writing/model-final.md b/templates/article-project/skeleton/08-model-writing/model-final.md deleted file mode 100644 index a997d08..0000000 --- a/templates/article-project/skeleton/08-model-writing/model-final.md +++ /dev/null @@ -1,21 +0,0 @@ -# Model Final - -## Model Name - -## Source Article - -## Model Definition - -## Core Structure - -## Mechanism - -## Applicable Scenarios - -## Non-Applicable Scenarios - -## Version Relationship - -## Derivative Models - -## AI Model Card Potential diff --git a/templates/article-project/skeleton/08-model-writing/sessions/.gitkeep b/templates/article-project/skeleton/08-model-writing/sessions/.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/templates/article-project/skeleton/08-model-writing/sessions/.gitkeep +++ /dev/null @@ -1 +0,0 @@ - diff --git a/templates/article-project/skeleton/project.md b/templates/article-project/skeleton/project.md deleted file mode 100644 index a1d20ec..0000000 --- a/templates/article-project/skeleton/project.md +++ /dev/null @@ -1,29 +0,0 @@ -# Project - -## Identity - -- Project ID: -- Temporary title: -- Final title: -- Status: active -- Current phase: 00-creation-plan -- Created: -- Last updated: - -## Intent - -## Target Article Type - -## Lead Writer / Style - -## Series Position - -## Human Decision Gates - -- Creation plan approval: -- Positioning approval: -- Outline approval: -- Draft repair approval: -- Publish approval: - -## Notes diff --git a/templates/article-project/skeleton/publish/final.md b/templates/article-project/skeleton/publish/final.md deleted file mode 100644 index c74c9e2..0000000 --- a/templates/article-project/skeleton/publish/final.md +++ /dev/null @@ -1,9 +0,0 @@ -# Final Article - -## Final Title - -## Article - -## Archive Destination - -## Publication Notes diff --git a/templates/article-project/skeleton/source-map.md b/templates/article-project/skeleton/source-map.md deleted file mode 100644 index d9df5ee..0000000 --- a/templates/article-project/skeleton/source-map.md +++ /dev/null @@ -1,15 +0,0 @@ -# Source Map - -## Knowledge Vault Sources - -## CCPE Sources - -## External Sources - -## Selected Materials - -## Source Policy - -This project references source files unless the user explicitly asks to copy selected excerpts into local context packs. - -## Open Source Questions diff --git a/templates/article-project/skeleton/status.md b/templates/article-project/skeleton/status.md deleted file mode 100644 index 2459778..0000000 --- a/templates/article-project/skeleton/status.md +++ /dev/null @@ -1,19 +0,0 @@ -# Status - -## Current State - -- Phase: 00-creation-plan -- Status: active -- Last updated: - -## Completed - -## Open Decisions - -## Next Actions - -## Blockers - -## Phase Notes - -Record skipped phases, waived review risks, archive destinations, and CCPE follow-up requests here. diff --git a/templates/article-project/source-map.md b/templates/article-project/source-map.md new file mode 100644 index 0000000..3e5da15 --- /dev/null +++ b/templates/article-project/source-map.md @@ -0,0 +1,20 @@ +# Source Map + +## Source Policy + +Original source files remain authoritative. Project material files are derived working aids. + +## Initial Outline + +- Path: +- Version: 1.0 + +## Source Materials + +| Source | Type | Path | Processing Plan | +| --- | --- | --- | --- | +| | | | | + +## Publication Target + +- Knowledge Vault final essay path: diff --git a/templates/article-project/status.md b/templates/article-project/status.md new file mode 100644 index 0000000..a43be39 --- /dev/null +++ b/templates/article-project/status.md @@ -0,0 +1,17 @@ +# Status + +```yaml +current_state: outline_review_prep +waiting_on: user +next_allowed_actions: + - user names reviewers + - prepare material compression + - create capability request if required +``` + +## Completed + +## Open Decisions + +## Next Action + diff --git a/templates/context-pack.md b/templates/context-pack.md deleted file mode 100644 index b0965a3..0000000 --- a/templates/context-pack.md +++ /dev/null @@ -1,24 +0,0 @@ -# Context Pack - -## Pack Type - -- lite / standard / deep - -## Task - -## Role Receiving This Pack - -## Current Artifact - -## Article Goal - -## Core Claims - -## Required Sources - -## Selected Evidence - -## Constraints - -## Output Request - diff --git a/templates/human-model-document.md b/templates/human-model-document.md deleted file mode 100644 index 49b2d86..0000000 --- a/templates/human-model-document.md +++ /dev/null @@ -1,22 +0,0 @@ -# Human Model Document - -## Model Name - -## Source Article - -## Model Definition - -## Core Structure - -## Mechanism - -## Applicable Scenarios - -## Non-Applicable Scenarios - -## Version Relationship - -## Derivative Models - -## AI Model Card Potential - diff --git a/templates/metadata-request.md b/templates/metadata-request.md deleted file mode 100644 index 38733c5..0000000 --- a/templates/metadata-request.md +++ /dev/null @@ -1,18 +0,0 @@ -# Metadata Request - -## Article Path - -## Target Output - -- title -- subtitle -- keywords -- description -- tags -- categories -- image prompt - -## Classification Rules - -## Notes - diff --git a/templates/project.md b/templates/project.md deleted file mode 100644 index 49448b2..0000000 --- a/templates/project.md +++ /dev/null @@ -1,24 +0,0 @@ -# Project - -## Identity - -- Project ID: -- Temporary title: -- Final title: -- Status: active -- Current phase: -- Created: -- Last updated: - -## Intent - -## Target Article Type - -## Lead Writer / Style - -## Series Position - -## Human Decision Gates - -## Notes - diff --git a/templates/requirements/ccpe-request.md b/templates/requirements/ccpe-request.md new file mode 100644 index 0000000..4c43096 --- /dev/null +++ b/templates/requirements/ccpe-request.md @@ -0,0 +1,24 @@ +# CCPE Capability Request + +```yaml +request_id: +created: +requested_by_project: +target_supplier: ccpe-system +status: requested +``` + +## Missing Capability + +## Why Writing Workbench Needs It + +## Expected Inputs + +## Expected Outputs + +## Invocation Requirements + +## Authority And Safety + +## Acceptance Check + diff --git a/templates/requirements/skills-vault-request.md b/templates/requirements/skills-vault-request.md new file mode 100644 index 0000000..8c92eab --- /dev/null +++ b/templates/requirements/skills-vault-request.md @@ -0,0 +1,22 @@ +# Skills-Vault Capability Request + +```yaml +request_id: +created: +requested_by_project: +target_supplier: skills-vault +status: requested +``` + +## Missing Automation + +## Input Files + +## Output Files + +## Side Effects + +## CLI Or Skill Behavior + +## Validation Check + diff --git a/templates/review-brief.md b/templates/review-brief.md deleted file mode 100644 index 9a8dd8f..0000000 --- a/templates/review-brief.md +++ /dev/null @@ -1,17 +0,0 @@ -# Review Brief - -## Review Target - -## Reviewer Role - -## Context Pack - -## Review Objectives - -## Known Concerns - -## Required Output - -- `session.md` for process record -- `report.md` for final review result - diff --git a/templates/review-report.md b/templates/review-report.md deleted file mode 100644 index 5e425dd..0000000 --- a/templates/review-report.md +++ /dev/null @@ -1,16 +0,0 @@ -# Review Report - -## Verdict - -## Strongest Parts - -## Critical Issues - -## Structural Risks - -## Missing Context Or Evidence - -## Repair Suggestions - -## Questions For User - diff --git a/templates/source-map.md b/templates/source-map.md deleted file mode 100644 index c6f5a70..0000000 --- a/templates/source-map.md +++ /dev/null @@ -1,14 +0,0 @@ -# Source Map - -## Knowledge Vault Sources - -## CCPE Sources - -## External Sources - -## Selected Materials - -## Source Policy - -This project references source files unless explicitly instructed to copy selected excerpts into local context packs. -