Pier_v1/README.md

전역 지침 공개용 꾸러미 — AI 업무 수행 지침 v0.3.01

이 꾸러미는 기술개발센터 CM기획팀이 운용해 온 AI 업무 수행 전역 지침을 다른 부서에서도 그대로 받아 쓸 수 있게 정리한 공개판입니다. 이 폴더는 생성 산출물입니다. 지침 파일을 직접 고치지 말고(부서가 채우는 값은 6.1), 개선 의견은 「9. 관리·개정」의 경로로 보내 주십시오.

1. 한눈에 보기

항목	내용
무엇인가	AI에게 업무를 맡길 때 매번 같은 순서와 같은 기준으로 일하게 만드는 작업 규칙 묶음입니다. 프롬프트 한 줄이 아니라 계획 → 실행 → 검증 → 기록까지의 절차를 정합니다.
누구를 위한 것인가	문서 작성·분석·검토·자료 정리·코드 작성에 AI를 쓰는 모든 부서
무엇이 들어 있나	상시 적용되는 코어 지침 1개 + 필요한 단계에서만 읽는 스킬 9종 + 프로젝트 폴더 골격 + 적용 배치
어디서 쓰나	Anthropic Claude(Cowork · Claude Code)가 주 사용 환경, Google Gemini(Antigravity)가 보조 환경입니다. 단, GPT 사용시 전역지침 위치를 Task 진행 전 명시해야합니다. 모든 환경에 같은 규범이 적용됩니다.
현재 버전	지침 v0.3.01 (2026-09-28). 운용하며 계속 개정 중인 0.x 판입니다.

2. 이 지침이 막아 주는 것

AI를 업무에 쓰다 보면 반복해서 겪는 문제가 있습니다. 조항마다 그 문제에 대한 대응이 들어 있습니다.

자주 겪는 문제	지침의 대응	조항
계획 없이 결과물부터 만들어 방향이 어긋난다	계획(Plan)을 먼저 제시하고 승인받은 뒤 실행	G1
그럴듯하지만 근거가 없는 답이 나온다	모든 수치·판단에 출처를 붙이고, 추정은 [추론], 없는 값은 [미확정]으로 표기	R4 · R5
"완료했습니다"라는데 파일이 없거나 구버전이다	종료 전 판정표로 검증하고, 파일의 실재·버전·핵심 내용을 대조	Step 3 · V9
같은 수정 지시를 여러 번 반복하게 된다	완료 기준을 착수 전에 정하고, 재작업이 하루 2회를 넘으면 방법 자체를 재검토	R7 · R8
고치다가 이전 판이 사라진다	버전을 올리지 않은 덮어쓰기 금지. 복사한 뒤 편집하고 구판은 backup/에 보관	F5
원본 엑셀·기준 파일이 망가진다	구조 변경 전 백업, 열·필드 중간 삽입 금지, 변경 후 지문 대조	F13
대화가 바뀌면 처음부터 다시 설명해야 한다	확정 사실을 프로젝트 메모리에, 작업 이력을 로그에 남겨 다음 세션이 이어받음	R6 · Step 5
AI가 중요한 판단까지 스스로 내린다	단계마다 결정 주체를 정하고, 규정 해석·원본 변경·대외 확정 등은 사람이 결정	G1-2
문서·웹페이지 속 문장을 지시로 받아들인다	외부에서 들어온 텍스트는 데이터로만 취급	F14
답해야 할 질문이 긴 응답 중간에 묻힌다	확인 요청은 응답 맨 끝 한 곳에 최대 3건	R10

3. 핵심 기능

3.1 여섯 단계 표준 프로세스

단계	하는 일
Step 0 컨텍스트 캡처	자료와 지시를 파악하고 착수 3줄(모집단 · 범위 · 종료조건)을 확정. 기존 메모리와 미해결 목록을 먼저 확인
Step 1 계획	방법, 단계별 작업, 완료 기준과 FAIL 조건, 위험 요소, 저장 경로를 제시
Step 2 실행	계획대로 수행. 결과물은 파일로 저장하고 화면에는 경로와 요지만 표시
Step 3 검증	V1~V16 체크리스트를 PASS / FAIL / N/A로 판정. 방법 · 모집단 · 표본 수를 함께 기재
Step 4 최종화	FAIL 항목 보정, 하지 못한 것과 확인하지 못한 것을 숨기지 않고 명시
Step 5 이관·로깅	얻은 컨텍스트를 메모리로, 작업 이력을 로그로 저장

