AIDB Dev Center

Readable architecture document

AIDB Developer Reading Rule

Правило короткого чтения для developer и обязанность архитектора давать task packet.

activesource: AIDB_DEVELOPER_READING_RULE.md

AIDB Developer Reading Rule

Статус

Статус: active.

Дата: 2026-05-20.

1. Главный принцип

Разработчик не должен читать длинные архитектурные документы полностью для каждой задачи.

Разработчик должен получать:

  • короткий task packet;
  • 2-5 нужных документов;
  • короткое резюме уже утвержденного канона;
  • четкий результат.

2. Что считается плохой практикой

Плохая практика:

  • "прочитай весь docs";
  • "разберись сам по всем документам";
  • "прочитай сначала весь foundation, потом весь system, потом весь children, потом roadmap".

Это тратит время и токены.

3. Что считается хорошей практикой

Хорошая практика:

  • foundation читается один раз;
  • дальше задача приходит с коротким packet;
  • architect дает только нужные документы;
  • developer тратит время в основном на код и проверку.

4. Обязанность архитектора

Архитектор обязан:

  • давать короткий packet;
  • не отправлять лишние документы;
  • заранее разрезать архитектуру на понятные stage-documents;
  • не держать критический смысл только в чате.