agentleFS
sergvsssergvss/agents-best-teams/skills/implementation-path/SKILL.md

implementation-path

Skill2 starsChanged 16 days agoMITView on GitHub

Use when asked to add, implement, fix or change functionality across several files or a contract (an API endpoint, a database schema, UI behaviour, docs and tests together), especially when the result has to be tested and verified - before writing the first line of code. Not for a one-line edit or a question.

The file

Files
SKILL.md

Путь от задачи до коммита

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

  1. Понять — прочитать существующий код прежде, чем писать новый. Найти, как похожая задача решена рядом.
  2. Спланировать — короткий план по пунктам, у каждого пункта проверка. Правка крупнее пары строк на основной ветке — сначала ветка для задачи, скилл start-branch.
  3. Реализовать — минимум кода, решающий задачу. Только то, что напрямую следует из запроса.
  4. Проверить — тесты, а не «выглядит правильно». Каждое «готово» в отчёте — с выводом команды, запущенной после последней правки: «тесты проходят» — число тестов и 0 провалов, «баг исправлен» — тест красный до и зелёный после, «роль сделала» — git diff и её вывод, а не её слова. Баг и новая логика — скилл test-first: тест краснеет до кода. Причина бага неясна — скилл debug-root-cause до исправления.
  5. Отревьюить — свежим взглядом или отдельной ролью. Своя правка всегда кажется понятной. Ведёшь задачу сам, без оркестратора, — шаг всё равно твой: вызови code-reviewer, где его требует Tier — на Tier 2 при security, RBAC, API-контракте и миграциях — и тогда плюс одна внешняя модель (SIDE-A), на Tier 3 всегда — и две внешние модели, если они настроены; не настроены — так и напиши в отчёте. Если в проекте включён шлюз ревью, коммит кода без его одобрения откроет человеку окно.
  6. Зафиксировать — только если попросили. Коммит не входит в «довести до готовности»: запись в историю репозитория делается по просьбе пользователя, а не по факту того, что тесты позеленели. Попросили — сообщение описывает зачем, а не что. Работа шла в ветке — дальше скилл finish-branch: влить её решает пользователь.

На каждом шаге действует правило хирургических правок: каждая изменённая строка должна прямо следовать из запроса. Не «улучшай» соседний код заодно.

Полный текст с критериями перехода между шагами и разбором того, где чаще всего срезают углы: ${CLAUDE_PLUGIN_ROOT}/checklists/implementation-path.md

Если методология установлена копированием — файл лежит в checklists/implementation-path.md репозитория.

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.