Matt-Dionis/nlad

NLAD는 개발자를 더 높은 수준의 추상화 (Abstraction) 단계로 격상시키는 애플리케이션 개발의 패러다임 전환을 나타냅니다. 대규모 언어 모델 (LLMs)을 활용함으로써, NLAD는 개발자가 어떻게 구축할 것인지에 대한 기술적인 구현 세부 사항보다는 무엇을 구축하고 싶은지에 집중할 수 있도록 합니다.

NLAD는 다음과 같은 방식을 통해 애플리케이션 개발을 변화시키는 것을 목표로 합니다:

추상화 수준 향상 (Raising the Abstraction Level): 애플리케이션 요구 사항, 설계 선택 및 기술적 결정을 자연어 (Natural Language)로 표현합니다.
구현 세부 사항 자동화 (Automating Implementation Details): 개발자가 비즈니스 로직 (Business Logic)과 사용자 경험 (User Experience)에 집중하는 동안, LLM이 하위 수준의 기술적 구현을 처리하도록 합니다.
설계와 개발의 가교 역할 (Bridging Design and Development): 자연어와 시각적 참조를 통해 UI/UX 결정을 개발 프로세스에 직접 통합합니다.
개발자 제어권 유지 (Maintaining Developer Control): 구현 세부 사항을 추상화하면서도, 개발자는 최종 결과물에 대한 완전한 제어권을 유지하며 필요에 따라 조정할 수 있습니다.

전통적인 애플리케이션 개발은 개발자에게 다음과 같은 사항을 요구합니다:

• 보일러플레이트 코드 (Boilerplate code) 작성
• 표준 패턴 (Standard patterns)의 수동 구현
• 기술적 통합 (Technical integrations) 처리
• UI 컴포넌트 라이브러리 관리
• 빌드 구성 (Build configurations) 처리
• 반복적인 테스트 작성

NLAD는 개발자가 다음과 같은 작업을 수행할 수 있게 함으로써 이러한 경험을 변화시킵니다:

고수준 의도 표현 (Express High-Level Intent): 기능과 동작을 자연어로 설명합니다.
기술적 세부 사항 자동화 (Automate Technical Details): LLM이 일상적인 구현 작업을 처리하도록 합니다.
사용자 경험에 집중 (Focus on User Experience): 사용자에게 중요한 것에 더 많은 시간을 할애합니다.
신속한 반복 (Iterate Rapidly): 애플리케이션을 빠르게 프로토타이핑 (Prototype)하고 개선합니다.
설계 통합 (Design Integration): 자연어와 시각적 참조를 통해 설계 선택을 지정합니다.
미래 지향적 개발 (Future-Proof Development): LLM의 능력이 향상됨에 따라 추상화 수준을 높일 수 있습니다.

• 애플리케이션 기능의 자연어 명세 (Natural language specification)

• 자연어 및 시각적 영감을 통한 디자인 통합

• 자동화된 기술 구현 제안

• API 및 프로토콜 통합 가이드

• 베스트 프랙티스 (Best practices)를 적용한 코드 생성

• 테스트 전략 권장 사항

강화된 디자인 역량 (Enhanced Design Capabilities)

• AI 기반 접근성 분석 (Accessibility analysis)

• 애니메이션 및 상호작용 명세

• 고급 반응형 동작 패턴 (Responsive behavior patterns)

강화된 추상화 (Enhanced Abstractions)

• 자연어를 통한 데이터베이스 스키마 (Database schema) 설계
• 설명을 통한 API 엔드포인트 (Endpoint) 생성
• 자동화된 상태 관리 (State management) 구현
• 보안 베스트 프랙티스 구현
• 성능 최적화 제안

NLAD는 다음과 같은 기능을 지원하는 Claude Projects 또는 유사한 LLM 플랫폼을 사용하여 구현하는 것이 가장 좋습니다:

• 문서 첨부 기능
• 대화 문맥 (Conversation context) 유지
• 풍부한 마크다운 (Markdown) 포맷팅
• 코드 구문 강조 (Syntax highlighting)

NLAD는 LLM에 세 가지 핵심 문서를 제공해야 합니다:

product_overview.md

• 구축할 애플리케이션/서비스에 대한 상세 설명

• 핵심 기능 및 기능성

• 비즈니스 요구사항 및 제약 조건

• 사용자 상호작용 흐름 (User interaction flows)

preferred_technologies.md

• 기술 스택 (Technology stack) 선택

• 프레임워크 선호도

• 아키텍처 (Architecture) 결정

• 개발 도구

design_specs.md

• 시각적 영감 레퍼런스
• 브랜드 및 스타일 가이드라인
• 컴포넌트 (Component) 명세
• 레이아웃 요구사항

LLM의 학습 데이터에 포함되지 않았을 수 있는 최신 기술, 프로토콜 또는 라이브러리의 경우, 추가적인 상세 문맥을 제공해야 합니다. 예시:

• 프로토콜 명세
• API 문서
• 구현 가이드
• 사용 가능한 도구 및 유틸리티

