🚀 엔지니어 · 온보딩 · 프로젝트 다루기 · L01

devtools 설치

작성일자 2026-07-24  ·  수정일자 2026-07-24  ·  강의차수 L01  ·  예상소요 3분

목표 프로젝트 생애주기 에이전트가 든 standarda-devtools 를 홈에 clone 하고, 런처 디렉토리 개념과 사전 요건을 이해한다.

1. 무엇을 하나

standarda-devtools 는 프로젝트 생애주기 에이전트 모음이다. Claude Code 서브에이전트 3개가 들어 있다.

에이전트 하는 일
create-project cookiecutter standarda-template 로 새 Django 프로젝트 생성. 포트 할당·.memory symlink 포함
clone-repo 기존 git repo 를 표준 레이아웃(~/<slug>/src)으로 clone + venv·패키지 셋업
delete-project 프로젝트와 부수 자원(DB·포트·vhost·인증서·Route53·repo·메모리) 일괄 정리

에이전트는 프로젝트 레벨(.claude/agents/)이라, 이 repo 를 cwd 로 Claude Code 를 켤 때만 로드된다. 반면 결과물(새 프로젝트)은 이 디렉토리가 아니라 실행 유저의 홈($HOME) 에 생성된다.

런처(Claude Code 켜는 곳):  ~/standarda-devtools
결과물(생성되는 프로젝트):    ~/<slug>/src

즉 ~/standarda-devtools 에서 create-project 를 실행하면 프로젝트는 $HOME/<slug> 에 생긴다. 경로는 어디에도 하드코딩돼 있지 않고 실행 유저의 $HOME 에서 파생된다.


2. 받기

각 유저 홈에 1회 clone 한다. private repo 이므로 gh 인증(앞 강의)이 선행돼야 한다.

git clone https://github.com/popupstudio-ai/standarda-devtools.git ~/standarda-devtools

사전 요건(실행 유저 환경). 없으면 해당 에이전트가 BLOCKED 로 멈춘다.

  • cookiecutter: create-project 용. 현재 공용 venv /home/ubuntu/standarda/bin/cookiecutter 에 있음. PATH 에 없으면 create-project 가 BLOCKED: cookiecutter-missing.
  • gh 인증: gh auth status. repo 삭제까지 하려면 gh auth refresh -h github.com -s delete_repo(EL10 참조).
  • AWS 프로필 popup-chris: delete-project 의 Route53 정리용. 없으면 삭제 중 Route53 단계가 막힌다.
  • sudo: dev 도메인 vhost·인증서 조작. devteam 멤버는 풀 sudo 보유.
  • postgres 권한: devteam 은 superuser(DB 생성/삭제).

sudo·postgres·AWS 세부 정책은 팀 wiki 의 infrastructure/sudo-policy.md, infrastructure/server-environment.md 참조.


마무리

  • 핵심 정리: standarda-devtools 를 ~/standarda-devtools 에 clone 했다. 런처는 이 repo, 결과물은 ~/<slug>/src. 에이전트는 실행 유저 $HOME 기준으로 동작한다.
  • 다음 시간: create-project 로 프로젝트 생성.
이 강의를 학습하셨나요?