Questions about specifying software
How does the free spec check work?
Last updated
You paste or upload a spec, a product requirements document or a list of requirements, confirm your email address with a 6-digit code, and Mochlion checks the document for the places where a builder would likely have to stop and ask, or guess. You see the counts and the most serious few on the page, and a copy comes by email.
There's no account to create and nothing to pay.
What can I check?
Any written description of an application someone wants built: a spec you were handed, a requirements list, a product requirements document, or your own notes if they're fairly complete. You can paste the text or upload a PDF, a Word (.docx), Markdown or plain text file, up to 5 MB.
It reads text only. A scanned document or a photo of a page won't work.
What does it look for?
Four kinds of problems:
- Not answered: a question a builder would need answered before building that part.
- Left open: something the document leaves open, so a builder would have to guess.
- Two parts disagree: two parts of the document that can't both be built as written.
- Not in the document: something the application clearly needs that the document doesn't cover, such as a rule, an error case, a permission, or what happens at the end of a process.
Each finding is rated by how much it matters: it would block that part of the build, it would likely lead to the wrong thing being built, or it's minor. Where a finding is about one place in your document, it quotes the heading or phrase, so you can find it.
Does it tell me how to fix the gaps?
No. The free check names the problems only. It doesn't guess the answers or suggest what to add, because the right answer has to come from the people who know the work, not from an AI's guess.
Choices a document leaves to the builder on purpose, such as the programming language, the hosting or the screen layout, aren't counted as gaps.
What happens to my document?
An AI reads it only to find the gaps. We delete the document's text after 7 days and keep the findings and your email address only to send you the report. We don't use it to train AI, and we don't share or sell it. Mochlion sends no marketing email, so checking a document doesn't put you on a mailing list. The Privacy Policy has the details.
Is there a limit?
Yes. To keep the check available for everyone, there are limits on how many checks one email address or one network can run, and on the total each day. Checking the same document twice returns the same result.
What if it finds nothing?
That's a good sign. A clean result means the check didn't find a place a builder would likely get stuck; it doesn't prove the document is complete, and results vary from one document to the next. Your own experts are still the ones who can say whether it describes what the business needs.
How is it different from a Build Specification?
The free check reads a document someone already wrote. A Build Specification is written from the answers of the people who know the work, with the gaps and disagreements settled by people before it's handed to a builder. See a sample.
Related questions
See a finished specification
The sample is a complete Build Specification for a made-up company, free to read.