papayu/docs/adr/ADR-002-edit-file-v3.md
Yuriy 65e95a458d feat: мульти-провайдер LLM, тренды дизайна, Snyk/Documatic sync, личная автоматизация
- Мульти-провайдер: PAPAYU_LLM_PROVIDERS — сбор планов от нескольких ИИ (Claude, OpenAI), агрегация
- Тренды дизайна и иконок: вкладка в модалке, поиск по безопасным доменам (Tavily include_domains)
- Snyk Code: PAPAYU_SNYK_SYNC, REST API issues → snyk_findings в agent-sync
- Documatic: architecture_summary из .papa-yu/architecture.md в agent-sync
- Личная автоматизация: capability personal-automation (терминал git/npm/cargo, открытие URL)
- agent_sync расширен: snyk_findings, architecture_summary; analyze_project_cmd и run_batch пишут sync
- Документация: SNYK_AND_DOCUMATIC_SYNC.md, SECURITY_AND_PERSONAL_AUTOMATION.md, обновлён CLAUDE_AND_AGENT_SYNC

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-10 15:05:39 +03:00

697 B

ADR-002: Structured PATCH/EDIT (v3) with Golden Traces

Context

The system performs automated file modifications driven by LLM output. Naive diff-based approaches led to nondeterministic and hard-to-debug behavior.

Decision

Introduce structured PATCH/EDIT protocol (v3) and lock behavior using golden traces.

Rationale

  • Deterministic behavior is more valuable than flexibility
  • Golden traces provide regression safety
  • Protocol versioning allows evolution without breaking behavior

Consequences

Positive:

  • Predictable edits
  • Easier debugging
  • Strong regression detection

Negative:

  • More rigid protocol
  • Higher upfront complexity