충분히 유능하게는 Fabio Akita가 쓴 인공지능에 관한 오픈 북입니다. 이 책은 베테랑 프로그래머가 2026년 한 해 동안 AI 에이전트로 실제 소프트웨어를 만들고, 개인 벤치마크에서 수십 개의 모델을 평가하며, 실수와 수정 과정을 기록하고, 업계의 발표를 증거와 비교하는 과정을 따라갑니다.
이 저장소에는 책과 책을 유지 관리하는 데 사용되는 도구가 함께 들어 있습니다. 포르투갈어 또는 영어 미리보기 판을 읽거나, 완성된 형식을 다운로드하거나, 프로젝트의 Ruby 및 문서 처리 워크플로로 소스에서 직접 빌드할 수 있습니다.
프로젝트에 포함된 내용
이 책은 AI 때문에 불안하거나 확신이 서지 않는 독자를 위해 쓰였습니다. 여기에는 대체를 걱정하는 전문가, 인공 일반 지능에 대한 예측을 지켜보는 부모, “AI 전환” 제안을 듣는 관리자 등이 포함됩니다. 접근 방식은 홍보성보다는 실용적이고 증거 중심입니다.
자료는 다섯 개의 주요 파트로 나뉩니다.
- 파트 I: 도대체 이게 뭐지? AI가 지능적인지, AGI가 다가오고 있는지를 살펴봅니다.
- 파트 II: 마라톤. 인상적인 시연을 넘어 AI가 실제로 작동하는지 묻습니다.
- 파트 III: 숫자와 선전. 모델 비교와 발표 내용을 평가하는 방법을 탐구합니다.
- 파트 IV: 열쇠를 쥔 사람은 누구인가? AI 시스템이 개인 또는 운영 리소스에 접근하도록 허용할 때의 위험을 검토합니다.
- 파트 V: 내 일은 어떻게 되지? 고용에 대한 우려와 앞으로 가능한 대응을 다룹니다.
저장소에는 두 개의 막간, 기계가 내부적으로 작동하는 방식을 수학 없이 설명하는 선택형 부록, 타임라인, 실용적인 체크리스트, 144개 용어가 담긴 용어집, 292개의 참고 자료도 포함되어 있습니다.
책 다운로드 및 읽기
프로젝트를 사용하는 가장 간단한 방법은 릴리스를 다운로드하는 것입니다. 릴리스 페이지를 열고 최신 판을 선택하세요.
- 포르투갈어 또는 영어 판을 선택합니다.
- 사용 중인 기기에 적합한 형식을 선택합니다.
- 릴리스의 첨부 파일에서 파일을 다운로드합니다.
- 전자책 리더, PDF 뷰어 또는 원하는 독서 애플리케이션으로 파일을 엽니다.
제공되는 형식에는 전자책 리더용 Competente-o-Suficiente.epub, 화면 읽기용 Competente-o-Suficiente-ebook.pdf, 인쇄용 Competente-o-Suficiente.pdf가 있습니다. 영어 판은 Competent-Enough.epub, Competent-Enough-ebook.pdf, Competent-Enough.pdf와 같은 대응하는 이름을 사용합니다.
이 파일들은 미리보기 판입니다. 책은 계속 수정될 수 있으며, 저자가 작업을 최종본으로 선언할 때까지 새 버전이 나올 예정입니다.
빌드 환경 설정
소스에서 책을 빌드하려면 저장소를 복제하고 docs/DESIGN.md 및 LICENSE.md를 포함한 프로젝트 파일을 살펴보세요. README에는 필요한 시스템 의존성으로 Ruby, Java, poppler-utils가 명시되어 있습니다.
Ruby는 프로젝트 작업을 실행합니다. EPUB 출력을 검증하는 epubcheck에는 Java가 필요합니다. Poppler 유틸리티는 빌드 중 문서 관련 처리를 지원합니다.
이러한 의존성을 설치한 후 저장소의 작업 실행기를 사용해 고정된 도구 모음을 가져옵니다.
rake tools이 작업은 Pandoc 및 Typst가 포함된 Quarto와 epubcheck를 비롯해 문서화된 도구 모음을 준비합니다.
출판 형식 빌드
도구와 시스템 의존성을 사용할 수 있게 되면 다음을 실행합니다.
rake build빌드 결과로 build/pt/ 아래에 EPUB, PDF, 웹, DOCX 판이 생성됩니다. 또한 EPUB 검증과 페이지 감사를 실행해 생성된 출력물의 문제를 찾는 데 도움을 줍니다.
일반적인 워크플로는 다음과 같습니다.
- Ruby, Java,
poppler-utils를 설치합니다. rake tools를 실행해 고정된 프로젝트 도구 모음을 가져옵니다.- 소스 콘텐츠를 업데이트하거나 점검합니다.
rake build를 실행합니다.build/pt/에 생성된 파일을 검토하고 검증 또는 페이지 감사 문제를 해결합니다.
README에는 별도의 영어 출력 디렉터리가 설명되어 있지 않으므로 영어 소스로 작업할 때는 저장소의 현재 문서와 작업 설정을 따르세요.
블로그의 변경 사항 추적
이 저장소는 저자의 akitaonrails.com 게시물과 동기화된 상태를 유지하도록 설계되었습니다. 각 문단에는 해당 문단이 가져온 게시물이 기록되어 있습니다. 이를 통해 게시물이 변경되었을 때 검토가 필요할 수 있는 책의 내용을 식별할 수 있습니다.
변경 추적 검사는 다음 명령으로 실행합니다.
rake drift
이 명령은 블로그의 변경 사항으로 영향을 받는 장을 보고하고 관련 diff를 표시합니다. 릴리스 전에 또는 원본 게시물을 업데이트한 후 실행하면 어떤 부분을 수정해야 하는지 파악할 수 있습니다.
프로젝트의 제작 방식 이해
이 저장소는 책을 정적인 문서가 아니라 지속적으로 관리되는 출판물로 다룹니다. 다이어그램은 코드로 작성하고, AI가 생성한 일러스트는 이미지 크레딧에 공개하며, 실제 사진에는 라이선스를 표시합니다. 이 과정에 대한 자세한 내용은 docs/DESIGN.md에서 확인할 수 있습니다.
이 접근 방식은 텍스트의 출처, 생성된 에셋, 라이선스 정보를 분리하므로 프로젝트를 검토하거나 기여할 때 유용합니다. 빌드를 재배포하기 전에 LICENSE.md를 주의 깊게 읽으세요.
저장소 작업을 위한 고급 팁
읽을 때는 릴리스를, 유지 관리에는 소스를 사용하세요
일반적으로 독자는 이미 일반적인 형식에 맞게 패키징된 릴리스 에셋을 사용해야 합니다. 책이 만들어지는 과정을 살펴보거나, 빌드를 재현하거나, 블로그와 책 사이의 변경 사항을 조사해야 할 때는 소스 저장소를 사용하세요.
게시 전에 드리프트 검사를 실행하세요
문서 콘텐츠가 변경되었다면 rake build 전에 rake drift를 실행하세요. 이를 통해 오래되었을 가능성이 있는 장의 목록을 집중적으로 확인하고, 생성된 판본을 기반이 되는 문서와 일치하는 상태로 유지할 수 있습니다.
빌드 과정에 검증을 포함하세요
빌드 작업에는 epubcheck와 페이지 검사가 포함되어 있습니다. 특히 템플릿, 다이어그램 또는 문서 구조를 변경할 때는 이러한 검사를 선택 사항이 아닌 출판 과정의 일부로 간주하세요.
재사용 전에 라이선스를 검토하세요
책의 본문, 표지 및 삽화의 저작권은 Fabio Akita에게 있으며, 빌드 스크립트와 템플릿에는 MIT 라이선스가 적용됩니다. 글꼴, 인용 형식 및 사진에는 LICENSE.md에 별도로 명시된 라이선스가 적용될 수 있습니다. 저장소의 모든 파일에 동일한 재사용 조건이 적용된다고 가정하지 마세요.
결론
Competent Enough는 비판적인 AI 서적과 재현 가능한 출판 워크플로를 결합합니다. Releases에서 미리보기 판본을 다운로드하고, rake build로 제공되는 형식을 빌드하며, rake drift를 사용해 원본 문서의 변경으로 영향을 받는 콘텐츠를 확인할 수 있습니다. 이를 통해 AI에 관한 주장을 학습하는 동시에 장문의 기술 출판물이 어떻게 유지 관리되는지도 살펴볼 수 있습니다.