--- schema_version: "1" id: 92b1554912ae19bd1acc34a13fcce2b9d71b350fd579e03e56890155ff3eeced title: 의도 - 가독성 collection: architect version: next locale: ko-kr portal_url: https://docs.salesforce.com/architect/next/ko-kr/well-architected-tools/guides/easy-readability.md canonical_url: https://staging.architect.salesforce.com/docs/architect/ko-kr/well-architected-tools/guide/easy-readability.html source_site: staging.architect.salesforce.com content_type: documentation content_hash: 0ee7c35dfcac5064dfc31127ac46d1a5270342ee01bd38ea2d143f52390094cc products: - 잘 설계된 도구 - Architect Site Content Repo --- # 의도 - 가독성 ### 설계 표준 패턴 자세히 알아보기 Well-Architected [Easy](/docs/architect/ko-kr/well-architected/guide/easy-overview) → [Intentional](/docs/architect/ko-kr/well-architected/guide/intentional) → [Readability](/docs/architect/ko-kr/well-architected/guide/intentional#가독성) → [Design Standards](/docs/architect/ko-kr/well-architected/guide/intentional#설계-표준) | 어디에서 찾을 수 있습니까?
제품 영역 \| 위치 | 좋은 모습은 무엇입니까?
패턴 | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Einstein \| 에이전트 | ✅ 에이전트의 언어 설정이 회사 어조와 일치하는 경우 회사 어조가 금융 기관과 같은 형식적인 경우 에이전트의 어조 설정은 "formal"입니다. 회사가 비공식적인 경우 어조 설정은 "Casual"입니다. 그렇지 않으면, 어조 설정이 "중립"입니다. | | Einstein \| 조직 | ✅ 프롬프트 템플릿은 서식을 활용하여 LLM에 컨텍스트를 제공하는 단일 해시를 사용하여 짧은 텍스트 블록을 프롬프트 템플릿 컨텍스트의 단일 단위로 표시합니다. | | Einstein \| 조직 | ✅ 프롬프트 템플릿은 일관된 쓰기 스타일을 사용합니다. 템플릿 전반에서 단어 선택 항목, 서식, 이모지, 문장 부호가 일관됩니다. | | Einstein \| 조직 | ✅ 프롬프트 템플릿은 간결하며 이해하고 자연어를 사용하기 쉽습니다. 템플릿은 산업 용어 또는 기술 용어를 피합니다. | | Einstein \| 조직 | ✅ 프롬프트 템플릿에 컨텍스트 및 지침이 명확하게 표시됩니다. 프롬프트에 컨텍스트를 제공한 후 ' 명령'이라는 텍스트와 함께 새 줄을 시작한 다음, 삼중 따옴표(""")로 묶은 명령을 따릅니다. | | 플랫폼 \| 비즈니스 | ✅ 승인된 AI 모델이 명확하게 식별되고 의도한 목적을 포함합니다. | | 플랫폼 \| 비즈니스 | ✅ 승인된 디자인 패턴을 사용 사례별로 쉽게 찾고 식별 | | 플랫폼 \| 비즈니스 | ✅ 팀은 작업을 완료하기 위해 사용할 도구(사용하지 않음)를 알고 있습니다. | | 플랫폼 \| 조직 | ✅ 코드 및 선언적 사용자 정의에 사용자가 읽을 수 있는 일관된 이름 | | 플랫폼 \| 조직 | ✅ 데이터 모델의 개체 및 필드에 일관되고 균일한 이름 | | 플랫폼 \| 조직 | ✅ 감사 시 보고서에서 필드가 일관되게 작성되고 참조되는 등 | ### 문서 패턴 에 대해 자세히 알아보기 Well-Architected [Easy](/docs/architect/ko-kr/well-architected/guide/easy-overview) → [Intentional](/docs/architect/ko-kr/well-architected/guide/intentional) → [Readability](/docs/architect/ko-kr/well-architected/guide/intentional#가독성) → [Documentation](/docs/architect/ko-kr/well-architected/guide/intentional#문서) | 어디에서 찾을 수 있습니까?
제품 영역 \| 위치 | 좋은 모습은 무엇입니까?
패턴 | | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Data 360 \| 문서 | ✅ 소스 시스템이 데이터 사전에서 재고됩니다 Data 360 데이터 소스는 소스 및 대상 시스템과 두 개 사이의 필드 매핑이 포함된 데이터 사전을 사용하여 솔루션 설계 프로세스에 문서화됩니다. | | 플랫폼 \| 비즈니스 | ✅ 모든 솔루션에 대한 비즈니스 기능 및 기술 구현 세부 사항에 대한 다이어그램이 있습니다. | | 플랫폼 \| 비즈니스 | ✅ 코드 및 선언적 사용자 정의에 대한 정보 로그가 있는 사람/시간/대상 키 | | 플랫폼 \| 비즈니스 | ✅ 관련 문서를 검색하고 찾을 수 있음 | | 플랫폼 \| 조직 | ✅ 코드 및 선언적 사용자 정의에 명확한 설명 | --- ### 설계 표준 안티 패턴 자세히 알아보기 Well-Architected [Easy](/docs/architect/ko-kr/well-architected/guide/easy-overview) → [Intentional](/docs/architect/ko-kr/well-architected/guide/intentional) → [Readability](/docs/architect/ko-kr/well-architected/guide/intentional#가독성) → [Design Standards](/docs/architect/ko-kr/well-architected/guide/intentional#설계-표준) | 어디에서 찾을 수 있습니까?
제품 영역 \| 위치 | 방지할 사항은 무엇입니까?
안티 패턴 | | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | Einstein \| 프롬프트 템플릿 | ⚡️ 프롬프트 템플릿은 간결한 자연어 대신 용어 및/또는 기술 용어를 사용합니다 프롬프트 템플릿에는 용어, 약어 및 기술 용어가 포함됩니다. | | 플랫폼 \| 비즈니스 | ⚡️ 승인된 AI 모델이 명확하게 식별되지 않으며 의도한 목적이 명확하지 않음 | | 플랫폼 \| 비즈니스 | ⚡️ 팀에서 다양한 도구를 사용하여 유사한 작업을 수행합니다. | | 플랫폼 \| 비즈니스 | ⚡️ 승인된 디자인 패턴이 없습니다. | | 플랫폼 \| 비즈니스 | ⚡️ 공급업체 또는 신입 직원이 온보딩하는 데 많은 시간이 소요됩니다. | | 플랫폼 \| 조직 | ⚡️ 코드 및 선언적 사용자 정의에는 이름이 일치하지 않습니다. | | 플랫폼 \| 조직 | ⚡️ 데이터 모델의 이름이 일관되지 않으며 많은 개체와 필드가 중복되는 것처럼 보입니다. | | 플랫폼 \| 조직 | ⚡️ 감사 시 사용되지 않는 필드 또는 다양한 사용 수준이 많이 표시되며, 보고에 일관된 링크가 없습니다. | ### 문서 안티 패턴 에 대해 자세히 알아보기 Well-Architected [Easy](/docs/architect/ko-kr/well-architected/guide/easy-overview) → [Intentional](/docs/architect/ko-kr/well-architected/guide/intentional) → [Readability](/docs/architect/ko-kr/well-architected/guide/intentional#가독성) → [Documentation](/docs/architect/ko-kr/well-architected/guide/intentional#문서) | 어디에서 찾을 수 있습니까?
제품 영역 \| 위치 | 방지할 사항은 무엇입니까?
안티 패턴 | | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Data 360 \| 조직 | ⚡️ 소스 대상 매핑은 데이터 매핑 캔버스에 문서화되어 있습니다. 데이터 소스 필드만 Data 360의 데이터 매핑 캔버스에서 구성하는 동안 즉시 데이터 모델 개체 필드에 매핑됩니다. | | 플랫폼 \| 비즈니스 | ⚡️ 솔루션을 찾기 어려우며 대부분의 팀에서 사용할 수 없는 이유 | | 플랫폼 \| 비즈니스 | ⚡️ 사용자가 작업 중인 솔루션 및 시스템을 이해하기 어려움 | | 플랫폼 \| 비즈니스 | ⚡️ 공급업체 또는 신입 직원이 온보딩하는 데 많은 시간이 소요됩니다. | | 플랫폼 \| 조직 | ⚡️ 코드 및 선언적 사용자 정의에는 설명이 없거나 이해하기 어려운 설명이 있거나 사용자 정의가 실제로 수행하는 작업과 일치하지 않는 설명이 있습니다. | ---