bd daemon sync: 2026-01-22 17:27:39#1
Open
Puremag1c wants to merge 33 commits into
Open
Conversation
- CLAUDE.md: now personal assistant file (transfers between projects) - Role, principles, working process - "Выработанные подходы" section for accumulated knowledge - Link to PROJECT.md for current project - PROJECT.md: new file for project-specific context - Claudev architecture and structure - Agents, scripts, phases description - Current status and next steps Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- CLAUDE.md now lives in ~/.claude/ (PARTNER repo) - Symlink CLAUDE.md -> ~/.claude/CLAUDE.md - Added to .gitignore (personal file, different path per machine) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- CLAUDE.md now symlinks to ~/.claude/CLAUDE.md (PARTNER repo) - Shows helpful message if ~/.claude/CLAUDE.md not found Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
CLAUDE.md is now managed independently via ~/.claude/link.sh (PARTNER repo) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…чивость - Tech Writer: Opus, сам пишет в beads, два режима (новый/итерация) - Manager: Sonnet, stateless, определяет фазу по beads - Архитектура: subagents + beads, каждый агент сам пишет состояние - UX: 4 статуса (в работе, ожидает, решение, завершено) - Отказоустойчивость: retry 3x, эскалация к Architect, лимит 2 - clarification vs decision issues - Исследование multi-agent patterns (Anthropic, Claude Code docs) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Зафиксированы решения: - CI/CD опционален - Статусы задач (open → in_progress → needs-review → closed) - Конфигурация через .claudev/config.yaml - Tech Writer собирает конфиг на старте - Secrets: средний уровень (gitleaks + инструкции) - Rollback: git revert при CI fail - Приоритет: bd ready сортирует, Executor берёт первую - Senior Executor делает релиз Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Senior Analyst убран (избыточен) - Tech Writer формирует ТЗ + config - CI/CD помечен как опционально Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Формат plaintext с timestamp для человекочитаемости - Ротация по итерациям (archive/iteration-N.log) - Обязательное логирование: фазы, задачи, git операции, ошибки - Опциональное логирование токенов через config - Хелпер log.sh для агентов - Правила безопасности (не логировать secrets) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Атомарный claim через bd update --claim - Лимит эскалаций: blocked:escalation-limit + дерево блокируется - Circular deps: bd dep cycles проверяет - Senior Executor последовательный by design - SPEC.md validation перед Architect - Beads daemon down = падаем - Merge conflicts: по приоритету, семантические → Architect - Статистика токенов по ролям после итерации Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Подтверждено: Analysts создают задачи БЕЗ deps - Architect в PLAN_REVIEW расставляет deps для новых задач Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Формат запуска агентов (heredoc + контекст) - Модель Executor через label model:* - Интерактивность vs цикл (два режима orchestrator) - install.sh: git init, remote prompt, атомарность - Graceful shutdown: trap, reset in_progress при старте Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Прогнали архитектурный чеклист по 7 пунктам: 1. Draft Tech Writer — привязка к задаче через notes 2. Iteration numbering — timestamp вместо счётчика 3. Cleanup — раз в сутки по timestamp 4. Stats tokens — оценка через chars/4 5. Release timing — review+release одной задачей 6. PR workflow — fail hard без remote 7. Config reload — каждую итерацию Все решения проходят чеклист: failure modes, bottlenecks, data flow, edge cases. LLM-friendly: простые команды, явные маркеры, изоляция. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Угрозы и решения: 1. GitHub remote — early detection + graceful degradation (локальный merge fallback) 2. Executor rebase conflicts — всегда эскалация к Architect (безопасность) 3. Stats tokens — измерять input, оценивать output (достаточно для MVP) 4. Config reload — hybrid yaml→sh (UX + простота системы) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Проведён полный архитектурный аудит перед началом реализации. Найдено и закрыто 10 угроз (4 критичных, 6 средних). Критичные (data loss, race conditions): - Orchestrator lock race condition → atomic через set -C - Config sync race condition → bash config напрямую - Executor rebase потеря работы → WIP commit - Graceful shutdown lost in-progress → smart reset (5min) Средние (неточность, edge cases): - GitHub remote detection → gh CLI + fallback - Beads daemon check → каждую итерацию - Senior Executor backpressure → queue limit - Stats tokens → простая оценка для статистики - Tech Writer draft → TTL 24h - Circular deps → check после каждого dep add Все решения следуют принципам: минимальная сложность, LLM-friendly, атомарные операции, graceful degradation, fail fast. Система готова к реализации. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Найдено: - 4 критичных (требуют кода, P0 задачи создано) - 5 средних (закрываются при реализации) Критичные (P0): - Config validation отсутствует → claudev-czh - Backpressure не работает без gh CLI → claudev-acs - Race: executors стартуют до PLAN_REVIEW → claudev-ssb - Manager cycles check нет обработки → claudev-h03 Решения #21-#25: - Iteration lock concept (одна итерация за раз) - Stats → Markdown формат - Retry counter → label retry:N - install.sh → dependency checker + auto-install - SPEC.draft.md cleanup → mv при финализации Итого: 19 угроз найдено за 2 прохождения аудита Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Из 4 задач второго аудита: - 2 реально критичных (P0) → блокируют реализацию - claudev-czh: config validation (typo → crash) - claudev-acs: backpressure через beads (без gh перегрузка) - 2 маловероятных (P1) → не блокируют - claudev-ssb: race executors/PLAN_REVIEW (теоретический) - claudev-h03: Manager cycles check (Architect уже проверяет) Добавлен STOP критерий в CLAUDE.md: - Чёткая классификация проблем (P0/P1/P2) - Честная оценка вероятности (реальная vs теоретическая) - Edge cases <1% приемлемы для MVP Готово к реализации после закрытия 2 P0 задач. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Основные компоненты: - 10 промптов агентов (Tech Writer, Manager, Architect, Executor, Senior Executor, 5 Analysts) - orchestrator.sh с lock file, config validation, graceful shutdown - run-executors.sh с backpressure через beads - run-analysts.sh для параллельного аудита - install.sh с dependency check и auto-setup Закрыто 52 задачи, включая 2 P0 блокера и 25 архитектурных решений. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- invite.sh: curl | bash установка из GitHub - README.md: простая документация для непрограммистов - PROJECT.md: обновлены инструкции установки Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- invite.sh: автоустановка git (xcode-select/apt) - install.sh: автоустановка homebrew, beads, gh, jq, claude-code - Официальные методы: brew, apt, curl install scripts - Поддержка macOS и Linux Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- invite.sh: определение Windows, инструкции по WSL - README.md: обновлены требования Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
После установки удаляются: README, PROJECT, CLAUDE, AGENTS, invite.sh, .beads/, docs/ — пользователю не нужны Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- invite.sh для curl | bash - Полная автоустановка зависимостей - Поддержка Windows через WSL - Очистка от файлов разработки Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add close-completed-parents.sh script - Features auto-close when all tasks completed - Epics auto-close via bd epic close-eligible - orchestrator calls auto-close each cycle Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Architect must bump version and update changelog before PASSED - VERSION file for universal version tracking - SemVer: MAJOR/MINOR/PATCH based on closed tasks Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.