# lanyxiaosheng/bookflow-skill architecture

> Architecture diagram of the GitHub repository lanyxiaosheng/bookflow-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lanyxiaosheng/bookflow-skill
- Repository: https://github.com/lanyxiaosheng/bookflow-skill

## Overview

bookflow-skill is a reusable, human-guided workflow for AI-assisted short-fiction production, supported by factory materials and BookFlow prompt modules. The README documents the main sequence from project setup through drafting, supporting materials, QA, and review, plus topic selection, benchmarking, publishing, and retrospectives. No source excerpts were provided, so relationships here rely only on the README; the mapping of individual prompt files to workflow stages is not asserted.

Main entry points: [`references/bookflow-prompts`](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts) (Prompt Library), [`references/factory`](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory) (Topic Selection), [`references/factory/02-资产库`](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory/02-%E8%B5%84%E4%BA%A7%E5%BA%93) (Story Assets), [`README.md`](https://github.com/lanyxiaosheng/bookflow-skill/blob/master/README.md) (Human Decisions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Story Workflow"]
  node_topic["Topic Selection"]
  node_project["Project Setup"]
  node_characters["Character Setup"]
  node_outline["Outline"]
  node_beats["Chapter Beats"]
  node_draft["Chapter Draft"]
  node_materials["Supporting Materials"]
  node_qa["Publish QA"]
  node_review["Review"]
end

subgraph group_factory["Factory Resources"]
  node_benchmark["Benchmark Analysis"]
  node_assets["Story Assets"]
  node_publishing["Publishing"]
end

subgraph group_prompts["Prompt Modules"]
  node_promptset["Prompt Library"]
end

subgraph group_oversight["Human Oversight"]
  node_approval["Human Decisions<br/>[README.md]"]
  node_retrospective["Project Retrospective<br/>[05-项目复盘表.md]"]
end

node_writer(("Writer"))
node_bookflow["Local BookFlow"]

node_writer -->|"provides idea"| node_topic
node_writer -.->|"starts locally"| node_bookflow
node_bookflow -.->|"enters at"| node_topic
node_topic -->|"scores into"| node_project
node_project -->|"sets up"| node_characters
node_characters -->|"precedes"| node_outline
node_outline -->|"precedes"| node_beats
node_beats -->|"precedes"| node_draft
node_draft -->|"precedes"| node_materials
node_materials -->|"precedes"| node_qa
node_qa -->|"precedes"| node_review
node_writer -->|"controls decisions"| node_approval
node_benchmark -.->|"informs selection"| node_assets
node_review -.->|"supports review"| node_retrospective
node_promptset -.->|"includes prompts"| node_characters
node_promptset -.->|"includes prompts"| node_outline
node_promptset -.->|"includes prompts"| node_beats
node_promptset -.->|"includes prompts"| node_draft
node_promptset -.->|"includes prompts"| node_qa
node_publishing -.->|"publishes after"| node_qa

click node_topic "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory"
click node_project "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory"
click node_outline "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts"
click node_beats "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts"
click node_draft "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts"
click node_materials "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts"
click node_qa "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts"
click node_review "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts"
click node_benchmark "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory"
click node_assets "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory/02-%E8%B5%84%E4%BA%A7%E5%BA%93"
click node_publishing "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory"
click node_promptset "https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts"
click node_approval "https://github.com/lanyxiaosheng/bookflow-skill/blob/master/README.md"
click node_retrospective "https://github.com/lanyxiaosheng/bookflow-skill/blob/master/references/factory/03-%E9%A1%B9%E7%9B%AE%E7%94%9F%E4%BA%A7/05-%E9%A1%B9%E7%9B%AE%E5%A4%8D%E7%9B%98%E8%A1%A8.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_topic,node_project,node_characters,node_outline,node_beats,node_draft,node_materials,node_qa,node_review toneBlue
class node_benchmark,node_assets,node_publishing toneAmber
class node_promptset toneMint
class node_approval,node_retrospective toneRose
class node_writer,node_bookflow toneIndigo
```

## Components

### Story Workflow

- [Topic Selection](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory): `references/factory`
- [Project Setup](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory): `references/factory`
- **Character Setup**
- [Outline](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts): `references/bookflow-prompts`
- [Chapter Beats](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts): `references/bookflow-prompts`
- [Chapter Draft](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts): `references/bookflow-prompts`
- [Supporting Materials](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts): `references/bookflow-prompts`
- [Publish QA](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts): `references/bookflow-prompts`
- [Review](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts): `references/bookflow-prompts`

### Factory Resources

- [Benchmark Analysis](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory): `references/factory`
- [Story Assets](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory/02-%E8%B5%84%E4%BA%A7%E5%BA%93): `references/factory/02-资产库`
- [Publishing](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/factory): `references/factory`

### Prompt Modules

- [Prompt Library](https://github.com/lanyxiaosheng/bookflow-skill/tree/master/references/bookflow-prompts): `references/bookflow-prompts`

### Human Oversight

- [Human Decisions](https://github.com/lanyxiaosheng/bookflow-skill/blob/master/README.md): `README.md`
- [Project Retrospective](https://github.com/lanyxiaosheng/bookflow-skill/blob/master/references/factory/03-%E9%A1%B9%E7%9B%AE%E7%94%9F%E4%BA%A7/05-%E9%A1%B9%E7%9B%AE%E5%A4%8D%E7%9B%98%E8%A1%A8.md): `references/factory/03-项目生产/05-项目复盘表.md`

### Other components

- **Writer**
- **Local BookFlow**

## Connections

- Writer → Topic Selection: provides idea (evidence: `README.md`)
- Writer → Local BookFlow: starts locally (evidence: `README.md`)
- Local BookFlow → Topic Selection: enters at (evidence: `README.md`)
- Topic Selection → Project Setup: scores into (evidence: `README.md`)
- Project Setup → Character Setup: sets up (evidence: `README.md`)
- Character Setup → Outline: precedes (evidence: `README.md`)
- Outline → Chapter Beats: precedes (evidence: `README.md`)
- Chapter Beats → Chapter Draft: precedes (evidence: `README.md`)
- Chapter Draft → Supporting Materials: precedes (evidence: `README.md`)
- Supporting Materials → Publish QA: precedes (evidence: `README.md`)
- Publish QA → Review: precedes (evidence: `README.md`)
- Writer → Human Decisions: controls decisions (evidence: `README.md`)
- Benchmark Analysis → Story Assets: informs selection
- Review → Project Retrospective: supports review
- Prompt Library → Character Setup: includes prompts
- Prompt Library → Outline: includes prompts
- Prompt Library → Chapter Beats: includes prompts
- Prompt Library → Chapter Draft: includes prompts
- Prompt Library → Publish QA: includes prompts
- Publishing → Publish QA: publishes after