새로운 Rust 프로젝트마다 동일한 것들을 설정하는 것에 지쳤어요. Clippy 설정, CI 파이프라인, 링커 플래그, 프리커밋 훅, cargo-nextest... 매번 처음부터 시작해야 해요. 그리고 AI 코딩 도구를 바꿀 때마다 다시 해야 해요 — 프로젝트 구조를 다시 설명하고, 린트 규칙을, 허용되지 않는 것은 무엇인지를.
그래서 rust-2026-template를 만들었어요. "이 템플릿을 사용하세요"를 클릭하고, 당신의 에이전트를 그 위로 가리키면, 코딩을 하는 것이 아니라 구성을 하는 거예요.
여기 실제로 무엇이 들어있는지 알아요.
나는 항상 마지막에 얻게 되는 설정
Rust 2024 버전, MSRV 1.87을 rust-toolchain.toml을 통해 고정한 것. 워크스페이스 레이아웃은 첫 날부터 — 작은 프로젝트에도요. 단일 크레이트 프로젝트를 나중에 워크스페이스로 리팩토링하는 것은 필요 없는 고통이에요:
crates/
example-crate/
sample-app/
이름을 변경했어요.
하나의 스크립트, 전체 품질 게이트
./scripts/quality-gates.sh
이것은 fmt, clippy (엄격, 경고 없음), cargo nextest, cargo audit, cargo deny를 실행하고, 선택적으로cargo mutants. CI가 실행하는 것과 같은 일을 한다. 커밋 전에 항상 이를 실행하므로 예상치 못한 일은 없다.
유전자 변이 테스트와cargo-mutants그것은 사람들이 시도하도록 권하는 것입니다 — 테스트가 정말로밴드버그인가요 아니면 그냥터치코드. 매우 다른 일들입니다.
보안 기본값, 마지막 생각이 아님
-
deny.toml— 라이선스 정책 및 금지된 크레이트 -
.gitleaks.toml— 커밋 전 비밀 스캔 -
.pre-commit-config.yaml— 훅이 로컬에서 실행되며 CI에서만 실행되지 않음
목표는 이를 기억해야 하는 일이 없도록 하는 것입니다. 그냥 일어납니다.
AI 에이전트는 직접 작동합니다
이제 가장 많이 사용하는 부분입니다. 모든 AI 코딩 도구는 프로젝트 맥락이 필요하며, 그것들은 조금 다른 곳에 있고 싶어요. 세션마다 규칙을 다시 설명하기 대신, 모두 체크인됩니다:
.agents/ — skill definitions per agent
.claude/ — Claude Code config
.cursor/ — Cursor rules
.gemini/ — Gemini CLI config
.opencode/ — OpenCode config
.qwen/ — Qwen CLI config
.windsurf/ — Windsurf config
AGENTS.md — canonical project rules, read by every agent
llms.txt — machine-readable project overview
AGENTS.md는 주요 파일입니다. 모든 에이전트에게: 작업 공간 레이아웃, 린트 규칙, 커밋 관례, 절대 건드리지 마라는 것을 알려줍니다. 프로젝트 중간에 Claude Code에서 Codex로 OpenCode로 전환해도 모두 같은 규칙을 읽습니다. 다시 onboarding할 필요가 없습니다.
이 템플릿으로 새로운 프로젝트를 시작할 때, 당신은 레포지토리 URL을 직접 에이전트에게 컨텍스트로 전달할 수도 있습니다.
"이 프로젝트를 참조로 사용하세요 github.com/d-oit/rust-2026-template."
이것은 당신이 그것에 대해 단 한 번의 프롬프트도 작성하지 않고 구조, 도구 선택, 관례를 인식합니다.
당신이 추가하지 않은 성능 기본값
.cargo/config.toml는 mold 링커를 설정합니다. 한 줄로 눈에 띄게 빠른 점진적 빌드. 개발 프로파일은 "나의 디버그 빌드는 영원히 걸리는" 문제를 피하도록 조정되었습니다. 작은 일이지만, 프로젝트에 여섯 개월 있다고 해서 알게 될 것입니다.
를 사용하세요
- "이 템플릿을 사용하세요"를 GitHub에 적용하세요 — 또는 당신의 에이전트에게:
github.com/d-oit/rust-2026-template를 이 프로젝트의 참조로 사용하세요 QUICKSTART.md를 따르세요 — 크레이트를 다시 이름 붙이고,Cargo.toml./scripts/quality-gates.sh를 로컬에서 한 번 실행하세요
MIT 라이선스. PRs 환영 — Rust 프로젝트에 항상 추가하는 패턴이 있다면 이슈를 열어주세요.