SpecificationsnormativeSheet 17 of 18
matrix@0.1
Make the trade-offs visible.
Explicit criteria, scores, and weights turn a comparison into an inspectable decision.
- File
*.matrix.md- Unit
- criterion
- View
- weighted comparison
- Codes
- MDTO1700–1799
01
Make the trade-offs visible.
Explicit criteria, scores, and weights turn a comparison into an inspectable decision.
Read the example Markdown
--- markdownto: [email protected] title: Choose the next experiment --- ## Learning value [weight:: 5] How much uncertainty will this remove? A higher score is better. | Option | Score | | --- | --- | | Interview five users | 9 | | Build a prototype | 8 | | Run a survey | 5 | ## Speed [weight:: 3] How quickly can we get useful evidence? Score 10 means fastest. | Option | Score | | --- | --- | | Interview five users | 7 | | Build a prototype | 4 | | Run a survey | 9 | ## Affordability [weight:: 2] Score 10 means least expensive. These are illustrative judgments, not objective measurements. | Option | Score | | --- | --- | | Interview five users | 8 | | Build a prototype | 3 | | Run a survey | 9 |
02
One clear meaning for every section
A level-2 heading is a criterion. The canonical specification defines the precise structure, validation rules, and source-preservation guarantees. The companion skill teaches agents how to create useful content within that contract.
03
A file, a renderer, and precise operations
Validate after authoring. Open the file as an application. Use the spec-owned verbs for deterministic operations and inspect their machine-readable results.
mdto validate example.matrix.md mdto render example.matrix.md mdto matrix --help
Every saved answer or weight stays in the Markdown. Publication exports preserve the authored content. No renderer invents missing facts.
04
Refuse ambiguity. Explain the repair.
--- markdownto: [email protected] --- ## Ease [weight:: -1] | Option | Score | | --- | --- | | Train | 8 | | Car | 5 |
-
MDTO1702 error line 5
## EaseWeight must be a finite number from 0 to 100.