# Intent Coherence starter

Viewyonder example, 5 November 2026. Project-memory practice inspired by Lode Coding by FJ Zeit: https://fjzeit.github.io/coding/lode-coding-basics . This is an original small example, not a copy or official distribution of FJ Zeit's template.

## Run without an account

Requires Node.js 18 or later. Extract this directory, then run:

    node run.mjs

The 20 supplied responses pass. Edit one response to break its required phrase and run again: the case must fail and the process must exit nonzero. You can pass your own files:

    node run.mjs cases.json responses.json

## Use on your project

Copy `project-memory.md` into your working notes. Replace the illustrative contract with one real behavior, its owner and an observable check. Create a case before changing implementation. Review its expected result with a person who owns the behavior.

For an LLM workflow, run the case prompts through your chosen model or application using your own authorized tooling. Save a JSON object mapping case IDs to response strings. Do not store credentials, personal data or confidential responses in a public repository. This skeleton deliberately performs no network calls and contains no provider credentials or adapters.

The included checks demonstrate required/forbidden strings. They cannot judge truth, security, tone or application side effects. Replace them with assertions against your actual outputs and retained runtime evidence. Review false positives and false negatives. A green example run only proves that the runner reads its example files.

After an accepted behavior change, update the project memory and case together. Keep a failed case from a real regression so the suite measures more than whether a phrase remains present.
