name: book-writing-workspace
description: Set up a complete book writing workspace with AI agents, instructions, prompts, and scripts. Use when users want to create a new book/technical writing project with Markdown + Re:VIEW + PDF output workflow. Triggers on "book writing workspace", "technical book project", "執筆ワークスペース", or similar project setup requests.
license: Complete terms in LICENSE.txt
metadata:
author: yamapan (https://github.com/aktsmm)

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:
   - [ ] Standard (8 chapters: Intro → 6 main → Conclusion)
   - [ ] Custom (specify chapter titles)
5. **Include Re:VIEW output?** (for PDF generation)
   - [ ] Yes (requires Docker + Re:VIEW setup)
   - [ ] No (Markdown only)
6. **Include reference materials folder?**
   - [ ] Yes
   - [ ] 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:

1. Edit docs/page-allocation.md - Set target word counts per chapter
2. Edit .github/copilot-instructions.md - Update book-specific overview
3. 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

Prompts Overview

Customization Points

Chapter Structure

Default 8-chapter structure:

0. Introduction
1-6. Main Chapters (customizable titles)
7. Conclusion
8. Glossary (optional)

Word Count Targets

Configurable in docs/page-allocation.md:

File Naming Convention

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

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

Resources

Post-Setup Actions

After workspace creation:

1. Initialize Git (commented example):

bash # Initialize repository and create the first commit git init && git add . && git commit -m "Initial commit"

1. Open in VS Code (commented example):

bash # Open the project in VS Code code {project-path}

1. Test prompts: Try /gc_Commit to verify setup
2. Start writing: Create key points in 01_contents_keyPoints/

Dependencies