promptist/
fractal
10월 말 공개

AI가 코드를 짜는 시대의 아키텍처 지도

AI가 짠 코드를,
사람이 더 빨리 이해하도록

시스템 전체부터 클래스 하나까지 한 장의 지도에. 필요한 깊이까지만 펼쳐 보세요.

INSTALL
$ npm i -g <패키지 이름>
$ cd my-repo
$ fractal skill link --claude  # 에이전트에게 모델 읽는 법
$ fractal dev                  # 지도 열기
Node 20.19 이상 · 서버·계정 없이 내 컴퓨터에서
변경 세트를 켠 채 L1 → L4실제 편집기

사람과 AI가 같은 지도를 봅니다

  1. AI

    레포를 읽고 지도를 그립니다

    fractal skill link 한 번이면 에이전트가 모델을 씁니다.

  2. 사람

    필요한 깊이까지만 읽습니다

    궁금한 곳만 확대합니다.

  3. 사람

    바꿀 곳을 지도 위에 설계합니다

    설계가 그대로 작업 지시서가 됩니다.

  4. AI

    구현하고, 다르면 제안합니다

    채택은 사람이 지도 위에서 합니다.

편집기에서 하는 일

흐름 따라가기

요청 하나가 지나는 길을 따라가기

클릭 하나가 어떤 서비스와 클래스를 지나는지 한 단계씩 봅니다.

플로우14초
변경 설계

바꿀 곳만, 지금 구조 위에 겹쳐 보기

추가·수정·제거가 지금 구조 위에 겹쳐 보입니다. AI 제안도 같은 지도에서 채택합니다.

변경 세트15초
AI에게 전달

그 설계를 그대로 에이전트에게

목표·변경·경계가 한 문서로 묶입니다. 복사해 붙이면 끝입니다.

AI 지시서10초

에이전트가 받는 것

$ fractal changeset CS-142발췌
# 작업 지시서 CS-142: 쿠폰 중복 적용 정책
범위: Commerce Platform › Order Service  (L2 CONTAINER)

## 목표
쿠폰을 최대 2장까지 함께 쓸 수 있게 가격 계산 규칙을 바꾼다. 결제·상품 인터페이스는 그대로 둔다.

## 변경 (모델 diff)
+ [추가] Commerce Platform › Order Service › PricingPolicy › CouponStackingRule
    정률 → 정액 순서로 최대 2장 적용, 최소 결제 금액 1,000원 보장
- [제거] Commerce Platform › Order Service › PricingPolicy › DiscountRule
~ [수정] Commerce Platform › Order Service › PricingPolicy
    적용 순서를 쿠폰 → 세금으로 고정

## 건드리지 않는 경계
- Payment Service 결제 요청 스키마
- Catalog Service 가격표 조회 API
- OrderPlaced 이벤트 스키마