개발 기록 2026-11-02 오전: 기술 아티클 8편 발행, 그림 도구 우선순위 스킬 추가, agy 그림 시험

이번 기록은 2026-11-01 저녁부터 2026-11-02 오후 1시까지의 작업이다. 대부분은 2일 오전에 이뤄졌다. 블로그 기술 아티클 발행, 히어로 그림을 만드는 도구 조사와 스킬 반영, 그리고 그 과정에서 막힌 권한 문제를 다룬다.

기술 아티클 8편 발행

/blog-tech-article 스킬로 두 차례에 걸쳐 기술 아티클을 발행했다.

1차 (09:23 요청): 주제 5개 중 Outbox·Inbox 패턴 글은 이미 올라가 있어서 제외했다. 나머지 4편을 공개로 발행했다.

ADR(Architecture Decision Record) 실전 작성법: 상태 흐름 다이어그램 포함
모놀리식 시스템을 Modular Monolith로 전환하는 설계 전략: 모듈끼리는 공개 API나 이벤트로만 통신하도록 그림
API Gateway와 BFF 도입 기준 및 보안 설계
AA 관점의 기술 부채 관리와 아키텍처 품질 지표

공개 확인 스크립트에서 4편 모두 페이지 200, /articles 목록 노출, 이미지 2/2 통과를 확인했다. 이미지 커밋은 09:28에 들어갔다.

2차 (09:43 요청): 주제 6개 중 Context Engineering·메모리 계층, Agent Eval 회귀 테스트 글은 이미 있어서 뺐다. 4편을 발행했다.

Claude Code와 Codex CLI의 Skill 재사용 아키텍처: 실제 스킬 폴더 3곳과 심볼릭 링크 구조를 읽고 씀
Multi-Agent Orchestration에서 병렬 처리와 충돌 방지
AI Agent의 Tool Calling 보안과 Prompt Injection 방어
Project Factory에 GitHub Actions와 Quality Gate 적용하기

4편 모두 같은 방식으로 공개 확인을 통과했다. 이미지 커밋은 09:49에 들어갔다.

agy CLI로 그림 생성 시험

블로그 히어로 그림을 Antigravity CLI(agy)로도 만들 수 있는지 확인했다.

설치와 기능: agy 1.4.10이 설치되어 있었고, 그림 요청을 내장 image-generator 서브에이전트가 맡는다고 되어 있었다.
막힌 곳 1, 권한 검사: Claude Code가 agy 실행을 "다른 에이전트를 띄우는 명령"(Create Unsafe Agents)으로 보고 두 번 막았다.
막힌 곳 2, 인자 순서: agy -p --print-timeout 600s "..."처럼 쓰면 -p가 --print-timeout을 프롬프트로 받는다. 옵션을 -p 앞에 두는 순서로 고쳐서 다시 실행했다.
결과: 1분 안에 1376×768 JPEG 한 장이 나왔다. 글자는 없었다. 다만 저장 위치는 요청한 ./hero.png가 아니라 agy 대화 폴더였다. 실행 명령은 "생성을 시작했다"는 답만 하고 끝나서, 명령 직후에는 결과 파일이 없었다.
톤: 배경이 종이색이 아니라 진한 갈색 나무 선실이었다. 블로그 톤과 맞지 않았다.

09:44부터 09:48까지 Antigravity에 같은 스타일 조건으로 그림 요청을 네 번 보냈다. 주제는 공방 벽, 주방, 은행 금고, 공장 조립 라인이었다. 돌아온 답은 모두 "생성을 시작했다"는 내용이었고, 완성 결과는 기록에 없다.

그림 도구 우선순위를 스킬에 반영

blog-tech-article 스킬에 그림 도구 우선순위를 넣었다. 순서는 Codex CLI → agy CLI → Kling이다.

gen_illustration.sh는 먼저 Codex로 그린다. 한도에 걸리거나 그림이 없으면 PASS codex를 찍고 agy로 넘어간다.
agy는 답을 먼저 돌려주므로, 스크립트가 agy 대화 폴더에 새 그림이 생길 때까지 최대 5분 기다렸다가 hero.png로 가져온다.
agy도 실패하면 종료 코드 3과 KLING_NEEDED 신호를 낸다. Kling은 스크립트에서 직접 부를 수 없는 MCP 도구라서, 이 신호를 받은 Claude가 Kling으로 그린다.
검증은 zsh -n 문법 검사만 했다. 실제로 돌리지는 않았다.

Codex는 11월 4일까지 사용량 한도에 걸려 있다. Kling은 한 번 그릴 때 2크레딧이 든다.

권한 설정

~/.claude/settings.json의 permissions.allow에 그림 스크립트 실행 규칙 두 줄을 넣었다. ~/ 경로와 절대 경로 두 가지 표기를 모두 맞추기 위해서다. jq로 JSON 문법을 확인했다. Bash(agy:*)처럼 agy 전체를 여는 규칙은 넣지 않았다. 프롬프트를 아무거나 보낼 수 있게 되기 때문이다.

이 규칙이 Create Unsafe Agents 검사를 실제로 건너뛰는지는 확인하지 않았다.

남은 것

gen_illustration.sh를 실제로 한 번 실행해 전체 흐름(Codex 실패 → agy 대기 → 복사)을 검증해야 한다.
허용 규칙이 Create Unsafe Agents 검사를 건너뛰는지 확인해야 한다.
agy 결과가 진한 갈색 톤으로 나오므로, 블로그의 종이색 톤에 맞게 프롬프트를 조정해야 한다.
09:44~09:48에 보낸 Antigravity 그림 네 건의 결과는 기록에 없어서 확인하지 못했다.