/book-map

/​book-map

Scaffold, audit, and manage Book_Map projects.

Subcommands

/​book-map scaffold

Scaffold the Book_Map structure in the current project directory.

Instructions for Claude:

1. Read references/​directory-spec.md for the complete file/​directory specification.
2. Create all required directories that do not exist.
3. Create all required files that do not exist, using appropriate templates.
4. For each file created, add the <!-- reviewed: YYYY-MM-DD --> freshness tag with today's date.
5. Do NOT overwrite existing files — only create missing ones.
6. After scaffolding, run the audit subcommand to verify completeness.

Output format:

Created: [list of files/​dirs created]
Skipped: [list of files/​dirs that already existed]
Run `/​book-map audit` to verify completeness.

/​book-map audit

Audit the current project against the Book_Map standard.

Instructions for Claude:

1. Read references/​checklist.md for the audit criteria.
2. Check each criterion and report pass/​fail.
3. For each failure, reference references/​remediation.md for the fix.
4. Report an overall score (pass count / total count).

Output format:

Book_Map Audit Results
======================
[Category]: [pass/​fail count]
  ✓ criterion description
  ✗ criterion description → fix: [remediation step]

Overall: [total pass] / [total checks] passed

/​book-map add-book

Add a new book to the series.

Instructions for Claude:

1. Determine the next book number by checking existing books/​book-NN/ directories.
2. Create the book directory structure:

   books/​book-NN/
     manuscript/
       _INDEX.md
       front_matter/​.gitkeep
       chapters/
       back_matter/​.gitkeep
     docs/
       _INDEX.md
       book/
         OVERVIEW.md
         OUTLINE.md
         CONTINUITY_BIBLE.md
   

3. Populate each file with appropriate templates:
   • manuscript/​_INDEX.md — empty chapter status table
   • docs/​_INDEX.md — per-book doc index linking to book-specific and shared docs
   • docs/​book/​OVERVIEW.md — minimal book premise referencing series arc
   • docs/​book/​OUTLINE.md — empty outline with contract format
   • docs/​book/​CONTINUITY_BIBLE.md — initialized from previous book's final state
4. Add the new book to books/​_INDEX.md.
5. Create a handoff template at series/​handoffs/​BOOK-NN-TO-MM.md (from previous book to this one).
6. Update docs/​_INDEX.md to include the new per-book documents.

Output format:

Created book-NN:
  books/​book-NN/​manuscript/​_INDEX.md
  books/​book-NN/​manuscript/​front_matter/​.gitkeep
  books/​book-NN/​manuscript/​chapters/
  books/​book-NN/​manuscript/​back_matter/​.gitkeep
  books/​book-NN/​docs/​_INDEX.md
  books/​book-NN/​docs/​book/​OVERVIEW.md
  books/​book-NN/​docs/​book/​OUTLINE.md
  books/​book-NN/​docs/​book/​CONTINUITY_BIBLE.md

Updated:
  books/​_INDEX.md
  series/​handoffs/​BOOK-[prev]-TO-NN.md
  docs/​_INDEX.md