diff --git a/README.md b/README.md index f420c88..5bd3925 100644 --- a/README.md +++ b/README.md @@ -108,6 +108,10 @@ The `flows/` layer describes repeatable processes that an agent can follow. Ever For a substantial feature, Feature Flow produces a Feature Pack in three stages: +The flow treats the feature as a testable vertical slice and follows +specification-driven development: the documents required by the selected route +are created and reviewed before implementation begins. + ```text brief.md design.md implementation-plan.md what and why → chosen solution → implementation and checks diff --git a/README.ru.md b/README.ru.md index 2d01670..fa11f6d 100644 --- a/README.ru.md +++ b/README.ru.md @@ -86,6 +86,8 @@ https://github.com/dapi/memory-bank/blob/main/docs/brownfield-adaptation-protoco риски. ``` +![Запуск задачи через маршрутизацию Memory Bank](docs/assets/quick-start-routing.gif) + [Инструкция по повседневной работе](docs/usage.md) объясняет цикл «задача → процесс → проверка» и короткие маршруты. @@ -109,6 +111,11 @@ https://github.com/dapi/memory-bank/blob/main/docs/brownfield-adaptation-protoco Для значимого функционального изменения процесс Feature Flow создаёт Feature Pack — комплект документов фичи, который проходит три стадии: +Процесс рассматривает функциональное изменение как проверяемый вертикальный +срез и следует разработке на основе спецификации: предусмотренные +выбранным маршрутом документы создаются и проходят проверку до начала +реализации. + ```text brief.md design.md implementation-plan.md что и зачем → выбранное решение → реализация и проверки diff --git a/docs/assets/quick-start-feature-pack.gif b/docs/assets/quick-start-feature-pack.gif index 71d90c2..9ae6175 100644 Binary files a/docs/assets/quick-start-feature-pack.gif and b/docs/assets/quick-start-feature-pack.gif differ diff --git a/docs/assets/quick-start-routing.gif b/docs/assets/quick-start-routing.gif index f5720e5..e534eee 100644 Binary files a/docs/assets/quick-start-routing.gif and b/docs/assets/quick-start-routing.gif differ diff --git a/docs/assets/quick-start-start-issue.gif b/docs/assets/quick-start-start-issue.gif index c65cb8c..b2a1682 100644 Binary files a/docs/assets/quick-start-start-issue.gif and b/docs/assets/quick-start-start-issue.gif differ diff --git a/docs/quick-start.md b/docs/quick-start.md index b3d3d45..1917127 100644 --- a/docs/quick-start.md +++ b/docs/quick-start.md @@ -57,16 +57,17 @@ memory-bank-cli doctor ## 3. Выбрать сценарий запуска -Используйте один из трёх сценариев. GIF показывают сокращённый ввод в терминале, -а команды под ними можно копировать. Ответы агента будут зависеть от задачи и +Используйте один из трёх сценариев. GIF показывают сокращённое +взаимодействие в терминале, а команды под ними можно копировать. Ответы агента +будут зависеть от задачи и текущего состояния проекта. ### Вариант 1. Доверить выбор процесса Memory Bank ![Запуск задачи через маршрутизацию Memory Bank](assets/quick-start-routing.gif) -Это основной сценарий. Memory Bank сам определит подходящий процесс и создаст -только необходимые документы. +Это основной сценарий. Агент выполнит маршрутизацию Memory Bank, выберет +подходящий процесс и создаст только необходимые документы. ```bash codex -C . \ diff --git a/docs/usage.md b/docs/usage.md index 51c2af2..7b516b2 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -108,6 +108,10 @@ Memory Bank добавляет управляемый цикл: Для значимой фичи процесс создаёт Feature Pack — долговременный комплект документов изменения: +Feature Flow рассматривает такую фичу как проверяемый вертикальный срез и +следует разработке на основе спецификации: предусмотренные выбранным маршрутом +документы создаются и проверяются до начала реализации. + ```text brief.md design.md implementation-plan.md что и зачем → выбранное решение → реализация и проверки