Book Writing Workspace

Create a reusable manuscript workspace with folders, agents, prompts, instructions, and setup scripts.

When to use

• Book writing, technical writing, 執筆プロジェクト, Re:VIEW
• Creating a new book or technical writing project
• Bootstrapping a manuscript repository from templates
• Setting up Markdown → Re:VIEW → PDF workflow

Quick Start

python scripts/setup_workspace.py `
    --name "project-name" `
    --title "Book Title" `
    --path "D:\target\path" `
    --chapters 8

Setup Workflow

1. Gather info: Project name, title, location, chapter count
2. Run script: scripts/setup_workspace.py
3. Review output: Confirm README, agents, prompts, and docs were created
4. Customize: Edit docs/page-allocation.md, docs/schedule.md, and .github/copilot-instructions.md

Generated Workspace

• Manuscript folders under 01_contents_keyPoints/, 02_contents/, and 04_images/
• AI workflow files under .github/agents/, .github/instructions/, and .github/prompts/
• Project docs such as README.md, docs/page-allocation.md, and docs/schedule.md
• Helper scripts such as scripts/count_chars.py and scripts/convert_md_to_review.py

Recommended Writing Unit

• Use 1 file = 1 section as the default manuscript unit.
• Keep chapter intro in ch{N}-00_<title>.md and section files in ch{N}-01_..., ch{N}-02_....
• For PDF/Re:VIEW output, heading levels define hierarchy, while file split mainly improves authoring and review workflow.

Migration Checklist (Path / Naming Changes)

When reorganizing workspace paths or file naming rules, update these together:

1. Docs: docs/naming-conventions.md, docs/page-allocation.md, docs/writing-guide.md
2. Instructions: templates/instructions/writing-*.instructions.md (applyTo and examples)
3. Scripts: templates/scripts/count_chars.py, templates/scripts/convert_md_to_review.py
4. Agent docs: templates/agents/*.agent.md if paths are explicitly written

Then verify with:

• python scripts/count_chars.py
• python scripts/convert_md_to_review.py

Agents Overview

Dependencies

Done Criteria

• Workspace folder structure created
• 4 agents deployed to .github/agents/
• docs/page-allocation.md configured
• README.md and docs/schedule.md customized
• /gc_Commit prompt working

Key References