docs: описать проект в CLAUDE.md и ARCHITECTURE.md #2

aep · 2026-10-18T18:17:40+03:00

aep commented

2026-10-18 18:17:40 +03:00

Closes #1

Bounded-задача: заполнены шаблоны claude-harness по фактическому коду.

Что изменено

CLAUDE.md — разделы «Что это», «Стек и ограничения», «Архитектура», «Команды», «Тесты», «Где лежит код». Секция «OpenSpec и superpowers» не тронута.
ARCHITECTURE.md — схема потоков данных (хук → jsonl → панель → HTTP → Toolbelt), таблица модулей, границы, открытые вопросы.

Проверка

python3 -m py_compile files/*.py && sh -n files/agents_panel_hook.sh && bash -n install.sh && bash -n uninstall.sh — OK.
claude_agents.py импортируется без iTerm2 (iterm2 = None) — проверено.
Утверждения о записи на диск и адресе сервера сверены с кодом (единственная запись панели — os.remove в cleanup_logs; сервер — 127.0.0.1).
Плейсхолдеров {{...}} не осталось.

Rulings I made

R-1: раздел шаблона «Первая подсистема» заменён на «Где лежит код» — проект уже написан, первой подсистемы нет; важнее зафиксировать, что код в files/ и что install.sh/uninstall.sh хуком require-plan не покрыты. Цена ошибки — вернуть раздел.
R-2: раздел «Тесты» описывает целевое состояние (pytest по чистым функциям, моки сети/Keychain/ps/tmux, фикстуры в tests/fixtures/), хотя тестов нет — чтобы следующая задача по тестам шла по нему. Цена ошибки — переписать раздел при первом плане тестов.
R-3: ARCHITECTURE.md заполнен в этом же PR (issue упоминает его как «заодно»).

Findings

Маркер	Суть	Статус
O-1	Docstring `files/claude_agents.py` ссылается на несуществующий `settings-hooks.json` и ручную установку — устарел после появления `install.sh`	deferred
O-2	Автотестов нет; `claude_agents.py` — один файл на 1500 строк	deferred
O-3	`__pycache__/` не в `.gitignore` — `py_compile` из раздела «Команды» оставляет мусор в `files/`	deferred
O-4	Команда проверки в черновике CLAUDE.md: `bash -n install.sh uninstall.sh` проверяла только первый файл	fixed `df6e0bc`

🤖 Generated with Claude Code

Closes #1 Bounded-задача: заполнены шаблоны claude-harness по фактическому коду. ## Что изменено - **CLAUDE.md** — разделы «Что это», «Стек и ограничения», «Архитектура», «Команды», «Тесты», «Где лежит код». Секция «OpenSpec и superpowers» не тронута. - **ARCHITECTURE.md** — схема потоков данных (хук → jsonl → панель → HTTP → Toolbelt), таблица модулей, границы, открытые вопросы. ## Проверка - `python3 -m py_compile files/*.py && sh -n files/agents_panel_hook.sh && bash -n install.sh && bash -n uninstall.sh` — OK. - `claude_agents.py` импортируется без iTerm2 (`iterm2 = None`) — проверено. - Утверждения о записи на диск и адресе сервера сверены с кодом (единственная запись панели — `os.remove` в `cleanup_logs`; сервер — `127.0.0.1`). - Плейсхолдеров `{{...}}` не осталось. ## Rulings I made - R-1: раздел шаблона «Первая подсистема» заменён на «Где лежит код» — проект уже написан, первой подсистемы нет; важнее зафиксировать, что код в `files/` и что `install.sh`/`uninstall.sh` хуком require-plan не покрыты. Цена ошибки — вернуть раздел. - R-2: раздел «Тесты» описывает целевое состояние (pytest по чистым функциям, моки сети/Keychain/ps/tmux, фикстуры в `tests/fixtures/`), хотя тестов нет — чтобы следующая задача по тестам шла по нему. Цена ошибки — переписать раздел при первом плане тестов. - R-3: ARCHITECTURE.md заполнен в этом же PR (issue упоминает его как «заодно»). ## Findings | Маркер | Суть | Статус | |---|---|---| | O-1 | Docstring `files/claude_agents.py` ссылается на несуществующий `settings-hooks.json` и ручную установку — устарел после появления `install.sh` | deferred | | O-2 | Автотестов нет; `claude_agents.py` — один файл на 1500 строк | deferred | | O-3 | `__pycache__/` не в `.gitignore` — `py_compile` из раздела «Команды» оставляет мусор в `files/` | deferred | | O-4 | Команда проверки в черновике CLAUDE.md: `bash -n install.sh uninstall.sh` проверяла только первый файл | fixed df6e0bc | 🤖 Generated with [Claude Code](https://claude.com/claude-code)

aep added 1 commit 2026-10-18 18:17:42 +03:00

docs: describe project in CLAUDE.md and ARCHITECTURE.md df6e0bcbc1

Refs #1

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

aep commented

2026-10-18 18:17:57 +03:00

O-5 (deferred): .claude/worktrees/ не в .gitignore — пока открыт worktree, основной checkout показывает его как untracked, и пункт 5 чеклиста закрытия (git pull --ff-only при чистом дереве) может споткнуться. Добавить строку в .gitignore отдельной задачей или в шаблон claude-harness.

aep merged commit 3ae32fadf9 into main

2026-10-18 18:18:39 +03:00

aep referenced this issue from a commit

2026-10-18 18:18:40 +03:00

Merge pull request 'docs: описать проект в CLAUDE.md и ARCHITECTURE.md' (#2) from feat/1-claude-md-describe into main

aep referenced this pull request

2026-10-18 18:18:50 +03:00

Описать проект в CLAUDE.md по коду #1

aep referenced this pull request

2026-10-18 18:18:52 +03:00

Follow-ups from #1 #3

Sign in to join this conversation.