Imported from benni-arnarsson/ormstunga (dorian/AGENTS.md). Install upstream with npx skills add benni-arnarsson/ormstunga --skill dorian. Copyright stays with the author.

dorian — literary-critique plugin

dorian is the literary-critique CLI plugin in the ormstunga plugin family. It ingests manuscripts, critiques them against style profiles and RAG-retrieved exemplars, tracks characters / plot / world, runs editor-style issue detection, supports ideation, export, scheduler, memory, and a few adjacent capabilities (similarity search, summary, background generation).

Every user-facing capability is registered with the dispatch registry and exposed to ahab over the CLI Transport Protocol (docs/cli-transport-protocol.md). Ahab is a peer package, not a dependency of dorian.

Layout

See ARCHITECTURE_WALKTHROUGH.md for deeper context.

Package invariants (canonical)

1. Manual DI through dorian/app.App. No service locator, no framework-level container. Every command handler is injected via Kong's Bind() with an *App. Tests construct App with mocks.
2. model.Adapter remains the single LLM gate from dorian's perspective; it is a Go type alias to shared/llmadapter.Adapter, which is the cross-plugin canonical type. Plugins import shared/, never the reverse — putting the canonical interface in shared/ is the only shape that satisfies the dependency-arrow rule. Every LLM call goes through that interface; no direct HTTP against Ollama, no new adapter frameworks. Prompt and schema live at the call site; the adapter only transports bytes. Traces to the critique-profiles and integration archived changes.
3. core.ParseDorianMD parses project context. The Markdown front-matter + section grammar is a contract — DORIAN.md in a manuscript directory holds style, characters, plot, world, notes. Returns nil with no error when absent. Never hard-code project context; always go through this parser.
4. RAG pipeline is deterministic. Chunk + embed + store is idempotent on the same input. Re-ingesting the same file does not duplicate chunks. Traces to ollama-rag.
5. Every new dorian feature has a CLI command AND a dispatch handler. Register in dorian/dispatch/handlers.go; the handler is automatically exposed via dorian ahab exec <capability>. No separate MCP tool file.
6. No real LLM API calls in tests. All LLM calls must be mocked via model.Adapter. Tests are table-driven; mocks are manual.
7. Command daemon dependency. Every new dorian CLI command MUST be registered in either standaloneCommands or requiresDaemonCommands in cmd/dorian/main.go. Standalone commands run under daemon_consent = "denied"; requires-daemon commands fail fast with the existing remediation message. The proposing OpenSpec change SHALL declare the new command's category. Drift is caught at make test time by TestStandaloneAndRequiresDaemonAreExhaustive. See openspec/specs/dorian-command-daemon-dependency/spec.md.

Shared/-first

Before inventing a cross-plugin-sibling plumbing surface inside dorian, prefer the shared utility:

• shared/cliplugin — manifest emission, Dispatcher interface, Kong subcommand tree, canonical JSON marshaler. dorian/ahab/ and dorian/manifest/ build on this; do not hand-roll manifest emission.
• shared/credentials — socket-speaking credentials client. Use for any secret dorian needs (Anthropic key, etc.); never read credentials from env directly in plugin code.
• shared/admin — admin registry + Serve helper. If dorian grows a plugin-admin protocol beyond what the CLI transport already covers, use this.

Examples of what belongs in shared/: anything a second plugin might also need (manifest shape, credential retrieval, admin registry). Examples of what stays in dorian/: critique-specific grammar, manuscript parser, tracking schemas, profile format.

Agent dispatch

• dorian-architect — plan-time review / proposal design / architecture alignment for dorian-local changes. Read-only.
• dorian-engineer — apply-time TDD / debug / verification for dorian tasks.
• Escalate to ahab-architect for CLI-transport or plugin-admin questions (the dorian/ahab glue layer). Escalate to the global architect for multi-package sequencing.

Cross-package links

• ahab — the orchestrator ahab discovers dorian via CLI transport. dorian/ahab/ is the client side.
• feanor — sibling plugin; feanor hosts coding backends while dorian hosts critique. They do not import each other.
• anansi / mercury — sibling plugins for marketing and publishing. Cross-reference via shared/ only.
• shared — the utilities above. See shared/AGENTS.md.

Verification

make fmt && make test for unit, make test-e2e for full CLI end-to-end (requires Ollama + qwen3.5:9b + nomic-embed-text; the e2e suite runs only on the designated mac-mini host per the root AGENTS.md "E2E test execution policy" section), make test-e2e-playwright for LibreChat UI (requires Docker, same host gate). Package-scoped: go test ./dorian/.... Never claim done without a fresh run.