사내 개발 인프라
개발 안전 워크플로우
사내에서 사용하는 개발 안전 워크플로우입니다. 브레인스토밍 → 기술 설계 → 구현 계획 → 실행까지 각 단계마다 사람 확인 게이트가 박혀 있고, 요구사항·기술설계·구현계획 문서와 실제 코드가 자동으로 동기화됩니다. 변경 이력은 각 문서 footer 에 자동 누적되고, 위험한 코드 라인에는 표준 RISK 주석이 자동 부착되어 리뷰 시 위험 지점이 한눈에 보입니다. 독립된 task 는 서브에이전트가 동시 처리하므로 체감 시간이 ⅓~½ 로 줄어듭니다.
Features
핵심 기능
- 단계별 확인 게이트 — 위험 결정만 사람에게, 나머지는 자율 진행
- 문서 ↔ 코드 자동 동기화 — 변경 시 downstream 문서까지 자동 갱신
- 변경이력 자동 누적 — 모든 변경에 사유 · before/after 기록
- 위험 코드 라인 자동 표시 — side-effect · breaking · race 자가 점검
- 서브에이전트 병렬 처리 — 체감 시간 ⅓~½ 단축
- 사람 가독용 다크모드 문서 사본 자동 생성
- 자동 모드 지원 — 사람 입력 최소화한 완전 자율 흐름
Use cases
사용 사례
- 01
브레인스토밍부터 구현까지 한 흐름으로 진행하면서 단계별 사람 확인
- 02
요구사항 변경 시 기술설계·구현계획·코드까지 자동 동기화
- 03
독립된 task 를 서브에이전트가 동시 처리해 체감 시간 단축
For you
이런 분께 유용합니다
AI 보조 개발에서도 문서·코드 정합과 위험 가시화를 잃지 않고 싶은 팀
How it works
작동 방식
단계별 확인 게이트
Discovery → Design → Plan → Build머릿속 아이디어가 실제 코드가 되기까지, 단계 사이마다 확인 게이트에서 한 번 멈춥니다. AI 가 자동으로 다음 단계로 넘어가지 않습니다.
- STEP 1 · Discovery
/brainstorm요구사항.md＋요구사항.html - STEP 2 · Design
/design기술설계.md＋기술설계.html - STEP 3 · Plan
/write-plan구현계획.md＋구현계획.html - STEP 4 · Build
/execute-plan코드
.md— AI 가 읽는 원본 문서.html— 사람 검토용 사본 (자동 생성)
매 단계 자동 부착
사람 손이 안 가는 흔적 3종- AUTO-01사람 친화 .html 사본각 .md 옆에 검토용 시각화 사본을 자동 생성
- AUTO-02위험 주석 (RISK 3-checklist)side-effect / breaking / race 3 항목 자가 점검 후 코드 라인에 부착
- AUTO-03변경이력 footer 자동 누적이유 / 범위 / 영향을 CH-id 단위로 문서 footer 에 기록
서브에이전트 wave-parallel
DAG 자동 분석 → 단계 dispatch구현계획의 task 들을 무작정 한 번에 돌리지 않습니다. task 사이 의존그래프를 먼저 분석한 뒤, 의존이 없는 묶음끼리만 동시에 처리합니다. 충돌 없는 범위에서 최대 병렬.
- Wave 1의존 없음 — 동시T1T2
- Wave 2Wave 1 완료 후T3
- Wave 3Wave 2 완료 후 동시T4T5
일꾼 에이전트는 계획서 변경을 한 글자도 안 틀리게 복붙합니다. 자기 머리로 새 코드를 짓지 않고, 의심스러우면 즉시 멈춥니다. 막히면 조정자 에이전트가 먼저 복구를 시도하고, 그래도 안 되면 사람에게 올립니다.
Stack
기술 스택
Claude Code plugin한국어 UI32 skill (brainstorm / design / write-plan / execute-plan + auto-*)0 외부 의존성MD 3종(요구사항 · 기술설계 · 구현계획) + .html 다크모드 사본RISK 주석 표준 + 변경이력 footer