git:20260928.e34bd76 to git:20260930.32652e4

5 added, 5 removed. Audit A to A.

# 이 저장소를 사용하는 AI 에이전트의 작업 규칙

이 저장소는 코드 템플릿이 아니라 사회복지 현장 실무자가 앱을 만들기 전에 업무, 데이터, 윤리, 플랫폼, 운영 조건을 판단하도록 돕는 문서 모음입니다. 사용자는 보통 GitHub의 "Use this template"으로 이 저장소를 복사해 자기 앱 저장소로 삼거나, `skills/`의 스킬을 플러그인으로 설치해 자기 앱 폴더에서 씁니다. 어느 쪽이든 아래 규칙은 같습니다.

1. 먼저 `README.md`와 `starter/workflow.md`를 읽습니다. 두 문서는 빠뜨리지 말아야 할 판단 기준이며 고정된 질문 목록이 아닙니다. 플랫폼 선택보다 업무의 필요성과 영향을 먼저 살핍니다. 앱 저장소 루트에 채워진 `DECISION.md`가 있으면 판정이 끝난 앱이므로, `DECISION.md`와 연결된 `starter/rules/` 파일을 먼저 읽고 판정을 처음부터 다시 하지 않습니다. 앱의 목적이나 데이터가 바뀌었을 때만 그 부분을 다시 판정합니다.

2. 대화와 저장소에서 알 수 있는 내용은 다시 묻지 않고 합리적으로 추론합니다. 결과를 크게 바꿀 수 있는 정보가 빠져 있을 때만 질문하며, 질문 순서와 분석 방법은 상황에 맞게 정합니다.

- 3. 사용자의 목적, 현장에 관한 설명과 명시적인 결정이 일반적인 권장사항보다 우선합니다. 개인정보 보호, 법적 의무, 보안 또는 되돌리기 어려운 영향과 충돌하면 구체적인 근거와 대안을 설명하고 확인합니다.

- 4. 사용자의 상황에 해당하는 문서만 추가로 읽습니다. 여러 양식은 `starter/assess/form-audit.md`, 여러 앱과 중복 데이터는 `starter/data/ssot.md`, 사람을 기록하는 앱은 `starter/assess/ethics.md`, 기관 서식이 HWP 파일이면 `starter/requirements/hwp.md`를 적용합니다. 사용자가 HWP 양식 파일을 주며 앱을 만들자고 하면 `starter/assess/form-to-app.md`의 절차를 따르고, 양식의 칸을 그대로 데이터 항목으로 삼지 않습니다. Aside 같은 에이전트 브라우저로 정부 업무 시스템(희망이음 등)과 기관 앱·시트를 동기화하거나 자동 입력하려 하면 `starter/assess/screen-agent.md`, AI 기능(요약·초안·분류·추천)을 넣는 앱은 `starter/requirements/ai.md`, 메신저나 포털에 붙이는 기관 공용 AI 에이전트는 `starter/assess/agent.md`를 적용합니다. 나머지 조건별 문서는 `starter/workflow.md`의 안내를 따릅니다.

+ 3. 사용자의 목적, 현장에 관한 설명과 명시적인 결정이 일반 권장사항보다 우선합니다. 개인정보 보호, 법적 의무, 보안 또는 되돌리기 어려운 영향과 충돌하면 구체적인 근거와 대안을 설명하고 확인합니다.

+ 4. 사용자의 상황에 해당하는 문서만 추가로 읽습니다. 여러 양식은 `starter/assess/form-audit.md`, 여러 앱과 중복 데이터는 `starter/data/ssot.md`, 직원과 이용자를 기록하는 앱은 `starter/assess/ethics.md`, 기관 서식이 HWP 파일이면 `starter/requirements/hwp.md`를 적용합니다. 사용자가 HWP 양식 파일을 주며 앱을 만들자고 하면 `starter/assess/form-to-app.md`의 절차를 따르고, 양식의 칸을 그대로 데이터 항목으로 삼지 않습니다. Aside 같은 에이전트 브라우저로 정부 업무 시스템(희망이음 등)과 기관 앱·시트를 동기화하거나 자동 입력하려 하면 `starter/assess/screen-agent.md`, AI 기능(요약·초안·분류·추천)을 넣는 앱은 `starter/requirements/ai.md`, 메신저나 포털에 붙이는 기관 공용 AI 에이전트는 `starter/assess/agent.md`를 적용합니다. 나머지 조건별 문서는 `starter/workflow.md`의 안내를 따릅니다.

