Why my code-generating agents
never write code. 코드 생성 에이전트인데,
코드를 직접 못 쓰게 했어요.

When six agents build an app, the obvious design is to let them write the Flutter code directly. I did the opposite on purpose. Raw code generation drifts between calls: the same prompt yields slightly different code each time, a one-line revision means regenerating whole files, and a "make this button blue" request can break something unrelated on the far side of the app. None of that is a prompt you can fix. It comes from treating code as the thing the agents pass around.

에이전트 6개로 앱을 만든다고 하면, 보통은 에이전트가 Flutter 코드를 직접 쓰게 해요. 저는 일부러 반대로 갔어요. 코드를 그대로 생성하면 모델을 호출할 때마다 출력이 흔들리거든요. 같은 프롬프트인데도 매번 조금씩 다른 코드가 나오고, 한 줄만 고치려는데 파일을 통째로 다시 만들고, "버튼을 파랗게 바꿔줘" 한마디가 앱 반대편의 엉뚱한 걸 건드려요. 이건 프롬프트를 잘 쓴다고 해결되는 문제가 아니에요. 에이전트가 코드라는 매체로 주고받기 때문에 생기는 일이에요.

Raw code is an output you can't diff semantically, can't validate cheaply, and can't regenerate deterministically. So rather than push the agents to write better code, I took code away from them entirely.

코드라는 출력물은 의미 단위로 비교하기도, 싸게 검증하기도, 똑같이 다시 만들어내기도 어려워요. 그래서 에이전트가 코드를 더 잘 쓰게 만드는 대신, 아예 코드를 손에서 뺐어요.

So I designed it around one rule. Agents (Clarifier, WidgetExtender, Structure, Design, Repair, Critic) only produce a typed AppState: a JSON model of screens, widgets, navigation, and state. A deterministic generator compiles that model to main.dart. Same state in, same code out, every time. A revision is a patch to the state, not a rewrite of the code.

그래서 규칙 하나를 중심에 두고 설계했어요. 에이전트(Clarifier, WidgetExtender, Structure, Design, Repair, Critic)는 타입이 정해진 AppState만 만들어요. 화면, 위젯, 내비게이션, 상태를 담은 JSON 모델이에요. 그리고 결정적 생성기가 그 모델을 main.dart로 바꿔요. 같은 상태를 넣으면 언제나 같은 코드가 나와요. 수정은 코드를 다시 쓰는 게 아니라 상태에 패치를 얹는 일이 됐어요.

Generation runs inside a closed loop. A static validator checks the state for structural errors (undeclared variables, illegal widget nesting, reserved identifiers, and so on). Failures go to a Repair agent that patches the state: two attempts max, with oscillation and wall-clock guards so it can't loop forever. If repair still fails, the system falls back to the prior valid state when one exists. A Critic then scores how faithful the result is to the original intent. In enforce mode every generation goes through this loop; off and shadow modes exist for comparison.

생성은 닫힌 루프 안에서 돌아요. 정적 검증기가 구조적 오류(선언 안 된 변수, 위젯 중첩 규칙 위반, 예약어 충돌 같은 것들)를 검사해요. 실패하면 Repair 에이전트가 상태를 고치는데, 최대 2번까지만이고, 같은 수리를 반복하거나 시간을 끌면 가드가 끊어요. 그래도 안 되면 이전에 성공한 상태가 있을 때 거기로 돌아가요. 마지막으로 Critic이 결과가 원래 의도에 얼마나 충실한지 점수를 매겨요. enforce 모드에서는 모든 생성이 이 루프를 지나가고, 비교용으로 off·shadow 모드도 있어요.

What I claim: the pipeline's shape works. All 53 automated tests pass, covering the validator's error codes, the closed-loop repair contract, and oscillation handling. Revisions stay stable because code is compiled from state, never edited. Preview runs in the browser via DartPad.

주장하는 것: 이 구조가 동작한다는 거예요. 검증기의 에러 코드, 닫힌 루프의 수리 계약, 진동 처리까지 자동 테스트 53개가 전부 통과해요. 코드는 상태에서 컴파일될 뿐 직접 수정되지 않으니까, 수정을 거듭해도 흔들리지 않아요. 미리보기는 브라우저에서 DartPad로 돌아가요.

What I don't claim: that the agents themselves are smart. The tests measure the pipeline's guarantees, not model quality. A bad generation still happens; the point of the design is that a bad generation gets caught, repaired, or rolled back instead of shipped.

주장하지 않는 것: 에이전트가 똑똑하다는 거요. 테스트가 재는 건 파이프라인의 보장이지 모델의 품질이 아니에요. 이상한 생성은 지금도 나와요. 이 설계의 핵심은 이상한 생성이 사용자에게 도착하기 전에 걸리고, 고쳐지고, 안 되면 되돌려진다는 거예요.