shareAI-lab/learn-claude-code

Bash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1

What it solves

이 프로젝트는 AI 에이전트를 위한 "harness"를 구축하기 위한 포괄적인 교육 프레임워크를 제공합니다. 에이전시가 프롬프트 체이닝이나 노코드 워크플로우 빌더를 통해 만들어진다는 오해에 반박하며, 에이전시는 모델 자체의 속성이고, harness는 모델이 행동할 수 있게 하는 운영 환경(도구, 지식, 권한)이라고 주장합니다.

How it works

프로젝트는 단일하고 변하지 않는 "agent loop"를 기반으로 하는 20개의 점진적 레슨으로 구성됩니다. 각 레슨은 핵심 루프를 변경하지 않고 에이전트의 기능을 향상시키는 새로운 메커니즘을 도입합니다. 이러한 메커니즘에는 다음이 포함됩니다:

  • Tooling: bash, 파일 I/O 등 원자적이고 조합 가능한 도구 구현.
  • Context Management: 장시간 세션을 처리하기 위한 컨텍스트 압축 및 메모리 서브시스템 구현.
  • Task Orchestration: 의존성 그래프와 백그라운드 실행을 갖춘 작업 시스템 생성.
  • Collaboration: 비동기 메일박스와 공유 통신 프로토콜을 갖춘 에이전트 팀 설정.
  • Governance: 권한 경계와 승인 워크플로우 수립.
  • Integration: Model Context Protocol(MCP)을 사용해 외부 기능을 플러그인.

Who it’s for

이 프로젝트는 "harness 엔지니어"를 위해 설계되었습니다. 단순 프롬프트 엔지니어링을 넘어 특정 도메인(특히 소프트웨어 엔지니어링)에서 자율 AI 에이전트를 배포하기 위해 전문 수준의 인프라를 구축하고자 하는 개발자를 대상으로 합니다.

Highlights

  • Progressive Curriculum: 간단한 bash 지원 루프에서 포괄적인 에이전트 harness까지 20단계 학습 경로.
  • Harness-Centric Philosophy: 모델("운전사")에 지능을 넣으려 하기보다 운영 환경("차량")에 초점을 맞춥니다.
  • Concrete Implementations: 각 레슨에 실행 가능한 code.py 파일과 서술형 README 포함.
  • Architectural Patterns: 서브 에이전트 격리, 온디맨드 스킬 로딩, 워크트리 격리 패턴을 교육합니다.