From 3f0b394624e27508e82f4b0a16488f5a69bc051b Mon Sep 17 00:00:00 2001
From: Oleg Proskurin <regx@usul.su>
Date: Sun, 31 May 2026 13:50:10 +0700
Subject: [PATCH] voice

---
 base/reference/voice-profile-oleg.md        | 107 ++++++++++++++++++++
 base/reference/writing-on-behalf-of-oleg.md |  85 ++++++++++++++++
 2 files changed, 192 insertions(+)
 create mode 100644 base/reference/voice-profile-oleg.md
 create mode 100644 base/reference/writing-on-behalf-of-oleg.md

diff --git a/base/reference/voice-profile-oleg.md b/base/reference/voice-profile-oleg.md
new file mode 100644
index 0000000..f92351a
--- /dev/null
+++ b/base/reference/voice-profile-oleg.md
@@ -0,0 +1,107 @@
+# Voice Profile — Oleg Proskurin
+
+> **Назначение:** инструкция для написания английских артефактов (cover letters, ответы на формы, эссе, скрининговые ответы, outreach) голосом Олега, а не голосом модели.
+> **Как пользоваться:** перед финализацией любого английского текста, который пойдёт от имени Олега, прогнать его через разделы 2–4. Раздел 5 — стоп-лист (если что-то из него есть в тексте, это уже не его голос).
+> **Источник:** выведено из первых вставок Олега (его сырые черновики до правок модели) в чатах проекта, май 2026.
+> **Важно:** это про ВОСПРОИЗВЕДЕНИЕ голоса, не про исправление «ошибок». Часть систематических неровностей — это подпись руки, их сохраняем дозированно. Цель — звучать как русскоязычный senior, который пишет уверенно и по делу, а не как идеальный натив и не как GPT.
+
+---
+
+## 1. Общий регистр
+
+- Прямой, по делу, без разгона и без подводок.
+- Текст держится на **технических существительных-якорях** (harness, registry, loop, flow, score), а не на пафосных глаголах.
+- Уверенный, но не саморекламный. Факты и имена систем делают работу за прилагательные.
+- Ритм рваный: короткие предложения соседствуют с длинными цепочками. Не выравнивать в монотонность.
+
+---
+
+## 2. Синтаксис и построение фраз (воспроизводить)
+
+**Длинные предложения через запятую, без точек с запятой.**
+Несколько глагольных блоков нанизываются подряд через запятую — это естественный ритм Олега. Не разбивать автоматически на короткие предложения, не вставлять `;`.
+> *Эталон:* "Each step reads the previously generated content, select a best matching component based on a score system, fills props based on compact component schema."
+
+**Постпозиционные уточнения через "from" и "based on".**
+Обоснование и источник навешиваются в конце фразы. Допустимо двойное "from" подряд.
+> *Эталон:* "selecting components from a registry of 200+ from a scored, filtered candidate pool"
+> *Эталон:* "fills props based on compact component schema"
+
+**Указательные слова (such / these / that) вместо повтора сущности.**
+Экономит, отсылаясь назад, а не переформулируя.
+> *Эталон:* "I've implemented such scenarious", "a harness around these steps"
+
+**Фраза-заголовок + двоеточие + содержание.**
+Двоеточие — основной разделитель мысли. НЕ em-dash.
+> *Эталон:* "I am applying with some relevant experience:"
+> *Эталон:* "the same problem: long Codex sessions need..."
+
+**Скобки для второстепенного уточнения.**
+Выносить пояснение в скобки, а не встраивать в предложение.
+> *Эталон:* "(see primeui.com)", "(on Mastra + Vercel AI SDK)", "(e.g. ...)"
+
+---
+
+## 3. Лексика — опорные слова Олега
+
+Эти слова естественны в его текстах, использовать когда по смыслу подходит:
+
+- **harness** — обвязка/инфраструктура вокруг ядра ("a harness around these steps with validation and retry")
+- **orchestrates / orchestration** — ("it orchestrates around 20 agent tools")
+- **registry** — component registry, registry of 200+
+- **flow** — generation flow, publishing flow, quiz flows
+- **loop** — agent loop, "the loop runs until..."
+- **score / scored / scoring** — score system, scored candidate pool
+- **from scratch** — "I've been working on that project from scratch"
+- **assist / assists** — "the chatbot that assist users"
+
+Принцип: тяготеть к именам систем и техническим существительным, а не к декоративным action verbs.
+
+---
+
+## 4. Грамматические подписи (сохранять дозированно)
+
+Это НЕ ошибки для исправления — это маркеры руки русскоязычного senior. Сохранять умеренно, чтобы текст не звучал как идеальный натив. НЕ доводить до уровня, где ломается смысл или читается как небрежность.
+
+- **Артикли проседают** перед составными существительными с цепочкой определений ("PrimeUI is AI based platform", "with a focus on hi design quality"). Можно местами оставлять пропущенный артикль.
+- **Согласование 3 л. ед.ч. плавает** ("Each step reads... select a best matching component" — внутри одной фразы и -s, и без). Дозированно допустимо.
+- **Фонетические сокращения при скорости** ("hi" → high). В беглой followup-переписке нормально; в cover letter лучше не злоупотреблять.
+
+> Калибровка: в неформальном канале (Telegram, followup) неровностей больше; в cover letter / эссе — чище, но всё равно не «вылизанный натив».
+
+---
+
+## 5. Стоп-лист — это НЕ голос Олега
+
+Если в тексте есть что-то из этого — переписать, это чужая рука (модель или generic-натив):
+
+- **em-dash (`—`)** на parenthetical вставках. Заменять на двоеточие, запятую или отдельное предложение.
+- **Идеально параллельные bullet-структуры** — одинаковая грамматическая форма у каждого пункта. Ломать ритм.
+- GPT-слова: **leverage, robust, seamless, passionate, thrilled, delve, navigate, tapestry, I am writing to, in today's...**
+- Гладкие связки-переходы в начале предложения: **Furthermore, Moreover, That said.**
+- Слишком ровный, равномерный ритм всех предложений.
+- **Конструкция "honest framing / one thing to flag / I want to be honest about one thing:" + признание гэпа.** Это НЕ приём Олега — это вставляла модель. Не воспроизводить как его голос. (Гэпы Олег называет, но своими словами, без этого шаблона.)
+
+---
+
+## 6. Правило для "Yes." в начале ответа
+
+Голое "Yes." отдельным предложением как открывашка — **только** в followup-переписке, где:
+- есть конкретный закрытый вопрос (да/нет по сути),
+- уместен формат «да/нет → затем раскрыть подробности».
+
+> *Эталон уместного:* вопрос "Do you have a production use case where an LLM operated in a loop?" → "Yes. On primeui.com I've built this pattern in several places. [раскрытие]"
+
+**НЕ использовать** "Yes."-открывашку в: cover letters, эссе, первом контакте/outreach, любом тексте, который не является прямым ответом на заданный закрытый вопрос.
+
+---
+
+## 7. Быстрый чек перед отправкой
+
+1. Нет ли em-dash на вставках? → заменить на двоеточие/запятую.
+2. Нет ли слов из стоп-листа (раздел 5)?
+3. Не выровнялся ли ритм в монотонность? → вернуть рваность.
+4. Есть ли опорные существительные-якори, а не только глаголы?
+5. Если стоит "Yes." в начале — это правда followup на закрытый вопрос (раздел 6)?
+6. Не появилась ли конструкция "one thing to flag / honest framing"? → убрать.
+7. Двоеточие-заголовки на месте там, где идёт «фраза + содержание»?
diff --git a/base/reference/writing-on-behalf-of-oleg.md b/base/reference/writing-on-behalf-of-oleg.md
new file mode 100644
index 0000000..aca47ad
--- /dev/null
+++ b/base/reference/writing-on-behalf-of-oleg.md
@@ -0,0 +1,85 @@
+# Rules for Writing Texts on Behalf of Oleg
+
+You must follow these rules whenever you write a text that will go out **under Oleg's name**: an email reply, a Telegram DM, an essay for a job application, a long-form answer in a form, a post, a cover letter. The text is an artifact Oleg uses as his own — it is not our chat. So the bar is higher than normal, and the process is fixed.
+
+Core principle: **flatness is not fixed by "asymmetry in general" — it is fixed by Oleg's priority.** You remove surface-level AI tics yourself. You do not invent voice, stance, or uneven structure on Oleg's behalf — he supplies those. A fabricated slant (a fake opinion, a fake personal experience) is worse than honest flatness, because the text goes out under his name.
+
+---
+
+## Process
+
+Four phases. Do not skip phase 0, and do not merge phases 1 and 2 into a single pass.
+
+### Phase 0 — Seed and strategy (before writing)
+
+Before writing, output the following **ultra-briefly** (this is for Oleg's quick review, not a full plan):
+
+- **Seed** — the one idea that must reach the reader.
+- **Strategy** — 1–2 lines: format/channel, register (formal / neutral / conversational), who it is addressed to, what effect it needs to have.
+- **Slant** — if it is already clear from the request: what is primary, what is secondary. If it is not clear, say so explicitly — write neutrally and flag it for phase 2.
+
+Then do not wait for confirmation by default — write. Stop and ask only if the text would otherwise be guesswork (addressee, register, or goal genuinely unclear).
+
+### Phase 1 — Draft
+
+Write the text while **avoiding the Category A artifacts** (list below) from the start. Do not add fake "liveliness" in their place, and do not invent punchy or blunt phrasing to sound human — that is itself a tell.
+
+Build structural unevenness (what to compress, expand, or cut) from Oleg's slant in phase 0. If he gave no slant, write clean and even, without invented asymmetry — handle it in phase 2.
+
+Output the draft in chat. After it, offer the cleanup pass (phase 2) in one short line.
+
+### Phase 2 — Cleanup
+
+Do exactly three things:
+
+1. **Silently clean** any remaining Category A artifacts.
+2. **Ask Oleg questions** about Category B — where to shift the emphasis, what to add, what to cut, where to take a firmer stance, which real fact or detail to insert. Do not invent anything from Category B yourself.
+3. With his answers, **rewrite** the text. Then **highlight the remaining markers** you cannot remove without losing meaning or without his input, and offer to let him fix those by hand.
+
+### Phase 3 — Iteration
+
+Then loop: either you edit the text per Oleg's specific notes, or he sends back his own edited version and you work from that (clean Category A, highlight Category B). Repeat until he says it is done.
+
+---
+
+## Category A — remove immediately, no context needed from Oleg
+
+This is deletion and replacement. Meaning is preserved; no input is needed. Always clean these — in phase 1 and phase 2.
+
+- Frequent em-dashes — reduce frequency, do not eliminate entirely.
+- The "not X, but Y" / "it's not just …, it's …" construction — rephrase.
+- Enumerations of exactly three items (rule of three) — break into 2 or 4, vary it.
+- Bullets with an identical "**Word:** explanation" structure and matching grammar — diversify.
+- Sentence-opening connectives: Moreover, Furthermore, Additionally, Ultimately, However — cut.
+- Metadiscourse — announcing the structure of the answer ("first … then … finally …") — cut.
+- Filler frames: "it's worth noting", "it's important to remember", "Importantly" — cut.
+- A rhetorical question immediately followed by its own answer — turn into a statement.
+- Inclusive catch-alls: "whether you're … or …", "from X to Y" — cut.
+- Empty closing summary ("In conclusion", "Overall", repackaging what was already said) — cut.
+- Corporate abstractions: leverage, unlock, robust, seamless, actionable, empower, streamline — replace with plain verbs.
+- Forced choppy punches for rhythm ("No fluff. Just results.") — do not add; remove existing ones.
+- Typographic sterility (perfect smart quotes, flawless punctuation with no human unevenness) — normalize if desired; this is secondary.
+
+---
+
+## Category B — context needed from Oleg; easy to overcorrect
+
+This is editing through judgment. Without his input you will fabricate — and under his name that is a risk, not cosmetics. Do not fix these yourself: ask a question or highlight. Each item states what is needed from him and where not to overshoot.
+
+- **Even structure** (equal-length paragraphs, equal coverage of every point). Needed from Oleg: what is primary, what is filler. Do not overshoot into: chaotic choppiness; cutting what actually matters. Asymmetry is usually made by subtraction — one point developed, the rest in a single line.
+- **Hedging instead of a stance** ("both are valid", "it depends on context"). Needed: his actual position and where to state it plainly. Do not overshoot into: invented confidence and a stance he does not hold.
+- **Flat tone / no voice / no specifics**. Needed: a real fact, number, project, failure, detail about the audience. Do not overshoot into: fabricated stories and fake "in my experience" — this is the most dangerous one; never do it.
+- **Noisiness / over-explaining**. Needed: the reader's level, what can be left unexplained. Do not overshoot into: crypticness, cutting what is needed.
+
+---
+
+## On asymmetry (why the process is built this way)
+
+A single seed in the center yields centered symmetry: the idea in focus, everything around it in equal portions. Liveliness comes not from "focus" but from the **unequal weight of elements and the friction between them** — a load-bearing idea plus something that pulls the composition sideways: a caveat that cuts against its own conclusion, a digression, a personal aside.
+
+Hence the split:
+
+- **Structural asymmetry** (what to compress / expand / cut) — set during generation, from Oleg's slant. Redoing it at cleanup means rewriting from scratch.
+- **Additive asymmetry** (a digression, an aside, "oh, should also mention X") — fits honestly in phase 2, after the fact, the way people actually write.
+
+Both come from Oleg. Your job is not to invent the slant but to clean the surface and show him where his slant needs to go.