3.2 업무 크기에 맞춘 경로와 진행 모드

• 경로 3종 — 여러 자료를 교차 분석하는 일은 COMPLEX, 여러 장으로 된 문건은 COMPLEX-DOC(목차 승인 뒤 장별로 작성), 단순 추출·변환은 SIMPLE(계획 단계 생략).
• 진행 모드 2종 — GATED는 단계마다 멈추고 승인을 받습니다. FAST는 승인 없이 끝까지 진행합니다. FAST에서도 검증(Step 3)과 기록(Step 5)은 생략되지 않습니다.
• 모드와 무관하게 반드시 멈추는 지점이 3곳 있습니다: 원본 파일을 파괴적으로 바꾸기 직전 / 지시가 모호하거나 자료가 모순될 때 / 재작업 상한에 도달했을 때.

3.3 자율성 등급 — 누가 결정하는가

등급	의미	예
HITL	AI는 초안까지, 최종 판단은 사람	규정 해석, 대외 배포본 확정, 원본 데이터 변경
HOTL	AI가 실행하고 사람이 감시	문건 작성, 분석, 코드 구현
HOOTL	AI가 끝까지 처리	조회 · 추출 · 변환 · 집계 등 되돌리기 쉬운 작업

등급은 AI가 제안하고 사용자가 확정합니다. 엄격하게 바꾸는 것은 AI가 스스로 할 수 있지만, 느슨하게 바꾸는 것은 사용자 승인이 필요합니다. 업무 규정의 해석, 원본 파일 구조 변경, 재작업 상한 후 방법 재선정, 대외 발행본 확정, 공유용 버전 승급의 다섯 가지는 항상 HITL입니다.

3.4 근거와 검증

• 수치와 판단에는 [출처: 문서명, p.XX] 형식의 근거가 붙습니다. 근거 자료는 프로젝트의 RAG/ 폴더에 넣어 둡니다.
• 외부 사실은 공식 1차 출처만 최종 근거로 인정하고, 확보하지 못하면 [확인 불가]로 남깁니다.
• 결과값을 맞추려는 역산 보정과 하드코딩을 금지합니다.
• 문건과 정량 결과는 만든 주체와 검증하는 주체를 분리합니다. 분리하지 못했으면 자기검증이라고 밝힙니다.
• 검증에 쓴 스크립트는 Code/에 보관합니다. 보관되지 않은 검증의 PASS는 인정하지 않습니다.

3.5 파일 · 버전 규칙

• 모든 문건은 Markdown으로 DOC/<유형>/에 저장합니다. 유형은 01_기획 · 02_분석 · 03_설계 · 04_실행 · 05_검증 · 06_보고서 · 99_기타 7종입니다.
• 파일명은 [유형]_[핵심주제]_[YYYY-MM-DD]_v[버전].md, 버전은 vMAJOR.MINOR.PATCH이며 최초 v0.1.00입니다.
• 모든 문건의 제목 아래에 변경 이력 표를 두고 행을 누적합니다.

3.6 안전 장치

• 원본 · 기준 파일의 구조를 바꾸기 전에는 예외 없이 백업합니다.
• API 키 · 비밀번호 · 토큰을 파일, 로그, 메모리에 평문으로 남기지 않습니다.
• temp와 backup 폴더는 근거로 읽지 않습니다. 폐기된 자료가 다시 근거로 쓰이는 것을 막습니다.
• 한 파일은 한 세션만 고칩니다.

3.7 여러 AI를 함께 쓸 때

• 하위 에이전트나 병렬 세션에 일을 나눠도 전체 책임과 최종 판정은 주 세션 하나가 집니다.
• 위임할 때는 목표 · 범위 · 근거 경로 · 완료 기준 · 금지 사항 · 예산을 모두 전달하고, 돌아온 결과는 주 세션이 다시 판정합니다.
• 착수할 때 도구 호출 예산을 선언하고, 1.5배를 넘으면 멈추고 방법을 재검토합니다.

