Textum

⚠️ Примечание: Версия на основе команд устарела и больше не поддерживается. Поддерживается только версия в виде скилла.

🤔 В чём суть?

Знакомые ситуации?

💬 Долго объясняешь требования AI, а он забывает их на полпути
🔄 Одно маленькое изменение требований — и приходится переписывать всё
🎲 Каждая генерация — лотерея, качество непредсказуемо

Именно для этого и создан Textum.

Он не сделает AI умнее, но через структурированный воркфлоу и валидацию помогает избежать ошибок, которых не должно быть в принципе.

✨ Как это работает?

Просто опишите идею обычным языком. Textum разбивает процесс на 4 фазы:

Шаг 1: 📝 Уточнение требований (PRD)

«Что именно мы строим?»

AI общается с вами, превращая размытые идеи в чёткий документ требований. Каждая фича получает номер (например, FEATURE-001) — больше не нужно повторяться.

Шаг 2: 🏗️ Технические решения (Scaffold)

«Какой стек? Как структурируем?»

Фиксируем архитектуру, выбираем технологии, определяем модули. Это создаёт «глобальный контекст», который обеспечивает согласованность всего кода.

Шаг 3: 🧩 Разбивка задач (Split)

«Каков план действий?»

Требования разбиваются на небольшие задачи (Stories) — как стикеры на доске. Одна Story — одна задача. Выполнили — переходим дальше.

Шаг 4: 💻 Реализация кода (Story)

«Пишем код!»

AI берётся за одну Story за раз, сосредоточенно и без отвлечений. Каждая Story валидируется по завершении — никакого отклонения от курса.

⚠️ Экспериментально: Story Full Exec поддерживает пакетное выполнение нескольких Stories (последовательно, без отката). Функция экспериментальная — используйте на своё усмотрение. ⚠️

🎯 Зачем столько шагов?

Представьте: вы даёте AI документ требований на 10 страниц и говорите «реализуй всё». Что происходит?

К пятой фиче AI уже забыл, какие поля были в первой. 😅

Дело не в том, что AI тупой — у него просто ограниченная «память». Чем больше информации вы даёте сразу, тем легче он теряет нить.

Поэтому философия Textum проста: меньше — значит лучше

Старый подход	Подход Textum
Скормить AI все требования сразу	📦 Подавать по фазам, только то, что нужно сейчас
Постоянно говорить «ну, тот API для логина»	🔗 Просто API-001 — коротко и однозначно
Одно изменение требования = перегенерировать всё	🎯 Перегенерировать только то, что реально затронуто

📏 Для каких проектов подходит?

Размер проекта	Количество фич	Чего ожидать	Примеры
🌱 Маленький	10–15	✅ Стабильный результат	Трекер расходов, todo-приложение, личные заметки
🌿 Средний	15–25	✅ Стабильный результат	Простой блог, система опросов
🌳 Крупный	25–35	⚠️ Требует проверки человеком	Многоролевая админ-панель, платформа бронирования

💡 Ещё крупнее? Разбейте на независимые подпроекты и прогоните каждый через Textum отдельно.

Отчёты симуляционного тестирования

Отчёты тестирования версии SKILL:

⚠️ (Тесты ниже основаны на устаревшей версии с командами, использовался Claude Opus 4.5. Только для справки)

V2 | V3 | V4
V5 (сложность растёт начиная с V5) | V6 | Beta

❌ Когда Textum не подходит

Нужно прямо сейчас: Textum требует времени на прохождение воркфлоу — не лучший выбор для «хотфикс и в прод немедленно»
Совсем простые задачи: Например, «сделай кнопку красной» — просто сделайте, не усложняйте
Нет понимания, что нужно: Если вы не можете описать задачу, Textum не поможет 😅

🚀 Начало работы

1️⃣ Установите uv

bash

# macOS и Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Или через пакетный менеджер
brew install uv  # macOS
pip install uv   # любая платформа

💡 Что такое uv? Молниеносно быстрый пакетный менеджер для Python (как npm, но для Python)

2️⃣ Инициализируйте проект

В корне вашего проекта:

bash

# Для пользователей Codex
uv sync --project .codex/skills/textum/scripts

# Для пользователей Claude Code
uv sync --project .claude/skills/textum/scripts

✅ Это автоматически:

Проверит версию Python (нужна >= 3.11)
Создаст изолированное виртуальное окружение (не засоряет проект)
Установит все зависимости

3️⃣ Начните разработку

Запустите AI-ассистент (Codex/Claude Code) и напишите:

«Хочу начать новый проект с Textum»

AI проведёт вас через все остальные шаги 🎯

👉 Хотите технические подробности? Смотрите Workflow

🕸️ Почему «Textum»?

«Истинная сила Машины была не в отдельных суждениях, а в том, чтобы сплетать разрозненных людей, события и время в единую сеть.» — Дань уважения сериалу Person of Interest

По отдельности фрагменты информации ничего не значат. Сплетённые вместе, они образуют паттерны.

Textum — латинское слово, означающее «нечто сотканное в единое целое». Именно это и делает проект: он не создаёт интеллект — он сплетает требования, контекст и задачи в связную, работающую систему.

📄 Лицензия

MIT License — используйте свободно.

Установка

README