Skip to content

Commit 2fab3b4

Browse files
committed
2026-02-28 20:20:39
1 parent 649861d commit 2fab3b4

2 files changed

Lines changed: 41 additions & 0 deletions

File tree

eng_2026/02/2026-02-28-17-53.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
**Separating Planning and Execution**
2+
[https://boristane.com/blog/how-i-use-claude-code/](https://www.google.com/url?sa=E&q=https%3A%2F%2Fboristane.com%2Fblog%2Fhow-i-use-claude-code%2F)
3+
The author shares a structured methodology that divides the process into stages so that Claude doesn't write code "blindly" but instead works according to an approved plan. Research and planning are always conducted first, and only then comes the implementation. This prevents mistakes, maintains control over the architecture, and minimizes token usage.
4+
5+
Workflow Stages
6+
1. **Research Phase:** We use words like "deeply" and "in detail" in prompts to review what already exists — the agent documents this in a `research.md` file.
7+
2. **Planning Phase:** We create a detailed plan in a `plan.md` file describing the approach, code snippets, file paths, and trade-offs.
8+
3. **Annotation Cycle:** We open the editor and add notes directly into the plan (e.g., "use PATCH, not PUT"), then tell the agent: "I added a few notes to the document, address all the notes and update the document accordingly. don’t implement yet". This is done iteratively several times.
9+
4. **Todo List:** When everything looks good, the agent converts the plan into a detailed checklist of tasks. We continuously remove unnecessary items from the plan to avoid scope creep.
10+
5. **Implementation Phase:** After the plan is approved, a standard prompt is used: "implement it all," with instructions to mark completed tasks, check types, and avoid unnecessary comments: "implement it all. when you’re done with a task or phase, mark it as completed in the plan document. do not stop until all tasks and phases are completed. do not add unnecessary comments or jsdocs, do not use any or unknown types. continuously run typecheck to make sure you’re not introducing new issues."
11+
12+
Practical Tips: Provide the agent with links to open-source projects that contain examples of similar code. Refer back to the plan when something goes wrong.
13+
14+
Discussion
15+
[https://news.ycombinator.com/item?id=47106686](https://www.google.com/url?sa=E&q=https%3A%2F%2Fnews.ycombinator.com%2Fitem%3Fid%3D47106686)
16+
Many users agree with the principle of **separating** planning and execution, considering it an effective way to reduce errors. Using detailed plans in .md files provides a clear track record of decisions and reasoning. Plans help identify the model's biases, making the process more transparent.
17+
18+
Critics call this method of programming "garbage" or a "gamble," arguing that it leads to both "brain atrophy" due to AI dependency and poor code quality.
19+
20+
#claudecode #prompts

ukr_2026/02/2026-02-28-19-53.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
**Розділення планування й виконання**
2+
https://boristane.com/blog/how-i-use-claude-code/
3+
Автор ділиться структурованою методологією, яка розділяє процес на етапи, щоб Claude не писав код "наосліп", а працював за затвердженим планом. Завжди спочатку проводиться дослідження та планування, а лише потім — реалізація. Це запобігає помилкам, зберігає контроль над архітектурою та мінімізує витрати токенів (одиниць обчислення в ШІ).
4+
5+
Етапи робочого процесу
6+
1. **Дослідження (Research Phase):** Використовуємо слова на кшталт "глибоко", "детально" в промптах щоб перевірити що вже є - це агент документує в файлі `research.md`.
7+
2. **Планування (Planning Phase):** Створюємо детальний план у файлі `plan.md` з описом підходу, сніпетами коду, шляхами файлів та компромісами.
8+
3. **Цикл анотацій (Annotation Cycle):** Відкриваємо редактор - додаємо нотатки безпосередньо в план (наприклад, "використовуй PATCH, а не PUT"), далі агенту "I added a few notes to the document, address all the notes and update the document accordingly. don’t implement yet". Це робимо ітеративно декілька разів.
9+
4. **Список завдань (Todo List):** Коли все ок агент перетворює план у детальний чек-лист завдань. Постійно видаляйте непотрібне з плану, щоб уникнути розростання проєкту.
10+
5. **Реалізація (Implementation Phase):** Після затвердження плану використовується стандартний промпт: "реалізуй все", з маркуванням завершених завдань, перевіркою типів і уникненням зайвих коментарів: "implement it all. when you’re done with a task or phase, mark it as completed in the plan document. do not stop until all tasks and phases are completed. do not add unnecessary comments or jsdocs, do not use any or unknown types. continuously run typecheck to make sure you’re not introducing new issues."
11+
12+
Практичні поради: Надавайте агенту посилання на відкриті проєкти де є приклади схожого коду. Посилайтесь на план коли щось іде не так.
13+
14+
Обговорення
15+
https://news.ycombinator.com/item?id=47106686
16+
Багато користувачів погоджуються з принципом **розділення** планування та виконання, вважаючи це ефективним для зменшення помилок. Використання детальних планів у файлах .md забезпечують чіткий трек рішень і причин. Плани допомагають виявити упередження моделі, роблячи процес прозорішим.
17+
18+
Критики називають такий метод програмування "сміттям" або "азартною грою", стверджуючи, що він призводить як до "атрофії мозку" залежності від ШІ, так й до низької якість коду.
19+
20+
21+
#claudecode #prompts

0 commit comments

Comments
 (0)