4. 팀 공용 업무 수행 기능

이 지침은 한 프로젝트 폴더를 여러 사람과 여러 AI 세션이 함께 쓰는 상황을 전제로 만들어졌습니다. 개인용 프롬프트 모음과 가장 크게 다른 부분입니다.

기능	내용	조항
담당자별 작업 이력	모든 Task가 prompt/<담당자>/<날짜>/에 로그로 남습니다. 입력한 지시 원문, 수행 요약, 채택안과 기각안, 산출물 경로, 사용 모델, 완료 상태를 기록하므로 누가 무엇을 시켰고 어떤 판단으로 결과가 나왔는지 다른 사람이 추적할 수 있습니다.	F4 · F8 · Step 5
팀 공유 메모리	확정된 사실과 결정이 context-migration/에 주제별 파일로 쌓입니다. 한 사람이 확정한 내용을 다른 사람의 세션이 그대로 이어받아 같은 조사를 반복하지 않습니다.	G3 · R6
메모리 신선도	모든 메모리에 소유자 · 확정일 · 최근확인일 · 재확인 조건을 적고, 90일이 지난 메모리는 인용 전에 다시 확인합니다.	G3-4
미해결 항목 단일 창구	보류 · 확인 필요 항목을 OPEN_미해결목록.md 한 파일에 모읍니다. 매 Task 시작 때 확인하고 끝날 때 갱신합니다.	G3-2
정본 선언	같은 목적의 산출물이 여러 갈래로 나뉘면 어느 것이 현행본인지 메모리 1건으로 선언하고, 실험본은 하위 폴더로 격리합니다.	G3-1
병행 작업 충돌 방지	착수 때 최근 수정 파일을 확인하고, 병렬 작업은 파일 단위로 담당을 나눕니다. 공유 파일은 한쪽만 고칩니다.	G3-5
공통 폴더 · 파일명 · 버전	누가 만들어도 같은 위치에 같은 이름 규칙으로 저장됩니다.	F1 · F5 · F6
버전이 곧 공유 범위	세 번째 자리(PATCH)는 일반 수정, 두 번째 자리(MINOR)는 내부 공유 발행, 첫 번째 자리(MAJOR)는 외부 공유 발행입니다. 공유용 승급은 사람이 요청할 때만 이뤄집니다.	F5
여러 프로젝트 일괄 적용	적용 배치가 여러 프로젝트 폴더에 같은 지침을 한 번에 넣습니다. 기존 산출물과 로그는 지우지 않고, 적용 전에 메모리와 로그를 백업합니다.	적용 배치
실행환경 공용	Claude용 지침(.claude/)과 Antigravity용 사본(.agents/)이 실행환경 표기 등 허용된 3가지 차이 외에는 같은 내용으로 유지되어, 사람마다 쓰는 도구가 달라도 같은 규칙으로 일합니다.	지침 저장소(정본) · SECTION 6

5. 꾸러미 구성

공개용_프로젝트템플릿/
├── README.md                이 문서
├── 지침적용.bat              한 프로젝트에 적용
├── 일괄적용.bat              여러 프로젝트에 한 번에 적용
├── 대상목록.txt              일괄 적용 대상 목록 (부서에서 채움)
├── .claude/                 지침 — 코어 taskexecutionagent.md + skills/tea-* 9종 + CHANGELOG 등
├── .agents/                 Antigravity용 사본(rules) + 스킬(skills)
├── .hmcmkit/                HMCMkit — 코딩/개발 업무 전용 선택 자산
├── Cowork_런처스킬/          Cowork 계정 스킬 등록용 런처 9종 (선택)
├── DOC/ Code/ RAG/ prompt/ context-migration/    폴더별 규칙 README + 골격
└── temp/ backup/            읽기 제외 폴더

코어는 항상 적용되고, 스킬은 아래 시점에만 읽습니다. 지침 전체를 매번 읽지 않도록 나눈 구조입니다.

