PRIME PRODUCTS · MISSION CONTROL
AI-first transformation · by TPL · vanos.tpl.one

Docs / 06-decisions/011-greek-administration-copies

ADR-011 Greek administration copies of discovery instruments

Discovery questionnaires may carry a committed Greek working copy (.el.md suffix) for administering sessions with the client; the English file remains the master and the only source of truth.

type: adr updated: 2026-07-06 owner: kotsalidis

ADR-011 — Greek administration copies of discovery instruments

Status

accepted — 2026-07-06 (decided by: kotsalidis). Amends ADR-003 (English-only vault content) with a narrow, explicit exception; ADR-003 otherwise stands unchanged.

Context

ADR-003 makes all committed content English. But discovery questionnaires are administered in Greek — the interviewer reads the questions aloud to Greek-speaking client staff. Translating live during a CEO call risks imprecise phrasing on exactly the questions where wording matters (system names, autonomy boundaries, success definitions). HANDOFF has carried “Greek working translations of the questionnaires for administration” as a pending item since the questionnaires were written; the first one is now needed for the REQ-014 pilot clarification call.

Keeping translations out of the repo (loose files, chat exports) would violate the second-brain principle — the instrument actually used in the room would be untracked.

Decision

  1. A discovery questionnaire (and only this doc class) may have a committed Greek administration copy, named as the English master plus an .el suffix: questionnaire-<slug>.el.md.
  2. The English file remains the master. The Greek copy is a translation artifact: it carries no independent content, links back to its master in the header, and is regenerated whenever the master changes (the master never changes to follow the copy).
  3. Answers, notes, transcript digests, and all other content remain English-only per ADR-003 — the exception covers the questions as administered, nothing else.
  4. Greek copies carry the same frontmatter as the master (with language: el added) and may publish to Mission Control so the client reads the questions in Greek on the dashboard.

Consequences

  • The interviewer administers verbatim-quality Greek; committed knowledge stays English.
  • One file per questionnaire to keep in sync — acceptable: questionnaires change rarely and the sync rule is mechanical.
  • First instance: 08-Transformation/03-discovery/questionnaire-pilot-order-desk.el.md (created with this ADR).