엔지니어링 노트: Claude와 만드는 방식
Maro Portal의 운영헌장과 작업 기록에서 가져온, Maro Portal과 Maro Writer를 만드는 실제 규칙입니다. Built with Claude.
누가 무엇을 하나
Maro Labs는 대표가 이끌고 여러 AI 작업자와 나란히 일합니다. 아래 역할 분담으로 Maro Portal과 Maro Writer를 매일 만듭니다.
Claude: 방향, 설계, 검토
중요한 일의 70% 이상을 Claude가 맡습니다. 방향 잡기, 설계, 기획, 핵심 검토입니다. Maro Writer는 Claude Code 세션에서 설계되었고, 두 앱 안에도 Claude가 연결되어 있습니다.
다른 AI 도구: 구현과 2차 검토
다른 모델, 주로 OpenAI Codex가 구현과 2차 검토를 맡습니다. 만드는 쪽과 검토하는 쪽을 따로 고르기 때문에, 변경을 만든 쪽이 유일한 검토자가 되지 않습니다.
Maro: 결정
Maro가 목표를 정하고, 되돌릴 수 없는 일을 승인하고, 최종 결정을 내립니다. 결정은 원래 문장 그대로 기록됩니다.
근거, 분석, 결론 순서
- 실물을 먼저 봅니다: 돌아가는 앱, 그 상태, 원본 기록.
- 확인된 사실과 의견·추론을 나눕니다.
- 위험과 대안을 따져 봅니다.
- 증명된 범위 안에서만 결론을 냅니다. PASS나 완료라는 말도 다시 재 보고, 확인하지 못한 것은 확인하지 못했다고 씁니다.
완료의 뜻
코드를 쓴 것은 완료가 아닙니다. 아래 일곱 가지가 모두 갖춰져야 완료입니다. 실행 중에 보여 주지 못한 것은 코드·단위 시험 통과, 실행 미확인으로 따로 적습니다.
- 구현
- 실행하거나 재현할 수 있는 검사
- 기능 검증
- 회귀 확인
- 증거 확보
- 기록 정정
- 남은 한계와 다음 위험의 정직한 보고
검토가 작동하는 방식
Maro Portal의 모든 작업은 마감 전에 별도 검토를 거칩니다. 검토자가 따르는 규칙입니다.
작성자와 검토자 분리
가능하면 변경을 만든 작업자가 그 변경을 검토하지 않습니다. 수치, 해시, 파일, 실행 상태는 보고를 믿지 않고 직접 대조합니다.
부분 통과는 부분 통과
여러 검토자의 결과는 같은 범위에 묶입니다. 부분 통과를 전체 통과로 올려 적지 않고, 조건부 통과의 메모를 지우지 않습니다.
영수증에 실제 모델을 적음
모든 검토·실행 영수증에는 실제 제공자와 모델, 역할, 어느 실행에서 나왔는지가 남습니다. 모델이 바뀌어도 이전 결과는 원래 출처를 그대로 유지합니다.
능력에 맞춘 검토 배정
검토 과업은 회사 이름이 아니라 모델이 실제로 할 수 있는 것(글 읽기, 화면 보기, 도구 실행)에 맞춰 배정합니다. 모델이 보지 못한 화면을 통과로 적지 않습니다.
판정 골라 받기 금지
제공자 쪽에서 판정 없이 실패하면(빈 응답, 연결 끊김, 한도, 시간 초과) 같은 입력을 다음 등록 검토자에게 넘깁니다. 판정이 하나라도 나왔다면 사람이 확인하기 전까지 그 판정이 유지됩니다.
현재 증거만 재사용
이전 검토는 파일 경로, SHA-256 해시, 범위가 모두 지금과 같을 때만 재사용합니다. 바뀐 파일과 그 영향 범위는 다시 읽습니다.
무엇이든 바꾸기 전 네 가지 질문
패치, 설치, 설정 변경, 삭제, 밖으로 보내기 전에 이 네 가지 답이 검토의 무게를 정합니다.
- 1
잘못되면 얼마나 나빠지나?
피해의 크기와 범위. 누구와 무엇이, 얼마나 오래.
- 2
되돌릴 수 있나?
실제로 쓸 수 있는 되돌림 방법이 있나. 이전 판, 사본, 복원 방법.
- 3
한 번 하면 끝인가?
가장 무거운 질문입니다. 그렇다면 한 번 더 멈추고 사본, 증거, Maro의 확인을 먼저 갖춥니다.
- 4
전체가 무거워지나, 가벼워지나?
새 검사, 규칙, 파일을 더하기 전에 빼거나 합치거나 고칠 것을 먼저 찾습니다.
작업을 잃지 않고 모델 바꾸기
목표, 범위, 현재 상태, 변경 파일과 해시, 시험 결과, 남은 지적, 인계 메모는 모델의 대화 세션이 아니라 Maro Portal의 작업 기록에 남습니다.
모델을 바꿨다고 작업을 다시 시작하거나 끝난 단계를 반복하지 않습니다. 이전 실행이 끝났거나 취소된 것을 확인한 뒤, 다음 안전한 단계에서 바꿉니다.
사용자가 고른 모델을 몰래 다른 모델로 바꾸지 않습니다. 이전 모델의 늦은 결과를 새 모델의 결과로 채택하지 않습니다.
월별 작업 폴더
| 2026년 7월 | 41 |
|---|---|
| 2026년 8월 | 51 |
| 2026년 9월 | 308 |
| 2026년 10월 1~12일 | 562 |
기록
- Maro Portal이 남긴 날짜별 작업 폴더 (2026년 7월 1일~10월 12일)
- 962
- 그중 검토 보고서
- 211
- 검토 이력이 있는 작업 (2026년 8월 20일 기준)
- 56
- 그중 두 번 이상 검토를 받은 작업 (최대 다섯 번)
- 24
규칙이 생긴 순서
- 2026년 7월 14일모든 Maro Portal 작업에 운영헌장 v1을 적용. CLAUDE.md 입구를 두어 모든 Claude 세션이 헌장을 먼저 읽게 함.
- 2026년 7월 17일헌장에 모델 독립을 명시. 외부 AI 모델은 별도 정체성이 아니라 바꿔 끼우는 부품.
- 2026년 8월 20일Codex가 쓴 장단점 패킷을 Claude가 읽기만으로 독립 재검토하고, 확인한 주장과 확인하지 못한 주장을 나눠 기록.
- 2026년 9월 13일구현 모델과 검토 모델을 각각 바꿔도 작업이 이어진다는 규칙 추가.
- 2026년 9월 27일Maro Writer를 Claude Code 세션에서 설계, 회귀 점검 309/309 통과.
- 2026년 9월 30일제공자 쪽 실패는 검토 기회를 쓰지 않고, 판정 골라 받기는 금지한다는 규칙 추가.
- 2026년 10월 12일무엇이든 바꾸기 전 네 가지 질문 규칙 추가. 작고 되돌릴 수 있는 변경은 빠르게, 되돌릴 수 없는 변경은 한 번 더 멈춤.