convez.ai
SkillDesenvolvimento WebAvançado
bruno-park

Frontend PoC Pipeline

bruno-park/frontend-poc-pipeline

Pipeline IA de frontend: Figma → PRD → TDD → Implementação → PR

Ver no GitHub
InicialPluginScore · de 0 a 100

Orquestrador 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-pipeline

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
2

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

validate

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

SkillPhaseDescription
figma-jira-prd1Figma UI + Description + Jira → PRD
figma-prd-validator1Figma ↔ PRD Gap Report
spec-validator1Figma description 정책 검증
branch-from-ticket2Jira 티켓 → 브랜치 자동 생성
epic-frontend-splitter2에픽 Jira → 프론트 하위 티켓 자동 생성
feature-planner3Figma/PRD/티켓 → planner.md 구현 청사진
test-writer4TDD RED orchestrator (위임: unit-test-gen, e2e-test-gen)
unit-test-gen4단위 테스트 작성 (test-writer 위임 대상)
e2e-test-gen4Playwright E2E 테스트 작성 (test-writer 위임 대상)
api-integration4React Query 훅 — 스펙 없으면 planner.md 잠정 타입+MSW 목, 있으면 OpenAPI(URL/파일/Apidog) 정확 타입
code-writer5TDD GREEN 구현 (--ui 컴포넌트 / --api → api-integration)
ui-builder—⚠️ DEPRECATED → code-writer --ui로 통합
refactor6TDD REFACTOR: GREEN 유지하며 정리
code-review7로컬/PR 코드 리뷰
coverage-report7단위/E2E 커버리지 리포트
create-pull-request8PR/MR 설명 자동 생성 + 사용자 승인 후 생성
release-notes8릴리즈 노트 생성
component-audit—pageComponents 파이프라인 준수 감사
conventions—프로젝트 공통 컨벤션 레퍼런스
hotfix—긴급 운영 핫픽스 fast-path
vitest-setupsetupVitest + RTL 환경 구성
msw-setupsetupMock Service Worker 설치

Slash Commands

commands/*.md 로 정의된 슬래시 커맨드입니다.

CommandDescription
/workflow현재 파이프라인 단계 진단 + 다음 커맨드 안내
/feature-plannerFigma/PRD/티켓 → planner.md 구현 계획
/test-writerTDD RED 진입 — 실패 테스트 작성
/code-writerUI/API/All 모드 구현
/refactorGREEN 통과 후 리팩터링
/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(차단)로 승격하세요.

키의미
modewarn(기본) | enforce — 전역
hooks["<name>"]훅별 off|warn|enforce 오버라이드
protectedBranchesforce 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

Ver o original no GitHub

Bom para

Relacionados