스킬	읽는 시점
tea-step-formats	Step 0 · 1 · 2 · 4 응답을 쓰기 직전, 진행 모드 · 자율성 등급 · 예산을 선언할 때
tea-doc-writing	여러 장으로 된 문건을 작성할 때
tea-verify	Step 3 검증을 시작할 때
tea-logging	Step 5 로그 · 메모리를 쓸 때, 담당자를 확정할 때
tea-versioning	파일명 · 버전 · 형식을 정할 때, 기존 산출물을 고치기 직전
tea-file-safety	원본 구조 변경, 경로 변경 · 이관, 병행 세션, 비밀정보, 외부 입력을 근거로 쓸 때
tea-orchestration	하위 에이전트 위임, 병렬 세션, 모델 · 플랫폼 전환, 예약 실행을 할 때
tea-design-ref	레이아웃 · 색 · 서체 등 디자인 판단이 필요할 때
tea-coding	코드를 작성 · 수정 · 검토할 때

6. 시작하기

적용 배치는 Windows 전용입니다. 순서는 ① 부서 값 채우기 → ② 프로젝트 폴더에 적용 → ③ AI 실행환경 연결 → ④ 첫 Task입니다.

6.1 먼저 채울 것 3가지

지침 파일(.claude/ · .agents/)은 고치지 않습니다. 아래 3가지만 부서가 채우는 값입니다.

채울 것	파일	내용
담당자 표	prompt/README.md의 「담당자 식별」 절 표	예시 행을 지우고 부서 담당자를 적습니다. 이름이 로그 폴더명이 됩니다.
디자인 지침 경로	context-migration/디자인지침_경로.md	부서(또는 회사) 디자인 지침 폴더의 경로를 적습니다. 디자인 지침이 없으면 없음이라고 적습니다.
일괄 적용 대상	대상목록.txt	프로젝트 폴더 경로를 한 줄에 하나씩 적습니다. 메모장에서 ANSI(CP949) 로 저장합니다. UTF-8로 저장하면 한글 경로가 깨집니다.

• 담당자 표와 디자인 지침 경로는 적용 전에 꾸러미 사본을 채워 두면 새로 적용하는 모든 프로젝트에 함께 들어갑니다.
• 이미 적용한 프로젝트에는 다시 들어가지 않습니다(보존 대상). 그 프로젝트 폴더의 파일을 직접 고칩니다.
• 새 판 꾸러미로 교체할 때는 채워 둔 이 3개 파일을 따로 보관했다가 새 꾸러미에 옮깁니다.

6.2 프로젝트 폴더에 적용

꾸러미 폴더에서 명령 프롬프트를 열고 실행합니다. 대상 폴더는 미리 만들어져 있어야 합니다. 지침적용.bat을 더블클릭하면 대상 경로를 묻습니다.

지침적용.bat "D:\내프로젝트" /L     미리보기 (실제로 쓰지 않음)
지침적용.bat "D:\내프로젝트"        적용
일괄적용.bat                        대상목록.txt 의 모든 폴더에 적용

• 실행하면 대상과 처리 방식을 보여 주고 Y/N 확인을 한 번 받습니다.
• 미리보기(/L)에서도 .claude 등은 [덮어씀]으로 표시되지만 실제로 쓰지는 않습니다.
• 탐색기 복사는 같은 이름의 파일을 건너뛰기 쉽고, robocopy /E만으로는 크기와 시각이 같은 파일이 갱신되지 않습니다. 배치를 쓰십시오.
• 배치는 대상 프로젝트의 산출물과 로그를 지우지 않습니다. 지우는 것은 스킬로 대체된 구판 지침 파일 2개(.agents\rules\coding-agent.md · orchestration.md)뿐입니다.
• 적용 직전에 context-migration/과 prompt/를 backup/<날짜>_지침적용전/에 보관합니다.
• 프로젝트가 자체 문서 폴더 구조를 쓰면 DOC\CONVENTION.md를 두고 무엇을 대체하는지 적어 두십시오. 그 파일이 있으면 유형 폴더 7종을 만들지 않습니다.

