Skaro 2.0: AI 개발을 위한 아티팩트

Skaro 2.0: 프로젝트 아티팩트를 활용한 협업 AI 개발 환경

Skaro 2.0은 개발자와 AI가 명확한 역할로 프로젝트를 진행하는 작업 공간입니다. 인간은 아키텍처, 요구사항, 핵심 결정을 담당하고, AI는 엔지니어 역할을 맡아 작업 논의, 코드 작성, 진행 상황 기록을 수행합니다. 핵심은 아티팩트—리포지토리의 구조화된 파일로, 아키텍처 결정 기록(ADR), 계획, 명세, 마일스톤을 저장합니다. 이는 프로젝트의 외부 메모리 역할을 하여 맥락 손실을 방지합니다.

아티팩트가 없으면 협업이 혼란에 빠집니다: 결정이 잊히고, AI가 이전 합의 없이 코드를 생성합니다. Skaro는 채팅을 아티팩트에 직접 내장해 논의를 제자리에 유지합니다.

디렉토리 구조: .skaro

아티팩트는 .skaro 폴더에 계층 구조로 구성됩니다. 주요 구성 요소는 다음과 같습니다:

.skaro
│   config.yaml
│   constitution.md
│   devplan.md
│   secrets.yaml
│   state.yaml
│   token_usage.yaml
│   usage_log.jsonl
│
├───architecture
│   │   adr-001-using-fastapi-as-web-framework.md
│   │   adr-002-simplified-layered-monolith-as-arch-pattern.md
│   │   architecture.md
│   │   chat-conversation.json
│   └───diagrams
├───milestones
│   └───01-foundation
│       └───config-module
│           │   clarifications.md
│           │   plan.md
│           │   spec.md
│           │   tasks.md
│           │   tests.json
│           └───stages
│               └───stage-01
│                   AI_NOTES.md
├───chat
│   tasks.json
└───templates
    adr-template.md
    plan-template.md

• architecture/: 결정 근거가 담긴 ADR 파일, 다이어그램.
• milestones/: 하위 모듈, 계획, 테스트, AI 노트가 포함된 마일스톤.
• chat/: 맥락을 위한 작업 로그.
• templates/: 아티팩트를 표준화하는 템플릿.

이 구조는 Git 리포지토리에 저장되어 버전 관리와 쉬운 접근을 보장합니다.

일반적인 워크플로

작업은 AI와 함께 협업 아키텍처 문서로 시작합니다. 다음으로 devplan.md를 만들어 마일스톤으로 세분화합니다. 각 마일스톤에는 spec.md, plan.md, tasks.md, 그리고 AI_NOTES.md가 포함된 스테이지가 들어갑니다.

• architecture/ 채팅에서 아키텍처 논의 후 ADR 확정.
• 세부 작업이 포함된 마일스톤 생성.
• 각 작업에서 AI가 아티팩트에서 초기 맥락을 가져와 파일 요청.
• 구현 후 자동 커밋(선택).
• 홈페이지 작업 보드 업데이트.

채팅은 완전한 맥락 지원: 아티팩트와 작업에 내장되어 맥락 전환이 불필요합니다.

2.0 버전 주요 업데이트

Skaro 2.0은 프로세스를 간소화합니다:

• 맥락 채팅: 아키텍처, 마일스톤, 작업에서 사용 가능. 논의는 chat-conversation.json으로 저장.
• 작업 전 LLM 맥락: 모델이 spec.md, plan.md, ADR을 사전 검토.
• 자동 커밋: config.yaml에서 작업 후 변경 커밋 설정.
• 통계 대시보드: token_usage.yaml과 usage_log.jsonl을 활용한 전용 페이지.
• 칸반 보드: 홈페이지에서 마일스톤, 스테이지, 작업 개요.
• UI 맞춤화: 테마와 강조 색상으로 일상 사용 편의.

안정성과 UI 문제도 수정했습니다.

로드맵

오픈소스 코어는 유지: 아티팩트와 협업 모델. 예정: 접근 제어 팀 워크스페이스, 토큰 분석, 공유 보드, 지출 관리.

주요 요약

• 아티팩트가 외부 메모리: ADR과 마일스톤으로 AI 개발 맥락 드리프트 방지.
• 역할 분리: 인간은 아키텍트, AI는 구조 기반 구현자.
• 맥락 채팅: 논의가 리포에 머무르며 산만함 없음.
• 자동화: 사전 맥락과 자동 커밋으로 마찰 감소.
• 확장성: 솔로 개발부터 팀 워크스페이스까지.

— Editorial Team