rornic/zweig: 스테판 츠바이크의 초안 작성 과정을 모방한 글쓰기 도구

"내가 마스터한 예술이 있다면, 그것은 생략하는 기술이다."
<br><sub >스테판 츠바이크(Stefan Zweig), <i >어제의 세계</i></sub>

Release

Claude Code

Codex

License: MIT

</div>

당신의 에이전트는 너무 많은 글을 씁니다. Zweig는 모든 천 페이지 중 여덟 백 페이지를 버린 소설가처럼 쓰도록 만듭니다.

스테판 츠바이크의 초안 작성 과정을 기반으로 Claude Code와 Codex를 위한 두 가지 작문 기술(writing skills)입니다. 밀도 있게 작성한 후, 강도를 높이기 위해 잘라냅니다.

전과 후 (Before and after)

EXAMPLE.md에서 가져온 zweig-refine의 실제 실행 예시입니다.

전 (Before) (105 단어)

배포 과정과 관련하여, 새로운 배포 과정은 이제 실제로 배포 단계(deploy step)를 진행하기 전에 먼저 빌드 단계(build step)를 실행해야 함을 알려드립니다. 이는 이전과는 작업 방식이 변경된 것입니다. 또한, 새로 추가된 빌드 단계는 평균적으로 약 5분이 소요될 것이며, 이 시간 동안에는 다른 작업을 하기 전에 기다려야 합니다. 왜냐하면 빌드 단계가 완료되기 전에 배포를 시도하는 것은 단순히 오류 메시지를 표시할 뿐이기 때문입니다.

후 (After) (25 단어)

이제 배포하려면 배포 단계 전에 빌드 단계(~5분)가 필요합니다. 빌드가 완료될 때까지는 오류로 인해 배포 단계가 차단됩니다.

모든 지침이 살아남습니다. 마지막 수정 사항은 세 번의 자체 검토 과정에서 놓쳤던 모호성을 포착한 맹목적인 리뷰어로부터 나왔습니다.

기술 (The skills)

`zweig-write`

에이전트가 초안을 작성하기 전에 자동으로 로드됩니다 (문서(docs), PR 설명, 커밋 메시지, 코드 주석, Slack 메시지 등). 말머리 정리, 완곡어법, 재진술, 정형화된 전환 문구, 장식용 이모티콘은 절대로 페이지에 남기지 않습니다. 명령어, 플래그, 경고, 실패 모드는 항상 남깁니다.

`zweig-refine`

삭제(Cut). 제거 가능한 모든 단어, 구문 또는 문장이 실제 파일에 대한 실제 편집처럼 삭제됩니다.
반복(Repeat). 더 이상 수정할 부분이 없을 때까지 다시 읽고 삭제합니다 (최대 4회 반복).
신선한 독자 게이트(Fresh-reader gate). 초안을 작성하는 대화 내용에 대해서는 알지 못하는 별도의 서브 에이전트가 최종 텍스트만 읽고 혼란스럽거나 빠진 부분을 표시합니다.

이 게이트가 존재하는 이유는, 삭제를 수행했던 맥락 자체가 자신의 사각지대를 볼 수 없기 때문입니다.

zweig-write는 초안 작성이 완료되면 실행할 것을 제안하거나, 언제든지 요청할 수 있습니다 ("이것을 다듬어줘", "README를 간결하게 해줘").

설치(Install)

Claude Code

/plugin marketplace add rornic/zweig
/plugin install zweig@zweig

Codex

codex plugin marketplace add rornic/zweig
codex plugin add zweig@zweig

인용구(The quote)

이 전체 방법은 Zweig의 말에 따르면, 『어제의 세계(The World of Yesterday)』에서 가져온 것입니다.

나는 책의 첫 초안을 거의 완성하자마자, 나에게는 진정한 작업이라고 할 수 있는 재료를 응축하고 그것을 담아낼 올바른 방식을 찾는 작업을 시작한다. 나는 이렇게 초안에서 초안으로 지칠 줄 모르고 일한다. 나는 끊임없이 짐(ballast)을 버리고, 책의 내적 구조를 강화하며 명확하게 한다. 대부분의 작가들은 어떤 것도 빼지 않으려고 하고, 자신의 주제에 너무 빠져들어 자신이 실제로 가지고 있는 것보다 더 넓고 깊은 지식을 매끄럽게 다듬어진 모든 문장에 보여주기를 바란다. 반면에 나의 야망은 항상 겉으로 보이는 것보다 더 많이 아는 것이다.

나중에 교정 단계(proof stages)에 이르러서는, 이 강화하고 극적인 효과를 증진시키는 과정을 한 번, 두 번, 혹은 세 번 반복한다. 결국 나는 또 다른 문장이나 단어 하나를 찾아내는 일에서 즐거움을 느낀다. 그 단어나 문장은 나의 정확한 의미를 훼손하지 않으면서 동시에 속도감을 높일 수 있는 것이다. 나는 정말로 무언가를 빼는 것에서 가장 큰 만족을 얻는다. 한 번은 책상에서 일어나 내가 한 작업에 만족했을 때, 아내가 오늘 기분이 좋아 보인다고 말했다.

따라서 제 책들의 성공에 적어도 부분적으로 기여하는 것은 문학적이고 집중적인 짧은 작품에 스스로를 가두는 저의 엄격한 규율입니다.

라이선스

MIT