AI 에이전트는 넓은 범위의 구조 변경을 한 번에 제안하는 경향이 있습니다. 하지만 T2Editor처럼 코어와 플러그인, 보기 화면 스타일, 외부 서비스 연동이 얽힌 구조에서는 이 방식이 매우 위험합니다. 따라서 AI는 원칙적으로 “문서 확인 → 작은 수정 → 테스트 → 문서 갱신”의 반복 루프 안에서만 사용해야 합니다.
라이선스 정책, 외부 API 연동 주소, 업로드 보안, 삭제/권한 로직, XSS와 관련된 출력 정책은 AI 결과물을 그대로 반영하지 말고 반드시 사람이 최종 검토해야 합니다.
AI가 문서를 수정할 때도 코드처럼 검수가 필요합니다. 문체가 기계적으로 흐르지 않는지, 실제 확인하지 않은 사실을 단정하지 않는지, 외부 링크가 실제 열리는지까지 사람이 다시 확인해야 합니다.
AI 에이전트는 넓은 범위의 구조 변경을 한 번에 제안하는 경향이 있습니다. 하지만 T2Editor처럼 코어와 플러그인, 보기 화면 스타일, 외부 서비스 연동이 얽힌 구조에서는 이 방식이 매우 위험합니다. 따라서 AI는 원칙적으로 “문서 확인 → 작은 수정 → 테스트 → 문서 갱신”의 반복 루프 안에서만 사용해야 합니다.
라이선스 정책, 외부 API 연동 주소, 업로드 보안, 삭제/권한 로직, XSS와 관련된 출력 정책은 AI 결과물을 그대로 반영하지 말고 반드시 사람이 최종 검토해야 합니다.
AI가 문서를 수정할 때도 코드처럼 검수가 필요합니다. 문체가 기계적으로 흐르지 않는지, 실제 확인하지 않은 사실을 단정하지 않는지, 외부 링크가 실제 열리는지까지 사람이 다시 확인해야 합니다.
| 이전 | 새 버전 | ||
|---|---|---|---|
| 1 | --- | 1 | --- |
| 2 | title: AI agent 작업 규칙 | 2 | title: AI agent 작업 규칙 |
| 3 | document_id: 68-ai-agent-work-rules | 3 | document_id: 68-ai-agent-work-rules |
| 4 | slug: 68-ai-agent-work-rules | 4 | slug: 68-ai-agent-work-rules |
| 5 | target_editor_version: 9.0.0 | 5 | target_editor_version: 9.0.0 |
| 6 | document_type: maintenance | 6 | document_type: maintenance |
| 7 | doc_type: maintenance | 7 | doc_type: maintenance |
| 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] | 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] |
| 9 | importance: High | 9 | importance: High |
| 10 | dependency: Medium | 10 | dependency: Medium |
| 11 | core_type: Maintenance | 11 | core_type: Maintenance |
| 12 | stability: [Version-Bound] | 12 | stability: [Version-Bound] |
| 13 | stable_anchor: [] | 13 | stable_anchor: [] |
| 14 | version_bound: [] | 14 | version_bound: [] |
| 15 | related_docs: [] | 15 | related_docs: [] |
| 16 | related_files: [] | 16 | related_files: [] |
| 17 | related_functions: [] | 17 | related_functions: [] |
| 18 | related_classes_modules: [] | 18 | related_classes_modules: [] |
| 19 | related_features: [] | 19 | related_features: [] |
| 20 | related_ui: [] | 20 | related_ui: [] |
| 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. | 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. |
| 22 | reading_order: 28 | 22 | reading_order: 28 |
| 23 | summary: AI 에이전트가 T2Editor를 수정할 때 따라야 할 규칙을 정리 문서 | 23 | summary: AI 에이전트가 T2Editor를 수정할 때 따라야 할 규칙을 정리 문서 |
| 24 | description: AI 에이전트가 T2Editor를 수정할 때 따라야 할 규칙을 정리 | 24 | description: AI 에이전트가 T2Editor를 수정할 때 따라야 할 규칙을 정리 |
| 25 | tags: [AI, agent, rules] | 25 | tags: [AI, agent, rules] |
| 26 | version_tag: 9.0.0 | 26 | version_tag: 9.0.0 |
| 27 | maintenance_difficulty: Medium | 27 | maintenance_difficulty: Medium |
| 28 | test_requirement: Medium | 28 | test_requirement: Medium |
| 29 | ai_agent_risk: Medium | 29 | ai_agent_risk: Medium |
| 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] | 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] |
| 31 | beginner_section_included: true | 31 | beginner_section_included: true |
| 32 | webmaster_section_included: true | 32 | webmaster_section_included: true |
| 33 | developer_section_included: true | 33 | developer_section_included: true |
| 34 | --- | 34 | --- |
| 35 | ## AI 에이전트 작업 수칙 | 35 | ## AI 에이전트 작업 수칙 |
| 36 | 36 | ||
| 37 | - **문서 우선 읽기**: 코드를 수정하기 전에 반드시 관련 문서를 읽어 구조와 의존성을 파악합니다. | 37 | - **문서 우선 읽기**: 코드를 수정하기 전에 반드시 관련 문서를 읽어 구조와 의존성을 파악합니다. |
| 38 | - **안정성 확인**: Stable Anchor로 지정된 부분을 우선적으로 활용하고, Version-Bound 영역은 신중하게 접근합니다. | 38 | - **안정성 확인**: Stable Anchor로 지정된 부분을 우선적으로 활용하고, Version-Bound 영역은 신중하게 접근합니다. |
| 39 | - **테스트 필수**: 변경 사항을 테스트 환경에서 실행하여 문제를 확인한 후 배포합니다. | 39 | - **테스트 필수**: 변경 사항을 테스트 환경에서 실행하여 문제를 확인한 후 배포합니다. |
| 40 | - **외부 의존성 준수**: dsclub.kr API와 같은 외부 서비스 호출 부분은 임의로 제거하거나 변경하지 말고, 공식 문서를 참고하여 수정합니다. | 40 | - **외부 의존성 준수**: dsclub.kr API와 같은 외부 서비스 호출 부분은 임의로 제거하거나 변경하지 말고, 공식 문서를 참고하여 수정합니다. |
| 41 | 41 | ||
| 42 | ## AI 작업이 특히 위험한 구간 | 42 | ## AI 작업이 특히 위험한 구간 |
| 43 | 43 | ||
| 44 | AI 에이전트는 넓은 범위의 구조 변경을 한 번에 제안하는 경향이 있습니다. 하지만 T2Editor처럼 코어와 플러그인, 보기 화면 스타일, 외부 서비스 연동이 얽힌 구조에서는 이 방식이 매우 위험합니다. 따라서 AI는 원칙적으로 “문서 확인 → 작은 수정 → 테스트 → 문서 갱신”의 반복 루프 안에서만 사용해야 합니다. | 44 | AI 에이전트는 넓은 범위의 구조 변경을 한 번에 제안하는 경향이 있습니다. 하지만 T2Editor처럼 코어와 플러그인, 보기 화면 스타일, 외부 서비스 연동이 얽힌 구조에서는 이 방식이 매우 위험합니다. 따라서 AI는 원칙적으로 “문서 확인 → 작은 수정 → 테스트 → 문서 갱신”의 반복 루프 안에서만 사용해야 합니다. |
| 45 | 45 | ||
| 46 | ## 사람이 반드시 검토해야 하는 항목 | 46 | ## 사람이 반드시 검토해야 하는 항목 |
| 47 | 47 | ||
| 48 | 라이선스 정책, 외부 API 연동 주소, 업로드 보안, 삭제/권한 로직, XSS와 관련된 출력 정책은 AI 결과물을 그대로 반영하지 말고 반드시 사람이 최종 검토해야 합니다. | 48 | 라이선스 정책, 외부 API 연동 주소, 업로드 보안, 삭제/권한 로직, XSS와 관련된 출력 정책은 AI 결과물을 그대로 반영하지 말고 반드시 사람이 최종 검토해야 합니다. |
| 49 | 49 | ||
| 50 | 50 | ||
| 51 | ## 문체와 사실 검수 규칙 | 51 | ## 문체와 사실 검수 규칙 |
| 52 | 52 | ||
| 53 | AI가 문서를 수정할 때도 코드처럼 검수가 필요합니다. 문체가 기계적으로 흐르지 않는지, 실제 확인하지 않은 사실을 단정하지 않는지, 외부 링크가 실제 열리는지까지 사람이 다시 확인해야 합니다. | 53 | AI가 문서를 수정할 때도 코드처럼 검수가 필요합니다. 문체가 기계적으로 흐르지 않는지, 실제 확인하지 않은 사실을 단정하지 않는지, 외부 링크가 실제 열리는지까지 사람이 다시 확인해야 합니다. |
| 54 | 54 | ||