HSE/tgit
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: guardrails в CLAUDE.md #21

New Issue
Closed
opened 2026-10-12 19:35:50 +03:00 by Eleboba · 0 comments
Eleboba commented 2026-10-12 19:35:50 +03:00
Owner
Copy Link
Copy Source

Описание

Зафиксировать в CLAUDE.md жёсткие правила по образцу Vobot/meditron, чтобы каждая сессия их соблюдала.

Желаемый результат

Раздел Guardrails: доступ — middleware на каждом апдейте (ADR-011); песочница для чужого кода (ADR-005/006); агент — фильтр + страж + LogQuery, логи не в LLM, grep не в shell (ADR-007/013); провайдер за протоколом (ADR-008); конфиг типизирован; секреты только в .env; внешние вызовы с ретраями; make lint && make test перед PR; в SourceCraft не пушим (ADR-010).

Подзадачи

  • Таблица guardrails + мнемоника
  • Ссылки на SPEC/ARCHITECTURE/ADR
  • Обновить TL;DR

Анализ

Затрагиваемые файлы

Файл Что меняется
CLAUDE.md раздел Guardrails

Ограничения и риски

Не дублировать документы — только правила и ссылки.

Как проверить

Прочитать CLAUDE.md: по нему ясно, чего нельзя делать в коде.

Лог выполнения

2026-10-13

  • Задача переписана под SPEC v2 (QR-доступ, меню из 4 разделов, командная модель — ADR-011…013).

2026-10-14

  • В CLAUDE.md раздел Guardrails: 10 правил с мнемоникой и ссылками на код/ADR (доступ, песочница, LLM без исполнения, провайдер за протоколом, типизированный конфиг, секреты, ретраи, схема только миграциями, гейт, SourceCraft — зеркало). TL;DR ссылается на них.
## Описание Зафиксировать в `CLAUDE.md` жёсткие правила по образцу Vobot/meditron, чтобы каждая сессия их соблюдала. ## Желаемый результат Раздел Guardrails: доступ — middleware на каждом апдейте (ADR-011); песочница для чужого кода (ADR-005/006); агент — фильтр + страж + LogQuery, логи не в LLM, grep не в shell (ADR-007/013); провайдер за протоколом (ADR-008); конфиг типизирован; секреты только в `.env`; внешние вызовы с ретраями; `make lint && make test` перед PR; в SourceCraft не пушим (ADR-010). ## Подзадачи - [x] Таблица guardrails + мнемоника - [x] Ссылки на SPEC/ARCHITECTURE/ADR - [x] Обновить TL;DR ## Анализ ### Затрагиваемые файлы | Файл | Что меняется | |------|--------------| | `CLAUDE.md` | раздел Guardrails | ### Ограничения и риски Не дублировать документы — только правила и ссылки. ## Как проверить Прочитать CLAUDE.md: по нему ясно, чего нельзя делать в коде. --- ## Лог выполнения ### 2026-10-13 - Задача переписана под SPEC v2 (QR-доступ, меню из 4 разделов, командная модель — ADR-011…013). ### 2026-10-14 - В `CLAUDE.md` раздел Guardrails: 10 правил с мнемоникой и ссылками на код/ADR (доступ, песочница, LLM без исполнения, провайдер за протоколом, типизированный конфиг, секреты, ретраи, схема только миграциями, гейт, SourceCraft — зеркало). TL;DR ссылается на них.
Eleboba added this to the M1 · MVP: загрузка → коммит → CI milestone 2026-10-12 19:35:50 +03:00
Eleboba added the docsrefactorsize/0.5 labels 2026-10-12 19:35:50 +03:00
Eleboba self-assigned this 2026-10-12 19:35:50 +03:00
Eleboba changed title from docs: guardrails в CLAUDE.md и ссылки на ТЗ/архитектуру to docs: guardrails в CLAUDE.md 2026-10-13 22:54:33 +03:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bot
Зона: код бота (app/)
 ci
Зона: CI
 docs
Зона: документация
 feature
Тип: новая функциональность
 fix
Тип: исправление
 infra
Зона: Docker, деплой, хост
 llm
Зона: LLM-ассистент
 refactor
Тип: рефакторинг
 size/0.5
≈ 2 ч
 size/1
≈ 4 ч
 size/2
≈ 1 день
No labels docs refactor size/0.5
Milestone
No items
No Milestone M1 · MVP: загрузка → коммит → CI
Projects
Clear projects
No projects
Assignees
Clear assignees
Eleboba
No Assignees Eleboba
1 Participants
Notifications
Due Date
No due date set.
Depends on
#2 docs: ТЗ, архитектура и бэклог проекта
HSE/tgit
Reference: HSE/tgit#21