구분	대상	동작
[A] 덮어씀	.claude/ · .agents/ · .hmcmkit/(자산) · DOC Code RAG context-migration의 README.md	항상 최신본으로 교체
[B] 보존	prompt/README.md(담당자 표) · context-migration/OPEN_미해결목록.md · context-migration/디자인지침_경로.md · .hmcmkit/state.json · blueprint.md · config.json	이미 있으면 건드리지 않음
[C] 건드리지 않음	대상 프로젝트의 DOC/ 산출물 · prompt/ 로그 · Code/ 스크립트 · backup/ · temp/	삭제하지 않음

6.3 AI 실행환경에 지침 연결

환경	연결 방법
Claude Cowork (데스크톱 앱)	앱 설정의 전역 지침 입력란에 .claude/taskexecutionagent.md 전문을 붙여 넣고, 작업할 때 프로젝트 폴더를 연결합니다. 스킬은 프로젝트의 .claude/skills/에서 읽습니다. 스킬을 이름으로 호출하고 싶으면 Cowork_런처스킬/의 9종을 계정 스킬로 등록합니다(선택).
Claude Code	프로젝트 루트에서 실행합니다. .claude/skills/의 스킬은 그대로 인식됩니다. 코어는 프로젝트 루트의 CLAUDE.md에 @.claude/taskexecutionagent.md 한 줄을 넣어 불러옵니다. CLAUDE.md가 없으면 새로 만듭니다.
Antigravity	.agents/rules/taskexecutionagent.md가 상시 적용 규칙(trigger: always_on)으로 들어 있어 별도 설정이 없습니다.

• 지침 버전이 바뀌면 Cowork의 전역 지침 입력란도 새 코어로 다시 붙여 넣어야 합니다.
• 설정 메뉴의 위치와 스킬 등록 절차는 앱 버전에 따라 달라지므로 이 문서에 적지 않았습니다. 막히면 CM기획팀에 문의하십시오.

6.4 첫 Task 해 보기

참고 자료를 프로젝트의 RAG/ 폴더에 넣고 아래처럼 지시합니다. 담당자명을 함께 적는 것이 규칙입니다.

task: 3분기 점검 결과를 요약 보고서로 작성 (담당자: 홍길동)
전역지침(taskexecutionagent.md)를 준수하여 Task 진행할 것.

1. AI가 Step 0 결과(문서 개요, 착수 3줄, 복잡도, 진행 모드와 자율성 등급 제안)를 내고 맨 끝에서 확인을 요청합니다.
2. 답하면 계획(Step 1)을 제시합니다. 승인하면 실행합니다. 여러 장으로 된 문건이면 목차를 먼저 승인받고 장별로 작성합니다. 빨리 끝내려면 "승인 없이 진행"이라고 지시합니다(FAST).
3. 결과물은 DOC/06_보고서/에 저장되고 화면에는 경로와 요지만 나옵니다.
4. 검증 판정표가 나온 뒤, 로그가 prompt/홍길동/<날짜>/에, 메모리가 context-migration/에 저장됩니다.

7. 자주 보는 태그

태그	의미
→ STOP	이 단계가 끝났고 사용자의 진행 지시를 기다림
[CLARIFICATION NEEDED]	지시나 자료가 모호해 임의로 해석하지 않고 질문함
[CONFLICT DETECTED]	자료 사이에 모순이 있어 양쪽을 나란히 제시함
[CONTEXT OVERFLOW]	한 번에 처리하기 어려운 분량이라 분할 방식을 물음
→ PROCESS COMPLETE	Task 종료
[추론] · [미확정] · [확인 불가] · [판독 불가]	근거 없이 추정한 것 / 사람의 확정을 기다리는 것 / 공식 출처를 찾지 못한 것 / 원자료에서 읽을 수 없는 것

8. 알아둘 점과 한계

