Skip to content

About the specifications

FilmOpen is described by three documents, each kept with the application it describes.

What it specifies
Project Specification The file format: a film as a folder of plain text — the script, the shots, the cast, the prompts, the records of what was generated. It is a public draft, open for comment.
Software Specification The application that reads, browses and generates from a project: its parts, its screens, its rules.
MCP Specification How an agent starts, drives and reads the application over MCP.

Each page is an exact copy of the document as it stands in the application’s repository, taken at one commit; the note at the top of the page says which, and which version of the document that is. Nothing is edited here. A copy is refreshed when a milestone of the application closes, so a page may trail the newest draft by a few weeks — and never disagrees with itself.

The copies are checked by machine: every file is recorded with its SHA-256 in snapshot/manifest.json, and the site does not build if one differs.

Because a specification is copied and not written here, a pull request against its page cannot be merged. Open an issue saying what is wrong or unclear and where; it is taken up where the document is kept, and arrives here with the next snapshot.