Исследования
Постройте карту вопросов по кодовой базе с привязкой к доказательствам
Карта вопросов и доказательств для исследования кодовой базы связывает каждый вопрос с проверенными файлами, символами, тестами, артефактами выполнения, уверенностью и следующей различающей проверкой.
Процесс
Делай в этом порядке.
- Определите набор вопросов, контекст решения, ревизию репозитория, границы области, стандарт доказательств и нужный ответ для каждого вопроса.
- Направьте каждый вопрос к самому маленькому релевантному источнику доказательств: исходному коду, истории, тестам, схемам, конфигурации, артефактам выполнения или ответственному владельцу.
- Проверяйте только доказательства, необходимые для ответа или различения, записывая точные пути, символы, ревизии, команды и даты получения.
- Классифицируйте каждый ответ как подтверждённый, противоречащий, частичный или неизвестный, сохраняйте конфликтующие данные и отличайте отсутствие от отрицательного результата.
- Выявите отсутствующие инструменты, учётные записи, разрешения или непубличные источники и направьте эти потребности через Latch/target-workspace, не выдумывая доступ.
- Проектируйте следующую проверку по тому, насколько она изменит уверенность, а не по тому, насколько легко собрать больше материала.
- Опубликуйте карту вопросов с ответами, ссылками на доказательства, уверенностью, пробелами, следующими действиями и нерешёнными рисками для владельца решения.
Принеси это
Входы, которые кот спросит.
- вопросы о кодовой базе и контекст решения
- ревизия и область репозитория
- доступные доказательства и границы доступа
- порог уверенности ответа и владелец
Роутер + один playbook
Сначала маршрут. Выбери один.
Cat Paw открывает один playbook на задачу, не смешивает несколько. Начни с этого роутера; остальные пути — кандидаты именно этого workflow.
- Роутер:
codebase-knowledge-pack skills/codebase-knowledge-pack/evidence-linked-codebase-question-map/SKILL.md
Границы
Границы едут вместе с промптом.
- Перед началом проверьте реальные инструменты, учётные записи, разрешения и рабочую область; никогда не утверждайте, что недоступный инструмент, учётная запись, источник или возможность существует.
- Используйте Latch/target-workspace для приватного кода, артефактов, живых проверок или непубличных данных; если доступ недоступен, остановитесь на границе и сообщите о блокировке, не подменяя её догадкой.
- Приостановите работу для явного одобрения перед внешними действиями с последствиями; верните доказательства, нерешённые риски, допущения и любое действие, ожидающее одобрения.
Готово значит
Проверяемый финиш.
Карта вопросов с привязкой к доказательствам даёт каждому вопросу о кодовой базе статус ответа, точные подтверждающие данные, уверенность, недостающий доступ, следующую различающую проверку и нерешённые риски.
Источники
Откуда взялся этот процесс.
- github.com/Egonex-AI/Understand-Anything/tree/6df3065f1d8ddc2ce3615314d1d493f36d6b1c80/
- docs.github.com/en/rest/overview
- c4model.com/
Источники задают рисунок workflow. Посты Reddit и сообщества, если они есть, — байки практиков, не универсальные факты.