Frontend PoC Pipeline
bruno-park/frontend-poc-pipeline
Pipeline IA de frontend: Figma → PRD → TDD → Implementação → PR
Ver no GitHubOrquestrador completo de habilidades para pipeline AI-driven de desenvolvimento frontend, integrando Figma, PRD, Jira, TDD e geração automática de código. Implementa fluxo end-to-end desde design até PR com validações de qualidade, testes automatizados e revisão de código.
Instalação
npx convez-ai bruno-park/frontend-poc-pipeline1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar criação de PRD a partir de designs Figma
- Gerar testes automatizados em modo TDD (RED/GREEN/REFACTOR)
- Criar componentes React com React Query integrado
- Orquestrar workflow completo de desenvolvimento frontend
- Validar gaps entre design e especificação
- Gerar relatórios de cobertura e release notes
Veredito

Solução robusta e modular para equipes que praticam TDD e querem automatizar todo o fluxo de frontend, desde design até merge. Exige integração com Figma/Jira/Git e entendimento de pipeline CI/CD, mas oferece ganho substancial em velocidade e consistência.
README
A tradução para o português deste README ainda está na fila.
frontend-poc-pipeline
Claude Code plugin marketplace for an AI-driven frontend PoC pipeline: Figma → PRD → Branch → TDD → Implementation → PR.
Install
/plugin marketplace add bruno-park/frontend-poc-pipeline
/plugin install frontend-poc-pipeline@frontend-poc-pipeline
설치 후 ${CLAUDE_PLUGIN_ROOT} 기반으로 hooks가 자동 등록되며, 별도의 워크스페이스 설정 없이 동작합니다.
Pipeline
[1] figma-jira-prd → Figma + Jira → PRD 작성
figma-prd-validator → Figma ↔ PRD 갭 검증 (품질 게이트)
spec-validator → Figma description 정책 검증
[2] branch-from-ticket → Jira 티켓 → 브랜치 생성
epic-frontend-splitter → 에픽 → 프론트 하위 티켓 분해
[3] feature-planner → planner.md (구현 청사진) 작성
[4] test-writer → TDD RED (위임: unit-test-gen, e2e-test-gen)
api-integration → React Query 훅 생성 (test-writer와 병렬)
[5] code-writer → TDD GREEN: 구현 (--ui 컴포넌트 / --api → api-integration 위임)
[6] refactor → TDD REFACTOR: GREEN 유지하며 정리
[7] code-review → 로컬 diff 또는 PR 코드 리뷰
coverage-report → 커버리지 + AC 매핑 리포트
[8] create-pull-request → PR/MR 설명 생성 + 승인 후 생성
release-notes → git log + Jira → 릴리즈 노트
Skills
| Skill | Phase | Description |
|---|---|---|
figma-jira-prd | 1 | Figma UI + Description + Jira → PRD |
figma-prd-validator | 1 | Figma ↔ PRD Gap Report |
spec-validator | 1 | Figma description 정책 검증 |
branch-from-ticket | 2 | Jira 티켓 → 브랜치 자동 생성 |
epic-frontend-splitter | 2 | 에픽 Jira → 프론트 하위 티켓 자동 생성 |
feature-planner | 3 | Figma/PRD/티켓 → planner.md 구현 청사진 |
test-writer | 4 | TDD RED orchestrator (위임: unit-test-gen, e2e-test-gen) |
unit-test-gen | 4 | 단위 테스트 작성 (test-writer 위임 대상) |
e2e-test-gen | 4 | Playwright E2E 테스트 작성 (test-writer 위임 대상) |
api-integration | 4 | React Query 훅 — 스펙 없으면 planner.md 잠정 타입+MSW 목, 있으면 OpenAPI(URL/파일/Apidog) 정확 타입 |
code-writer | 5 | TDD GREEN 구현 (--ui 컴포넌트 / --api → api-integration) |
ui-builder | — | ⚠️ DEPRECATED → code-writer --ui로 통합 |
refactor | 6 | TDD REFACTOR: GREEN 유지하며 정리 |
code-review | 7 | 로컬/PR 코드 리뷰 |
coverage-report | 7 | 단위/E2E 커버리지 리포트 |
create-pull-request | 8 | PR/MR 설명 자동 생성 + 사용자 승인 후 생성 |
release-notes | 8 | 릴리즈 노트 생성 |
component-audit | — | pageComponents 파이프라인 준수 감사 |
conventions | — | 프로젝트 공통 컨벤션 레퍼런스 |
hotfix | — | 긴급 운영 핫픽스 fast-path |
vitest-setup | setup | Vitest + RTL 환경 구성 |
msw-setup | setup | Mock Service Worker 설치 |
Slash Commands
commands/*.md 로 정의된 슬래시 커맨드입니다.
| Command | Description |
|---|---|
/workflow | 현재 파이프라인 단계 진단 + 다음 커맨드 안내 |
/feature-planner | Figma/PRD/티켓 → planner.md 구현 계획 |
/test-writer | TDD RED 진입 — 실패 테스트 작성 |
/code-writer | UI/API/All 모드 구현 |
/refactor | GREEN 통과 후 리팩터링 |
/hotfix | 긴급 운영 핫픽스 fast-path |
Hooks
플러그인 활성화 시 ${CLAUDE_PLUGIN_ROOT} 기반으로 자동 등록됩니다. 모든 훅은 stdin JSON 으로 입력을 받고(환경변수 입력 아님), 공유 라이브러리 hooks/_lib.sh 를 통해 입력 파싱(jq → python3 fallback)·모드 판정·출력(deny/block/advise)을 표준화합니다.
강제(enforce) 가능 훅 — 핵심:
- PreToolUse(Bash)
bash-safety-guard— 위험 명령(루트/홈/시스템 경로rm -rf, fork bomb,chmod -R 777,curl|sh·base64|sh·bash <(curl)원격 실행,git push --force/force refspec 등) 차단. catastrophic·난독화 사고 방지용 defense-in-depth (완전한 보안 경계는 Claude 권한 시스템). - PreToolUse(Bash)/PostToolUse(Write)
secret-leak-guard— private key·벤더 토큰(AWS/Slack/GitHub/Google)·하드코딩 크리덴셜 노출 차단/경고. - PostToolUse(Write·Edit·MultiEdit)
planner-schema-guard—planner.md필수 섹션(컴포넌트·Hook Layer·URL state·체크리스트·필드|타입표) 키워드 검증. - PreToolUse(Write)
pipeline-order-guard—pageComponents아래 새 구현 파일 생성 시 순서 강제: feature의planner.md선존재(planner-required) + 컴포넌트면 대응 RED 테스트 선존재(tdd-required). 기존 파일 편집은 비차단. - Stop
stop-gate— PostToolUse 훅이 ledger에 적은 미해결 위반(planner 미완성·시크릿 작성)이 남아 있으면 턴 종료를 차단(루프가드). PostToolUse(차단 불가)를 실질 강제로 닫는 종착 게이트. - SubagentStop
subagent-regate— 계획/설계 에이전트 종료 시 최근planner.md재검증(루프가드 포함, enforce 시decision:block). - PreToolUse(Bash)
commit-message-check/branch-name-check— Conventional Commit·브랜치 네이밍 강제(enforce 시 차단).
PostToolUse 강제를 닫으려면
stop-gate를enforce로 두세요 — 그래야planner-schema·secret-leak(write)의 위반이 "턴 종료 차단"으로 실제 강제됩니다(PostToolUse 자체는 차단 불가).
advisory 훅:
- PostToolUse(Write·Edit·MultiEdit)
post-write-advisor— 작성 파일 경로/내용을 보고 다음 단계 안내(차단 없음): planner.md→Figma 갭 검증, 테스트→RED·AC, E2E→실행 가이드, 구현 tsx→/code-review,console.log/any경고,package.json→패키지 컨벤션. (이전 6개 안내 훅을 1개로 통합.)
설정 (.fpp-hooks.json)
소비 레포 루트에 hooks/fpp-hooks.example.json 을 .fpp-hooks.json 으로 복사해 제어합니다. 기본 모드는 warn(경고만) — 검증 후 enforce(차단)로 승격하세요.
| 키 | 의미 |
|---|---|
mode | warn(기본) | enforce — 전역 |
hooks["<name>"] | 훅별 off|warn|enforce 오버라이드 |
protectedBranches | force push 차단 대상 (기본 main/master/release/*) |
disable: true | 전체 끄기 |
env 오버라이드(파일보다 우선): FPP_HOOKS_DISABLE=1(킬스위치), FPP_HOOKS_MODE, FPP_HOOK_<NAME>(예 FPP_HOOK_BASH_SAFETY=enforce).
훅 동작은 bash scripts/test-hooks.sh (fixture 하네스)로 검증합니다.
Validate
마켓플레이스/플러그인 메타데이터, hooks 스크립트, skills frontmatter, 멀티-에이전트 라우팅 doc(AGENTS.md/CLAUDE.md/GEMINI.md)의 정합성을 검사합니다.
python3 scripts/validate-plugin.py
CI는 .github/workflows/validate.yml 에서 동일 검증 + shellcheck --severity=error 를 돌립니다.
License
MIT