design_specs.md 파일은 자연어와 선택적인 시각적 영감을 통해 UI/UX 명세를 지원합니다. 개발자는 원하는 만큼 디자인 방향을 제공할 수 있으며, LLM은 명시되지 않은 세부 사항을 베스트 프랙티스와 문맥을 사용하여 채워 넣습니다.

선택적으로 최대 3개의 영감 이미지를 참조할 수 있습니다:

Style Reference (스타일 참조): 전반적인 미학(Aesthetic) 및 색상 팔레트 영감
Component Reference (컴포넌트 참조): UI 패턴 및 상호작용 요소
Brand Reference (브랜드 참조): 기존 브랜드 자료 또는 가이드라인

# Design Specifications (디자인 사양)
## Visual Inspiration (시각적 영감)
- style_reference.jpg: 원하는 미학을 가진 현대적인 인터페이스
...

"TalkShop"이라는 이름의 지역 비즈니스를 위한 대화형 인터페이스를 구축하고 싶습니다.
이 애플리케이션은 다음과 같은 기능을 수행합니다:
- 고객과 비즈니스 간의 자연어 상호작용(Natural language interactions)을 가능하게 합니다
...

- 타입 안정성(Type safety)과 개발자 경험(Developer experience)을 위한 TypeScript
- 웹 프레임워크를 위한 Next.js
- 스타일링을 위한 TailwindCSS
...

NLAD의 핵심 구성 요소는 사용 가능한 컨텍스트(Context)와 이를 사용하는 방법에 대해 LLM에 명확한 지침을 제공하는 것입니다. 이러한 지침은 간결하고 구체적이어야 합니다. 다음은 그 예시입니다:

당신에게는 다음과 같은 프로젝트 지식(Project knowledge)이 제공되며, 이를 광범위하게 활용해야 합니다:
- 'product_overview': 우리가 구축할 제품에 대한 개요
- 'preferred_technologies': 우리가 구축할 애플리케이션을 위한 선호 기술 스택(Tech stack)
...

이 지침 형식은:

• 제공된 모든 컨텍스트 파일(Context files)을 나열합니다
• 각 파일의 목적을 설명합니다
• LLM이 이 정보를 어떻게 사용해야 하는지에 대한 명확한 가이드를 제공합니다
• 상호작용 스타일에 대한 기대치를 설정합니다

NLAD는 프레임워크나 라이브러리가 아닌 방법론(Methodology)입니다. 이는 개발자와 LLM 간의 구조화된 상호작용으로 구성되며, 여기서 LLM은 지능적인 개발 어시스턴트(Development assistant) 역할을 합니다. 다음은 작업 흐름(Workflow)의 예시입니다:

개발자: "고객이 채팅 인터페이스를 통해 음식 배달 주문을 할 수 있도록 TalkShop에 GrubHub API를 통합해야 합니다."
NLAD 어시스턴트: "GrubHub 통합 구현을 도와드리겠습니다. 이를 다음과 같이 나누어 보겠습니다:
...

Natural Language Interactions (자연어 상호작용)

• 요구사항을 평이한 영어로 표현합니다

• 개발 어시스턴트와 대화를 유지합니다

• 대화를 통해 반복(Iterate)하고 개선합니다

Prompt Engineering Patterns (프롬프트 엔지니어링 패턴)

• 일반적인 개발 작업에 대한 구조화된 접근 방식

• 재사용 가능한 프롬프팅 (Prompting) 전략

• 제어력과 명확성을 유지하기 위한 모범 사례 (Best practices)

Technical Implementation Control (기술적 구현 제어)

• 제안된 구현 사항에 대한 완전한 가시성 확보

• 개발자가 코드 결정에 대한 제어권을 유지

• 기존 개발 워크플로 (Workflows)와의 통합

Testing and Validation (테스트 및 검증)

• 테스트 커버리지 (Test coverage) 및 검증에 대한 가이드
• 품질 보증 (Quality assurance)을 위한 모범 사례

TalkShop은 NLAD 원칙을 사용하여 개발된 애플리케이션의 예시입니다. 이는 복잡한 기능들이 자연어 상호작용을 통해 어떻게 구현될 수 있는지를 보여줍니다:

Developer: "고객이 지역 업체와 상호작용할 수 있는 채팅 기능을 구현해야 합니다. 채팅은 메뉴 탐색, 주문, 그리고 주문 상태 업데이트를 지원해야 합니다."
...

Developer: "대화 전반에 걸쳐 고객의 선호도와 과거 주문을 기억하는 시스템을 구현해야 합니다. 이 문제에 어떻게 접근해야 할까요?"
NLAD Assistant: "이 메모리 시스템에는 여러 구성 요소가 필요합니다:
...

NLAD 방법론에 대한 기여를 환영합니다! 여러분의 경험을 공유하거나, 개선 사항을 제안하거나, 문서 확장을 도와주세요. 자세한 내용은 Contributing Guide를 참조하십시오.

이 문서는 MIT License에 따라 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하십시오.

• GitHub Discussions - 방법론 논의 및 질문용
• GitHub Issues - 문서 개선 및 제안용

Built with ❤️ by the NLAD Community