Передача системы
Начните с чек-листа, если передача идёт; с того, что запросить, если человек уходит в следующем месяце; и со страницы рисков, если пытаетесь понять, насколько сильно волноваться.
- Руководство Чек-лист передачи Девять областей, сорок один пункт и порядок, в котором это должно происходить, — вместе с тремя приёмочными проверками, которые заменяют «документация сдана» как определение готовности. Что должно перейти из рук в руки, когда программа переходит к новой команде?
- Руководство Что спросить до ухода Рассчитывайте на один час настоящего внимания, а не на сорок. Потратьте его на две вещи, которых больше никто не даст, — рассуждение и эксплуатационную привычку, — а всё остальное выведите из системы потом. Что запросить у разработчика, который уходит?
- Руководство Передача кодовой базы Механика: репозиторий и история, окружения, секреты, демонстрационная неделя и последовательность, в которой доступы сначала передают, а потом меняют, — та часть, которую обычно делают наоборот. Как передать кодовую базу новой команде разработки?
- Руководство Риски передачи Одиннадцать вещей, которые идут не так, разложенные по тому, стоят они вам времени или способности вести дело, — и что именно предотвращает каждую. Что на самом деле может пойти не так при передаче программы?
- Руководство Документация передачи Большая часть документации передачи пишется в цейтноте о том, что кто-то помнит. Что стоит писать руками, что лучше вывести и как это заказать, чтобы получить полезную половину. Какую документацию должна дать передача программы?
Зависимость от одного подрядчика
Почти всё это совместимо с тем, чтобы оставить подрядчика, который вам нравится, — а это обычно и есть правильный исход. Сначала владение, всё остальное после.
- Руководство Кому принадлежит продакшен Доступ — это не владение. Какие аккаунты обязаны быть на компании, почему адрес восстановления важнее логина и как переоформить всё это без ссоры. Кому должны принадлежать облачные аккаунты, домен и данные продакшена?
- Руководство Снижение зависимости от агентства Шесть шагов в порядке пользы на потраченный час, и почти все совместимы с тем, чтобы оставить подрядчика, которым вы довольны, — а это обычно и есть правильный исход. Как снизить зависимость от агентства разработки?
- Руководство Смена агентства Пошаговый переход от момента до объявления об уходе до окна консультаций после него, включая то, что закрепить за собой в первую очередь и где открывается дорогой разрыв. Как перевести проект от одного агентства к другому?
- Руководство Привязка к поставщику Не всякая привязка плоха, а избегать всякой дорого. Шесть видов, во что обходится выход из каждого и два, на которые стоит потратить деньги сейчас. От каких видов привязки к поставщику действительно стоит уходить?
Программа, которую здесь никто не понимает
Легаси редко про возраст. Это значит, что людей, которые в этом разбирались, больше нет, а то, что осталось, не умеет отвечать на вопросы.
- Руководство Разобраться в легаси Семь шагов в том порядке, который работает, начиная с того, что запущено, а не с кода, — и четыре вещи, которые на это время стоит перестать делать. Как разобраться в легаси-кодовой базе?
- Руководство Совсем нет документации Первая неделя, когда ничего не записано и спросить некого: что установить, в каком порядке и почему отсутствие документации — лучшая стартовая позиция, чем неверная документация. Мне досталась кодовая база без документации. С чего начать?
- Руководство Карта существующей архитектуры Пять проходов по порядку: что запущено, из чего состоит, с чем разговаривает, куда идут данные и что установить не удалось, — плюс что записывать по каждому элементу, чтобы карта пережила своё второе обновление. Как составить карту архитектуры уже существующей программы?
- Руководство Описание легаси-системы Проекты по документации легаси почти никогда не заканчиваются, потому что никто не может сказать, сколько осталось. Что выводить, что писать руками и как сделать задачу конечной. Как описать легаси-систему, которую никто не понимает?
Программа, написанная быстрее, чем её прочитали
Ничто здесь не довод против кодовых агентов. Это довод за то, что понимание должно за ними поспевать.
- Руководство Код, написанный ИИ Разница именно в том, что по дороге его никто не прочитал. Что проверять первым, как отделить прочитанное агентом от выведенного и какие следы оставляет быстрая работа агента. Как разобраться в коде, который написал кодовый агент?
- Руководство Чек-лист для проекта от агента Двадцать восемь проверок по данным, деньгам, несчастливым путям, внешним краям, доступу, эксплуатации и пониманию — те, что чаще всего срабатывают на системах, написанных быстрее, чем их прочитали. Что проверить, прежде чем программа, собранная кодовым агентом, примет живой трафик?
- Руководство Выпуск непрочитанного Не «ИИ пишет плохой код». Семь конкретных уязвимостей от того, что понимание не поспевает за продакшеном, и во что обходится каждая. Каковы настоящие риски выпуска программы, которую никто не прочитал целиком?
- Руководство Документация от ИИ Сгенерированная документация гладкая, обширная и неотличимая от проверенной. Как её испытать, что оставить и почему непроверенная документация хуже, чем никакой. Можно ли доверять документации, которую сгенерировал кодовый агент?
- Руководство SaaS от ИИ — для владельца Читать код не нужно. Нужно знать, на какие вопросы ответы другие, когда систему написали быстрее, чем её кто-либо прочитал, — таких вопросов девять. Что нетехническому основателю знать о продукте, построенном с ИИ?
Владеть программой, которую вы не писали
Для владельца, который не читает код, и для технического руководителя, пришедшего в систему, построенную кем-то другим.
- Руководство Что стоит знать основателю Не то, как она работает. Двенадцать вещей, которые вы должны уметь установить о системе, которой владеете, почему каждая важна коммерчески и как получить каждую, не читая кода. Что основателю на самом деле стоит знать о собственной программе?
- Руководство Вопросы техническому директору Двадцать четыре вопроса, сгруппированных по тому, как часто их задавать, и описание того, как звучит хороший ответ, — потому что форму ответа можно оценить, не понимая его содержания. О чём спрашивать технического директора и как читать ответы?
- Руководство Разобраться в своём SaaS Четырёхнедельная последовательность для владельца: опись, зависимости, данные и подсчёт концентрации, — и ничто из этого не требует ни чтения кода, ни большого проекта. Как получить картину собственного SaaS-продукта?
- Руководство Первые 30 дней нового CTO Один результат: описание системы, которое не зависит от того, как её опишет один конкретный человек. По неделям — что установить, о чём спросить и о чём не объявлять. Что новому техническому директору сделать в первые тридцать дней?
- Руководство О чём просить команду Что запрашивать, что вместо запроса вывести самому и какую передачу новому техническому руководителю должны устроить, но почти никогда не устраивают. О чём новому техническому руководителю просить существующую команду?
Как они написаны
- Вопрос в заголовке и ответ в первых трёх предложениях. Если этого хватило, дальше можно не читать.
- Все примеры вымышлены и помечены как вымышленные. У 1ADK пока нет клиентов, поэтому нет и кейсов, и не будет, пока не появится, о ком писать, — с именем и с разрешения.
- Каждое руководство говорит, чего оно не покрывает. Страница без раздела об ограничениях написана, чтобы продать, а не чтобы быть правой.
- Дата и автор. Техническое утверждение без того и другого — утверждение, которое никто не может взвесить.
- Ничто не спрятано за почтой. Ни чек-листы, ни шаблоны, ни инструменты.