aep/claude-harness
1
0
Fork 0
Code Issues 13 Pull Requests 3 Actions Packages Projects Releases Wiki Activity
claude-harness/CHANGELOG.md
Andrey Epifancev ed5d1f9014 docs: роли в HARNESS.md и README, CHANGELOG 0.3.0, решения плана в спеке 
Refs #2

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MzkPQWjfA7RpqYWkjnqJwt
2026-10-12 00:38:55 +04:00

5.0 KiB
Raw Blame History

Changelog

0.3.0 — 2026-10-11

  • Роли сессии dev|admin|analyst|qa: общий слой roles/<r>.md (~/.claude/roles/), проектный слой <workspace>/.claude/roles/<r>.md; формат из четырёх разделов (спека docs/superpowers/specs/2026-10-11-roles-and-memory-design.md).
  • Skill /role <r>: читает оба слоя, раздел памяти роли, «Читать на старте»; строки brief: — фоновому агенту briefing (sonnet, только чтение).
  • SessionStart-хук role-hint.sh: подсказка роли по заголовку сессии (claude -n "admin …"), регистр и префикс cc- не важны; ничего не блокирует.
  • link-roles.sh: симлинки ролей и агентов из workspace в репозитории направлений по таблице | Каталог | Репозиторий | Роль |. Память агентов через симлинк не работает (проверено, спека, раздел 11) — для неё запасной вариант 6.5 (notes/agent-memory.md).
  • Шаблоны project-template/workspace/ и project-template/role-repo/; режим --workspace в adopt-project.sh и new-project.sh.
  • Глобальный CLAUDE.md сжат до ≤ 3 КБ (роль, хуки, память, маркировка, стиль); процесс разработки переехал в roles/dev.md — таблица адресов docs/retro/2026-10-11-claude-md-addresses.md. Изменения правил: архив OpenSpec всегда отдельным PR; п. 4 чеклиста закрытия — из worktree по allow-правилу; bounded обновляет спеку при смене API; новый п. 7 — память задачи при закрытии.
  • Политика памяти: состояние задачи в трекере, уроки в notes/ направления и памяти агентов, в auto-memory — только ловушки машины и индекс.
  • doctor.sh: файлы ролей, самотест role-hint, режим workspace (симлинки, размеры CLAUDE.md и индекса памяти).
  • Тесты пакета tests/run.sh (bash, без зависимостей): хук, роли, размеры, skill/agent, link-roles, workspace, doctor, install.
  • Ретроспектива docs/retro/2026-10-11.md и скрипты docs/retro/scripts/.

0.2.0 — 2026-09-27

  • Skill harness-doctor (doctor.sh + чеклист прочтения): машина, самотест хуков, проект; ставится в ~/.claude/skills/.
  • require-plan: защищает любой src/ на любой глубине (было — только от корня), переопределение списком в .claude/code-paths.
  • SessionStart-хук harness-check.sh: при старте сессии в неподключённом проекте агент предлагает (или с HARNESS_AUTO_ADOPT=1 — сразу выполняет) adopt-project.sh; скрипты бутстрапа ставятся в ~/.claude/harness/.
  • adopt-project.sh — подключение обвязки к существующему репозиторию (ветка → бутстрап → ff-merge); project-template/CLAUDE.harness-section.md.
  • codegraph: codegraph init в worktree и projectPath в вызовах codegraph_explore — MCP-сервер видит только индекс папки запуска.
  • Порядок старта фичи: worktree на временной ветке → issue → переименование ветки (хук guard-main блокирует запись на main).
  • Маркировка находок и решений: T<n>.<k>, C/I/M-n, R-n, O-n, H-n; обязательный статус fixed / deferred / rejected.
  • Чеклист закрытия: issue закрывается только при выполнении всех её пунктов, иначе комментарий с закрытыми маркерами; неприменимые к bounded пункты пропускаются с пометкой.
  • Чеклист закрытия: п. 6 — отложенные находки собираются в issue Gitea Follow-ups from #N.

0.1.0 — 2026-09-27

  • Первая версия после пилота на obsidian-voice-note (10 задач, 125 тестов, PR #2).
  • Хуки: guard-main (main + detached HEAD, Bash-запись, исключение для openspec/), require-plan (.bounded).
  • Глобальный CLAUDE.md: маршрутизация superpowers/OpenSpec/Gitea/codegraph, контроллер SDD на sonnet, чеклист закрытия из 6 пунктов, раздел «Decisions made without discussion».
  • new-project.sh и шаблон проекта.