pechernyi-compress

name	pechernyi-compress
description	Стискайте файли пам'яті (CLAUDE.md, todos, налаштування) у формат pechernyi для заощадження вхідних токенів. Зберігає всю технічну суть, код, URL та структуру. Стиснута версія перезаписує оригінальний файл. Резервна копія зберігається як FILE.original.md. Тригер: /pechernyi:compress <filepath> або "стисни файл пам'яті"

Pechernyi Compress

Призначення

Стискання файлів природною мовою (CLAUDE.md, todos, налаштування) у формат pechernyi для зменшення кількості вхідних токенів. Стиснута версія перезаписує оригінал. Резервна копія зберігається як <filename>.original.md.

Тригер

/pechernyi:compress <filepath> або коли користувач просить стиснути файл пам'яті.

Процес

1. Скрипти стиснення знаходяться в pechernyi-compress/scripts/. Якщо шлях недоступний, знайдіть pechernyi-compress/scripts/__main__.py.

2. Запуск:

cd pechernyi-compress && python3 -m scripts <absolute_filepath>

3. CLI виконає:

• визначення типу файлу (без токенів)
• виклик Claude для стиснення
• валідація виводу (без токенів)
• якщо є помилки: точкове виправлення за допомогою Claude (тільки цільові виправлення, без повторного стиснення)
• до 2 повторних спроб
• якщо після 2 спроб все ще не вдається: повідомити користувача про помилку, залишити оригінальний файл недоторканим

4. Повернення результату користувачеві

Правила стиснення

Видалити

• Артиклі (для англійської), зайві сполучники та частки
• Слова-паразити: просто, дійсно, в основному, фактично, суттєво, загалом
• Ввічливі фрази: "звичайно", "безумовно", "радий допомогти", "я б рекомендував"
• Невпевнені фрази: "можливо варто", "ви могли б розглянути", "було б добре"
• Надлишкові фрази: "для того, щоб" → "щоб", "переконайтеся, що" → "забезпечте"
• Сполучний "флафф": "проте", "крім того", "додатково"

Зберігати ТОЧНО (ніколи не змінювати)

• Блоки коду (огороджені ``` та з відступом)
• Вбудований код (вміст у лапках)
• URL-адреси та посилання (повні URL, markdown посилання)
• Шляхи до файлів (/src/components/..., ./config.yaml)
• Команди (npm install, git commit, docker build)
• Технічні терміни (назви бібліотек, API, протоколи, алгоритми)
• Власні назви (назви проектів, людей, компаній)
• Дати, номери версій, числові значення
• Змінні оточення ($HOME, NODE_ENV)

Зберігати структуру

• Усі заголовки markdown (зберігати точний текст заголовка, стискати текст під ним)
• Ієрархію списків (зберігати рівень вкладеності)
• Нумеровані списки (зберігати нумерацію)
• Таблиці (стискати текст комірок, зберігати структуру)
• Frontmatter/YAML заголовки в markdown файлах

Стискати

• Використовуйте короткі синоніми: "великий" замість "об'ємний", "виправити" замість "реалізувати рішення для", "використовувати" замість "утилізувати"
• Фрагменти замість повних речень: "Запустити тести перед комітом" замість "Вам слід завжди запускати тести перед тим, як робити коміт"
• Опускайте "вам слід", "переконайтеся", "пам'ятайте" — просто вказуйте дію
• Об'єднуйте повторювані пункти, що говорять про одне й те саме різними словами

КРИТИЧНЕ ПРАВИЛО: Все всередині ... має бути скопійовано ТОЧНО. Не можна:

• видаляти коментарі
• видаляти пробіли
• змінювати порядок рядків
• скорочувати команди
• спрощувати будь-що

Вбудований код (...) має бути збережений ТОЧНО.

Якщо файл містить блоки коду:

• Ставтеся до блоків коду як до регіонів лише для читання
• Стискайте лише текст поза ними
• Не об'єднуйте розділи навколо коду

Приклад

Оригінал:

Ви завжди повинні переконатися, що запустили набір тестів перед тим, як надсилати будь-які зміни до головної гілки. Це важливо, оскільки допомагає вчасно виявити помилки та запобігає розгортанню зламаних збірок у продуктивному середовищі.

Стиснуто:

Запустіть тести перед push у main. Виявляйте помилки вчасно, запобігайте зламаним деплоям.

Межі

• Стискайте ТІЛЬКИ файли природною мовою (.md, .txt, без розширення)
• НІКОЛИ не змінюйте: .py, .js, .ts, .json, .yaml, .yml, .toml, .env, .lock, .css, .html, .xml, .sql, .sh
• Якщо файл має змішаний вміст, стискайте ТІЛЬКИ прозові розділи
• Резервна копія створюється як FILE.original.md перед перезаписом
• Ніколи не стискайте FILE.original.md (пропускайте його)