5. 사용자는 개발 지식이 없다고 가정하고, 전문용어가 처음 나오면 `starter/glossary.md`를 참고해 한 문장으로 설명합니다.

- 6. 실제 이용자의 개인정보를 대화나 에이전트 컨텍스트에 제공하도록 요구하지 않습니다.

+ 6. 실제 이용자의 개인정보를 대화나 에이전트 컨텍스트에 넣도록 요구하지 않습니다.

7. 판단 결과는 앱 저장소 루트의 `DECISION.md`에 기록합니다. `starter/templates/DECISION.md`를 복사해 사용합니다. 이 저장소를 템플릿으로 복사해 쓰고 있다면 그 저장소가 곧 앱 저장소입니다.

- 8. 판정이 끝나면 앱은 같은 저장소에서 만듭니다. 플러그인으로 쓰는 경우에는 먼저 `starter/`, `ops/`, `AGENTS.md`, `CLAUDE.md`를 앱 폴더로 복사해 같은 구조를 만든 뒤 아래를 적용합니다. `starter/`와 `ops/`(템플릿으로 복사했다면 `skills/`도)는 판단 근거와 운영 자료이므로 삭제하거나 앱 코드로 덮어쓰지 않습니다. 앱 코드는 `app/`처럼 별도 폴더에 두고(이미 있는 앱 코드는 옮기지 않습니다), 선택한 `starter/rules/` 파일과 `starter/rules/agentic.md`를 `CLAUDE.md`에는 `@starter/rules/파일명.md`로, `AGENTS.md`에는 읽으라는 문장으로 연결합니다. 앱 개발을 시작할 때 `README.md`는 `starter/templates/APP-README.md`를 바탕으로 앱 소개로 바꾸고(앱 소개가 이미 있으면 덧붙이고), 스타터 안내는 원본 저장소 링크로 대신합니다. `ops/`에서 앱마다 채우는 것은 `handover.md`와 `destruction-log.md`이고(N등급 앱은 `starter/templates/DECISION.md` 머리말의 예외를 따릅니다), 동의서와 처리방침 파일은 참고 양식이므로 앱마다 고쳐 쓰지 않고 기관이 실제로 쓰는 동의서와 처리방침의 위치를 `DECISION.md`에 적습니다. 다음 앱은 새 저장소(템플릿 복사)나 새 폴더(플러그인)에서 시작하고, 한 저장소에 앱을 두 개 만들지 않습니다.

+ 8. 판정이 끝나면 앱은 같은 저장소에서 만듭니다. 플러그인으로 쓰는 경우에는 먼저 `starter/`, `ops/`, `AGENTS.md`, `CLAUDE.md`를 앱 폴더로 복사해 같은 구조를 만든 뒤 아래를 적용합니다. `starter/`와 `ops/`(템플릿으로 복사했다면 `skills/`도)는 판단 근거와 운영 자료이므로 삭제하거나 앱 코드로 덮어쓰지 않습니다. 앱 코드는 `app/`처럼 별도 폴더에 두되 이미 있는 앱 코드는 옮기지 않습니다. 선택한 `starter/rules/` 파일과 `starter/rules/agentic.md`를 `CLAUDE.md`에는 `@starter/rules/파일명.md`로, `AGENTS.md`에는 읽으라는 문장으로 연결합니다. 앱 개발을 시작할 때 `README.md`는 `starter/templates/APP-README.md`를 바탕으로 앱 소개로 바꾸고, 스타터 안내는 원본 저장소 링크로 대신합니다. 앱 소개가 이미 있으면 바꾸지 않고 덧붙입니다. `ops/`에서 앱마다 채우는 것은 `handover.md`와 `destruction-log.md`입니다. N등급 앱은 `starter/templates/DECISION.md` 머리말의 예외를 따릅니다. 동의서와 처리방침 파일은 참고 양식이므로 앱마다 고쳐 쓰지 않고, 기관이 실제로 쓰는 동의서와 처리방침의 위치를 `DECISION.md`에 적습니다. 다음 앱은 새 저장소(템플릿 복사)나 새 폴더(플러그인)에서 시작하고, 한 저장소에 앱을 두 개 만들지 않습니다.

