# LAKA Volumetric Writing Grammar System

> Break writing into first principles and expose machine-readable IF / ELSE / AND / OR rules across grammar, style, narrative, nonfiction, technical writing, copywriting, accessibility, ethics, and editing.

Version 1.0.0. 228 base rules, 56 LAKA transformation states, 5 cross-axis rules — 289 operational records across 30 JSON files.

This is a decision system, not a style guide. Every rule declares how hard it binds:
- hard_constraint: must pass or block
- context_default: apply unless a documented exception improves the intended outcome
- heuristic: score and rank
- creative_option: offer as a controlled alternative

## Start here
1. Read 01-first-principles.json.
2. Load 02-laka-grid.json and 03-context-axes.json.
3. Implement 04-logic-operators.json using 05-rule-schema.json.
4. Load the relevant application profile and rule domains.
5. Execute 23-rule-engine.json and validate against 26-rule-test-cases.json.

## API
Base URL: https://writingsystem.bowtiekreative.com
OpenAPI: https://writingsystem.bowtiekreative.com/v1/openapi.json
Index: https://writingsystem.bowtiekreative.com/v1

Read:
- https://writingsystem.bowtiekreative.com/v1/rules?domain=clarity — filter rules by domain, layer, strength, source or free text
- https://writingsystem.bowtiekreative.com/v1/rules/{id} — one rule with its condition tree, branches, tests and sources
- https://writingsystem.bowtiekreative.com/v1/files/{slug} — any of the 30 source files, verbatim
- https://writingsystem.bowtiekreative.com/v1/search?q= — search rules, terms, templates, pipelines and sources

Run:
- POST https://writingsystem.bowtiekreative.com/v1/evaluate — run the rules over a text
- POST https://writingsystem.bowtiekreative.com/v1/resolve — which rules govern a context, before drafting
- POST https://writingsystem.bowtiekreative.com/v1/score — score against the twelve quality metrics
- POST https://writingsystem.bowtiekreative.com/v1/analyze — surface analysis only

## How the engine handles what it cannot know
Rule conditions read named facts. The analyser derives surface facts from raw text. Semantic
facts — whether a claim is causal, whether evidence suffices, what a sentence intends — are not
derivable and are never guessed. Such conditions evaluate to `unknown`, and the rule is
returned under `needs_input` with the exact fact paths required. Supply them under `facts`.

See https://writingsystem.bowtiekreative.com/v1/engine/facts for the full list of derived versus required paths.

## Domains
- grammar (20 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=grammar
- punctuation (20 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=punctuation
- syntax (20 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=syntax
- structure (20 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=structure
- clarity (20 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=clarity
- technical_writing (20 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=technical_writing
- copywriting (20 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=copywriting
- narrative (18 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=narrative
- argument (16 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=argument
- accessibility (15 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=accessibility
- editing (15 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=editing
- ethics (12 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=ethics
- voice (6 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=voice
- rhythm (6 rules): https://writingsystem.bowtiekreative.com/v1/rules?domain=rhythm

## Application profiles
- PROFILE-GENERAL — General nonfiction: grammar, punctuation, syntax, structure, clarity, voice, argument, editing, ethics
- PROFILE-PLAIN — Plain and accessible public content: grammar, syntax, structure, clarity, accessibility, editing, ethics
- PROFILE-TECH — Technical documentation: grammar, punctuation, syntax, structure, clarity, technical_writing, accessibility, editing, ethics
- PROFILE-NARRATIVE — Narrative prose: grammar, punctuation, syntax, voice, narrative, editing, ethics
- PROFILE-COPY — Persuasive copy: grammar, syntax, structure, clarity, voice, copywriting, accessibility, ethics, editing
- PROFILE-SAFETY — Safety-critical instruction: grammar, punctuation, syntax, structure, clarity, technical_writing, accessibility, ethics, editing
- PROFILE-UI — UX microcopy: grammar, syntax, clarity, voice, technical_writing, accessibility, ethics

## Pages
- https://writingsystem.bowtiekreative.com/principles — First principles: Eleven levels, signal to content system
- https://writingsystem.bowtiekreative.com/laka — The LAKA grid: 6 × 6 × 6, and 14 dynamics × 4 states
- https://writingsystem.bowtiekreative.com/logic — Rule logic: Conditions, branches, exceptions
- https://writingsystem.bowtiekreative.com/primitives — Linguistic primitives: Parts of speech, dependencies, discourse
- https://writingsystem.bowtiekreative.com/rules — Browse all rules: 228 base rules, filterable
- https://writingsystem.bowtiekreative.com/rules?strength=hard_constraint — Hard constraints: What must pass or block
- https://writingsystem.bowtiekreative.com/tests — Test cases: Minimal pairs, before and after
- https://writingsystem.bowtiekreative.com/files — Source files: All 30 JSON files, verbatim
- https://writingsystem.bowtiekreative.com/engine — Run the engine: Evaluate a text against the rules
- https://writingsystem.bowtiekreative.com/templates — Composition templates: 19 conditional structures
- https://writingsystem.bowtiekreative.com/pipelines — Writing pipelines: 7 end-to-end sequences
- https://writingsystem.bowtiekreative.com/profiles — Application profiles: Which domains switch on where
- https://writingsystem.bowtiekreative.com/metrics — Quality metrics: Twelve measures and four gates
- https://writingsystem.bowtiekreative.com/api — API reference: Every endpoint, with examples
- https://writingsystem.bowtiekreative.com/glossary — Glossary: 47 terms
- https://writingsystem.bowtiekreative.com/sources — Bibliography: 52 sources and influences
- https://writingsystem.bowtiekreative.com/search — Search: Rules, terms, templates, sources

## Usage note
This is a decision system, not a universal command to make all prose plain or uniform. Apply genre, audience, stakes, dialect, locale, and deliberate exceptions while preserving truth, safety, accessibility, and intended meaning.

## Copyright
The package contains original synthesis and paraphrased principles. It does not reproduce the source books. Source titles remain the property of their respective authors and publishers.