Blockstudio으로 바이브 코딩하기
Andrej Karpathy는 2월 2025에 “바이브 코딩”이라는 용어를 만들어, 원하는 것을 AI에 설명하면 AI가 코드를 작성하는 워크플로를 가리켰습니다. 1년 후, 이 방식은 그가 이제 “에이전트 엔지니어링”이라고 부르는 단계로 발전했습니다. 개발자가 한 줄씩 코드를 작성하는 대신 AI 에이전트를 지휘하는 방식입니다.
Blockstudio은 이를 위해 만들어졌습니다. 파일 기반 아키텍처, 빌드 도구가 필요 없는 환경, 예측 가능한 프로젝트 구조 덕분에 AI 지원 WordPress 개발에 가장 적합한 환경 중 하나입니다.
이 가이드에서는 프로젝트 설정부터 전체 사이트 생성까지, Blockstudio에서 AI 코딩 에이전트를 사용하는 실용적인 패턴을 다룹니다.
Blockstudio이 AI 에이전트와 잘 맞는 이유
데이터베이스가 아닌 파일
AI 코딩 에이전트는 파일을 읽고 씁니다. 이것이 에이전트의 기본 인터페이스입니다. Blockstudio은 모든 것을 파일 시스템에 보관합니다. 각 블록마다 block.json와 템플릿 파일이 있고, 페이지마다 page.json가 있으며, 패턴마다 pattern.json가 있습니다. 관리할 데이터베이스 항목도, 클릭해서 살펴볼 관리자 UI도, 실행할 빌드 단계도 없습니다.
파일 시스템과 셸 명령은 LLM 사전 학습 데이터의 가장 큰 출처 중 하나이므로 중요합니다. 모든 모델은 파일을 읽고, 쓰고, 정리하는 사례를 수백만 건 학습했습니다. WordPress 개발 워크플로가 그 인터페이스와 일치하면 에이전트는 최소한의 지시만으로 작업할 수 있습니다.
예측 가능한 구조
모든 Blockstudio 블록은 같은 패턴을 따릅니다.
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
이러한 일관성 덕분에 블록 하나를 만든 에이전트는 블록 100개도 만들 수 있습니다. 예상치 못한 요소나 예외적인 경우, 숨겨진 설정이 없습니다. 페이지(page.json + 템플릿), 패턴(pattern.json + 템플릿), 확장 기능(extend.json)에도 같은 패턴이 적용됩니다.
파일로 된 전체 페이지
기존 WordPress 페이지 제작에는 블록 편집기가 필요합니다. 블록을 끌어다 놓고, 설정을 구성하고, 관리자에서 저장해야 합니다. AI 에이전트는 이런 작업을 할 수 없습니다. 에이전트에는 파일이 필요합니다.
Blockstudio의 파일 기반 페이지가 이 문제를 완전히 해결합니다. page.json는 페이지 메타데이터를 정의하고, index.php 템플릿은 HTML를 사용해 블록 구조를 정의합니다.
pages/about/
├── page.json # Title, slug, post type, template lock
└── index.php # Block structure as HTML
<block name="core/cover" key="hero" url="https://example.com/bg.jpg">
<h1 blockEditingMode="contentOnly">About Us</h1>
<p blockEditingMode="contentOnly">Our story.</p>
</block>
<div key="team">
<h2>The Team</h2>
<block name="my/team-member" />
<block name="my/team-member" />
</div>
에이전트는 핵심 블록, 사용자 정의 블록, 템플릿 잠금, 편집 컨트롤을 모두 갖춘 전체 WordPress 페이지를 파일 두 개만 작성해 뼈대부터 만들 수 있습니다. wp bs pages sync을 실행해 소스를 WordPress에 적용하세요. 관리자를 열어도 동기화가 자동으로 실행되지는 않습니다.
이는 AI 지원 개발에서 가장 강력한 기능 중 하나입니다. 페이지 레이아웃을 설명한 뒤 편집기에서 직접 구성하는 대신, 에이전트에 설명하면 에이전트가 템플릿을 작성합니다. 결과물은 버전 관리할 수 있고 재현 가능하며, 몇 초 만에 반복해서 수정할 수 있습니다.
빌드 단계 없음
컴파일, 번들링, 트랜스파일할 것이 없습니다. 에이전트가 파일을 만들면 바로 작동합니다. SCSS은 서버 측에서 컴파일됩니다. ES 모듈은 런타임에 확인됩니다. Tailwind CSS은 프런트엔드 요청이 있을 때마다 컴파일됩니다. “에이전트가 코드를 작성”한 뒤 “브라우저에서 코드가 실행”되기까지의 피드백 과정이 가능한 한 짧습니다.
Tailwind CSS을 선택해야 하는 이유
Blockstudio은 일반 CSS와 Tailwind CSS를 모두 지원하지만, AI 에이전트와 함께 작업할 때는 Tailwind에 큰 이점이 있습니다.
LLM은 Tailwind을 매우 잘 알고 있습니다
Tailwind CSS은 수만 개의 오픈 소스 저장소에서 사용됩니다. Claude.ai, Vercel, Shopify, Cursor, 그리고 OpenAI의 자체 제품 인터페이스를 구현하는 데 쓰입니다. 학습 데이터에 널리 포함되어 있어 LLM은 Tailwind 클래스를 높은 정확도로 생성하고, 존재하지 않는 유틸리티를 지어내는 경우가 드뭅니다.
클래스 어휘는 유한하며 명확하게 정의되어 있습니다. 에이전트는 존재하지 않는 CSS 속성을 만들어낼 수 없습니다. 이 덕분에 에이전트가 잘못된 선택자를 생성하거나 캐스케이드 동작을 오해할 수 있는 자유 형식 CSS에 비해 스타일 오류가 크게 줄어듭니다.
마크업 안에 있는 스타일
Tailwind에서는 모든 스타일 정보가 HTML 템플릿 안에 함께 있습니다. 에이전트는 한 곳에서 요소의 전체 시각적 설명을 확인할 수 있습니다. 별도의 .css 파일을 찾아보거나 캐스케이드 순서를 파악하거나 명시도 충돌을 추적할 필요가 없습니다.
템플릿이 이미 단일 파일인 Blockstudio 블록에서는 특히 유용합니다. 에이전트는 한 번에 스타일을 포함한 완전한 컴포넌트를 생성할 수 있습니다.
<div useBlockProps class="bg-white rounded-2xl shadow-lg p-8">
<h2 class="text-2xl font-bold text-gray-900">
<?php echo $a['title']; ?>
</h2>
<p class="mt-4 text-gray-600 leading-relaxed">
<?php echo $a['description']; ?>
</p>
</div>
충돌 없이 에이전트 병렬 실행
Tailwind 스타일은 각 템플릿에 범위가 한정되어 있으므로 여러 에이전트(또는 개발자)가 서로 다른 블록에서 동시에 작업해도 CSS 병합 충돌이 발생하지 않습니다. 한 컴포넌트의 변경이 다른 컴포넌트를 실수로 망가뜨릴 수 있는 공유 스타일시트가 없습니다. 각 블록은 독립적으로 구성됩니다.
이는 Blockstudio의 범위 지정 스타일(style.scoped.css)을 사용하면 일반 CSS에서도 잘 작동합니다. 하지만 Tailwind은 CSS 파일 자체를 없애므로 에이전트가 블록마다 관리할 파일이 하나 줄어듭니다.
일반 CSS도 여전히 사용 가능
Tailwind은 필수가 아닙니다. Blockstudio의 에셋 파이프라인은 범위가 블록에 한정된 스타일을 포함해 .css 및 .scss 파일을 자동으로 처리합니다. 프로젝트에서 다른 CSS 방법론을 사용하더라도 에이전트는 그대로 작업할 수 있습니다. Tailwind의 장점은 학습 데이터에 많이 포함되어 있고 스타일이 마크업과 함께 있다는 점 덕분에 LLM이 더 능숙하게 다룬다는 데 있습니다.
AI 코딩 에이전트
다음 CLI 도구는 모두 Blockstudio 프로젝트에서 별도의 설정 없이 사용할 수 있습니다. 파일을 읽고 쓰며, 셸 명령을 실행하고, 컨텍스트 파일을 바탕으로 프로젝트 구조를 파악합니다.
터미널 에이전트(CLI)
| 도구 | 제공업체 | 참고 |
|---|---|---|
| Claude Code | Anthropic | 터미널 중심 에이전트입니다. 프로젝트 컨텍스트를 위해 CLAUDE.md를 읽습니다. |
| Codex CLI | OpenAI | Rust으로 만든 오픈 소스 CLI입니다. 데스크톱 앱으로도 사용할 수 있습니다. |
| Gemini CLI | 1M 토큰 컨텍스트 윈도우를 지원하는 오픈 소스입니다. GEMINI.md를 읽습니다. |
|
| GitHub Copilot CLI | GitHub | 탐색, 작업, 계획, 검토를 위한 전문 병렬 에이전트입니다. |
| Aider | 오픈 소스 | 로컬 모델을 포함해 100개 이상의 LLM 제공업체를 지원합니다. |
| OpenCode | 오픈 소스 | LSP 통합을 지원하는 터미널 TUI입니다. 75개 이상의 제공업체를 지원합니다. |
| Amazon Q Developer CLI | AWS | 무료 요금제를 사용할 수 있습니다. AWS 통합 프로젝트에 적합합니다. |
IDE 에이전트
| 도구 | 제공업체 | 참고 |
|---|---|---|
| Cursor | Cursor | AI가 내장된 VS Code 포크입니다. CLI도 있습니다(베타). |
| Windsurf | Cognition AI | Cascade 에이전트형 어시스턴트가 포함된 VS Code 포크입니다. |
| Cline | 오픈 소스 | 단계별 승인을 지원하는 VS Code 확장 프로그램입니다. CLI도 있습니다. |
| Kilo Code | 오픈 소스 | 하위 에이전트를 조율하는 오케스트레이터 모드입니다. |
| Continue | 오픈 소스 | 비동기 CI/CD 에이전트를 지원하는 VS Code/JetBrains 확장 프로그램입니다. |
| Augment Code | Augment | 기업용에 초점을 두고 코드베이스를 심층적으로 인덱싱합니다. |
이 도구들은 모두 Blockstudio 프로젝트 디렉터리에서 파일을 만들고 수정할 수 있습니다. Blockstudio 개발에는 IDE 전용 기능이 필요하지 않고 전적으로 파일 기반이므로 터미널 에이전트가 특히 잘 맞습니다.
AI 에이전트를 위한 프로젝트 설정
LLM 컨텍스트 파일
Blockstudio에는 프레임워크 문서 전체를 색인하는 사전 구축 컨텍스트 파일이 포함되어 있습니다. 요약이나 치트 시트가 아닙니다. 모든 문서의 경로, 목적, 해당 문서가 담당하는 식별자가 한 번씩 목록에 있어 에이전트는 질문에 답하는 페이지를 찾아 그 페이지만 열 수 있습니다. 모든 문서와 스키마의 전문은 전체 자료를 한 번에 원하는 도구를 위해 두 번째 파일에 제공됩니다.
blockstudio.json에서 활성화하세요.
{
"ai": {
"enableContextGeneration": true
}
}
이제 색인은 your-site.com/blockstudio-llm.txt에, 전문은 your-site.com/blockstudio-llm-full.txt에 제공됩니다. AI 도구가 색인을 참조하도록 설정하면 별도의 지시 없이 전체 Blockstudio API에 접근할 수 있습니다. 도구별 설정은 AI 통합 문서를 참조하세요.
이렇게 하면 프레임워크별 지침을 직접 작성할 필요가 없습니다. blockstudio-llm.txt에 접근할 수 있는 에이전트는 블록 생성, 필드 정의, 템플릿 작성, Tailwind 구성, 페이지 설정 방법과 Blockstudio에서 제공하는 모든 후크의 사용법을 찾을 수 있습니다.
프로젝트별 컨텍스트 파일
대부분의 AI 코딩 에이전트는 코드베이스에 맞는 지침을 담은 프로젝트 수준의 컨텍스트 파일도 읽습니다. 파일 이름은 도구마다 다릅니다.
| 파일 | 도구 |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI 등 |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
blockstudio-llm.txt에 프레임워크 정보가 이미 있으므로 프로젝트 컨텍스트 파일에는 디렉터리 구성, 명명 규칙, 명령, 작업 범위 등 프로젝트 고유의 내용만 설명하면 됩니다.
blockstudio/phpstan을 설치하면 이 설명을 직접 작성할 필요가 없습니다. vendor/bin/blockstudio-agents은 blockstudio.json와 프로젝트 파일을 바탕으로 AGENTS.md을 생성합니다. 여기에는 프로젝트에서 작성한 항목, 활성화된 기능, 분석 과정에서 거부될 항목, 적용 가능한 명령이 포함됩니다. 직접 작성하지 않은 파일은 덮어쓰지 않으며, 다시 생성할 때도 사용자가 작성한 메모를 보존합니다.
# My WordPress Site
Built with Blockstudio 7. File-based blocks with Tailwind CSS.
Fetch https://example.com/blockstudio-llm.txt for full framework docs.
## Structure
- `blockstudio/` - Custom blocks (block.json + index.php)
- `pages/` - File-based pages (page.json + index.php)
- `patterns/` - Block patterns (pattern.json + index.php)
- `blockstudio.json` - Plugin settings
## Conventions
- Use Tailwind utility classes for all styling
- Keep blocks small and focused: one component per block
- Use `$a['fieldId']` to access field values in templates
## Commands
- `wp server` - Start local development server
AI 워크플로를 위한 개발자 도구
Blockstudio에는 AI 지원 개발을 위해 특별히 설계된 개발자 도구 두 가지가 포함되어 있습니다.
캔버스
캔버스는 모든 Blockstudio 페이지를 Figma처럼 한눈에 보여주는 화면입니다. 실시간 iframe 아트보드가 단일 화면에 표시됩니다. 트랙패드로 이동하고, 핀치 또는 Ctrl+스크롤로 확대·축소하세요.
탭을 전환하거나 WordPress 관리자 화면을 탐색하지 않고도 모든 페이지를 시각적으로 살펴볼 수 있어 AI 에이전트 작업에 유용합니다. 에이전트가 페이지 템플릿을 수정하면 결과를 바로 확인할 수 있습니다. 실시간 모드를 켜면 파일이 바뀔 때 캔버스가 자동으로 새로고침됩니다.
blockstudio.json에서 활성화하세요.
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
그런 다음 /wp-admin/admin.php?page=blockstudio-canvas으로 이동하세요. 페이지 보기(전체 너비 아트보드)와 블록 보기(등록된 모든 블록과 기본값을 보여주는 그리드) 사이를 전환할 수 있습니다.
요소 선택기
요소 선택기는 AI 워크플로에서 흔히 발생하는 문제, 즉 페이지의 특정 요소를 렌더링하는 파일을 에이전트에 알려주는 문제를 해결합니다.
프런트엔드 URL에 ?blockstudio-devtools을 추가한 다음 Cmd+C(Mac) 또는 Ctrl+C(Windows)를 100ms 동안 누르세요. 십자선 선택기가 활성화되고 마우스를 올리면 Blockstudio 블록이 강조 표시됩니다. 요소를 클릭하면 해당 컨텍스트가 클립보드에 복사됩니다.
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
이 내용을 AI 코딩 도구에 붙여넣으면 에이전트가 파일 경로, HTML 구조, 가리키는 요소를 바로 파악합니다. 이제 템플릿 파일 경로를 일일이 찾을 필요가 없습니다.
blockstudio.json에서 활성화하세요.
{
"dev": {
"grab": {
"enabled": true
}
}
}
실용적인 패턴
블록 하나 만들기
가장 간단한 워크플로는 원하는 내용을 설명하고 에이전트가 만들도록 하는 것입니다.
프롬프트:
인용문(textarea), 작성자 이름(text), 작성자 역할(text), 작성자 사진(files) 필드가 있는 추천사 블록을 만드세요. 스타일에는 Tailwind을 사용하세요. 인용문은 장식용 따옴표가 있는 큰 기울임꼴 글꼴로 표시해야 합니다.
에이전트가 다음을 만듭니다.
blockstudio/testimonial/
├── block.json
└── index.php
전체 페이지 만들기
Blockstudio의 파일 기반 페이지를 사용하면 에이전트가 전체 WordPress 페이지를 템플릿으로 구성할 수 있습니다. 여기서 큰 효과가 나타납니다. 블록을 하나씩 만드는 대신, 에이전트가 한 번에 모든 블록을 포함한 전체 페이지 구조를 만듭니다.
프롬프트:
히어로 섹션, 팀 그리드, 문의 양식 자리 표시자가 있는 “About” 페이지를 만드세요. 가능한 경우 기존 블록을 사용하고, 필요한 경우 새 블록을 작성하세요. 게시물 ID 2에 고정하세요. 템플릿을 잠그되 제목과 단락은 편집할 수 있게 하세요.
에이전트가 만드는 항목:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
참조된 사용자 정의 블록(e.g., blockstudio/team-member/)도 함께 생성됩니다. wp bs pages sync를 실행해 템플릿 잠금과 편집 컨트롤을 갖춘 WordPress 게시물을 만드세요. 전체 페이지를 버전 관리하고 재현할 수 있습니다.
전체 사이트 만들기
Blockstudio의 아키텍처는 여기서 진가를 발휘합니다. 모든 산출물이 파일이므로 프롬프트 하나로 사이트 전체를 생성할 수 있습니다.
프롬프트:
다음 페이지로 포트폴리오 웹사이트를 만드세요: Home, Work, About, Contact. 다음 사용자 정의 블록을 만드세요: 히어로 섹션, 프로젝트 그리드, 프로젝트 카드, 팀원, 연락처 정보, 푸터. Tailwind을 사용해 어두운 테마를 적용하세요. blockstudio.json에서 Tailwind을 사용자 정의 색상 팔레트로 구성하세요.
에이전트는 블록 디렉터리, 페이지 템플릿, blockstudio.json 및 Tailwind 설정을 만들고, 재사용 가능한 섹션용 패턴도 선택적으로 생성합니다. 모든 항목은 단일 변경 세트로 git에 커밋됩니다.
에이전트 병렬 워크플로
일부 도구(Codex 데스크톱 앱, GitHub Copilot CLI, Kilo Code)는 여러 에이전트를 병렬로 실행할 수 있습니다. Blockstudio의 블록별 파일 아키텍처 덕분에 안전하게 사용할 수 있습니다.
- 에이전트 1: 히어로 블록과 홈 페이지를 만듭니다
- 에이전트 2: 프로젝트 카드 블록과 작업 페이지를 만듭니다
- 에이전트 3: 문의 양식 블록과 문의 페이지를 만듭니다
각 블록은 별도의 디렉터리에 있고 Tailwind 스타일은 템플릿 안에 있으므로 에이전트 간에 충돌이 발생하지 않습니다. 공유 파일은 blockstudio.json 하나뿐이며, 일반적으로 처음 설정할 때 한 번만 구성하면 됩니다.
더 나은 결과를 위한 팁
-
LLM 컨텍스트 파일을 참조하세요. 에이전트가 프레임워크 문서에 접근할 수 있으면 훨씬 더 나은 Blockstudio 코드를 생성합니다. 항상 에이전트가
blockstudio-llm.txt을 참조하도록 하고, 프로젝트 자체를 설명하는 생성된AGENTS.md를 제공하세요. -
필드 유형을 구체적으로 지정하세요. “이미지 필드를 추가해”라고 하는 대신 “
allowedTypes: ['image']와returnFormat: 'object'가 있는 files 필드를 추가해”라고 하세요. 필드 정의가 구체적일수록 필요한 반복 작업이 줄어듭니다. -
블록 하나로 시작한 다음 확장하세요. 에이전트가 블록 하나를 제대로 만들도록 한 뒤 패턴을 검토하고, 같은 규칙에 따라 나머지도 만들도록 요청하세요. 이렇게 하면 이후 결과물의 기준이 되는 참조 사례를 마련할 수 있습니다.
-
결과물을 검토하세요. 바이브 코딩은 코드를 무작정 받아들이는 것을 뜻하지 않습니다. 필드 유형이 의도에 맞는지, 템플릿이 올바르게 렌더링되는지, Tailwind 클래스가 원하는 시각적 결과를 내는지 확인하세요. AI가 생성한 코드는 배포 전에 검토해야 합니다.
-
block.json스키마를 사용하세요. Blockstudio은https://blockstudio.dev/schema/block에 JSON 스키마를 제공합니다. block.json에"$schema"를 추가하면 에이전트에 유효성 검사 피드백을 제공하고 잘못된 설정을 방지할 수 있습니다. -
블록은 작고 집중적으로 구성하세요. 시각적 컴포넌트마다 블록 하나를 만드세요. 그러면 에이전트가 각 블록을 더 쉽게 파악하고 템플릿도 한 번의 컨텍스트 윈도우 처리에 들어갈 만큼 짧게 유지할 수 있습니다.