{
  "markdown": "<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/Version-1.1.0-brightgreen.svg\" alt=\"Version\">\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\" alt=\"License\"></a>\n  <img src=\"https://img.shields.io/badge/Claude_Code-Plugin-purple.svg\" alt=\"Claude Code Plugin\">\n  <img src=\"https://img.shields.io/badge/Agents-18-orange.svg\" alt=\"18 Agents\">\n  <img src=\"https://img.shields.io/badge/Skills-10-green.svg\" alt=\"10 Skills\">\n  <a href=\"https://github.com/MJbae/awesome-novel-studio/stargazers\"><img src=\"https://img.shields.io/github/stars/MJbae/awesome-novel-studio?style=social\" alt=\"GitHub Stars\"></a>\n</p>\n\n# Awesome Novel Studio\n\n**AI Web Novel Creation Harness** — A Claude Code Plugin\n\n**English** | [한국어](README_KO.md)\n\nAn end-to-end web novel production system built on Claude Code. Combines 18 specialist agents and 10 skills to automate the full pipeline: **propose → design → create → polish → rewrite**.\n\n> **Production-Proven** — A web novel written with this workflow secured a publishing deal.\n> Daily views 2,500+ / Likes 1,000+ / Subscribers 300+\n\n---\n\n## Installation\n\n### Via Marketplace\n\n#### Add the marketplace\n```shell\n/plugin marketplace add MJbae/awesome-novel-studio\n```\n\n#### Install the plugin\n```shell\n/plugin install novel-studio@awesome-ai-studio\n```\n\n#### Restart session to activate\n```shell\n/exit\n```\n\n---\n\n## Quick Start\n\n```bash\n# 1. Generate 3 novel proposals, pick one\n/propose\n\n# 2. Big design (bootstrap + character sheet + plot-hook guide)\n/design-big\n\n# 3. Small design (25-episode detailed design)\n/design-small\n\n# 4. Write episodes\n/create\n\n# 5. Polish\n/polish\n```\n\n## Pipeline\n\n```\nPropose ────── Design ─────────────── Create ──── Polish ──── Publish\n/propose        /design-big                /create   /polish\n                /design-small\n                     ↕ On design changes\n                  /rewrite → /polish\n```\n\n---\n\n## The Three Walls of Long-Form AI Fiction\n\nWriting a single 5,000-character episode with AI is easy. Scaling that to 300 episodes and 1.5 million characters is where things break.\n\n| The Wall | Symptom | Awesome Novel Studio's Solution |\n|----------|---------|------------------------|\n| **Character depth collapse** | Distinct personalities, speech patterns, and motivations blur into sameness as episodes accumulate. | **Character sheet + voice table** — Define each character's tone, sentence endings, and non-verbal palette at design time. Automatically verified every episode via the `VOICE`, `TITLE`, and `ALIVE` polish axes. |\n| **Story coherence breakdown** | Cause-and-effect chains and foreshadowing unravel across a sprawling world. | **Plot-hook guide + continuity-bridge** — Decompose the full narrative arc into 25-episode beat structures. Before each episode, `continuity-bridge` collects timeline, foreshadowing, and character state from the previous 2 episodes and feeds it to the creation agent. |\n| **Number and setting inconsistency** | Currency values, historical dates, character ages — the hard facts that anchor the story start contradicting each other. | **guard_rails + LOGIC axis** — Define absolute rules in `novel-config.md`. The `LOGIC` polish axis cross-checks numbers and timeline against the previous 2 episodes. |\n\n---\n\n## Commands\n\n| Command | Description | Notes |\n|---------|-------------|-------|\n| `/propose` | Generate 3 proposals from genre + Korean platform + concept | Starting point for a new novel |\n| `/design-big` | Full novel design (bootstrap, characters, plot) | Includes auto-research |\n| `/design-small` | 25-episode detailed design | Requires big design first |\n| `/design` | Design router (big + small combined) | Use when scope is unclear |\n| `/bootstrap` | Generate bootstrap document only | World-building and concept only |\n| `/character` | Generate character sheet only | Character design only |\n| `/plot-hook` | Generate plot-hook guide only | Narrative structure only |\n| `/create` | Write episodes sequentially | Based on design documents |\n| `/polish` (= `/lint`) | 16-axis polish (6 agents in parallel) | Auto-sequential progression |\n| `/rewrite` (= `/revise`) | Rewrite episodes after design changes | Auto-calculates impact scope |\n\n### Scope Targeting\n\nAll create/polish/rewrite commands accept episode range arguments:\n\n```bash\n/create EP051          # Start from EP051\n/create EP001-EP010    # EP001 through EP010\n/polish start          # From EP001\n/rewrite project-name EP001-EP010\n```\n\n## Workflow\n\n```\n/propose                Generate 3 proposals, select 1\n       ↓\n/design-big             Bootstrap + character sheet + plot-hook guide\n       ↓                → novel-config.md auto-generated\n/design-small           25-episode detailed design (optional, recommended)\n       ↓\n/create                 Episode creation (auto-sequential)\n       ↓\n/polish                 16-axis polish (auto-sequential)\n       ↓\n[On design changes] /rewrite → /polish   Rewrite then re-polish\n```\n\n## Directory Structure\n\nRunning the pipeline generates this project structure:\n\n```\n{project-name}/\n├── novel-config.md              # Project config (central file)\n├── design/                      # Design documents\n│   ├── {name}_bootstrap.md      # World-building, concept, platform strategy\n│   ├── {name}_character.md      # Character profiles, relationships, dialogue DNA\n│   └── {name}_plot-hook.md      # 3-act structure, 25-ep beats, hook strategy\n├── episode/                     # Episode manuscripts\n│   ├── ep001.md\n│   └── ...\n├── revision/                    # Working files\n│   ├── fix_plan.md              # Polish progress tracker\n│   └── learnings.md             # Patterns discovered during polish\n└── _workspace/                  # Temporary workspace\n    └── 00_research/             # Auto-research results\n```\n\n## novel-config.md\n\nThe central configuration file for the entire pipeline. Auto-generated by `/design-big`, then reviewed and edited by the user.\n\n```yaml\nproject:\n  name: \"My Novel\"\n  target_platform: \"문피아\"\n  target_genre: \"regression+specialist\"\n  episode_dir: \"episode/\"\n  work_dir: \"revision/\"\n  design_dir: \"design/\"\n\ndesign_documents:\n  bootstrap: \"design/my-novel_bootstrap.md\"\n  character_core: \"design/my-novel_character.md\"\n  plot_guide: \"design/my-novel_plot-hook.md\"\n\nep_range_table:\n  - range: \"EP001-EP025\"\n    label: \"Act 1: Origin\"\n    plot_guide: \"design/my-novel_plot-hook.md\"\n\nguard_rails:\n  - \"The protagonist's regression ability only allows recalling past information\"\n\ncustom_axes:\n  EXPERTISE: \"Domain knowledge should be hinted at through dialogue, never explained\"\n```\n\n- **ep_range_table**: Episode ranges auto-extracted from the plot guide\n- **guard_rails**: Absolute rules enforced at every creation and polish step\n- **custom_axes**: Project-specific additional polish criteria\n\n## 16-Axis Polish System\n\n| Axis | Name | Description |\n|------|------|-------------|\n| 1 | BANNED | Banned expressions (time-skip cliches, meta-commentary) |\n| 2 | VOICE | Character dialogue consistency (checked against voice table) |\n| 3 | TITLE | Forms of address (speaker, listener, context) |\n| 4 | SILENCE | Silence pattern overuse (max 4 per episode) |\n| 5 | TRANS | Translationese, AI tone, semantic literal translation detection |\n| 6 | SCENE | Scene structure (beats, conflict, resolution) |\n| 7 | LOGIC | Narrative logic, timeline, numerical consistency |\n| 8 | SUMMARY | Scene-level justification of existence |\n| 9 | UNIFORM | Cross-episode consistency |\n| 10 | HOOK | Hook intensity (opening, midpoint, cliffhanger) |\n| 11 | OPENING | Opening hook within 200 characters |\n| 12 | MOBILE | Mobile readability (paragraph length, dialogue ratio) |\n| A1 | ALIVE | Echo dialogue resolution |\n| A2 | ALIVE | Silence-to-nonverbal replacement |\n| A3 | ALIVE | Character vitality at tension points |\n| A4 | ALIVE | Emotional distance management |\n\n## Agent Architecture\n\n### Design Agents (5)\n`concept-builder` · `character-architect` · `plot-hook-engineer` · `proposal-generator` · `domain-researcher`\n\n### Creation Agents (4)\n`episode-architect` · `episode-creator` · `continuity-bridge` · `quality-verifier`\n\n### Polish Agents (6)\n`rule-checker` · `story-analyst` · `platform-optimizer` · `alive-enhancer` · `revision-executor` · `revision-reviewer`\n\n### Rewrite Agents (4)\n`revision-analyst` · `character-sculptor` · `episode-rewriter` · `quality-verifier`\n\n> `quality-verifier` is shared between Creation and Rewrite phases (18 unique agents total).\n\n## Acknowledgments\n\nSpecial thanks to [Minho Hwang (revfactory)](https://github.com/revfactory) — his [Harness](https://github.com/revfactory/harness) plugin made it easy to bootstrap the initial harness architecture. The insights he shares on LinkedIn and other channels have been a constant source of inspiration.\n\n## License\n\n[Apache 2.0](LICENSE)\n",
  "bytes": 8833,
  "sha": "8be69cf1456ff7e8765e25f1bb0f4662024467061c8859cf17c8de9287ab5f90",
  "repo_slug": "mjbae/novel-studio",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mjbae_novel_studio_novel_studio_0e8b91fd/readme"
}