1
28c4e5dc
2025.10.22
탄생
맨 처음 기록 — Claude Code 공통 설정(내 모든 프로젝트에 함께 적용되는 설정)을 처음 추가한 날
- 총괄 AI(오케스트레이터)의 행동 규칙을 적은 첫 문서 — 159줄
- 총괄 AI가 쓰던 두뇌 등급: sonnet — 당시엔 가벼운 등급 (지금은 가장 똑똑한 opus 등급)
- 외부 도구에 의존 — 문서를 찾아주는 Context7, 할 일을 관리하는 TaskManager (둘 다 'MCP'라 부르는 외부 연결 서버)
- AI 일꾼(에이전트) 6종: 설계 담당 architect, 버그 수정 bug-fixer, 코드 검토 reviewer, 테스트 작성 test-writer, 성능 담당 performance, 범용 담당 specialist
- 작업을 단계(Phase)로 나누지 않고 — 위에서 아래로 순서대로만 실행
b0db3d30
2025.12.07
문서 규칙 강화 — 전문 AI(specialist)에게 일을 시킬 때 파일이 어디 있는지 정확한 위치를 반드시 알려주도록
6ec297d8
2025.12.15
정점 35개
AI 일꾼이 35개까지 늘어남 — 역대 가장 많았던 때
보안(security)·성능(performance)·배포(devops)·문서(documentation)·UI 디자인(ui-ux-designer)·기획(product-specifier)까지, 필요 이상으로 마구 늘렸다
62cbed83
2025.12.16
첫 정리
AI 일꾼을 35개에서 21개로 줄임 — 첫 대규모 정리 (14개 삭제)
2
552a2674
2026.01.30
사고
설정을 다른 컴퓨터와 맞추다가(동기화) 총괄 AI 규칙 문서를 실수로 삭제
2월 10일에 되살렸다. 이 사고를 계기로 '중요한 정보는 파일 한 곳에만 두고 늘 거기서만 읽는다'는 원칙(파일이 유일한 진실의 원천)이 자리 잡았다.
8f0aa592
2026.02.11
패러다임 전환
작업 방식 재설계 — 외부 도구(Context7·TaskManager)를 버리고, 기억 저장소 claude-mem과 Claude Code에 원래 들어 있는 작업 관리 기능으로 교체
외부 연결 서버(MCP)에 대한 의존을 완전히 없앴다. 대신 컴퓨터 안의 파일을 정보의 유일한 출처로 삼았다.
3997522e
2026.02.11
단순화
AI 두뇌 등급 전략: 3등급(똑똑한 opus·중간 sonnet·가벼운 haiku)에서 2등급(opus·sonnet)으로 단순화
29f692b0
2026.02.11
핵심 원칙
정보 전달 방식 개선 — 전문 AI(specialist)들끼리 서로 정보가 끊기던 문제를 해결
파일이 유일한 진실의 원천 — 모두가 같은 파일 하나만 본다
외부 도구를 거치지 않고 파일을 직접 읽어서 넘긴다. 예를 들어 데이터베이스 설계 파일을 그대로 열어 정확한 표 구조(스키마)를 얻는다.
247949a1
2026.02.11
작업 1~4단계(Phase)에 걸친 대규모 개선 완료
6312307d
2026.02.11
품질 반복
품질검사(QA) 되먹임 고리 완성 — 발견한 문제를 담당 전문 AI에게 자동으로 연결해 고치게 함
307e983c
2026.02.12
보안 품질검사, 변경 이력(changelog) 기록, 여러 AI 동시 실행(병렬 디스패치) 규칙을 하나로 통합
4
51d3dd0b
2026.03.04
대청소
AI 일꾼과 총괄 AI 설정 대청소
- AI 일꾼(에이전트) 37개 → 12개 (-68%)
- 자동 검사 스크립트(훅) 15개 → 7개 (-53%)
- 설정 파일(settings.json) 754줄 → 143줄 (-81%)
de5dcd84
2026.03.06
동시 실행
팀형 총괄 AI에 '여러 AI 동시 실행' 방식 추가
화면 담당(frontend)과 서버 담당(backend) AI를 동시에 띄우고(spawn), 백그라운드에서 돌리며(run_in_background), 각자 별도 작업 폴더(worktree)에서 겹치지 않게 격리
715bf4e2
2026.03.06
격리
여러 프로젝트를 동시에 다룰 때 서로 섞이지 않게 분리 — 팀 이름(team_name)으로 구분
5
1464d935
2026.03.10
강제
웹 화면을 실제 브라우저로 테스트하도록 의무화
품질검사를 실제로 했다는 증거 파일(.qa-evidence.json)에 '브라우저 테스트를 실행함(browser_test.executed: true)'을 반드시 기록해야 한다. 코드가 빌드(컴파일)만 됐다고 합격 처리하면 '거짓 보고'로 본다.
9fe13788
2026.03.11
패러다임 전환
2.5단계(Phase 2.5) 도입 — 코드를 짜기 전에 무엇을 어떻게 테스트할지(품질검사 시나리오)를 먼저 확정
가장 중요한 변화.
- 테스트 계획 문서(docs/qa-test-plan.md)를 만들지 않으면 다음 구현 단계(3단계)로 넘어갈 수 없음
- 테스트 시나리오는 '무엇을 만들어달라'는 요구사항에서 뽑아낸다 (이미 짠 코드에 맞춰 만드는 것은 금지)
- 시나리오는 곧 코드가 반드시 통과해야 할 '약속(계약)'이다
466f7d82
2026.03.11
수정 반복
품질검사에서 실패하면 그 리포트를 바탕으로 자동으로 고치고 다시 검사하는 반복 과정 추가 (3·4단계)
실패 → 문제 리포트 뽑기 → 담당 전문 AI에게 전달(어느 시나리오인지 · 몇 번 실패했는지 · 기대한 결과와 실제 결과) → 수정 → 다시 품질검사
71fceacc
2026.03.11
세밀화
사람에게 도움을 넘기는(에스컬레이션) 기준을 '전체 작업 3번 실패'에서 '같은 시나리오 3번 실패'로 변경
어려운 버그 하나 때문에 프로젝트 전체가 멈추던 문제를 해결했다. 막힌 시나리오만 사람에게 넘기고, 나머지는 계속 자동으로 고친다.
e88d9808
2026.03.12
연동
품질검사만 전담하는 별도 지휘 AI(qa-orchestrator)를 이어 붙여 독립적으로 한 번 더 검사
마지막 5단계가 끝나면 '품질검사 전담 AI를 한 번 더 돌릴까요?'라고 반드시 묻는다. '예'를 고르면 독립적으로 다시 검증한다.