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. |
Why they are snapshots
Section titled “Why they are snapshots”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.
Proposing a change
Section titled “Proposing a change”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.