How we build

읽기만 하는 사이트가 아니라
검증 가능한 delivery loop입니다

Breaking Point는 AI 도구 이름을 나열하지 않습니다. Orient → Spec → Change → Verify → Review → Integrate 순환을 반복해 lab과 인프라를 만듭니다. 특정 Agent OS나 CLI는 권장 참고일 뿐, merge 조건이 아닙니다.

Delivery loop

공개 URL에 올리기 전에 develop에서 통합하고, 공개는 release PR로만 합니다. 머지는 rebase로 선형 이력을 유지합니다.

1
Orient contract와 roadmap item을 읽고 범위를 닫습니다.
2
feature/* 한 사용자 결과만 담은 브랜치에서 구현합니다.
3
Verify pnpm quality와 UI evidence로 통과를 판정합니다.
4
Review Standards와 Spec 축을 분리해 검토합니다.
5
develop rebase로 통합합니다. Pages에는 아직 올리지 않습니다.
6
release → main rebase로 공개하고 Actions·URL로 관측합니다.

이 서비스의 구조

아래는 현재 Breaking Point runtime 경계입니다. vendor 제품 이름을 정답처럼 쓰지 않고, GLOBAL_STANDARD에 따라 project contract / practice / vendor boundary를 구분합니다.

Static learning shell

de facto practice

랩 본문, Wiki, 로드맵을 build time HTML로 제공합니다.

Astro · GitHub Pages · Pagefind index

Interaction islands

project contract

simulation, chart, challenge, Pet Coach처럼 상호작용만 React로 올립니다.

ConnectionPoolLab · QueueSenseLab · P50P99Lab · PetCoach

Deterministic model

project contract

Scenario와 seed로 같은 결과를 내는 browser model입니다. production benchmark가 아닙니다.

src/lib/engine.ts · Scenario JSON · challenge scripts

Isolated AI gateway

vendor boundary

API key와 provider 호출만 분리합니다. 학습 shell과 runtime을 섞지 않습니다.

Cloudflare Worker · OpenRouter · model allowlist

랩에서 배운 감각을 운영에도

system design lab의 개념은 코드 안에만 있지 않습니다. 이 repository를 돌리는 방식에도 같은 언어로 연결합니다.

이용률과 Queue CI·리뷰 대기열에 여유 없이 쌓이면 머지 지연이 수직으로 튑니다.

p50과 p99 평균 빌드 시간은 괜찮어도 느린 PR 꼬리가 배포 체감을 망칩니다.

커넥션 풀 / 공유 자원 에이전트·CI·리뷰어를 늘려도 공통 contract와 quality gate가 병목이면 소용없습니다.

Timeout과 overload PR과 release에 시간 예산을 두고, 빨간 CI에서는 merge circuit을 엽니다.

Evidence / tracing 대화가 아니라 test output, Scenario, Pages URL로 결과를 추적합니다.

참고 도구 (비강제)

mattpocock/skills — grill, TDD, code-review 같은 composable engineering loop
Alibaba Open Code Review — 로컬 diff 리뷰 보조 CLI. CI 필수 게이트가 아닙니다.
Ouroboros — specification-first Agent OS 레퍼런스. 이 저장소의 필수 runtime이 아닙니다.

기여자·에이전트를 위한 canonical 문서

공개 페이지는 이야기이고, 실행 contract는 repository 문서입니다.