WHO
Cursor／Claude Code／Codex로 백엔드를 쓰고 Markdown에 아키텍처 규칙을 넣어도 PR마다 계층·ORM 위반을 고치는 5–50명 팀의 Tech Lead／Staff Engineer.
ConstraintGate · 대기 명단
아키텍처 규칙을 코딩 에이전트가 무시할 수 없는 CI로 바꾸세요
YAML／TOML로 계층 경계·금지 import·필수 ORM 등 불변식을 선언하고, PR에서 CI를 실패시키며 SARIF와 에이전트용 repair brief를 출력합니다. Node(Express/Nest) + Python(Flask/FastAPI)용 — JVM 전용 ArchUnit이나 무거운 오케스트레이터가 아닙니다.
시장 검증 페이지 · 무료 대기 명단 · 가짜 사용자 수 없음
문제
모든 PR에서 constraint decay
구조적 제약이 쌓이면 LLM 코딩 에이전트 assertion 통과율이 평균 약 30pp 하락(constraint decay). AGENTS.md의 Markdown은 강제력이 없어 PR에서 계층·ORM/DB 위반을 반복 수정합니다.
Before
- AGENTS.md／Cursor rules는 무시 가능
- PR에서 계층·ORM／DB 위반 반복 수정
- ArchUnit은 JVM; eslint DIY; eval은 구조를 못 막음
After
- YAML／TOML 불변식＋필수 CI
- SARIF로 즉시 실패
- Node＋Python 경량 게이트＋repair brief
솔루션
ConstraintGate가 하는 일
코딩 에이전트로 백엔드를 만드는 팀을 위한 실행 가능 아키텍처 게이트 — YAML 불변식 → CI 빨강 + SARIF + repair brief.
PROBLEM
Markdown 규칙은 힌트일 뿐 게이트가 아님. constraint decay로 PR이 계층·ORM 위반 수리장이 됩니다.
SOLUTION
YAML／TOML 불변식 선언 → PR에서 GitHub Action／CLI → CI 빨강 + SARIF + 에이전트 가독 repair brief.
RESULT
아키텍처 규칙이 무시할 수 없는 CI가 됩니다 — 또 하나의 스킵되는 Markdown이 아닙니다.
기능
기능
제품 가설에 따른 마케팅 포인트 — 수요 검증용이며 정식 스펙 약속이 아닙니다.
YAML／TOML 아키텍처 불변식
계층 의존, 금지/허용 import, 필수 ORM/DB 경계를 선언 — Markdown 의도를 기계 검사 규칙으로.
PR의 GitHub Action／CLI
모든 PR에서 정적 검사; 위반 시 CI 빨강 — 에이전트와 사람이 MD를 건너뛸 수 없음.
SARIF + 사람용 리포트
GitHub Code Scanning／PR checks용 SARIF와 가독 리포트.
에이전트 가독 repair brief
Cursor／Claude Code／Codex에 다시 넣을 수정 태스크; 선택적 webhook.
Node + Python MVP
Express/Nest와 Flask/FastAPI 흔한 레이아웃 우선; $49–$149/월 정액 가설.
작동 방식
작동 방식
대기 명단 단계 제품 가설에 맞춘 3단계.
- 1
YAML／TOML로 불변식 선언
계층 경계, 금지 import, 필수 ORM／DB — Express／Nest／Flask／FastAPI 관례에 맞춤.
- 2
모든 PR에서 실행
GitHub Action 또는 CLI; 위반 → CI 빨강 + SARIF(Code Scanning/checks).
- 3
에이전트에 repair brief 전달
사람용 리포트 + 에이전트 가독 수정 태스크; 선택적 webhook으로 다음 Cursor／Claude Code／Codex 루프.
사용 사례
이런 팀에게
익숙하다면 검증을 위해 대기 명단에 합류하세요.
AGENTS.md에 Clean Architecture를 써도 계층 간 import
리뷰어 눈이 아니라 PR CI 빨강이 필요.
domain→DB 직결 금지, repository/ORM 강제
data-layer 위반이 많을 때 불변식으로 차단.
Nest/Express 모듈 경계 부패
DIY eslint/dependency-cruiser 피로 → YAML + repair brief.
FastAPI/Flask에서 Cursor가 route를 대량 생성
규칙을 CI에 넣고 실패 brief를 에이전트 루프로.
ArchUnit(JVM)이나 archfit을 검토한 뒤
Node/Python 경량 게이트 + 정액 — 무거운 오케스트레이터 불필요.
공개 시그널
업계 공개 시그널
공개 보도와 업계 논의만 — 가짜 추천문이나 지표 없음.
- arXivConstraint Decay: capable configs drop ~30pp assertion pass rate; data-layer ~45% of logic failures.
- Hacker News~287 points, 197 comments — practitioners argue for linters / ArchUnit / CI over Markdown constraints.
- ArchUnitOfficial userguide for JVM architecture tests — the pattern teams want beyond Markdown.
- alexei-led/archfitDeterministic arch check + agent-readable repair task direction on GitHub.
- DEV.toFrom prompts to invariants — re-architecting with ArchUnit and LLMs.
FAQ
자주 묻는 질문
ArchUnit과 뭐가 다른가요?
ArchUnit은 JVM에 강합니다. 우리는 Node／Python, YAML 불변식, 에이전트용 repair brief부터 — 테스트 클래스 더미가 아닙니다.
eslint／dependency-cruiser／nx와 차이는?
공존 가능. 초점은 아키텍처 불변식 → CI + SARIF + 에이전트 루프용 repair brief로 Markdown 드리프트를 줄입니다.
Braintrust／LangSmith와 차이는?
그쪽은 행동／eval 쪽. 우리는 구조 게이트(import／계층／ORM)로 PR CI를 실패시킵니다 — 프롬프트 점수가 아닙니다.
AGENTS.md／Cursor rules만으로 안 되나요?
Markdown은 힌트. ConstraintGate는 실패 가능한 CI — 코딩 에이전트가 무시할 수 없습니다.
MVP 범위는?
Node(Express/Nest) + Python(Flask/FastAPI) 흔한 레이아웃. 다른 언어는 day-one 약속 밖.
Early Access는 언제인가요?
대기 명단에서 이메일로 순차 초대. 가짜 출시일을 만들지 않습니다.
예상 가격은?
가설 구간 $49–$149／월(정액); 정식 가격은 런치 알림 기준.
대기 명단
대기 명단 등록
ConstraintGate Early Access와 출시 알림을 위해 이메일을 남겨 주세요. 가짜 출시일을 만들지 않습니다.
감사합니다 — ConstraintGate 대기 명단에 등록되었습니다.
Early Access 초대와 출시 업데이트를 순차 이메일로 보냅니다. 언제든 수신 거부 가능합니다.