Book Writing Workspace

Set up a professional book writing workspace with AI-assisted workflow support.

When to use Creating a new book or technical writing project Setting up Markdown → Re:VIEW → PDF workflow Establishing multi-chapter document structure with AI agent support Setup Workflow Step 1: Gather Project Information

Ask the user for project configuration:

📚 Book Writing Workspace Setup

Please provide the following information:

1. Project Name (folder name, e.g., "my-book-project")
2. Book Title (e.g., "Introduction to Cloud Security")
3. Target Location (e.g., "D:\projects\")
4. Chapter Structure - Choose one:
5. [ ] Standard (8 chapters: Intro → 6 main → Conclusion)
6. [ ] Custom (specify chapter titles)
7. Include Re:VIEW output? (for PDF generation)
8. [ ] Yes (requires Docker + Re:VIEW setup)
9. [ ] No (Markdown only)
10. Include reference materials folder?
11. [ ] Yes
12. [ ] No

Step 2: Create Directory Structure

Run the setup script with gathered information:

Setup workspace with the collected project configuration

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

Step 3: Customize Configuration

After setup, guide the user to customize:

Edit docs/page-allocation.md - Set target word counts per chapter Edit .github/copilot-instructions.md - Update book-specific overview Review agent configurations in .github/agents/ Generated Structure {project-name}/ ├── .github/ │ ├── agents/ # AI agent definitions │ │ ├── writing.agent.md │ │ ├── writing-reviewer.agent.md │ │ ├── converter.agent.md │ │ └── orchestrator.agent.md │ ├── instructions/ # Writing guidelines │ │ ├── writing/ │ │ │ ├── writing.instructions.md │ │ │ ├── writing-heading.instructions.md │ │ │ └── writing-notation.instructions.md │ │ └── git/ │ │ └── commit-format.instructions.md │ ├── prompts/ # Reusable prompts │ │ ├── gc_Commit.prompt.md │ │ ├── gcp_Commit_Push.prompt.md │ │ └── gpull.prompt.md │ └── copilot-instructions.md ├── 01_contents_keyPoints/ # Outlines and key points │ └── {chapter folders}/ ├── 02_contents/ # Final manuscripts │ └── {chapter folders}/ ├── 03_re-view_output/ # Re:VIEW source and PDF output (optional) │ ├── output_re/ │ ├── output_pdf/ │ └── images/ ├── 04_images/ # Image assets │ └── {chapter folders}/ ├── 99_material/ # Reference materials (optional) │ ├── 01_contracts/ │ ├── 02_proposals/ │ └── 03_references/ ├── docs/ │ ├── writing-guide.md # Workflow guide │ ├── naming-conventions.md # File naming rules │ ├── page-allocation.md # Word count targets │ └── schedule.md # Project schedule ├── scripts/ │ ├── count_chars.py # Character counter │ └── convert_md_to_review.py (optional) ├── .gitignore ├── AGENTS.md └── README.md

Agents Overview Agent Role Permissions @writing Write and edit manuscripts Edit 02_contents/ @writing-reviewer Review manuscripts (P1/P2/P3) Read only @converter Convert Markdown to Re:VIEW Edit 03_re-view_output/ @orchestrator Coordinate multi-agent workflow Delegate to other agents Prompts Overview Prompt Usage /gc_Commit Git commit with formatted message /gcp_Commit_Push Git commit and push /gpull Git pull with change summary Customization Points Chapter Structure

Default 8-chapter structure:

1. Introduction 1-6. Main Chapters (customizable titles)
2. Conclusion
3. Glossary (optional)

Word Count Targets

Configurable in docs/page-allocation.md:

File Type Default Target Range Chapter intro 300-500 chars Adjustable Main section 3,000-5,000 chars Adjustable Column/sidebar 2,000-3,000 chars Adjustable File Naming Convention

Pattern: {prefix}-{chapter}-{section}-{number}_{title}.md

Example: 01-1-a-00_Introduction_to_Topic.md

Resources Directory Contents scripts/ Setup and utility scripts references/ Template files for agents, instructions, prompts assets/ Static files (.gitignore templates, etc.) Post-Setup Actions

After workspace creation:

Initialize Git (commented example):

Initialize repository and create the first commit

git init && git add . && git commit -m "Initial commit"

Open in VS Code (commented example):

Open the project in VS Code

code {project-path}

Test prompts: Try /gc_Commit to verify setup

Start writing: Create key points in 01_contents_keyPoints/

Dependencies Tool Purpose Required Python 3.8+ Scripts Yes Git Version control Yes Docker Re:VIEW PDF build Optional Re:VIEW PDF generation Optional