remotion-brand-codify
리서치 결과물을 모든 컴포지션이 읽을 수 있는 타입화된 코드로 변환합니다.
트리거
remotion-brand-research가.research/아래에 도메인을 작성한 후.- 사용자가 브랜드 색상, 글꼴, 톤 노트를 붙여넣고 "{브랜드} 브랜드 코드화"라고 말한 경우.
입력
.research/brand-{slug}-{date}.json(권장) 또는 마크다운 도메인- 기존
Synthex/packages/brand-config/src/brands/{slug}.ts(차이 비교용)
방법
- 도메인이
BrandConfig의 모든 필수 필드를 포함하는지 확인합니다 (Synthex/packages/brand-config/src/types.ts참조). 누락된 필드가 있으면 차단하고remotion-brand-research에 채우도록 요청합니다. - 경계 계약을 적용합니다 — 색상 16진수 / 타이포그래피 스케일 / 간격 / 구성 요소 / 레이아웃은
.design.md로, 음성 / 오디오 / 모션 / 대상 / 채널 / 금지어 / 로고 경로 / 서명은.ts로 이동합니다.Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md를 참조하세요. - 각 색상에 대해 팔레트 색상이 5개 미만이거나 기본 텍스트에 대해 WCAG-AA에 실패하면
remotion-colour-family를 실행합니다. color-family 스킬은.design.md의colors:섹션에 바로 넣을 수 있는 YAML 블록을 생성합니다. - 모션에 대해
motion블록이 비어 있으면remotion-motion-language를 실행합니다. - 글꼴에 대해 라이선스를 검증합니다: OFL / Apache / MIT 패밀리만 통과합니다. Adobe Fonts (서버 측 렌더링 금지) 및 유료 Google Fonts는 차단합니다.
Synthex/packages/brand-config/src/brands/{slug}.ts를 생성합니다 — 실행 시점 필드만 포함합니다 (CONTRACT.md 기준).Synthex/packages/brand-config/src/brands/ra.ts를 표준 예시로 사용합니다. 이후Synthex/packages/brand-config/에서npm run build를 실행하여dist/를 재생성합니다.Synthex/packages/brand-config/src/brands/{slug}.design.md를 생성합니다 — 시각적 토큰만 포함하며,@google/design.md형식을 준수합니다. 기존*.design.md(예:ra.design.md)를 표준 예시로 사용합니다.- design.md를 린트합니다 —
npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md를 실행합니다. 오류 시 차단합니다. 경고는 권고 사항입니다 — 참조되지 않은 토큰 경고는 사용되지 않은 토큰에 의미적 의도가 없을 때만 수정합니다. - 런타임 위치로 미러링합니다 —
cp Synthex/packages/brand-config/src/brands/{slug}.design.md Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md. 런타임 로더(loadDesign(slug))는 remotion-studio의 워크스페이스 링크를 통해 Pi-Dev-Ops 로컬 복사본을 읽습니다. - 슬러그가 새 것이면
Synthex/packages/brand-config/src/brands/index.ts를 업데이트합니다 (또한types.ts의BrandSlug유니온을 확장합니다). Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md에서 사람이 읽을 수 있는 9개 섹션 투영을.ts와.design.md모두에서 읽어 재생성합니다. 섹션 2(색상 팔레트), 3(타이포그래피), 4(구성 요소), 5(레이아웃)는.design.md에서 가져오고, 섹션 1, 6, 7, 8, 9는.ts+ 지원 산문에서 가져옵니다.
출력
브랜드당 세 개의 편집된 파일:
Synthex/packages/brand-config/src/brands/{slug}.ts— 타입화된BrandConfig(런타임 + 동작, RA-1985 기준 진실 공급원).Synthex/packages/brand-config/src/brands/{slug}.design.md— 시각적 토큰 (진실 공급원, 스펙 준수@google/design.md).Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md— 9개 섹션 사람이 읽을 수 있는 투영 (둘 다에서 재생성됨; 수동 편집 금지).
추가로 Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md의 런타임 미러 (2번의 복사본 — brand-config 통합이 로컬 복사본을 제거할 때까지 동기화 유지).
9개 섹션 .md 투영은 .ts + .design.md의 투영이며, 병렬 소스가 아닙니다. 소스 중 하나가 변경될 때마다 재생성하세요. 수동 편집은 절대 하지 마십시오. 섹션 순서는 고정입니다:
- 시각적 테마 및 분위기 (
.ts의 voice + audience 산문에서) - 색상 팔레트 및 역할 (
.design.mdcolors:를 반영하는 표, 정의된 경우 다크 변형 행 포함) - 타이포그래피 규칙 (
.design.mdtypography:+ 라이선스 추적을 위해BrandTypography의 패밀리/두께에서) - 구성 요소 스타일링 (
.design.mdcomponents:에서) - 레이아웃 원칙 (
.design.mdspacing.outer-margin-*+BrandLogo.safeAreaPx에서) - 깊이 및 고도 (
.design.mdElevation 산문에서) - 해야 할 일과 하지 말아야 할 일 (
.tsdoNot+voice.forbiddenWords+.design.mdDo's/Don'ts 섹션 연결) - 반응형 동작 (
.ts의 종횡비,.design.md의 비율당 유형 스케일) - 에이전트 프롬프트 가이드 (
{colors.*}및motion.signature토큰을 호출하는 리터럴 예제 하나)
추가로 PR (또는 로컬 diff) 요약:
- 소스 도메인 경로
- 입력된 필드 대 창립자 검토로 남겨진 필드
- 린트 상태 (
design.md lint오류 / 경고, 글꼴 라이선스, 대비) - 세 파일 모두 생성됨 (
.ts+.design.md+.md투영) — 누락된 아티팩트 시 차단
경계
- 항상 PR
auto-merge:false설정 — 브랜드 음성 미묘함은 인간이 검토해야 합니다. - 기존 파일을 조용히 덮어쓰지 말고, 나란히 diff를 생성하세요.
- 글꼴이나 색상을 절대 발명하지 마십시오 — 값은 리서치 도메인에서 오거나
// TODO: founder review주석이 있는 중립적 기본값으로 대체합니다. - 절대
.ts와.design.md에 토큰을 중복하지 마십시오.colour.primary가.design.md에 있다면.ts는 이를 다시 선언해서는 안 됩니다. CONTRACT.md가 중재자입니다. - 절대
.md투영을 수동으로 편집하지 마십시오 — 소스에서 재생성합니다.
재사용
src/brands/CONTRACT.md— 토큰 소유권 경계src/brands/ra.design.md— 표준.design.md예시Synthex/packages/brand-config/src/brands/ra.ts— 표준.ts예시src/design-systems/_library/— 시각적 학교 앵커링을 위한 140개의 판매된 DESIGN.md 파일 (최대 하나 인용)
재사용 유틸리티
Synthex/packages/brand-config/src/types.ts— 스키마 진실 공급원 (RA-1985 기준)remotion-studio/src/colour/index.ts— WCAG 검사를 위한contrast()remotion-studio/src/design-systems/_library/— 138개의 판매된 참조 DESIGN.md 파일 (오픈 디자인, Apache-2.0)..md투영에서 시각적 학교 앵커로 최대 하나 인용, 그대로 복사 금지- 참조 투영:
remotion-studio/src/brands/ra.md는 모방할 표준 예시입니다