Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Dossier는 AI 네이티브 제품 구축을 위한 플랫폼으로, 복잡한 개발 과정에서 발생하는 컨텍스트 관리 및 일관성 문제를 해결합니다. 이 도구는 제품을 계층적 지도(Product → Workflow → Feature card)로 구조화하여 에이전트가 필요한 컨텍스트만을 받아 정확하게 기능을 구현하도록 돕습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기복잡한 과정에서 벗어나, 다시 제품 제작에 집중하다.
Dossier는 AI 네이티브(AI-native) 제품 구축 플랫폼입니다. 이 도구는 사용자의 전체 제품에 대한 살아있는 지도—구조화되고, 가시적이며, 에이전트가 준비된 형태—를 제공하여, 사용자가 제품 비전에 집중하는 동안 에이전트들이 세부 사항을 구축할 수 있도록 돕습니다.
사용자님은 AI로 구축하는 방법을 배웠습니다. Dossier는 그 다음 단계입니다.
지금까지 사용했던 도구들은 프로젝트가 본격화되기 전까지는 잘 작동했습니다.
하지만 이제는 열 개의 채팅 창을 오가며 무엇이 완료되었고 무엇이 문제가 있는지 추적하기 어렵고, 모든 새 프롬프트에 컨텍스트를 붙여 넣어야 하며, 에이전트들이 자신감 있게 잘못된 것을 구축하는 모습을 지켜보게 됩니다. 개발 규모가 커지고 있습니다(ballooning). 일관성은 떨어지고 있습니다. 제품을 구체화하는 시간보다 프로세스를 관리하는 데 더 많은 시간을 쓰고 있는 상황입니다.
이는 도구의 문제가 아닙니다. 확장성(scale)의 문제입니다. 그리고 Dossier는 바로 이러한 자연스러운 변곡점(inflection point)을 위해 설계되었습니다.
Dossier는 제품을 계층적 지도—제품 (Product) → 워크플로우 (Workflow) → 피처 카드 (Feature card)—로 구조화하고, 모든 요소에 풍부한 컨텍스트 카드를 연결합니다. 워크플로우는 사용자의 관점을 설명하며, 피처 카드는 소프트웨어가 어떻게 작동할지를 설명합니다. 각 카드는 해당 기능에 중요한 사실(facts), 가정(assumptions), 질문(questions)을 담고 있습니다. 에이전트를 배포하면, 필요한 컨텍스트만을 정확하게 받게 됩니다. 그 이상도 그 이하도 아닙니다.
Implementation map: workflows and feature cards
사용자 스토리 맵(user story map)은 Dossier의 핵심입니다. 워크플로우는 왼쪽에서 오른쪽으로 진행되며, 기능 카드들이 그 아래에 쌓입니다. 모든 카드는 현재 상태를 보여줍니다. 에이전트들은 왼쪽 패널에서 활동을 실시간으로 보여줍니다. 전체 제품이 항상 시야에 들어와서, 큰 그림을 놓칠 일이 없습니다.
Context card: requirements, tests, context docs, code files
모든 기능에는 카드가 있습니다. 에이전트가 기능을 건드리기 전에, 이 카드는 필요한 정보—요구사항, 연결된 테스트 파일, 컨텍스트 문서, 그리고 생성하거나 수정해야 할 코드 파일—를 담고 있습니다. 사용자가 검토하고 승인합니다. 그런 다음 빌드를 진행합니다. 에이전트는 관련 있는 내용만 받습니다. 집중된 컨텍스트가 깔끔한 구현과 환각적인(hallucinated) 구현을 구분하는 요소입니다.
Agent panel with user message and agent activity
에이전트들이 작업하는 것을 지켜보세요. 에이전트 패널은 활동, 추론 과정, 완료 상태를 실시간으로 보여줍니다. 더 이상 내용물을 블랙박스에 붙여 넣고 기대만 할 필요가 없습니다. 무슨 일이 일어나고 있는지 확인하고 통제권을 유지할 수 있습니다.
Implementation map description, tech stack, personas, deployment
모든 제품에는 최상위 개요서(top-level brief)가 존재합니다. 여기에는 설명, 기술 스택(tech stack), 고객 페르소나, 배포 대상, 디자인 영감 등이 포함됩니다. 이 컨텍스트는 모든 워크플로우와 기능 카드를 통해 아래로 흐릅니다. 에이전트는 항상 무엇을, 그리고 누구를 위해 구축하고 있는지 알고 있습니다.
Connected repo and file selection for context
GitHub 레포지토리를 연결하고 컨텍스트에 사용할 파일을 선택할 수 있습니다. 에이전트는 로컬에서 파일을 작성할 수 있으며, GitHub는 PR(Pull Request)을 열고자 할 때만 필요합니다. Dossier는 제품 구조를 코드베이스에 직접 매핑합니다. 에이전트는 어떤 파일을 수정해야 하고, 어떤 파일을 그대로 두어야 하며, 조각들이 어떻게 맞춰지는지 알고 있습니다.
NEW: Dossier를 벗어나지 않고 원격 레포의 업데이트된 사본을 가져올 수 있습니다.
Project documents: FILES and DOCS tabs
에이전트에게 채팅으로 요청하여 프로젝트 문서를 추가하고 편집할 수 있습니다 (예: 아키텍처 요약, 디자인 시스템, 도메인 지식, 테스트 명세서). UI에서의 직접 편집 기능은 추후 제공될 예정입니다. Dossier는 적절한 시점에 올바른 에이전트에게 필요한 문서를 제시합니다. 세션 간에 컨텍스트가 손실되지 않습니다.
Dossier는 세 가지의 독립적인 상태 레이어를 분리합니다:
| 레이어 | 포함 내용 | 저장소 |
|---|---|---|
| 제품 구조(Product structure) | 프로젝트 → 워크플로우 → 활동 → 카드 계층 구조, 풍부한 컨텍스트 카드 | SQLite (dossier.db) + RuVector (ruvector/vectors.db)를 임베딩용으로 사용 |
| ... |
제품 구조 레이어는 Dossier의 차별점입니다. 이곳은 당신의 비전이 존재하고, 컨텍스트가 축적되며, 무엇을 구축할지 형태를 갖추는 곳입니다.
Project
└── Workflow (다수) — 사용자의 관점 (여정, 행동)
└── WorkflowActivity (다수) — 워크플로우 내 그룹화
...
| 레이어 | 기술 |
|---|---|
| 프론트엔드(Frontend) | React 19 + TypeScript + Tailwind CSS (Next.js App Router) |
| ... |
사전 준비 사항(Prerequisites): Node.js 20 이상 버전과 Anthropic API key가 필요합니다. GitHub를 사용하는 경우 (리포지토리 목록, HTTPS git, PR 흐름), .env.local에 GITHUB_OAUTH_CLIENT_ID를 설정한 후 /setup에서 Connect GitHub 기능을 사용하거나, repo 스코프를 가진 개인 액세스 토큰(personal access token)을 붙여넣으세요. 환경 변수에 GITHUB_TOKEN을 설정할 수도 있습니다 (예: CI). 에이전트는 GitHub 없이도 로컬에서 파일을 작성할 수 있습니다.
Windows 사용자: Dossier는 네이티브 SQLite를 사용하며, 설치 과정에서 C++ 컴파일러가 필요합니다. Visual Studio Build Tools를 다운로드하여 “C++을 사용한 데스크톱 개발(Desktop development with C++)” 워크로드를 설치하거나, 권한이 높은 PowerShell에서 다음 명령어를 실행하세요:
npm install -g windows-build-tools이는 일회성 설정입니다. macOS와 Linux는 일반적으로 필요한 빌드 도구를 이미 갖추고 있습니다.
| 주제 | 링크 |
|---|---|
| 시스템 아키텍처(System architecture) | docs/SYSTEM_ARCHITECTURE.md |
| ... |
구성(API 키, OAuth 또는 PAT를 통한 GitHub 연결)은 웹 UI의 /setup에서 설정하거나 ~/.dossier/config 파일을 편집하여 설정할 수 있습니다. OAuth 변수 및 우선순위는 .env.example과 설정 참조 — GitHub OAuth를 참고하세요.
NEW: Claude MAX 계정을 직접 사용하세요. 추가 설정이 필요 없습니다 (로컬에 Claude Code가 설치되어 있는 경우).
~/.dossier/dossier.db)에 저장되며, 벡터 임베딩은 로컬 RuVector 스토어(~/.dossier/ruvector/vectors.db)에 저장됩니다. 빌드 클론은 ~/.dossier/repos/ 아래에 위치합니다. Anthropic 및 (사용하는 경우) GitHub 연결을 통해서만 데이터를 전송하며, 다른 방식으로 데이터가 외부로 나가지 않습니다.직접 구축할 수도 있습니다. 그 본능, 즉 인프라를 사용하기보다 구축하려는 욕구는 바로 Dossier가 여러분을 해방시키기 위해 설계된 함정입니다.
Dossier는 어렵게 얻은 경험의 산물입니다. AI 에이전트(AI agents)를 사용하여 진지하게 구축한 1년간의 경험을 통해, 대규모로 품질을 실제로 제어하는 것이 무엇인지 배웠습니다. 데모에서 약속하는 것과는 다릅니다. 그 안에 포함된 패턴들—컨텍스트 카드 구조(context card structure), 계층별 검증(layer-by-layer verification), 제품 계층 구조(product hierarchy)로부터 프롬프트가 생성되는 방식—은 올바르게 구현하기 위해 실제 반복 작업이 필요했습니다. 직접 버전을 구축하는 것은 당신을 다시 복잡한 문제에 빠지게 합니다(puts you back in the weeds). Dossier는 당신을 그곳에서 벗어나게 해줍니다.
기여를 환영합니다. 변경하고 싶은 내용을 논의하려면 이슈(issue)를 열거나, 풀 리퀘스트(pull request)를 제출하세요.
PolyForm Shield License 1.0.0
Dossier와 경쟁하지 않는 모든 목적으로 무료로 사용할 수 있습니다. 포크(fork)하거나, 기반으로 구축하거나, 자체 호스팅(self-host)하거나, 자신의 제품에 통합할 수 있습니다—단, 경쟁하는 AI 네이티브 제품 계획 또는 빌드 오케스트레이션 도구(AI-native product planning or build orchestration tool)를 만들고 있는 경우는 제외합니다. 전체 약관은 LICENSE를 참조하세요.