프로젝트 설정

프로젝트를 편하게 작업하기 위한 요소들 — 어떤 터미널을 열지, 각 터미널이 시작할 때 무엇을 실행할지, 어떤 에이전트를 어디에 배치할지 — 은 보통 한 사람의 머릿속에만 있는 지식입니다. 1DevTool은 이 지식을 저장소 안에 담아둘 수 있게 해줍니다.

.1devtool/ 폴더

프로젝트 설정은 저장소 루트에 있는 하나의 폴더입니다.

.1devtool/ tasks/ # one markdown file per task ... # project setup files

일반 텍스트이기 때문에 다른 파일과 마찬가지로 diff되고, 리뷰되고, 브랜치와 함께 이동합니다. 커밋해두면 저장소를 클론한 팀원도 여러분의 설정을 그대로 받게 되고, .gitignore에 추가하면 나만의 설정으로 남습니다.

편집하기

사이드바에 있는 프로젝트의 컨텍스트 메뉴에서 설정 편집기를 열 수 있습니다. 이 편집기는 파일을 그 자리에서 직접 수정하므로, 여기서 할 수 있는 모든 작업은 에디터에서 손으로 직접 해도 동일합니다.

시작 명령어

각 터미널은 열릴 때 실행되는 시작 명령어를 가질 수 있습니다 — npm run dev, docker compose up, SSH 터널, source .venv/bin/activate 같은 것들입니다.

여러 명령어로 이루어진 시퀀스도 지원되며, 이는 하나의 셸 라인으로 컴파일되어 Windows ConPTY에서도 정상적으로 동작하게 해줍니다. Windows에서는 WSL 명령어가 wsl -- bash -lc로 감싸집니다.

태스크는 브랜치와 함께 이동합니다

태스크는 .1devtool/tasks/ 아래에 있는 마크다운 파일입니다. 피처 브랜치는 자신만의 태스크를 가지고, 풀 리퀘스트에는 해당 브랜치가 추가한 태스크가 표시되며, git log를 보면 태스크가 언제 변경되었는지 알 수 있습니다. 자세한 내용은 Tasks 문서를 참고하세요.

공유할지, 로컬에만 둘지

공유된 설정을 그대로 사용하는 것은 무료입니다. 설정을 직접 작성하고 내보내는 것은 Pro 기능인데, 이는 팀이 자신들의 설정을 무료 플랜 사용자를 포함한 누구에게나 넘겨줄 수 있게 하려는 의도입니다.

여기에 담기지 않는 것

비밀 정보입니다. 값은 환경 변수 관리자를 사용하고, 평소처럼 .env는 저장소에서 제외하세요. 프로젝트 설정은 어떤 터미널을, 어떤 명령어를 쓰는지와 같은 구조를 설명할 뿐, 자격 증명을 담지 않습니다.

관련 문서

• 프로젝트 사이드바
• Tasks 개요
• 환경 변수