NaC — Narrative-as-Code

AI novel writing framework for OpenCode. Author writes. AI mirrors.

Installation

For Humans

Let an AI install and configure NaC for you. The setup involves npm, Python dependencies, OpenCode provider config, and project injection — an AI agent handles all of it correctly.

Paste this into OpenCode, Claude Code, Cursor, or any agent:

Install and configure NaC (Narrative-as-Code) by following:
https://raw.githubusercontent.com/alint/nac/main/docs/installation.md

For LLM Agents

curl -fsSL https://raw.githubusercontent.com/alint/nac/main/docs/installation.md

The guide covers: prerequisites, npm install, project initialization, Python MCP dependencies, OpenCode provider setup, parallel subagent configuration, and the full writing workflow.

Quick start (DIY)

npm install -g @alintever/nac
nac init ./my-novel
cd my-novel && opencode web
# then run /nac:init in the session

How it works

NaC injects a complete novel-writing framework into your project:

| Layer | What | Count | |-------|------|-------| | Skills | Writing, outlining, reviewing, init | 4 | | Agents | Writer (creative), Reviewer (reasoning), Planner | 3 | | MCP | L1 rules check, foreshadow tracker, style learner | 3 | | Commands | /nac:write, /nac:init, /nac:outline, /nac:review | 4 |

Writing pipeline

Context Assembler → Draft Generation → L1 ∥ L2×8 ∥ L3 (parallel checks)
    → Self-Revision (≤3 rounds) → Submit to Author

Every chapter passes through zero-LLM rule checks, 8 parallel fact-checking agents, and self-revision before the author sees it.

CLI

nac init [path]     Inject NaC into a directory
nac status [path]   Show novel stats (title, chapters, foreshadows)
nac update [path]   Upgrade injected skills to latest nac version
nac mcp <server>    Start a MCP server (l1 | foreshadows | style)

License

MIT