시스템 아키텍처부터 실제 코드로: Basalt의 Doc View 소개

Basalt를 구축하면서 깨달은 점 중 하나는 시스템 아키텍처를 생성하는 것이 문제의 절반에 불과하다는 것입니다.

나머지 절반은 여러분의 코딩 에이전트가 그것을 이해하도록 하는 것입니다.

여러분은 Basalt에서 상세한 아키텍처를 만들 수 있지만, Claude, ChatGPT, Google Antigravity 또는 다른 AI 코딩 에이전트로 이동할 때도 여전히 무엇을 구축했는지, 구성 요소들이 어떻게 상호 작용하는지, 의도된 워크플로우가 무엇인지, 그리고 무엇을 구현해야 하는지를 설명해야 합니다.

이는 시스템을 설계하는 것과 실제로 구축하는 것 사이에 불필요한 마찰(friction)을 만듭니다.

그래서 우리는 그 전환 과정을 더 간단하게 만들기로 결정했습니다.

Doc View 소개

Doc View는 여러분의 Basalt 아키텍처를 AI 코딩 에이전트를 위한 구조화되고 바로 사용할 수 있는 프롬프트로 변환합니다.

작동 방식은 다음과 같습니다:

1. 평소처럼 Basalt에서 아키텍처를 설계합니다.
2. Doc View로 전환하여 아키텍처로부터 생성된 프롬프트를 얻습니다.
3. 프롬프트를 복사하고 프로젝트별 요구 사항, 제약 조건 또는 지침을 추가합니다.
4. 코딩 에이전트에 붙여넣고 구축을 시작합니다.

그게 전부입니다.

모든 구성 요소, 연결 및 아키텍처 결정을 처음부터 길고 장황한 프롬프트로 수동 번역할 필요가 없습니다.

이것이 왜 중요할까요?

AI 코딩 에이전트는 점점 더 능력이 향상되고 있지만, 그 출력 품질은 우리가 제공하는 컨텍스트에 크게 의존합니다.

잘 정의된 아키텍처는 구현을 시작하기 전에 에이전트에게 의도된 시스템에 대한 더 명확한 그림을 제공합니다.

무엇을 구축하고 싶은지에 대한 모호한 설명으로 시작하는 대신, 이미 설계한 아키텍처를 가지고 시작하여 이를 구현의 기반으로 사용할 수 있습니다.

목표는 간단합니다: 시스템 설계와 코드 생성 간의 격차를 줄이는 것입니다.

다음 단계는 무엇일까요?

Doc View는 Basalt가 단순한 아키텍처 설계 도구를 넘어설 수 있도록 하는 또 하나의 단계입니다. 우리는 Basalt가 아이디어를 시스템 설계부터 구현까지 가져가는 워크플로우의 일부가 되기를 바랍니다.

시스템을 설계하세요. 코딩 에이전트에게 컨텍스트를 제공하세요. 구축을 시작하세요.

당신의 아키텍처가 작동하는 시스템이 되었습니다.

Basalt 사용해 보기: https://basaltarch.io

현재 시스템 아키텍처 다이어그램에서 AI 지원 구현으로 어떻게 전환하고 계신지 듣고 싶습니다. 당신의 워크플로우는 어떤 모습인가요?