agentleFS
Sign inStart free
MADTeacherMADTeacher/skills/solution-interview/SKILL.md

solution-interview

Skill1 starsChanged 6 months agoMITView on GitHub

Провести последовательное интервью по всем аспектам проекта, функции, бага, архитектурного решения или плана, чтобы сформировать полное представление о задаче и пространстве решений. Использовать, когда агенту нужно не сразу реализовывать, а сначала глубоко разобраться: что строится, зачем, для кого, как должно работать, какие есть зависимости, ограничения, риски, альтернативы и критерии готовности.

The file

Create a free account to mount
Files
SKILL.md

Проведи со мной интервью по этому проекту, функции, багу, архитектурному решению или плану, пока у тебя не сформируется полное и согласованное понимание задачи и пространства решений.

Твоя цель — не просто уточнить отдельные детали, а последовательно пройти по всем существенным аспектам решения и не упустить важные ветви дерева решений.

Задавай вопросы по одному за раз.

Для каждого вопроса:

  1. задай сам вопрос;
  2. объясни, какой аспект решения он проясняет;
  3. дай рекомендуемый ответ, пример хорошего ответа или направление, в котором стоит думать.

Двигайся по дереву решений последовательно:

  1. выясни общий замысел и цель;
  2. контекст проекта и текущее состояние системы;
  3. пользователей, сценарии и ожидаемое поведение;
  4. данные, состояния, переходы и бизнес-правила;
  5. интерфейсы, API, интеграции и внешние зависимости;
  6. архитектуру, ограничения, компромиссы и альтернативы;
  7. ошибки, крайние случаи и деградации;
  8. безопасность, права доступа, приватность и надежность;
  9. производительность, масштабирование и эксплуатацию;
  10. миграции, совместимость и влияние на существующее поведение;
  11. тестирование, наблюдаемость и критерии готовности;
  12. риски, открытые вопросы и решения, которые нужно явно принять;
  13. технологический стек, который будет использоваться для решения (особенно, если речь идет о создании проекта с нуля).

Не ограничивайся этим списком. Если в ходе интервью появляется новая ветвь решения, исследуй ее до конца перед переходом к следующей.

Разрешай зависимости между решениями по одной: если ответ на один вопрос влияет на другие аспекты, сначала закрой эту зависимость, затем продолжай интервью.

Если на вопрос можно ответить, изучив кодовую базу, документацию, логи, тесты или уже предоставленные материалы, сначала изучи их, а не спрашивай пользователя.

Периодически кратко фиксируй текущее понимание:

  • что уже понятно;
  • какие решения приняты;
  • какие ветви дерева решений закрыты;
  • какие вопросы остаются открытыми.

Заверши интервью только тогда, когда сможешь сформулировать целостное описание:

  • что именно нужно сделать;
  • зачем это нужно;
  • как это должно работать;
  • какие сценарии покрываются;
  • какие ограничения и зависимости существуют;
  • какие альтернативы были рассмотрены;
  • какие риски остаются;
  • как проверить, что задача выполнена правильно.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free