Программная инженерия
Проследите функцию через UI, API, данные, задачи и конфигурацию
Сквозная трассировка одной функции связывает действие пользователя с интерфейсом, API, доменной логикой, данными, асинхронными задачами, конфигурацией и наблюдаемыми результатами.
Процесс
Делай в этом порядке.
- Назовите функцию, результат пользователя или системы, ревизию, среды, входное событие и границу между включённым и соседним поведением.
- Проследите взаимодействие от состояния и маршрута интерфейса через аутентификацию, проверку API, доменные команды, запросы и записи данных.
- Проследите события, очереди, запланированные задачи, вебхуки, вызовы третьих лиц, повторы и ветви конфигурации или feature flags до потребителей.
- Сопоставьте состояния успеха, отказа, пустого состояния, разрешения, тайм-аута, дублирования и восстановления с обратной связью пользователю, журналами, метриками, трассировками и аудитом.
- Проверьте каждый переход исходным кодом, тестами, схемами или авторизованными данными выполнения, отмечая неизвестные связи вместо превращения правдоподобного пути в факт.
- Выявите контракты, версионирование, владение, изоляцию и границы отказа, которые могут сломать функцию при изменении одного слоя.
- Опубликуйте диаграмму последовательности или таблицу трассировки с расположением в исходном коде, уверенностью доказательств, пропущенными связями, следующими проверками и нерешёнными рисками.
Принеси это
Входы, которые кот спросит.
- определение функции и результат пользователя
- ревизия репозитория и среды
- границы интерфейса, API, данных и задач
- необходимые доказательства и владелец
Роутер + один playbook
Сначала маршрут. Выбери один.
Cat Paw открывает один playbook на задачу, не смешивает несколько. Начни с этого роутера; остальные пути — кандидаты именно этого workflow.
- Роутер:
code-graph-pack skills/code-graph-pack/cross-layer-feature-trace/SKILL.md
Границы
Границы едут вместе с промптом.
- Перед началом проверьте реальные инструменты, учётные записи, разрешения и рабочую область; никогда не утверждайте, что недоступный инструмент, учётная запись, источник или возможность существует.
- Используйте Latch/target-workspace для приватного кода, артефактов, живых проверок или непубличных данных; если доступ недоступен, остановитесь на границе и сообщите о блокировке, не подменяя её догадкой.
- Приостановите работу для явного одобрения перед внешними действиями с последствиями; верните доказательства, нерешённые риски, допущения и любое действие, ожидающее одобрения.
Готово значит
Проверяемый финиш.
Трассировка функции между слоями связывает действие пользователя с интерфейсом, API, доменом, данными, задачами, конфигурацией и наблюдаемостью, приводя доказательства исходного кода и явные пробелы.
Источники
Откуда взялся этот процесс.
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- c4model.com/
- github.com/open-telemetry/semantic-conventions-genai
Источники задают рисунок workflow. Посты Reddit и сообщества, если они есть, — байки практиков, не универсальные факты.