• 0.x 판입니다. 운용 결과에 따라 조항이 바뀝니다. 하위 에이전트 위임의 상한값(위임 깊이 3 · 재위임 1회 · 병렬 5 · 평가 루프 5회)은 실측 전 초기값이고, 코어–스킬 분할 구조는 운용 실측이 끝나지 않았습니다.
• 절차와 기록이 늘어납니다. 단순한 일은 SIMPLE 경로와 FAST 모드로 가볍게 처리하십시오.
• AI가 지침을 항상 빠짐없이 따르지는 않습니다. Step 3 판정표와 로그가 실제로 나왔는지 사람이 확인해야 합니다. "사람이 검토한다"는 선언만으로는 검토가 이뤄지지 않습니다.
• **조항 곳곳의 「사고 사례」**는 CM기획팀의 운용 기록에서 나온 것입니다. 조항이 왜 생겼는지를 보여 주는 근거라 그대로 두었습니다.
• 지침 파일 속 내부 참조 — .claude/README.md · CHANGELOG.md · 코어의 변경 이력에는 CM기획팀 저장소에만 있는 문서 · 스크립트 이름과 운용 실측 수치가 나옵니다. 그 파일들은 꾸러미에 없습니다.
• HMCMkit(.hmcmkit/과 .agents/skills/의 개발용 스킬)은 코딩/개발 업무에서만 선택적으로 쓰는 자산입니다. 문서 · 분석 업무에는 쓰이지 않습니다. HMCMkit 자체 설명서는 프로젝트 루트의 agents.md를 전제로 쓰여 있으나, 이 꾸러미에서는 .claude/agents.md에 있습니다. 일부 스킬에는 외부 공개 자료에서 가져온 내용과 그 출처 · 라이선스 표기가 들어 있으니, 회사 밖으로 다시 배포할 때는 그 표기를 유지하고 사용 조건을 확인하십시오.

공개판과 정본의 차이

공개판은 CM기획팀 정본 v0.3.01에서 스크립트로 생성했습니다. 조항 번호는 같고, 내용은 아래만 다릅니다. [F15]의 두 행은 규범 내용이 달라진 부분입니다.

항목	정본	공개판
[F15] 디자인 지침 경로	팀 내부 경로 고정	context-migration/디자인지침_경로.md에 부서별로 등재. 디자인 지침이 없는 부서는 없음으로 등재하고 [R8] 수용 기준으로 대신함
[F15] 참조 순서	정해진 파일 순서를 항상 적용	디자인 지침 폴더가 그 구조를 따를 때 적용. 구조가 다르면 그 폴더의 진입 문서를 따름
코어 머리말	—	「공개판」 표기 1행 추가
코어 변경 이력 v0.2.04 행	팀 폴더명 표기	「조직 디자인 지침」으로 문구 일반화
CHANGELOG.md [F11] 행의 실측 근거	팀 운영 실측 수치	「비밀정보 평문 저장·복제 사례」로 일반화
버전 표기 예시 파일명 (tea-versioning · DOC/README.md)	팀 산출물명	가상 명칭
담당자 표 (prompt/README.md)	팀 구성원 등재	예시 행 1개
적용 배치 (지침적용.bat)	prompt/README.md를 덮어씀	이미 있으면 보존. 디자인지침_경로.md 양식을 함께 배포
일괄 적용 대상 (대상목록.txt)	팀 프로젝트 목록	빈 양식
안내문 (README.md)	유지관리자용	이 문서
Antigravity 글로벌 스킬 경로	특정 PC 경로	%USERPROFILE% 기준 경로
추가 자료	—	Cowork_런처스킬/ 9종, 디자인지침_경로.md 양식

9. 관리 · 개정

• 관리 부서는 CM기획팀입니다. 정본은 CM기획팀 저장소 한 곳에만 있고, 이 꾸러미는 거기서 생성됩니다.
• 이 꾸러미의 지침 파일을 직접 고치면 다음 판을 적용할 때 덮어써집니다. 조항 개선 의견, 오류, 적용 사례는 CM기획팀으로 보내 주십시오.
• 부서 고유의 규칙은 프로젝트의 하위 지침이나 context-migration/ 메모리에 두십시오. 전역 지침과 충돌하면 전역 지침이 우선합니다.
• 새 판을 받으면 6.1의 3개 파일을 새 꾸러미로 옮긴 뒤 6.2의 배치를 다시 실행합니다. [B] · [C] 항목은 보존됩니다.