Neckbeard는 앱을 검토 가능한 클라우드 인프라로 바꾼다

Neckbeard는 코딩 에이전트가 앱을 분석해 검토 가능한 클라우드 인프라와 월간 비용 추정치를 만들도록 돕는 플러그인이다. AWS·GCP·Azure와 GitHub Actions·GitLab CI를 지원하며, 제품은 현재 배포 전 인프라 생성과 검증까지를 제공하는 프리알파 단계다.

Claude Code에서는 아래 두 명령을 각각 실행해 설치한 뒤, 앱 저장소에서 /neckbeard:analyze를 실행한다. 첫 /neckbeard: 명령이 플러그인이 사용하는 neckbeard CLI를 설치한다. 릴리스 바이너리는 SHA-256으로 검증하며, Go가 있으면 go install을 사용한다. 비용 추정과 정적 검증에는 Infracost, OpenTofu, Checkov 등이 쓰일 수 있다. /neckbeard:doctor는 필요한 도구와 각 도구가 제공하는 기능을 알려준다.

/plugin marketplace add bealesh/neckbeard
/plugin install neckbeard@neckbeard

Codex, Cursor 또는 SKILL.md를 지원하는 에이전트에서는 설치 안내를 따른다.

/neckbeard:analyze는 저장소를 근거가 포함된 app-profile.yaml로 정리하고, 답이 필요한 질문을 한 뒤 neckbeard.yaml을 제안한다. /neckbeard:estimate는 모듈 카탈로그를 바탕으로 환경별 월 비용의 낮음·예상·높음 시나리오와 사용량 가정, 가격을 산정하지 못한 리소스를 보여준다. serverless vs kubernetes처럼 비교 조건을 지정할 수도 있다. /neckbeard:sync는 계획·비용 추정·파일 생성·검증을 진행하며, 기존 사용자의 편집 내용을 말없이 덮어쓰지 않는다는 소유권 규칙을 둔다. 결과는 PASSED, FAILED, NOT EXERCISED로 표시된다.

제작자가 제시한 동일한 기준 앱(HTTP 서비스, 작업자, 크론 작업, Postgres)을 가장 작은 티어로 구성한 월 비용은 다음과 같다. 가격은 Infracost의 실시간 가격을 사용했다.

• Infracost는 Container Apps 컴퓨팅 비용을 아직 산정하지 못한다. Neckbeard는 이를 낮은 추정치로 감추지 않고, 가격을 산정하지 못한 리소스를 보고서에 표시한다고 설명한다. 보고서에는 유휴 상태 기준 비용, 사용자가 수정할 수 있는 사용량 가정, 낮음·예상·높음 시나리오와 비용 출처 정보도 담긴다.

Neckbeard는 사람이 버전 관리되는 OpenTofu 모듈과 파이프라인 템플릿을 관리하고, 에이전트는 앱을 분석해 카탈로그 입력값을 정하고 설명하는 방식으로 역할을 나눈다. 계획기는 해시 검증된 blueprint.yaml 잠금 파일을 만들며, 같은 입력에는 같은 결과를 내도록 설계됐다. 카탈로그가 지원하지 않는 요구사항은 가장 가까운 모듈에 억지로 끼워 맞추는 대신 별도 항목으로 표시한다.

생성되는 구성에는 개발·스테이징·운영 환경별 독립 상태, 클라우드마다 서버리스 컨테이너 또는 Kubernetes 선택지, GitHub Actions 또는 GitLab CI 파이프라인이 포함된다. 네트워크는 기본적으로 비공개로 설정하고, CI에는 범위를 제한한 ID와 OIDC 페더레이션을 사용한다. 정적 클라우드 키를 두지 않으며, 비밀 값은 사용자가 직접 입력하고 Neckbeard나 상태 파일, Git 기록에는 전달하지 않는다는 설명이다. 부트스트랩 안내서 docs/bootstrap.md는 상태 백엔드와 OIDC 신뢰 관계, CI ID 설정을 환경별로 안내한다. validate 이후 단계에는 사람이 참여해야 한다.

지원 대상은 기존 계정·프로젝트·구독에 배포하는 이미지 하나와 최대 10개의 HTTP·작업자·크론 프로세스, Postgres, 객체 저장소, 비밀 정보다. 그 밖의 요구사항은 unsupported로 표시한다.

검증 수준은 정적 검사(V0), 인증된 계획(V1), 배포 확인(V2)으로 구분한다. 정적 검증 통과가 실제 배포 가능성을 입증하지는 않는다. 저장소 설명에 따르면 12개 클라우드·버전 관리 시스템·런타임 조합의 정적 경로는 CI에서 검사하고, 서로 다른 세 개의 예제 앱을 처음부터 끝까지 적용했다. 실제 서버리스 배포·업데이트·롤백은 AWS와 GitHub, Azure와 GitHub에서 데이터베이스 확인을 포함해 통과했다. GCP 실배포와 GitLab 경로, Kubernetes, 승격 및 복구 훈련은 구현됐지만 아직 실행 검증되지 않았다. 배포 수명주기 기능은 실험적이며, 랜딩 존은 설계만 됐고 구현되지 않았다. 프로젝트는 현재 상태를 프리알파로 명시한다.

저장소와 상세 자료는 Neckbeard GitHub 저장소, 설계 문서, 실배포 근거, 검증 과정에서 확인한 문제, 출시 계획, 기여 안내에서 확인할 수 있다. 라이선스는 Apache-2.0이다.