inkboard/system-atlas

해결하는 문제

System Atlas는 오래되고 정적인 아키텍처 다이어그램의 문제를 해결합니다. 빠르게 "거짓"이 되는 수동으로 그린 다이어그램 대신, 단일 진실의 원천(데이터 파일)을 사용하여 인터랙티브한 등축도 지도와 상세한 텍스트 기반 문서 파일(SYSTEM.md)을 생성함으로써 시각적 설명과 텍스트 설명이 항상 동기화된 상태를 유지합니다.

작동 방식

이 도구는 간단한 빌드 파이프라인을 기반으로 작동합니다. 사용자 또는 AI 에이전트가 시스템의 구조, 흐름, 결정을 포함하는 data.mjs 파일을 편집합니다. 이후 빌드 스크립트(build.mjs)가 이 데이터를 템플릿에 처리하여 두 가지 출력물을 생성합니다:

1. 인터랙티브 HTML 지도: 자체 포함된 등축 시각화로, 구조물 위로 마우스를 올리면 정보가 표시되고, 클릭하면 실행 단계를 확인할 수 있으며, 데이터 패킷이 컴포넌트 간에 이동하는 모습을 시각화할 수 있습니다.
2. 텍스트 복제본: 결정 테이블, 흐름 테이블, 열린 질문의 추적 인덱스를 포함하는 SYSTEM.md 파일.

대상 사용자

다른 사람들에게 복잡한 시스템 설계를 전달해야 하는 개발자 및 아키텍트, 그리고 리포지토리 변경 사항을 기반으로 파이프라인 매핑 또는 아키텍처 문서 업데이트를 자동화할 수 있는 AI 에이전트(skills CLI를 통해)를 위한 것입니다.

주요 특징

• 진행형 정보 공개: 시스템을 "장"으로 나누어 정보 과부하를 방지하고, 구조를 단계적으로 노출합니다.
• 간결한 시각적 표현: 브레인, 스토어, 툴 덱 등 다양한 역할에 특정한 등축 도형을 사용하여 범례 없이도 지도를 쉽게 이해할 수 있도록 합니다.
• 검사 가능한 데이터 흐름: 실제 요청을 움직이는 점으로 시각화하고, 클릭하면 JSON 페이로드를 확인할 수 있습니다.
• 안정적인 질문 추적: 열린 질문에 안정적인 ID(예: Q-<code><n>)를 부여하여 여러 설계 라운드에 걸쳐 피드백과 해결 상태를 추적할 수 있습니다.
• 에이전트 준비 완료: AI 에이전트가 특정 설계 언어와 프로세스를 학습할 수 있도록 "스킬" 형태로 제공되어 아틀라스를 생성하고 유지 관리할 수 있도록 합니다.