Структура вікі v1
active
Owner Роман Овсеєнко
Оновлено 2026-10-09
Версія as-is
Для автори вікі
Тип довідник
Структура вікі v1
Затверджено 2026-10-09. Джерела: 4 інвентаризації (HR, Продажі, AI, Операції), 144 позиції → 92 унікальні документи. Анкета рішень — у чаті проєкту «Art Solution — Wiki & Knowledge».
1. Рішення, що задають структуру
| # |
Рішення |
Вибір |
| A1 |
Підрозділи відділів у регламентах |
6: продажі, проєктування, цех-і-монтаж, закупівля, бухгалтерія, юрист |
| A2 |
Публічний розділ |
public/ зарезервовано, порожньо |
| A3 |
«Як є» vs «як має бути» |
одна сторінка, поле version: as-is / target |
| A4 |
Глибина |
3 рівні |
| A5 |
Мова назв файлів |
кирилиця, нижній регістр, дефіси |
| A6 |
Owner |
конкретна людина |
| A7 |
Правила ціноутворення / КП |
мігрують у вікі; sales-репо посилається на вікі (окремий крок) |
| A8 |
AI-екосистема |
окремий розділ |
| A9 |
Runbook VPS, реєстр доступів |
приватно; у вікі — вказівник |
| A10 |
Компенсаційні правила |
у вікі як правила без імен |
| A11 |
Фінансові методики |
у вікі без цифр |
| A12 |
Цільовий читач v1 |
офіс (продажі, конструктори, PM, закупівля) |
| A13 |
Інциденти |
шаблон у вікі; реєстр — приватно |
| A14 |
Картки ролей |
окремий розділ ролі/ |
| A15 |
raw/ |
у тому ж репо, не публікується |
| A16 |
Ліміт P1 |
без ліміту; черга — хвилями |
| Шаблон |
Верстка сторінки |
варіант 2: Коротко + «чому» під правилом + Контроль; метадані — бічна колонка з frontmatter; підказки <!-- -->; схеми flowchart LR |
2. Дерево
docs/
├── index.md
├── STRUCTURE.md
├── про-компанію/
├── ролі/
├── регламенти/
│ ├── загальні/ продажі/ проєктування/ цех-і-монтаж/
│ └── закупівля/ бухгалтерія/ юрист/
├── процеси/
├── інструкції/
│ ├── сервер-і-файли/ pipedrive/ worksection/
├── ai-та-агенти/
├── адаптація/
│ ├── загальне/ за-ролями/
├── продукти-і-технології/
├── довідники/
│ ├── транспорт/ монтажні-бригади/ охорона-праці/ обладнання/ постачальники/
├── шаблони/
└── public/ (зарезервовано)
raw/ (не публікується)
├── транскрипти/
└── чернетки/
3. Розділи
| Розділ |
Owner |
Читач |
Оновлення |
про-компанію/ |
Роман Овсеєнко |
усі |
квартал; оргструктура — при зміні |
ролі/ |
керівник напряму (пише), Роман Овсеєнко (затверджує) |
новачок, колега, кандидат |
при зміні ролі |
регламенти/ |
за підрозділами |
офіс |
при зміні правила |
регламенти/загальні/ |
Роман Овсеєнко |
офіс |
при зміні правила |
регламенти/продажі/ |
Олександр Гетьманець (ціни, КП, пресейл), Андрій Пуцик (Pipedrive, ліди) |
менеджери, пресейл, CEO |
місяць |
регламенти/проєктування/ |
Іра — старший конструктор; Катя К. — CAD |
конструктори, PM |
квартал |
регламенти/цех-і-монтаж/ |
Володя — керівник монтажу; методика — Олександр Гетьманець |
PM, монтаж, пресейл |
квартал |
регламенти/закупівля/ |
Вероніка Стрижова |
закупівля, PM, пресейл |
квартал |
регламенти/бухгалтерія/ |
Ірина Яремчук |
PM, менеджери, закупівля |
при зміні обліку |
регламенти/юрист/ |
Беліченко |
менеджери, PM, CEO |
квартал |
процеси/ |
Роман Овсеєнко (власник процесу) |
PM, менеджери, конструктори |
при зміні процесу; RACI — квартал |
інструкції/ |
Олександр Гетьманець (сервер, репо), Роман Овсеєнко (Pipedrive, Worksection) |
усі користувачі інструмента |
при зміні інструмента |
інструкції/сервер-і-файли/ |
Олександр Гетьманець |
усі |
при зміні |
інструкції/pipedrive/ |
Роман Овсеєнко |
продажі |
при зміні |
інструкції/worksection/ |
Роман Овсеєнко |
PM, конструктори |
при зміні |
ai-та-агенти/ |
Роман Овсеєнко |
усі, хто працює з ботами |
місяць |
адаптація/ |
Роман Овсеєнко; за ролями — керівник напряму |
наставник, новачок |
при кожному наймі |
адаптація/загальне/ |
Роман Овсеєнко; чеклист ментора — Іра |
наставник, новачок |
при кожному наймі |
адаптація/за-ролями/ |
керівник напряму |
новачок |
при кожному наймі |
продукти-і-технології/ |
Олександр Гетьманець; Reynaers — Микола Хлапук |
продажі, новачки |
квартал |
довідники/ |
Володя (транспорт, бригади, ОП), Вероніка Стрижова (постачальники), Іра (обмірне) |
усі |
при зміні даних |
довідники/транспорт/ |
Володя |
PM, монтаж, продажі |
при зміні авто; страховка — щороку |
довідники/монтажні-бригади/ |
Володя |
PM |
при зміні складу |
довідники/охорона-праці/ |
Володя; кадрова частина — Ірина Яремчук |
монтаж, PM |
півроку |
довідники/обладнання/ |
Іра (обмірне), Володя (монтажне) |
конструктори, монтаж |
при закупівлі |
довідники/постачальники/ |
Вероніка Стрижова |
закупівля, PM, пресейл |
квартал |
шаблони/ |
Роман Овсеєнко |
автори вікі |
рідко |
4. Реєстр документів
Є: Г — голова · Д — документ/пам'ять · Р — sales-репо/скіл · С — система · ✕ — немає · Д? — існування не підтверджено. ⚠ — потребує рішення до написання.
про-компанію/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| C1 |
оргструктура-і-ролі.md |
Оргструктура і ролі |
Роман Овсеєнко |
P1 |
1 |
Д |
хто за що, підпорядкування, точки ескалації |
| C2 |
карта-систем.md |
Карта систем компанії |
Роман Овсеєнко |
P1 |
1 |
✕ |
Pipedrive = пресейл, Worksection = постсейл, Drive, Telegram, Ringostat; хто адмініструє |
| C3 |
ритм-зустрічей.md |
Ритм зустрічей |
Роман Овсеєнко |
P1 |
1 |
Г |
дейлі, sales-стендап, Пн аудит проєктів, планування монтажу, 1:1, п'ятничний фідбек |
| C4 |
ескалації-і-маршрут-питань.md |
Матриця ескалацій і маршрут питань |
Роман Овсеєнко |
P1 |
1 |
Д |
до кого з чим іти |
| C7 |
політика-вікі.md |
Політика вікі |
Роман Овсеєнко |
P1 |
1 |
Д |
що публікуємо, що ні, хто пише, як оновлюється |
| C5 |
глосарій.md |
Глосарій |
Роман Овсеєнко |
P2 |
— |
✕ |
|
| C6 |
реквізити-і-бренд.md |
Довідник компанії для документів |
Роман Овсеєнко |
P2 |
— |
Р |
⚠ «Солюшин» / «Солюшн» |
| C9 |
конкуренти.md |
Конкуренти |
Роман Овсеєнко |
P3 |
— |
Д |
|
ролі/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| РЛ1 |
менеджер-з-продажу.md |
Менеджер з продажу |
Андрій Пуцик |
P1 |
1 |
Д |
|
| РЛ2 |
пресейл-інженер.md |
Пресейл-інженер |
Олександр Гетьманець |
P1 |
1 |
Д |
|
| РЛ3 |
конструктор.md |
Конструктор |
Іра |
P1 |
1 |
Г |
|
| РЛ4 |
керівник-проєкту.md |
Керівник проєкту |
Роман Овсеєнко |
P1 |
1 |
Г |
|
| РЛ5 |
керівник-монтажу.md |
Керівник монтажу |
Володя |
P2 |
— |
Г |
|
| РЛ6 |
монтажник.md |
Монтажник |
Володя |
P2 |
— |
Г |
|
| РЛ7 |
закупівля.md |
Закупівля |
Вероніка Стрижова |
P2 |
— |
Г |
|
| РЛ8 |
бухгалтер.md |
Бухгалтер |
Ірина Яремчук |
P2 |
— |
Г |
|
| РЛ9 |
юрист.md |
Юрист |
Беліченко |
P2 |
— |
Г |
|
регламенти/загальні/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| R3 |
безпека-з-ai.md |
Правила безпеки з AI |
Роман Овсеєнко |
P1 |
4 |
Д |
|
| R1 |
комунікація-з-ceo.md |
Комунікація з CEO і колегами |
Роман Овсеєнко |
P2 |
— |
Д |
|
| R2 |
конфіденційність.md |
Конфіденційність об'єктів та ІВ |
Роман Овсеєнко |
P2 |
— |
Г |
|
| R4 |
claude-team.md |
Користування Claude Team / Claude Code |
Роман Овсеєнко |
P2 |
— |
Г |
|
| R5 |
термінологія.md |
Термінологія і заборонені формулювання |
Роман Овсеєнко |
P2 |
— |
Д |
|
| R7 |
робота-у-вихідні.md |
Оплата роботи у вихідні |
Роман Овсеєнко |
P2 |
— |
Д |
правило без ставок |
| R8 |
дисципліна-монтажу.md |
Дисципліна монтажного відділу |
Володя |
P2 |
— |
Д |
|
| SL11 |
комісії-і-бонуси.md |
Матриця комісій і партнерських бонусів |
Роман Овсеєнко |
P2 |
— |
Д |
правила без імен (A10=A) |
| R6 |
тривоги-і-дистанційно.md |
Робота під час тривог / дистанційно |
Роман Овсеєнко |
P3 |
— |
Г |
|
регламенти/продажі/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| SL1 |
робота-в-pipedrive.md |
Регламент роботи в Pipedrive |
Андрій Пуцик |
P1 |
2 |
Д |
|
| SL13 |
пресейлз-інженер-регламент.md |
Регламент ролі пресейлз-інженера |
Олександр Гетьманець |
P1 |
2 |
Д |
+ мінімальний пакет вводних |
| SL14 |
передати-лід-у-sales-групу.md |
Передати лід у Sales-групу |
Андрій Пуцик |
P1 |
2 |
✕ |
|
| SL2 |
воронка-і-життєвий-цикл-угоди.md |
Етапи воронки і життєвий цикл угоди |
Андрій Пуцик |
P1 |
2 |
Г |
|
| SL3 |
регламент-кп.md |
Регламент КП |
Олександр Гетьманець |
P1 |
2 |
Д |
строки, гейти, знижки |
| SL4 |
комерційні-умови.md |
Стандартні комерційні умови |
Роман Овсеєнко |
P1 |
2 |
✕ |
⚠ 4 схеми оплати — рішення |
| SL5 |
ціноутворення.md |
Правила ціноутворення |
Роман Овсеєнко |
P1 |
2 |
Р |
міграція з репо (A7=C) |
| SL6 |
стандарт-кп.md |
Стандарт КП |
Олександр Гетьманець |
P1 |
2 |
Р |
міграція з репо; 3 копії → 1 |
| SL7 |
внутрішній-кошторис.md |
Стандарт внутрішнього кошторису |
Олександр Гетьманець |
P1 |
2 |
Р |
⚠ 2 описи — рішення |
| SL8 |
кваліфікація-ліда.md |
Кваліфікація ліда |
Андрій Пуцик |
P1 |
2 |
Д |
⚠ 3 версії — рішення |
| SL10 |
зустрічі-з-ceo.md |
Розподіл зустрічей: коли їде CEO |
Роман Овсеєнко |
P2 |
— |
Д |
|
| SL12 |
прайс-матриця.md |
Прайс-матриця і прайс-бук дрібних позицій |
Олександр Гетьманець |
P2 |
— |
✕ |
|
| SL9 |
go-no-go-тендери.md |
Go/no-go на тендери понад 2 млн |
Олександр Гетьманець |
P2 |
— |
✕ |
|
| SL15 |
імпортні-проєкти.md |
Імпортні проєкти |
Роман Овсеєнко |
P3 |
— |
Д |
|
регламенти/проєктування/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| D1 |
замір.md |
Стандарт заміру |
Іра |
P1 |
3 |
Г |
пресейл і постсейл, черга vs WIP |
| D2 |
cad-стандарт.md |
CAD-стандарт |
Катя К. |
P1 |
3 |
Д? |
|
| D3 |
приймання-кд.md |
Чеклист приймання КД конструктор → PM |
Іра |
P1 |
3 |
✕ |
|
| D4 |
самоперевірка-кд.md |
Чеклист самоперевірки КД/PDF |
Іра |
P2 |
— |
Д? |
|
| D5 |
еталони-креслень.md |
Еталони креслень |
Катя К. |
P2 |
— |
Д? |
|
| D6 |
нормативна-база.md |
Нормативна база |
Іра |
P2 |
— |
Д |
|
регламенти/цех-і-монтаж/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| M1 |
готовність-до-монтажу.md |
Чеклист готовності до монтажу |
Володя |
P1 |
3 |
✕ |
|
| M2 |
монтажний-чеклист.md |
Монтажний чеклист і передача замовнику |
Володя |
P1 |
3 |
✕ |
|
| M3 |
методика-розрахунку-монтажу.md |
Методика розрахунку монтажу |
Олександр Гетьманець |
P1 |
3 |
Р |
|
регламенти/закупівля/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| P1 |
правила-закупівлі.md |
Правила закупівлі |
Вероніка Стрижова |
P2 |
— |
Г |
|
| P2 |
оплата-зразків-і-підрядників.md |
Оплата зразків і підрядників |
Вероніка Стрижова |
P2 |
— |
Д |
|
регламенти/бухгалтерія/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| L2 |
finmap-задача.md |
Finmap-задача при продажу |
Ірина Яремчук |
P1 |
2 |
Г |
18 полів |
| L3 |
pl-по-проєктах.md |
P&L по проєктах |
Ірина Яремчук |
P2 |
— |
Д |
методика без цифр |
регламенти/юрист/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| L1 |
контрактні-застереження.md |
Контрактні ризики і стандартні застереження |
Беліченко |
P2 |
— |
Г |
|
процеси/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| PR1 |
лід-гарантія.md |
Наскрізний процес: лід → гарантія |
Роман Овсеєнко |
P1 |
1 |
✕ |
карта з посиланнями на етапи |
| PR2 |
handoff-sales-delivery.md |
Handoff Sales → Delivery |
Роман Овсеєнко |
P1 |
2 |
Д |
картка, точка передачі, призначення PM |
| PR3 |
життєвий-цикл-проєкту.md |
Життєвий цикл проєкту у Worksection |
Роман Овсеєнко |
P1 |
3 |
С |
5 стадій |
| PR4 |
дисципліна-задач.md |
Дисципліна задач у Worksection |
Роман Овсеєнко |
P1 |
3 |
Г |
|
| PR5 |
закриття-проєкту.md |
Закриття проєкту |
TODO |
P1 |
3 |
✕ |
⚠ owner не призначений |
| PR6 |
комунікація-з-клієнтом-після-handoff.md |
Комунікація з клієнтом після handoff |
Роман Овсеєнко |
P2 |
— |
Д |
|
| PR7 |
milestone-і-kpi-pm.md |
Milestone-контроль і KPI PM |
Роман Овсеєнко |
P2 |
— |
Г |
|
| PR8 |
паспорт-проєкту.md |
Паспорт проєкту |
Роман Овсеєнко |
P2 |
— |
Д? |
|
| PR9 |
plaud-транскрипт-summary.md |
Plaud → транскрипт → summary |
Роман Овсеєнко |
P2 |
— |
Д |
|
інструкції/сервер-і-файли/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| I1 |
нумерація-і-структура-папок.md |
Нумерація проєктів і структура папок |
Олександр Гетьманець |
P1 |
1 |
Д |
|
| I5 |
sales-репо.md |
Робота у sales-репо |
Олександр Гетьманець |
P1 |
2 |
Р |
посилання на how-we-work |
| I2 |
pc-4-і-drive.md |
Сервер Pc-4 ↔ Google Drive |
Олександр Гетьманець |
P2 |
— |
Д |
|
інструкції/pipedrive/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| I3 |
налаштування.md |
Pipedrive: налаштування |
Роман Овсеєнко |
P2 |
— |
С |
поля, Ringostat |
інструкції/worksection/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| I4 |
шаблон-і-аудит.md |
Worksection: шаблон і аудит |
Роман Овсеєнко |
P2 |
— |
Д |
|
ai-та-агенти/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| A1 |
архітектура.md |
Архітектура AI-екосистеми |
Роман Овсеєнко |
P1 |
4 |
Д |
|
| A2 |
як-працювати-з-ботами.md |
SOP «Як працювати з ботами» |
Роман Овсеєнко |
P1 |
4 |
Д |
|
| A3 |
наталка.md |
Pipeline «Наталка» |
Роман Овсеєнко |
P1 |
2 |
Д |
|
| A4 |
governance.md |
Governance агентів |
Роман Овсеєнко |
P2 |
— |
Д |
|
| A5 |
runbook-vps.md |
Runbook VPS — вказівник |
Роман Овсеєнко |
P2 |
— |
Г |
лише де лежить (A9=B) |
| A6 |
реєстр-доступів.md |
Реєстр доступів — вказівник |
Роман Овсеєнко |
P2 |
— |
✕ |
лише де лежить (A9=B) |
| A7 |
procurementbot.md |
ProcurementBot |
Вероніка Стрижова |
P2 |
— |
✕ |
|
| A8 |
tenderwatch.md |
TenderWatch / ProZorro |
Олександр Гетьманець |
P2 |
— |
Д |
|
| A9 |
формат-промптів-adminagent.md |
Формат промптів AdminAgent |
Роман Овсеєнко |
P2 |
— |
Д |
|
| A10 |
juristagent.md |
JuristAgent |
Беліченко |
P3 |
— |
✕ |
|
адаптація/загальне/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| O1 |
програма-адаптації.md |
Загальна програма адаптації |
Роман Овсеєнко |
P1 |
4 |
Д |
|
| O2 |
план-30-60-90.md |
Шаблон плану 30/60/90 |
Роман Овсеєнко |
P1 |
4 |
Д |
|
| O3 |
чеклист-ментора.md |
Чеклист ментора |
Іра |
P1 |
4 |
Д |
|
| O4 |
чеклист-доступів.md |
Чеклист доступів новачка |
Олександр Гетьманець |
P1 |
4 |
Г |
день 1 |
| O10 |
навчальні-матеріали.md |
Навчальні матеріали по продуктах |
Роман Овсеєнко |
P2 |
— |
Д? |
|
| O5 |
пятничний-фідбек.md |
Шаблон п'ятничного фідбеку |
Роман Овсеєнко |
P2 |
— |
Д |
|
| O11 |
журнал-прогалин.md |
Журнал прогалин |
Роман Овсеєнко |
P3 |
— |
Д |
|
адаптація/за-ролями/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| O6 |
менеджер-з-продажу.md |
План адаптації: менеджер з продажу |
Андрій Пуцик |
P1 |
4 |
Д |
|
| O8 |
керівник-проєкту.md |
План адаптації: керівник проєкту |
Роман Овсеєнко |
P1 |
4 |
✕ |
|
| O7 |
конструктор.md |
План адаптації: конструктор |
Іра |
P2 |
— |
✕ |
|
| O9 |
монтажник.md |
План адаптації: монтажник |
Володя |
P2 |
— |
✕ |
|
продукти-і-технології/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| T1 |
каталог-конструкцій.md |
Каталог типових конструкцій |
Олександр Гетьманець |
P1 |
4 |
Д? |
|
| T2 |
навіси-на-вантах.md |
Навіси на вантах |
Роман Овсеєнко |
P2 |
— |
Р |
|
| T3 |
алюміній-reynaers.md |
Алюмінієвий напрям (Reynaers) |
Микола Хлапук |
P2 |
— |
Г |
|
| T4 |
типові-помилки.md |
Типові помилки і уроки |
Роман Овсеєнко |
P2 |
— |
✕ |
знеособлено, з ретроспектив |
довідники/транспорт/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| ДВ1 |
index.md |
Автомобілі компанії |
Володя |
P1 |
4 |
Г |
одна сторінка на авто |
довідники/монтажні-бригади/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| ДВ2 |
index.md |
Монтажні бригади |
Володя |
P2 |
— |
Г |
|
довідники/охорона-праці/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| ДВ3 |
index.md |
Охорона праці: реєстр документів |
Володя |
P2 |
— |
Д? |
|
довідники/обладнання/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| D7 |
обмірне-обладнання.md |
Обладнання для обміру |
Іра |
P3 |
— |
Г |
|
довідники/постачальники/
| ID |
Файл |
Документ |
Owner |
P |
Хвиля |
Є |
Примітка |
| P3 |
index.md |
Постачальники, системи, прайси |
Вероніка Стрижова |
P1 |
4 |
Д |
|
Не у вікі
| ID |
Документ |
Де |
| C8 |
Ключові клієнти та дизайнери-провідники |
Pipedrive |
| A11 |
ЄДЕССБ / моніторинг об'єктів |
приватний AI-проєкт |
| A12 |
ManyChat / Instagram |
приватний AI-проєкт |
| RT2 |
Реєстр інцидентів |
приватна папка CEO (A13=B) |
Разом: P1 — 46, P2 — 46, P3 — 6, не у вікі — 4.
5. Черга P1 — хвилі
| Хвиля |
Логіка |
Документи |
| 1 |
Каркас — без них іншим нікуди посилатися |
Ш1–Ш6, C1, C2, C3, C4, C7, РЛ1, РЛ2, РЛ3, РЛ4, PR1, I1 |
| 2 |
Продажі + handoff — найбільше конфліктів і читачів |
SL1, SL2, SL3, SL4, SL5, SL6, SL7, SL8, SL13, SL14, L2, PR2, I5, A3 |
| 3 |
Delivery — Worksection і закриття проєктів |
D1, D2, D3, M1, M2, M3, PR3, PR4, PR5 |
| 4 |
Люди і довідки — адаптація, AI, продукти |
R3, A1, A2, O1, O2, O3, O4, O6, O8, T1, ДВ1, P3 |
Рішення ⚠, потрібні до хвиль 2–3: схема оплати за замовчуванням (SL4); канонічний шаблон кошторису (SL7); версія кваліфікації ліда (SL8); owner стадії закриття (PR5).
6. Frontmatter
---
title: Назва документа
owner: Ім'я Прізвище
updated: РРРР-ММ-ДД # дата останнього merge, що торкнувся сторінки
status: draft # draft | active | archived
audience: [продажі, pm] # усі | офіс | продажі | конструктори | монтаж | закупівля | pm | керівництво | новачок | наставник
type: регламент # регламент | процес | інструкція | адаптація | ретро | роль | довідник
version: as-is # as-is | target
related: [] # імена файлів без .md
---
status: draft поки owner не поставив active; archived — файл лишається, з nav зникає.- Імена людей — лише в
owner і в картках ролей; у тексті правил — назва ролі.
- Метадані рендеряться у бічну колонку з frontmatter (
overrides/main.html), у тексті не дублюються.
7. Іменування
| Правило |
Приклад |
| Кирилиця, нижній регістр, дефіси; без пробілів, апострофів, дат, версій |
дисципліна-задач.md |
Назва = предмет; тип документа — у папці і в type |
регламенти/продажі/робота-в-pipedrive.md |
| Назви систем — латиницею |
pipedrive, worksection, ai-та-агенти |
Кожна папка має index.md |
обов'язково на всіх рівнях |
| Картка ролі і план адаптації = назва ролі в однині |
ролі/конструктор.md, адаптація/за-ролями/конструктор.md |
| Довідники: одна сутність = один файл |
довідники/транспорт/марка-модель-номер.md |
raw/: РРРР-ММ-ДД-тема.md — єдиний виняток із датою |
raw/транскрипти/2026-10-13-аудит-проєктів.md |
Зображення — _img/ поруч, назва = сторінка + номер |
_img/дисципліна-задач-1.png |
8. Посилання
- Відносні шляхи до
.md; mkdocs build --strict падає на битих.
- На роль — завжди на картку ролі, не на ім'я.
- Процес ↔ регламент ↔ інструкція — через
related і секцію «Пов'язане».
- На sales-репо — GitHub-посилання з позначкою
(репо) до завершення міграції SL5/SL6.
- Шляхи на сервері — у
код, не гіперпосиланням. На Drive — лише на папку.
9. Що куди НЕ класти
| Категорія |
Приклади |
Де тримати |
| HR-конфіденційне |
офери, зарплати, % конкретних людей, персональні плани адаптації з оцінками, red flags, причини звільнень |
приватна папка CEO |
| Персональні дані співробітників |
паспортні дані, ІПН, дата народження, домашня адреса, особисті контакти, статуси бронювання, здоров'я |
бухгалтерія (кадри). У вікі: ПІБ, роль, робочий телефон/email |
| Персональні дані клієнтів і контрагентів |
телефони, email, ЄДРПОУ, директори в контексті угод |
Pipedrive |
| Секрети |
паролі, ключі, токени, MCP-URL з токеном, Wi-Fi |
менеджер секретів; у вікі — «де лежить, хто видає» |
| Фінанси компанії |
виручка, прибуток, маржа, собівартості, коефіцієнти, red lines |
фінансова папка CEO; у вікі — методика без чисел |
| Інциденти з іменами |
реєстр, попередження, розбори людей |
приватний реєстр CEO; у вікі — знеособлений урок + правило |
| Комерційні переговори |
умови з вендорами, грантами, знижки постачальників |
приватно |
| Чужі закриті об'єкти |
під NDA / усною умовою |
усно, CEO |
| Документи з реквізитами |
техпаспорти, поліси, підписані журнали ОП, договори |
Drive; у вікі — витяг + посилання на папку |
| Чернетки без owner |
— |
raw/ |
Запобіжник: scripts/check-secrets.sh у pre-commit — блокує коміт у docs/ з телефонами +380…, email не на домені компанії, token=, api_key, 10-значними ІПН.
10. Робочий цикл
- Гілка
doc/<id>-<файл> (напр. doc/SL1-робота-в-pipedrive) — один документ або одна хвиля.
- Claude Code пише за шаблоном з
шаблони/, джерело — raw/ або інвентаризація.
- PR → owner читає →
status: active → merge → Cloudflare Pages деплоїть.
raw/ розбирає агент: транскрипт → чернетка в гілці → PR.