메뉴
Set up the development environment for the project. Use when starting work on the project, when dependencies are out of sync, or to fix environment setup failures.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Build the project and automatically fix any build errors, compilation failures, or type mismatches. Use when the project fails to build, shows "broken" states, or after making significant changes.
Perform a "hard reset" of the development environment. Use when dependencies are corrupted, lockfiles are out of sync, or environment tools (Trunk/uv) are in an inconsistent state.
Fix a GitHub issue end-to-end. Use when given an issue number to fix, implementing bug fixes, or addressing reported problems.
Self-improvement skill for evolving Claude Code configuration. Use when you notice repeated mistakes, want to add new workflows, or optimize the development experience. Enables Claude to improve its own CLAUDE.md, skills, hooks, and agents.
Run linters and fix violations, formatting errors, or style mismatches using Trunk. Use when code quality checks fail, before submitting PRs, or to repair "broken" linting states.
Manage Architecture Decision Records (ADRs) using adr-tools. Use this to initialize, create, list, and link ADRs to document architectural evolution.
| name | setup-dev-env |
| description | Set up the development environment for the project. Use when starting work on the project, when dependencies are out of sync, or to fix environment setup failures. |
This skill automates the process of setting up the development environment to ensure all tools and dependencies are correctly installed and configured.
.python-versiontrunk installationuv installationmake setuptrunk install to fetch managed linters and formattersRead the .python-version file in the workspace root. Ensure the current Python environment matches this version. If there's a mismatch, inform the user to switch Python versions (e.g., using pyenv or asdf).
Check if trunk and uv are installed.
If not found, advise the user to install them. On macOS, use:
brew install trunk-io uv
Run the following command at the workspace root to install all project dependencies. Refer to ../common-references/python-commands.md for more commands.
make setup
This command runs dev/setup.sh, which installs uv if needed (via pip), creates a virtual environment, and syncs dependencies.
Trunk manages linters and formatters hermetically. Run the following command to ensure all required tools are downloaded and ready.
trunk install
trunk and uv are installed..python-version.To ensure the environment is fully operational:
verifier subagent (../../agents/verifier.md). This confirms that the freshly installed dependencies allow for a successful build, pass lint checks, and satisfy all unit tests.verifier fails, follow its reporting to resolve environment-specific issues.