Doc Harness

中文版 README

Файловое управление проектом для AI-human коллаборации.

Doc Harness — это скилл для Claude Code, который даёт вам и AI-агентам структурированный способ управлять любым проектом — как упряжь, которая направляет силу лошади и держит её под контролем.

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

Подходит для любого проекта: написание диссертации, разработка SaaS-фичи, анализ данных для клиента, исследование для журналистского материала, разработка программной библиотеки или что угодно другое, что охватывает несколько сессий и порождает файлы.

Обзор за 30 секунд

После установки агент ведёт 5 статусных документов для вашего проекта: точка входа (CLAUDE.md), текущий статус (CURRENT_STATUS.md), индекс файлов (FILE_INDEX.md), журнал истории (WORKLOG.md) и спецификация (DOC_HARNESS_SPEC.md). Сброс контекста, новый агент, возвращение после выходных — чтения этих 5 файлов достаточно, чтобы продолжить работу без потерь.

Нулевые зависимости (чистый Markdown, без MCP / базы данных / внешних сервисов) · Двуязычный (English / 中文) · MIT.

Какую проблему это решает?

Когда вы работаете с AI-агентами над проектом на протяжении дней или недель:

• AI теряет память. Контекстные окна сжимаются или сбрасываются. Вчерашний анализ сегодня забыт.
• Файлы накапливаются без карты. После нескольких сессий у вас 30 файлов, и никто не помнит, что где лежит.
• Принципы размываются. Вы установили правила («валидировать на out-of-sample данных»), но AI постепенно их забывает.
• Передача контекста ломается. Новый агент приходит с нулевым контекстом. Вы тратите 20 минут на повторное объяснение.
• Вы теряете место. После выходных ни вы, ни AI не знаете точно, где остановились.

Doc Harness решает эти проблемы, поддерживая самодостаточную систему документации — набор файлов, которые любой агент может прочитать и сразу понять, без внешней памяти или брифинга.

Что такое «проект»?

Всё, что имеет цель, охватывает несколько рабочих сессий и порождает файлы:

• Академическая диссертация или исследовательская статья
• SaaS-фича или программный модуль
• Пайплайн анализа данных для клиента
• Лонгрид или отчёт
• Серия экспериментов
• План запуска продукта

Проект — это просто папка. Внутри неё Doc Harness создаёт пять статусных документов рядом с любыми папками и файлами, которые нужны вашей работе:

Doc Harness не диктует структуру папок — он только требует, чтобы каждый файл был зарегистрирован в FILE_INDEX.

Пять документов: как они работают

Каждый документ служит отдельной цели, обновляется с разной частотой и отвечает на разный вопрос. Вместе они охватывают всё, что нужно знать агенту или соавтору.

CLAUDE.md — Стабильный якорь

Отвечает на вопрос: «Что это за проект? Каковы правила? С чего начать?»

Первое, что читает любой агент. Содержит обзор проекта, обязательные правила («железные правила»), технические детали (команды сборки, пути) и — что важно — встроенные операционные правила, которые учат агента поддерживать Doc Harness. Это означает, что вам никогда не придётся объяснять систему новому агенту — всё уже есть в файле.

Почти не меняется. Обновляется только при смене фаз или добавлении важных правил. Это стабильный фундамент, на котором держится всё остальное.

CURRENT_STATUS.md — Живой пульс

Отвечает на вопрос: «Что только что произошло? Что происходит сейчас? Что дальше?»

Проект в движении похож на едущий автомобиль: есть дорога позади (история), текущее положение (сейчас), направление впереди (ещё не определённое) и правила, которым вы следуете во время езды. Всё это нужно отслеживать и фиксировать. CURRENT_STATUS.md организован вокруг этой метафоры:

Обновляется каждую сессию. Когда фаза работы завершается, кузов (полные детали) архивируется в WORKLOG, сжимается до резюме в следах шин и очищается для новой фазы. Это позволяет документу всегда оставаться компактным (~200 строк), при этом ничего не теряется.

Именно это обеспечивает восстановление работы. Агент с нулевой памятью читает это и за секунды узнаёт: где был проект (следы шин), где он сейчас (кузов), куда движется (фары) и каким правилам следовать (руководство водителя).

FILE_INDEX.md — Библиотечный каталог

Отвечает на вопрос: «Какие файлы существуют, что они содержат и где находятся?»

Каждый файл в проекте получает однострочную запись, организованную по категориям:

## Research Notes
- `notes/literature_review.md` — Обзор 30 статей о ценовом влиянии
- `notes/key_findings.md` — Синтез по статьям

## Scripts
- `scripts/analyze_data.py` — Регрессия ценового влияния

Растёт по мере создания файлов. Правило простое: создал файл → сразу зарегистрируй его. Незарегистрированный файл невидим для агентов.