<프로젝트>.subproject.kr로 이미 따로 배포한다).npm run dev # 빌드 후 http://127.0.0.1:4173
npm run check # 빌드 + 콘텐츠·노출·글자 크기 검사 (푸시 전)
npm run build, 출력 dist, 프로덕션 main, 미리보기 develop.src/data/projects.json이 프로젝트 목록의 정본이다. 항목 하나가 한 프로젝트이며 listed: false면 사이트에 나오지 않는다. 비공개 저장소(visibility: private)에는 repo 링크를 둘 수 없다(검사가 막는다).available(지금 쓸 수 있음), building(만드는 중), archived(개발 중단) 세 가지뿐이다. 이 밖의 상태를 늘리지 않는다.src/i18n/ko.json·en.json이 정본이고 두 파일의 키가 같아야 한다. 프로젝트 소개는 항목의 summary.ko·summary.en에 둔다. 한국어는 /, 영어는 /en/로 빌드 때 각각 HTML을 만든다(scripts/build.mjs).nameEn을 쓴다.src/static/은 그대로 dist/로 복사된다(CSS, 필터 스크립트, _headers, 파비콘). 외부 폰트·CDN 없이 로컬 자산만 쓴다.src/data/site.json의 email을 채우면 연락 구역에 나타난다.main은 프로덕션, develop은 통합·미리보기 브랜치다. 두 브랜치에 직접 커밋하지 않는다.develop에서 딴 작업 브랜치(feat/ fix/ docs/ chore/ + kebab-case)에서 하고, PR로 develop에 병합한다.develop → main PR로 한다.main·develop은 지우지 않는다.이 구역은 ysm-skills 베이스라인이 관리한다. 프로젝트 고유 규칙은 이 구역 밖에 쓰고, 충돌하면 프로젝트 규칙이 우선한다. 소통·판단·검증 같은 공통 진행 규칙은 전역 지침(ysm-global)이 맡는다.
README.md·AGENTS.md·CLAUDE.md·LICENSE·CHANGELOG.md처럼 관례상 필요한 파일만 두고, 기획·인수인계·결정 기록·가이드 같은 나머지 문서는 docs/에 둔다. 사용자가 폴더에 넣어 둔 입력 문서도 docs/로 옮긴다.audit-docs).CHANGELOG.md는 Added·Changed·Fixed·Removed로 나누고, 같은 주제는 한 줄로 합쳐 간결하게 쓴다.reset --hard는 사용자가 그 대화에서 직접 요청했을 때만 한다. 푸시 전 로컬 커밋의 amend·fixup 정리는 이력 재작성이 아니다. --no-verify로 훅을 우회하지 않는다.main이 아닌 작업 브랜치(feat/ fix/ docs/ chore/ + kebab-case)에서 한다. 프로젝트가 main 직행을 명시하면 예외다. 병렬 작업은 브랜치마다 git worktree로 분리한다.develop을 쓴다고 명시하면 작업 브랜치는 develop에서 따서 develop으로 병합하고(미리보기), main은 릴리즈로만 갱신한다(정식). 릴리즈 요청은 버전 결정·CHANGELOG·병합·태그·브랜치 정리·검증까지 전체이며(스킬 release-project), 병합 요청은 릴리즈를 뜻하지 않는다.<type>(<선택 scope>): <요약>이다. type은 feat fix perf refactor docs test build ci chore style revert, 72자 이내, 끝에 마침표 없음. 형식은 .githooks/commit-msg가 검사한다. 이유가 필요하면 본문에 쓴다. 제목 언어는 프로젝트가 정한다..githooks/pre-commit이 검사한다)..github/pull_request_template.md).Co-Authored-By: Claude …, 🤖 Generated with … 등)를 넣지 않는다. 커밋은 훅이 제거하지만 PR 본문은 직접 지킨다.main·develop 같은 장기 브랜치 제외). GitHub의 “Automatically delete head branches”는 켜지 않는다. 푸시·병합까지 요청받은 작업은 로컬과 원격이 일치하고 미커밋 변경이 없는 상태로 마친다.git config core.hooksPath .githooks를 실행한다(Claude Code는 세션 시작 때 자동 실행).tidy-code).package.json의 devDependencies와 npx.uv로 프로젝트 .venv만 쓴다(uv sync, uv add)..node-version, .python-version에만 고정한다. mise.toml은 두지 않는다..env, 키, 토큰, 개인정보, 개인 절대경로, 개인 취향·운영 데이터, 실제 업무 문서를 저장소에 넣거나 읽어 출력하지 않는다. 환경변수 예시는 값이 없는 .env.example만 둔다..githooks/pre-commit이 커밋을 막는다.permissions: contents: read로 시작하고 pull_request_target은 쓰지 않으며, 포크 PR 실행에 시크릿을 노출하지 않는다.