human-execution-engine

HEE (Human Execution Engine) — это открытый фреймворк выполнения, основанный на доктрине, предназначенный для детерминированной оркестрации человеческой работы. Он координирует человеческое рассуждение, машинную поддержку и автоматизацию без неоднозначности, ставя корректность выше консенсуса, структуру выше интуитивного восприятия и детерминизм выше удобства. Проект решает проблему отклонения записей от реальности — когда утверждения становятся устаревшими или неверными, даже если никто намеренно не врёт. Поскольку агентские системы читают и действуют по записям со скоростью машины, устаревшие или ошибочные данные распространяются быстрее, чем человек успевает заметить. HEE предоставляет механизмы для намеренного выявления расхождений, а не случайного обнаружения. Ключевые концепции: - Типизированные объекты: каждая запись управления (Card, Pill, Contract, Blueprint, Plan, Registry) представляет собой YAML-файл с полем kind, блоком метаданных и хеш-идентификатором, вычисленным как sha256(seed). Они проверяются с помощью hee lint. - Проверки верификации: hee check сверяет утверждения с реальными измерениями — проверяет записи в списке против активных учётных записей GitHub, проверяет отсоединённые подписи GPG по их исходным файлам, подтверждает, что хеши идентичности воспроизводятся из семян, и выявляет секреты в публичных репозиториях. - Цепочки подписей: контракты утверждаются подписями GPG над YAML-файлом. Файл .asc рядом с YAML является доказательством; строка состояния — лишь утверждение о нём. - Тезис и дуопле: Тезис — это утверждение, предназначенное для стресс-тестирования. Дуопле — это утверждение, приведённое к проверяемой форме с подтверждением доказательствами. Обозначение чего-либо как Тезиса — это честный отчёт о состоянии, а не снижение уровня. - Разделение доктрины: blueprints/ и hee/ определяют, что должно быть истинно. ci/, tooling/ и scripts обеспечивают соблюдение, но никогда не являются источником истины. CLI-интерфейс hee предоставляет команды, такие как hee check, hee lint и hee list. Проект рекомендует использовать его в чистом временном каталоге, поскольку установка не требуется. Ключевые директории: - blueprints/: схемы доктрины и валидационные контракты; - hee/: карточки, таблетки, контракты, реестры и навыки; - mib/: модуль словаря HEE-MIB; - docs/doctrine/: HEE_POLICY; - tooling/bin/: инструменты hee. HEE определяет, что должно быть истинно, но не указывает, как это сделать. Это не инструмент рабочего процесса, библиотека промптов или фреймворк агентов, и он не имеет мнения о языке реализации.