9. 가격, 한도, 서비스 정책처럼 바뀔 수 있는 정보는 인터넷에 접근할 수 있다면 해당 사업자의 공식 문서에서 최신 내용을 확인합니다.

- 10. 이 저장소의 문서를 사용하는 방법은 세 가지이고, 각각 시작 파일이 다릅니다. `CLAUDE.md`·`AGENTS.md`(폴더 안에서 실행하는 도구), `skills/welfare-app-assess/SKILL.md`와 `skills/hwp-form-app/SKILL.md`(플러그인으로 설치한 도구), `starter/chat-prompt.md`(채팅창에 붙이는 사람). 원본 저장소에서 규칙이나 `starter/workflow.md`를 고쳤다면 이 시작 파일들이 서로 어긋나지 않는지 확인하고, `starter/chat-prompt.md`는 머리말 아래에 `starter/workflow.md` 본문을 다시 붙여 새로 만듭니다. `starter/workflow.md` 맨 앞의 "꼭 지킬 것"은 본문과 다른 문서의 요지이므로, 그 원문을 고치면 이 블록도 어긋나지 않는지 확인합니다. 원본 저장소에서 판단 기준을 바꾸면 `CHANGELOG.md`에 버전 단위로 적습니다. 새 판단 문서가 생기거나 판정이 달라질 만큼 바뀌면 새 버전(1.2 → 1.3)을 열고, 그 사이의 보완은 지금 버전에 더하거나 기존 줄을 고칩니다. 문장 손질이나 오타 수정은 적지 않습니다. `plugin.json`, `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`의 `version`은 새 버전이면 앞 두 자리를(1.3.0), 보완이면 마지막 자리를(1.2.1) 올립니다. `README.md`의 "최근 바뀐 것"은 최근 3개 버전을 표로 요약합니다(버전, 바뀐 것, 이미 만든 앱에서 할 일). 파일 이름과 기술 용어를 그대로 써서 한 번 읽고 알 수 있게 합니다.

+ 10. 이 저장소의 문서를 사용하는 방법은 세 가지이고, 방법마다 시작 파일이 다릅니다. 폴더 안에서 실행하는 도구는 `CLAUDE.md`·`AGENTS.md`를, 플러그인으로 설치한 도구는 `skills/welfare-app-assess/SKILL.md`와 `skills/hwp-form-app/SKILL.md`를 먼저 읽고, 채팅으로 쓰는 사람은 `starter/chat-prompt.md`를 채팅창에 붙입니다. 원본 저장소에서 규칙이나 `starter/workflow.md`를 고쳤다면 이 시작 파일들이 서로 어긋나지 않는지 확인하고, `starter/chat-prompt.md`는 머리말 아래에 `starter/workflow.md` 본문을 다시 붙여 새로 만듭니다. `starter/workflow.md` 맨 앞의 "꼭 지킬 것"은 본문과 다른 문서의 요지이므로, 그 원문을 고치면 이 블록도 어긋나지 않는지 확인합니다. 원본 저장소에서 판단 기준을 바꾸면 `CHANGELOG.md`에 버전 단위로 적습니다. 새 판단 문서가 생기거나 판정이 달라질 만큼 바뀌면 새 버전(1.2 → 1.3)을 열고, 그 사이의 보완은 지금 버전에 더하거나 기존 줄을 고칩니다. 문장 손질이나 오타 수정은 적지 않습니다. `plugin.json`, `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`의 `version`은 새 버전이면 앞 두 자리를(1.3.0), 보완이면 마지막 자리를(1.2.1) 올립니다. `README.md`의 "최근 바뀐 것"은 최근 3개 버전을 표로 요약합니다(버전, 바뀐 것, 이미 만든 앱에서 할 일). 파일 이름과 기술 용어를 그대로 써서 한 번 읽고 알 수 있게 합니다.