DevRails-26 AGENTS.md

Что является продуктом этого репозитория

DevRails — framework агентной разработки, а не обычное приложение и не набор независимых prompts.

Canonical source через installer разворачивается в целевой проект как runtime skills, Memory Bank, workflows, protocols и validators.

Изменения оцениваются по всей цепочке:

canonical source
  -> installer/generator
  -> deployed target files
  -> поведение runtime-агента
  -> workflow state, gates и handoffs

Наличие файла в source repo не означает, что он доступен runtime-агенту в target project.

Skills как executable workflow contracts

Runtime skills, shared workflows, protocol shapes и validators являются частями одного публичного workflow contract.

Без отдельного решения нельзя менять или терять:

• inputs, outputs, statuses и verdicts;
• lifecycle и status ownership;
• blockers, stop conditions и resume routes;
• required gates и handoffs;
• task schema и registry semantics.

Leaf skill должен описывать собственный outcome и immediate handoff, а общие правила получать из доступного в target canonical reference.

Стиль runtime-инструкций

• Пиши runtime-инструкции только для исполняющего агента. Перед сохранением сокращай или объединяй формулировки и удаляй текст, если это не меняет допустимое поведение агента и workflow contract.
• Из однозначных contract-equivalent вариантов выбирай кратчайший. Не дублируй правила; rationale, пояснения и примеры оставляй только когда они нужны для однозначного исполнения.
• Каждая инструкция должна защищать workflow contract, корректность, безопасность или совместимость.
• Inputs, outputs, gates, blockers, validation и handoff формулируй нормативно.
• В остальных случаях избегай повелительного тона: внутреннюю тактику и порядок действий оставляй на выбор агента.
• Не превращай примеры, предпочтения и best practices в обязательные шаги.
• Сокращение текста не должно менять statuses, ownership, stop conditions и resume routes.

Цель и тактика

• В инструкциях, промптах и ответах фиксируй цель, ограничения и критерии результата.
• Не предписывай тактику, шаги, порядок или инструменты без основания в корректности, безопасности, совместимости или workflow contract; оставляй их выбор агенту.