Практычныя прытамулі: Як усталяць справжню систему Claude Code з калькамі: два керавання, 9
Практычныя прыказкі: Как функцыонуе рэальная настаўка Claude з колькама агентамі: два лідэры, 9 пунктав — кантракты, перакальбаванні і слоты для коду для команд, якія викорыстоўваюць гэты патэрн.
Існавайце гэта як перапрацоўаны варыянт ідэй з статті «Усередзіне рэальнай наладкі Claude з колька агентаў: два керавання, 9 проектаў, 40 запитоў на дзень» для працавіка-оператара: чыстыя этапы, арганізаваныя блакіткі коду і прыметкі з восстанавлення, якія застаюцца пасля перадачы. Этап «Апглэйв» найкраща працюе, калі яго спрыямаць як вимерную плошчу. Запісайце адна ідеальная транскрыпцыю, адзін прыклад неудачы і прыметку з вярненням да пачатковага стану, перш чым расширваць масштабы. Запісвайце час выканання і вартасць токеноў або запытаў разам з функцыйнальнымі рэзултатамі. Відразувая вартасці запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спакульнаныя сераўысы.
Форма рэшэння
Для выклікання формы сцэны неабяжна пазначыць вхідныя даны, адпаведальнага за крок і критэрыі завершэння пры перадзяве коду. Аперацыйныя працавнікі должны магчымасць перзапуск кроку з вядомай точкі контролю, не прабуючы спадарацца прыватны стан. Конфігурацыю трэба залічыць пазначальна ад коду прыемлена. Файлы сераўіса, хранальнікі секрэтных данных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое працавнікі можуць пераглядаць, не чытаючы весь ланцуг задач. Калі наступны крок — це код або вызов інструмента, лепш выкарыстоўваць структураваныя выходны даны з перакананнем схэмы, чым вольнае пісьменне выказванне.
+---------------------------------+------------------+
| Who I talk to | Share of my time |
+---------------------------------+------------------+
| The two lead agents | ~60% |
| Project tech leads / PMs directly | ~35% |
| Anything below tech lead level | ~5% (escalations) |
+---------------------------------+------------------+
Што зараз дазволяе гэта здарыцца
Кабы з’ясаваць, што робіць гэты механічны этап, перш чым зменяць код, неабходна адзначыць вхідныя даны, адпаведальнага за этап і крэтары завершэння. Аператары должны магчымаць перзапуск этапа з вядомай точкі контролю, не падозрюючы прыхованага стану. Неабходна адзначыць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не яго пазнейшай дапрацоўкі. Калі наступны этап — це код або вызов інструмента, лепш выкарыстоўваць структураваныя выходныя даны з перакананнем ў схеме, чым вольныя тэкстовыя апісанні.
Формы неудач, якія трэба перажыць
Для спосабаў неудачы на гэтым этапе неабходна праканалізаваць вхідныя даны, адпаведальнага за крок і крэтарыі выходу пры змяне коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы прыхованы стан. Валідзіце кароткія, тэставаныя елементы замест большых скрыптаў. Калі крок не выканаецца, прычына неудачы павінна вказываць на аднойчыную адпаведальнасць, а не на заплутаную ланцюговую структуру. Калі наступны крок — це код або вызов інструмента, валідзіце структураваныя выходны даны з парадаксамі, а не вольнай формы тэкст. Для спосабаў неудачы на гэтым этапе неабходна праканалізаваць вхідныя даны, адпаведальнага за крок і крэтарыі выходу пры змяне коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісвайце час выконання і кост токеноў або запытаў разам з функцыйнальнымі рэзультатамі. Відразлівасць костаў з самага пачатку запобегае неспакойным рахункам, калі процес пераходзіць з дэмавай версіі ў спяльныя сераўы.
Што насправды красты, якщо вы не ведаеце 9 проектаў
Калі працуеце над этапам «Што насправды красты», спачатку запісайце контракт: неабяжлівыя данні, сигнал успеху і тое, што выходзіць на частым неудачам. Такі список дапамагае заліцварыць пазнейшыя змены ў кодзе. Зберагаюце настройкі праза код аплікацыі. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куда аператары можуць аудытаваць іх, не чытаючы весь структураны код. Кэшаваце стабільныя інструкцыі системы і схемы інструментаў. Перадача ідэнтычных прамулкіў — частая прычына витрачання ресурсаў.
Мінімальны скелет, які можна проста скопіраваць
Калі працуеце над мінімальным каркасам, спачатку запішыце умовы працы: неабяжлівыя даны, сигнал успеху і тое, што выканаецца у разе частковага невыпання. Такі список контроля дапамагае заліцварыць пазнейшыя змены ў кодзе. Дакументавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є часткай продукту, а не элементамі пазнейшага дапрацоўвання. Зберагайце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Перадача таго ж прамэрая ёсць частым выклікам зношвання ресурсаў.
---
name: tech-lead
description: Owns decomposition and review for one project. Forks IC agents for individual tasks, reviews their diffs, escalates only genuine blockers.
tools: Read, Grep, Glob, Bash, Edit, Agent
---
You are the tech lead for this project. You do not write most of the code
yourself. When a task arrives:
1. Break it into the smallest pieces that can be verified independently.
2. For each piece, spawn a fork subagent scoped to exactly one piece:
subagent_type: "fork", with a prompt naming the specific files or
directory it may touch and nothing else.
3. Review every diff before it is considered done. Reject anything that
touches files outside the scope you gave it.
4. Only message the lead session (via SendMessage / @-mention) if you are
blocked on a decision you cannot make with the context you have, or if
two of your own IC agents produced conflicting changes.
Never let two IC agents work on overlapping files in the same task cycle.
---
name: ic-migration
description: Handles only database migration scripts under db/migrations/. Never touches application code.
tools: Read, Edit, Bash
---
You only read and write files under db/migrations/. If a task requires
changing anything outside that directory, stop and report back to whoever
assigned you the task instead of making the change yourself.
Write one migration per task. Run it against the local test database
before reporting done. Include the rollback in the same file.
# coordinator.py
# pip install anthropic --break-system-packages
# A local, file-backed mailbox so "agents" (just API calls) can hand
# work to each other without any hosted message broker.
import sqlite3
import json
import time
from anthropic import Anthropic
DB = "mailbox.db"
client = Anthropic() # reads ANTHROPIC_API_KEY from env
def init_db():
conn = sqlite3.connect(DB)
conn.execute("""
CREATE TABLE IF NOT EXISTS messages (
id INTEGER PRIMARY KEY AUTOINCREMENT,
to_agent TEXT,
from_agent TEXT,
body TEXT,
status TEXT DEFAULT 'pending',
created_at REAL
)
""")
conn.commit()
conn.close()
def send(to_agent, from_agent, body):
conn = sqlite3.connect(DB)
conn.execute(
"INSERT INTO messages (to_agent, from_agent, body, created_at) VALUES (?, ?, ?, ?)",
(to_agent, from_agent, body, time.time()),
)
conn.commit()
conn.close()
def next_message(to_agent):
conn = sqlite3.connect(DB)
row = conn.execute(
"SELECT id, from_agent, body FROM messages WHERE to_agent=? AND status='pending' ORDER BY id LIMIT 1",
(to_agent,),
).fetchone()
if row:
conn.execute("UPDATE messages SET status='taken' WHERE id=?", (row[0],))
conn.commit()
conn.close()
return row
def run_ic(scope_dir, ticket_body):
"""One scoped worker call. No memory between calls by design here,
since we're not using Claude Code's native forking in this path."""
response = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=2048,
system=f"You may only reason about files under {scope_dir}. "
f"If the ticket requires anything outside that scope, "
f"say so and stop.",
messages=[{"role": "user", "content": ticket_body}],
)
return response.content[0].text
if __name__ == "__main__":
init_db()
send(to_agent="ic-migration", from_agent="tech-lead", body="Add index on users.email")
msg = next_message("ic-migration")
if msg:
_, sender, body = msg
result = run_ic("db/migrations/", body)
send(to_agent=sender, from_agent="ic-migration", body=result)
print(result)
Дзе вы знаходзіцеся
Калі працюеце над стадзіяй «Дзе вы знаходзіцеся», спачатку запісайце умовы кантракту: неабяжлівыя даны, сигнал успеху і тое, што выканаецца у разе частковага нявыполнення. Такі список контроля дапамагае заліцьварыцца пасляэйшныя змены ў кодзе. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына нявыполнення павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Зберагаеце у кэшы стабільныя інструкцыі системы і схемы інструментаў. Павторны адправкі ідэнтычных даных — частая прычына зайвых витрацоў. Калі працюеце над стадзіяй «Дзе вы знаходзіцеся», спачатку запісайце умовы кантракту: неабяжлівыя даны, сигнал успеху і тое, што выканаецца у разе частковага нявыполнення. Такі список контроля дапамагае заліцьварыцца пасляэйшныя змены ў кодзе. Запісвайце час выканання і вартасць токенаў або запытак праза функцыйнае рэзультат. Відкрытая інформацыя пра вартасці з’являецца рана і запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя среды.
Чэрніцкі списак для эксплуатацыі
Калі працюеце над стадзіяй аператывнага чэк-лісту, спачатку запісайце контракт: неабяжлівыя данні, сігнал успеху і тое, што выходзіць у случае частковага нявыпання. Такі чэк-ліст дапамагае заставіць пазнейшыя змены коду быць чыстымі.
Спрыяйце гэтай стадзіі як контракту межа даннімі і перакананымі выходамі. Дайце назвы элементам, задаце правілы пераканання успеху і адмовіцеся ад мовчазнага частковага завершэння.
Зберагачвайце стабільныя інструкцыі системы і схемы інструментаў. Перадзесланне ідэнтычных прамаўляючых частак — частая прычына проблем.
Зберагачвайце стан графа ў простам і типаваным формате. Вярнутыя блокі маскуюць, який вузел запісаў канкрэтны поле, і спакойваюць працу пасля перарываў.
Калі бюджет дазволяе, дадзіце тэст, які перабірае критычны шлях у CI з фіксатрамі, а не з рэальнымі платнымі API.
Документавайце як шлях успеху, так і шлях вяснавання разам. Перапрыбуткі, людзкія контралі і обработка неканальных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам.
Перш чым запускать стак, заморозьце версіі, зафіксавце «золаты» транскрыпты для критычнага шляху і паказайце способы абяроны. У спільных средах неабходны ліміты частоты запуска, пераконтроль кожнага корыстувача і чысткі власнік для змены секрэтных даных. Лепшая ўзаемна надзея, чым крэатывныя деманстрацыі разова.
Прыметка для 77fe16868297: не кладзіце ключы прадаўцаў у репазітарый, задаце максімальную кантитатыву токенаў на сесію і храніце транскрыпты празаўсёды з фіксатрамі eval, каб пазнейшыя замены модэляў заставаліся парабелнымі.
Для прыметкі па забезпечэнню безпекі на стадыі 0 абмовіцеся вхіднымі дадзеннямі, власнікам крока і крэтэрыям завершэння прычынам змены коду. Аперацыйныя системы павінны магчымае перзапуск крока з вядомай точкі контролю, не падозрэўваючы схованы стан. Спрыяйце цій стадыі як кантракту межа вхіднымі дадзеннямі і перакананымі выходнымі рэзультатамі. Даце назвы артыфактам, абмовіцеся перакананнямі пра успех і адмовіцеся ад тыхоўскага частковага завершэння.
Дзеянне паўжасткі 0/744: звярніце увагу на час выканання, класы памылак і колькасць викорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай сэтце запытаў, а не на асобістых спазыраннях, выявіце, чы хацяце застаўіць змену.
Калі працюеце над першым этапам запісу паўжасткі, спачатку запішыце контракт: неабходныя вхідныя даны, сігнал успеху і тое, што выканаецца у разе частковай памылки. Такі чэрніцкі ліст дапамагае заставіць пасляэтапныя змены коду чыстымі. Зберагаеце настройкі праза код аплікацыі. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабходнасці чытання всей структуры.
Дзеянне паўжасткі 1/744: звярніце увагу на час выканання, класы памылак і колькасць викорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай сэтце запытаў, а не на асобістых спазыраннях, выявіце, чы хацяце застаўіць змену.
Этап 2 прыцеленняя на зміцнэнне работае найкраща, калі яго розглядаць як вимероўваную паверхню. Запісаце адна «золатая» транскрыпцыя, адин прыклад неудачы і запіс пра вярнэнне да пачатковага стану перш чым расширваць масштабы. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выходзіць, прычына неудачы павінна вказваць на адную адпаведальнасць, а не на заплутаны процес.
Дзеянне прыцеленняя на зміцнэнне 2/744: вимеравайце час выканання, класію памылак і колькасць викорыстоўваных токенав для гэтага дзеяння, а потым вырашайце, чы рашыцца застаўляць змяну, ставячыся да фіксаванага набора пытанняў, а не да індывідуальных спогадаў.
Для трэція ўрагу практыкы забезпечэння надзеі неабходна пазначыць вхідныя даны, адпаведальнага за выкананне крока і критэрыя завершэння пры зміне коду. Аператары должны магчыма ўвайсці крок з вядомай точкі контролю, не прабуючы спадарожваць схованы стан. Запісвайце час выканання і вартасць токена або запытку праза функцыйнальныя рэзултаты. Відразлівае паказанне вартасцей запобегае неспадзяваным рахункам, калі процес пераходзіць з дэмовай среды ў спяльнаваныя сераўеры.
Дзеянне забезпечэння надзеі 3/744: звярніце увагу на час выканання, класы каштоўкаў і витрату токена для гэтай практыкі, а потым вынікніце рашэнне пра тое, чы хацяць застаўіць зміны, адпаведна фіксаванаму набору пытанняў, а не індывідуальным спостарожэнням.
Калі працуеце над 4-й стадзіяю прыемкі з павышэння безпекі, спачатку запісайце угоду: неабяжлівыя данні, сігнал успеху і тое, што выходзіць пад частковы нявыплэн. Такі список контроля дапамагае заставіць пазнейшыя змены коду быць чыстымі.
Документавайце як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе контралі і обработка некоректных паведамленняў ёсць частью продукту, а не пазнейшым дапрацоўкам.
Дзялей 4/744 прыемкі з павышэння безпекі: вымерайце час выканання, класыя ошибакі і витрату токенав для гэтай прыемкі, а пасля выберайце, чы робіць змены на адной пазначанай сэткі пытанняў, а не на адной толькі прымітцы.
4-я стадзія прыемкі з павышэння безпекі работае лепей, калі яе спрыямаць як вымеральную паверхню. Зафіксуйце адна ідеальная транскрыпцыя, адзін прыклад нявыплэну і прымітку па вярненню да пачатковага стану, прычым расшырюючы масштабы.
Спрыяйце гэтай стадзіі як угоды межа даннімі і перакананымі выходамі. Дайце назвы артыфактам, задаць критэрыя успеху і адмовіцеся ад тыхнай частковай роботы без паведамлення.
Дзеянне паўжасткі 5/744: звярніце увагу на час выканання, класы памылак і витрату токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшацься застаўляць змяну.
Для 6-й стадзіі паўжасткі запісу перад змянай коду неабходна визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыяныя працавнікі должны магчымае перадзваначыць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Канфігурацыю трэба зберагчы за межамі коду прыемленае. Файлы сяродавішча, хранільнікі секрэтных дадзенняў і флагі функцый должны знаходзіцца ў аднам месцы, якое працавнікі можуць аудытаваць, не чытаючы весь граф.
Дзеянне паўжасткі 6/744: звярніце увагу на час выканання, класы памылак і витрату токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на індывідуальных прыкладах, выявіце, чы рэшацься застаўляць змяну.
Калі працуеце над 7-ю стадзіяй забезпечэння безпекі, спачатку запісайце умовы кантракта: неабяжлівыя данні, сігнал успеху і тое, што выходзіць на частым неудачам. Такі список контроля дапамагае залічыць пазнейшыя змены ў кодзе чыстымі. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, неудача павінна вказваць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач.
Дзялянка забезпечэння безпекі 7/744: замерайце час выканання, класію паканаў і колькасць токенаў, якія былі выкарыстоўваны для гэтай дзялянкі, а пасля выберайце, чы робіць змены на адной фіксаванай базе пытанняў, а не на адной лічбе прыкладаў.
7-я стадзія забезпечэння безпекі працуе лепей, калі яе спрыямаць як меравальную плошчу. Запісайце адны ідеальны прыклад роботы, адзін кейс неудачы і прыказку па абратанні пакульных змян, перш чым расширваць сферу дзеяння. Запісвайце часы выканання і кост токенаў або запытаў разам з функцыйнальнымі рэзултатамі. Відразувая візуабельнасць костаў запобегае неспакойным рашчыткам, калі процес пераходзіць з дэмаверсіі ў спяльныя сераўы.
Дзеянне паўжчання 8/744: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы робіць змены.
Для 9-го этапу паўжчання неабходна перад змянай коду чытко визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыйныя працавнікі должны магчымае перадзвануць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабходна адначасова задокументаваць шлях успеху і шлях вярнення. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не чымсь, што дадаецца пазней.
Дзеянне паўжчання 9/744: звярніце увагу на час выканання, клас памылакі і колькасць выкорыстоўваных токенаў для гэтага запісу, а пасля, на аднойчынай базе фіксаванага набору пытанняў, а не на асобістых спазыраннях, выявіце, чы робіць змены.
Калі працуеце над 10-ю стадзіяй ударожэння, спачатку запісайце контракт: неабяжлівыя данні, сігнал успеху і тое, што выходзіць у разе частковага неяксаменства. Такі список контроля дапамагае залічыць пазнейшыя змены коду адкрыта. Спрэцьвуйце да гэтай стадзіі як да контракту межа даннімі і перакананымі выходамі. Дайце назву артыкулам, задаце правіла пераканання успеху і адмовіцеся ад тыхоўскага частковага завершэння.
Дзеянні ўдарожэння 10/744: звярніце увагу на час выканання, класыя ошибакі і витрату токенав для гэтай змены, а пасля вырашыце, чы рашыцца застаўіць змену на адной пазначанай сэткі пытанняў, а не на адной лячбе.
11-я стадзія ўдарожэння працюе лепей, калі яе спрэцьвоўваюце як вимерную паверхню. Запісайце адны ідеальны прыклад, адзін кейс неяксаменства і прыказку па адвярнэнню перад расшырэнням масштаба. Зберагачыце настройкі за межамі коду прыемленае. Файлы сяродавішча, хранілішчы секрэтных дадзенняў і флагі функций павінны знаходзіцца ў адном месцы, якое аператары можаць пераглядаць без неабяжлівага чытання всей структуры.
Дэталі зміцнення 11/744: звярніце увагу на час выканання, клас памялкі і колькасць викорыстоўваных токенав для гэтай змянкі, а пасля выберыце, чы рашыцца застаўіць змяну, стварыўшы фіксаваны набор пытанняў, а не на базе індывідуальных прыкладаў.