연대지능네트워크
공지사항
AI 대화
교육 과정이나 연대지능 활동에 대해 질문하세요.
활동가 의견
의견 게시판
사이트 운영 방식이나 기능 개선에 대해 자유롭게 의견을 남겨주세요.
검증 종합 리포트
모든 활동가의 검수 결과를 종합하여 위키 콘텐츠의 품질 현황을 보여줍니다. 각 내용에 대한 판정과 개선의견이 집계됩니다.
판정 기준
유지: 좋음이 과반수이고 오류가 20% 미만
수정 필요: 오류가 과반수이거나 오류 비율 40% 이상
보완 필요: 그 외 (보완이 가장 많거나 의견이 혼재)
최소 3건 이상 검수된 항목만 리포트에 포함됩니다.
학습개요
바이브 코딩이 무엇인지 큰 그림부터 이해해요. 개념을 읽은 뒤 '실습시작' 메뉴에서 한 단계씩 실습합니다
전체 환경 관계도
내 PC ↔ 인터넷 서비스 ↔ AI 세 영역이 연결되어 바이브 코딩 환경을 이룹니다
내 PC
Node.js, Git, VSCode, Obsidian
AI 엔진
Claude Code, CLAUDE.md, Anthropic API
인터넷 서비스
GitHub, Cloudflare, Supabase, Quartz 위키
바이브 코딩 한눈에 보기 (1부 · 전체 지도)
웹사이트가 만들어지는 큰 그림을 "지도 한 장"으로 먼저 이해해요. 순서는 딱 4단계입니다.
STEP 1. 도구 세팅
클로드 코드 — AI와 대화하며 코드를 만드는 작업 도구
STEP 2. 프론트엔드
HTML·CSS·JS — 눈에 보이는 화면
STEP 3. 백엔드
Supabase — 데이터 저장·처리
STEP 4. 배포
Cloudflare Pages — 인터넷에 공개
그리고 이 흐름 전체를 받쳐주는 것이 Git(내 컴퓨터의 세이브 파일)과 GitHub(인터넷 창고)예요. 아래 카드를 하나씩 눌러 읽어보세요.
AI 코딩 도구는 두 부분으로 나눠 이해하면 쉬워요.
- 두뇌(LLM): ChatGPT, Gemini, Claude 같은 거대 언어 모델. 생각을 담당해요.
- 손발(코딩 에이전트): 실제로 파일을 만들고 코드를 고치는 도구. 우리는 클로드 코드를 써요.
도구는 이렇게 진화해왔어요
- 터미널: 검은 명령어 창으로 컴퓨터를 제어 (구식)
- VS Code: 코드 편집기에서 파일을 보며 작업
- Cursor AI: 편집기에 LLM을 통합
- 클로드 코드 PC판: 터미널·편집기 없이 단독 실행 (최신)
유료 구독이 필요하지만, 전문가에게 개발을 맡기는 비용(월 200만 원 이상)에 비하면 월 40만 원 미만으로 훨씬 저렴해요. Pro 요금제로 시작해서 필요해지면 Max로 올리는 걸 권해요.
바이브 코딩을 시작하려면 세 가지만 설치하면 돼요.
- ① 클로드 코드: AI 코딩 작업 도구
- ② Git: 코드가 바뀔 때마다 저장·복원할 수 있는 게임 세이브 파일 같은 도구. Mac은 기본 설치, Windows는 git-scm.com에서 다운로드해요.
- ③ GitHub: Git 기록을 보관하는 인터넷 창고. 가입 후 클로드 코드와 연결해요.
실습시작 메뉴의 2단계(Git)·8단계(GitHub 저장소)에서 하나씩 실습해요.
웹사이트는 시계에 비유하면 쉽게 이해돼요.
- 프론트엔드 = 시계판: 초침·분침·숫자처럼 눈에 보이는 화면. HTML·CSS·JS, React 같은 기술을 써요.
- 백엔드 = 태엽: 알람·타이머처럼 화면 뒤에서 데이터를 처리하는 장치. 서버·데이터베이스·API가 여기 속해요.
회원가입이나 게시판 같은 기능을 만들려면 백엔드가 꼭 필요해요. 백엔드는 복잡하지만 개념만이라도 이해해두면, 나중에 AI에게 요청할 때 훨씬 정확한 결과를 얻을 수 있어요.
어떤 언어·기술로 만들지 고민할 필요 없어요. AI에게 만들려는 것의 규모만 정확히 알려주면 돼요.
왜 '규모'가 중요할까요?
- 언어와 구성마다 장단점이 달라요.
- 작은 스택으로 큰 서비스를 만들면, 방문자가 몰릴 때 사이트가 멈출 수 있어요.
- 그래서 처음 설계할 때부터 규모에 맞추는 것이 매우 중요해요.
① Supabase — 데이터 매니저
서버 빌리기, 데이터 저장, 프로그램 설치를 한 번에 처리해주는 서비스예요.
- GitHub 계정으로 가입 → New Project → 지역은 서울 선택
- Connect 버튼에서 프로젝트 URL과 공개(anon) 키를 복사해 클로드 코드에 붙이면, 연결 코드와 테이블(표) 생성 명령문을 만들어줘요.
- Supabase SQL Editor에 그 SQL을 붙여넣고 Run → 사이트에서 저장한 값이 표에 나타나면 연결 성공!
- 보안: 공개 키라도 환경변수 파일에 저장해서 노출을 막아요.
② Cloudflare Pages — 배포 매니저
내 컴퓨터에 있는 사이트를 인터넷에 올려주는 서비스예요. 유튜브의 '업로드' 버튼과 같아요.
- GitHub 계정으로 연결 → 저장소 선택 → Deploy → 내 사이트 주소 발급
- 내 컴퓨터가 꺼져 있어도 24시간 운영돼요.
- GitHub에 수정본을 올리면 사이트도 자동으로 업데이트돼요.
① 도구는 클로드 코드 하나면 충분해요.
② 프론트엔드는 규모만 전달하면 언어·스택은 AI가 정해줘요.
③ 백엔드는 Supabase(데이터) + Cloudflare Pages(배포) 두 매니저에게 맡겨요.
원문: 바이브 코딩의 개요 (1부)
바이브 코딩 깊이 보기 (2부 · 하네스, 나만의 AI 작업장)
1부가 "좋은 도구 고르기"였다면, 2부는 "좋은 작업장 만들기"예요. 명령 한 번의 '딸깍'만으로는 세 가지 벽에 부딪혀요: 매번 처음부터(AI가 과거 맥락을 기억 못 함), 신뢰성 부족(그럴듯한 거짓 생성), 기능 제한(외부 데이터 연결 불가). 이 벽을 넘는 장치가 하네스입니다.
하네스의 네 기둥
지시문
원칙과 말투를 규정
기억
이전 작업 맥락을 유지
도구·재료
외부 데이터 접근·연결
검증
결과를 확인하는 습관
.md 형식의 지시문 파일이에요. CLAUDE.md, AGENTS.md, GEMINI.md처럼 도구마다 이름이 달라요. AI가 작업을 시작할 때마다 자동으로 읽기 때문에 "헌법"이라고 불러요.
- 실제 사용 예: "거짓말 금지", "데이터 우선" 같은 레드라인을 기록해둬요.
자주 반복하는 작업을 이름 붙은 절차로 저장해두는 거예요. 요리 레시피 카드처럼, 이름만 부르면 정해진 순서대로 실행돼요.
- 실제 사용 예: '배포', '지원사업', '위키 발행' 같은 스킬을 만들어두고 한 마디로 실행해요.
AI를 외부 서비스에 연결하는 표준 규격이에요. 어떤 기기든 꽂을 수 있는 콘센트처럼, 한 가지 방식으로 여러 서비스를 연결해요.
- 실제 사용 예: Supabase, Gmail, 캘린더, 텔레그램 등을 AI에 연결해서 "메일 확인해줘" 같은 요청이 가능해져요.
프로그램들이 서로 정보를 교환하는 공식 창구예요. 민감한 키(열쇠)는 반드시 환경변수에 따로 저장해서 노출을 막아요.
- 실제 사용 예: 법령·날씨·지도 API를 연결해서 AI가 실시간 정보를 활용하게 해요.
하나의 AI에게 모든 걸 시키는 대신, 특정 작업을 전담하는 AI 여럿으로 나누는 방식이에요.
- Maker(생성) ↔ Checker(검증) 역할을 분리하면 결과의 신뢰도가 올라가요.
- 실제 사용 예: 코드 담당, 문서 담당, 배포 담당 에이전트를 따로 두고 협업시켜요.
자동 실행(타이머), 격리 작업대, 스킬, 커넥트(MCP), 전담 에이전트, 디스크 기억 — 이 6가지 부품이 모이면 스스로 도는 자동 작업장(루프)이 완성돼요. 그런데 마지막 조각인 "완전 무인 재귀"는 일부러 넣지 않아요.
무인 재귀의 세 함정
- 검증 붕괴: 아무도 안 본 결과가 계속 쌓여요.
- 이해 부채: 과정에 참여하지 않아서 문제가 생겨도 대응할 수 없어요.
- 인지 투항: 사람이 생각하기를 포기하게 돼요.
우리의 선택: 반자동 트리아지
AI는 발견·분류까지(자동), 사람은 판단·실행(수동). 예를 들어 서버 감시라면 AI가 5분마다 상태를 확인하고 이상을 분류하되, 재시작 여부는 사람이 판단해요.
① 하네스 = 지시문·기억·도구·검증으로 만든 나만의 AI 작업장이에요.
② MD·스킬·커넥트·API·에이전트 다섯 부품이 모이면 자동 작업장(루프)이 돼요.
③ 단, 판단의 자리에는 항상 사람을 둬요 (반자동 트리아지).
원문: 바이브 코딩 2부 — 하네스
실습시작
AI와 대화하며 환경 구축부터 하네스까지 15단계를 한 단계씩 실습합니다. 개념이 궁금하면 학습개요를 먼저 읽어보세요
학습 진행 현황
AI 학습 대화
아래 버튼을 눌러 학습을 시작하세요. 각 단계마다 안내를 따라 진행하고, 진행 화면을 캡처해서 올려주세요.
안녕하세요! 바이브 코딩 환경 구축을 도와드릴게요.
아래 버튼 중 하나를 눌러 시작하세요:
- 지금부터 학습 시작: 1단계부터 차근차근 시작
- 다시 이어서 학습 시작: 이전에 저장한 곳부터 이어서 진행
- 중간 단계부터 시작: 위 진행 현황의 단계 배지를 클릭하거나, "3단계부터 시작"이라고 입력
각 단계를 시작할 때마다 이전 단계가 제대로 됐는지 점검부터 안내해드려요. 점검에 문제가 있으면 "이전 단계"라고 입력하세요.
연대지능기여게임
위키에 올라온 실제 내용을 검수합니다. 이 내용이 그대로 좋은지, 보완이 필요한지, 오류인지 판정하고 품질평가와 개선의견을 작성하세요.
활동가를 평가하는 것이 아니라 위키 콘텐츠의 품질을 높이기 위한 검수입니다. 매달 300문제가 새로 준비되며, 한 번 검증할 때마다 5문제씩 출제됩니다.
이 위키 내용의 품질을 판정하세요
내 검증 기록
지금까지 참여한 연대지능기여게임의 기록입니다
성과 반영
검증 참여는 기여도 점수에 반영됩니다
| 활동 | 점수 | 설명 |
|---|---|---|
| 검수 참여 1건 | +2점 | 판정 선택 + 품질평가 작성 |
| 상세 평가 | +2점 | 품질평가 20자 이상 작성 |
| 개선의견 | +3점 | 보완/오류 시 개선의견 10자 이상 |
| 10건 완료 | +5점 | 한 세션에서 10건 검수 완료 시 |
최근 검증 기록
내 진행 상태 진단
AI에게 환경을 점검받고, 결과를 붙여넣으면 현재 단계를 알려줘요
1단계: 아래 프롬프트를 복사해서 내 AI에게 물어보세요
Claude Code 명령어 입력창이나 챗 Claude에 아래 프롬프트를 붙여넣으세요. AI가 현재 환경을 점검해줘요.
2단계: AI의 답변을 여기에 붙여넣으세요
AI가 점검한 결과를 그대로 복사해서 아래에 붙여넣고 진단하기 버튼을 누르세요.
성과
위키 활동 평가
연대지능 위키(deka2026/solidarity-intelligence-wiki) 기여 현황
위키 데이터 연결
아래 명령어를 명령어 입력창에서 실행한 뒤 결과(JSON)를 붙여넣고 연결을 누르면 내 위키 활동이 바로 반영돼요.
활동가별 기여 현황
| 활동가 | GitHub | 문서 | 반영요청 | 반영완료 | 검토 | 점수 | 등급 |
|---|
기여도 평가 기준
| 항목 | 배점 | 설명 |
|---|---|---|
| 문서 작성 (반영 요청) | 10점/건 | 위키에 새 문서를 작성하여 반영 요청 |
| 검수 통과 (최종 반영) | 5점/건 | 검토자 검수를 통과하여 반영 완료 |
| 검토 참여 | 3점/건 | 다른 활동가의 문서에 의견 작성 |
| 문서 개선 | 5점/건 | 기존 문서를 수정·보완하는 반영 요청 |
| 연결 기여 | 2점/건 | 문서 간 [[링크]]를 추가하여 관계 형성 |
등급 기준
| 등급 | 필요 점수 | 조건 |
|---|---|---|
| L1 입문 | 0점~ | 교육 신청 완료 |
| L2 기록 | 30점~ | 문서 3건 + 반영 2건 이상 |
| L3 연결 | 80점~ | 문서 10건 + 검토 5건 이상 |
| L4 멘토 | 150점~ | 문서 20건 + 검토 10건 + 성과발표 1회 |
활동보고서 출력
내 위키 활동 데이터(작성 문서, 반영 완료, 검토, 점수, 등급, 반영 요청 목록)를 정리한 활동보고서를 Word 문서로 바로 내려받습니다.
비밀번호 변경
임시 비밀번호로 로그인하셨다면, 여기서 원하는 비밀번호로 바꿔주세요.
품질 리뷰 대시보드
전체 검증 활동과 의견 게시판 현황을 한눈에 확인합니다
검증 참여 현황
교육생별 연대지능기여게임 참여 기록
문항별 판정 분포
3건 이상 검수된 문항만 표시 · 오류 비율 높은 순 정렬
의견 게시판 현황
카테고리별 의견 수와 최근 등록 현황
주간 의견 리포트 내보내기
선택한 주간의 의견을 Word 문서로 내보냅니다. 각 의견에 Claude 수정 지시용 프롬프트가 포함됩니다.
교육생 관리
교육 신청 현황, 승인/거절, GitHub 계정 연결
대기 중인 신청
승인된 교육생
GitHub 계정 연결
교육생의 이메일과 GitHub 사용자명을 연결하면 위키 활동 기록이 자동으로 연결돼요.
연대지능 학습 가이드
연대지능의 개념부터 위키 기여까지, AI와 대화하며 한 단계씩 배워요
연대지능 이해
개념, 원칙, 기존 방식과의 차이
활동가 역할
4가지 역할, 역량 체계, 성장 경로
위키 실천
문서 작성법, 지식 분류, 위키 기여
연대지능 위키
개인 위키와 연대지능 위키를 연결하여 현장 지식을 공유합니다
deka2026/solidarity-intelligence-wiki활동가 각자의 Quartz 위키에서 작성한 문서를 연대지능 위키에 반영 요청으로 올리면, 검수를 거쳐 공동 지식이 돼요.
개인 위키 → 연대지능 위키 연결 구조
1. 내 위키
Obsidian + Quartz로 운영하는 개인 위키. 현장기록, 메모, 학습 노트를 자유롭게 쌓습니다.
2. 정제 & 분류
개인 노트 중 공유할 만한 것을 4종 문서 유형(개념, 현장기록, 사용법, 사례연구)으로 정리합니다.
3. 반영 요청
정리된 문서를 연대지능 위키 저장소에 내 공간에 복사 → 반영 요청으로 올려요. Claude Code로 자동화할 수 있어요.
4. 검수 & 최종 반영
검토자가 지식 분류 5가지 질문으로 검수해요. 통과하면 최종 반영되어 연대지능 위키에 게시됩니다.
시작하기: 연대지능 위키 셋업
아래 프롬프트를 Claude Code에 붙여넣으면 연대지능 위키 저장소를 내 공간에 복사하고 개인 위키와 연결하는 설정을 자동으로 진행해요.
개인 위키에서 문서 가져오기
개인 Quartz 위키에 이미 작성한 문서를 연대지능 위키 형식에 맞게 바꿔서 반영 요청을 해요.
현장기록 바로 올리기
현장에서 경험한 것을 바로 연대지능 위키에 기록합니다. 개인 위키에 먼저 저장할 필요 없이 바로 반영 요청을 할 수 있어요.
개인 위키에 연대지능 위키 링크 연결
개인 Quartz 위키에서 연대지능 위키의 문서를 참조할 수 있도록 링크를 설정합니다.
기존 문서 최신 상태로 맞추기
연대지능 위키에 반영된 내 문서를 개인 위키에도 맞춰서, 양쪽에서 모두 확인할 수 있게 해요.
반영 요청 상태 확인
내가 올린 반영 요청의 상태를 확인하고, 검토 의견에 대응해요.
동료 문서 검토하기
다른 활동가가 올린 문서를 검토하여 활동 점수를 쌓고 지식의 품질을 높여요.
교육일정 · 공지사항
교육 일정
달력에서 날짜를 눌러 일정을 추가하세요. 등록된 일정은 달력과 목록에 표시됩니다.
일정 추가
등록된 일정
공지사항
작성한 공지는 홈(연대지능네트워크) 화면 상단에 최근 10건이 표시됩니다.
공지 작성
등록된 공지
로그인
교육 신청 시 등록한 이메일과 비밀번호로 로그인하세요.
비밀번호 설정
교육 승인이 완료되었습니다. 로그인에 사용할 비밀번호를 설정해주세요.
수정 요청 메시지 보내기
받는 사람:
승인 완료 — 계정 안내 내용
아래 내용을 복사해서 지메일 등 사용하시는 메일로 직접 보내주세요.
받는 사람: