Kwark. Design System
Open Kwark

Structure, not teaching

Every field in Kwark feeds a real artefact a person can use. Kwark never coaches, quizzes or explains film theory, and every piece of structure can be switched off.

Kwark method

Two rules that work together

Structure, not teaching (Decision 0004). Kwark is for students and working professionals who want to make films but cannot do it full time. They need working structure, not film school. On 17 September 2026 the founder said: “structure is our usp, not teaching them. that’s why pre production must be more comprehensive.”

Structure is always optional (Decision 0003). Some writers want an outline tied to the page; some want an empty page. On 8 September he said beat-to-screenplay “must be flexible and must not force user to use structure unless they want to, and this can be switched off whenever they want.”

Together: Kwark gives people more structure than any other tool, and asks them to use none of it.

The artefact test

For every field, ask: what real artefact does this end up in? A list, a sheet, a date, a cost, a page that prints. If the answer is “it helps them think”, the field is coaching and it goes.

Field Ends up in Verdict
A character’s age The character page, the cast list, the casting brief Keep
A scene’s day or night The scene heading, the stripboard strip colour, the call sheet Keep
A location’s cost per day The budget Keep
“Name the feeling we force them to endure” Nothing Remove
A 0 to 100 slider for “tension” Nothing a crew can use Remove
A preset explaining what a push-in “means” Nothing Remove

The modules the founder disliked and that were removed under this record: the Director’s Manifesto prompts, Camera Language’s emotional arc, an Enneagram quiz, “Engine of…” text, tension sliders, camera “meaning” engines, an Idea “Conviction” percentage and Outline “Finder” trophies.

A recent case

Empty cards in the outline’s Writing view once showed questions by story position, such as “What does an ordinary day look like before anything changes?”. They were coaching inside a field, shipped before the rule was written. On 4 November they were removed: an empty card now says “Add words…”. Nothing the writer had written was touched. Whether to bring them back as an opt-in is an open question for the founder, recorded in 0004.

Comprehensive means every department, not more explanation

“Structure is our USP” is a promise of depth: pre-production covers each department’s real prep (breakdown, shots, schedule, call sheets, budget, paperwork, costume, camera and light). It is never a promise to explain how those jobs are done. A second AD knows what a call sheet is; Kwark’s job is to make one that is right.

Understanding is about the story

The writing phase describes the story, not the production. The character tab once called “Casting Sheet” is now Characteristics: age, occupation, distinctive features and appearance are facts the writer decides long before anyone is cast. A real casting sheet (availability, representation, union standing) is a different document about a different person and lives in Cast & Crew in Prepare to shoot.

  • Always ask whether a new field describes the story or the production. Production goes to Prepare to shoot.
  • Never assume one country’s industry: unions, guilds, contracts and paperwork are country-specific.

Optional, all the way down

Every structure-aware feature is opt-in and can be switched off at any time: the beat map, the structure rail, act assignment, breakdown tags, writing insights, the timeline.

  • Must put every structure-aware editor feature behind a switch. In the screenplay these live in Settings, labelled “This project”, for example Map the outline onto the script and What the page shows.
  • Must default a structure feature to off for a script with no linked outline.
  • Must leave nothing behind when a feature is off: when the beat map is off, the panel shows only the switch, not an outline underneath.
  • Never block writing on a missing beat. Acts land in a scene with no beats written in them, in any order; writers write act 1, then 3, then 2.
  • Never create outline entries automatically without asking.
  • Always let the writer choose the level of the outline the page shows, offering the levels their outline actually has, with the top level recommended.

A switch that cannot turn a feature fully off is a bug (Decision 0003).

Writing labels without teaching

  • Always label a field with the plain noun a crew uses: “Call time”, “Cost per day”, “Day or night”.
  • Always use a hint, if any, to say where the value goes: “Appears on the call sheet.” Never to say why it matters to the story.
  • Never phrase a label as a question to the writer.
  • Never add a “Learn more” lesson beside a field. Help that explains Kwark’s own controls is fine; help that teaches filmmaking is not.

Cost per day. Hint: “Goes to the budget for every day this location is booked.”

Do

What does this place cost your story? Hint: “Locations carry emotional weight. Consider…”

Don’t

When the beat map is off, the panel shows one switch: Map the outline onto the script.

Do

When the beat map is off, the outline still shows underneath in grey “so they know it is there”.

Don’t

AI readiness test

Task. Add fields to the Look Book for a film’s colour palette.

Give the agent. This page, Decisions 0003, 0004, 0005, Specs and handoff.

Constraint. No new coaching copy.

A reliable answer

  • Names the artefact each field feeds (the printed look book, the costume and art department sheets)
  • Labels are plain nouns with hints that say where the value goes
  • Nothing is required to save
  • No “meaning” or mood-score fields

Give this Markdown to your coding agent or share its URL.

Open .mdllms.txt
Loading…