From a domain rule to a working application
A useful first GND project ends with a small application behavior you can run:
check a recommendation, approve an expense, or inspect a shipping request.
You can use individual commands as needed. The optional gnd solve harness
organizes selected CLI steps once their inputs already exist.
Follow the application path
- Describe one decision. Write example facts and rules, then author a model with the modeling guide or the text-to-model skill.
- Check contrasting cases. Validate the model and inspect one accepted population and one purposeful failure. Add synthetic grounding when it answers a real testing question.
- Generate the project. Produce the model-derived tools and artifacts, then implement the user-visible behavior in developer-owned extensions.
- Test the application. Run focused tests and the architecture smoke. Inspect conformance when the generated surface or model may have drifted.
- Change deliberately. Evolve an existing model when requirements change, regenerate explicitly where needed, and rerun the affected examples.
Use BookRec for the full path. Its generated artifacts and supplied application extension make each stage concrete. The expense chapters provide a second path focused on state checks and adding a requirement to an existing application.
Use the CLI station harness when it helps
gnd solve composes validation, synthesis, code generation, experiment run,
and conformance in its documented order. It does not elicit requirements,
author an experiment contract, or implement the extension for you. Inspect
the current help before selecting a walk:
The following is a contextual validation-only walk. It assumes the model
exists and uses an explicit workspace. --auto authorizes the selected gate;
without it the harness requests authorization interactively.
Select --from, --until, and --skip according to the station names shown
by help. An experiment directory must already be authored and be inside the
workspace when the exp-run station is selected. The harness records station
selection, authorization, captured output and evidence paths.
Exit 0 means all selected stations completed with accepted exits. Exit 17
means the walk halted. The individual station's exit and halt reason are in
the log; a halted walk is not a replacement domain verdict. A self-consistent
log describes the harness record, not independent proof of every claimed
process execution.
Exit codes by family
Report each exit code as it was returned; a nonzero exit is not always a failed
business rule. When several conditions occur in one check, the verdict band
follows the precedence 3 > 1 > 4 > 2 > 0.
| Family | Exit | Meaning |
|---|---|---|
Verdict bands (gnd check, gnd verify) |
0 | pass; acceptance_ready is true only here |
| 1 | an alethic constraint is violated | |
| 2 | vacuous: the population is inadequate, not violating | |
| 3 | ill-formed: the model or population failed to load, so the check never ran | |
| 4 | indeterminate: an alethic constraint could not be evaluated | |
| Generation and measurement | 5 | a generator invariant failed; nothing was measured |
| 6 | the checker disagreed with independent ground truth (quarantined case or checker defect) | |
| Lifecycle | 10 | installed skills are stale, missing or modified (gnd doctor) |
| 11 | a write was refused and nothing was destroyed | |
| 12 | no install manifest was found | |
| 13 | model-code drift (gnd conformance); from gnd evolve apply it also means the model was published |
|
| 14 | an experiment's obligations are not discharged; gnd exp close refused |
|
| 15 | a session ended without acceptance | |
| 16 | a review panel had fewer than three schema-valid reviews | |
| 17 | a gated station walk halted before completing its selection | |
| 18 | an evolution change is gated and needs the documented hand-edit route | |
| Tool-level (never verdicts) | 64 | usage error |
| 66 | a required input is missing; nothing was established, so this is not a pass | |
| 70 | internal error in GND | |
| 74 | I/O or path refusal |
For code recovery, finish the separate gnd recovery verify gate before
entering the harness. For agent-directed work, select each sibling skill
explicitly as described in Work with an agent. The workflow
map and stable station numbering live in the
solve skill;
the executable station policy lives in gnd solve --help.