Merge pull request #86 from Miyamura80/chore/improve-agent-readiness

🏗️ improve agent readiness with skills and devcontainer

Author: Miyamura80

.claude/skills/code-quality.md

@@ -0,0 +1,19 @@
+# Code Quality Skill
+
+This skill provides instructions for running code quality checks and maintaining standards in the Python-Template project.
+
+## Commands
+
+Use the following `make` targets to ensure code quality:
+
+- `make fmt`: Runs the `ruff` formatter and formats JSON files.
+- `make ruff`: Runs the `ruff` linter to catch common errors and style issues.
+- `make vulture`: Searches for dead code across the project.
+- `make ty`: Runs the `ty` type checker to ensure type safety.
+- `make ci`: Runs all of the above checks (`ruff`, `vulture`, `import_lint`, `ty`, `docs_lint`, `check_deps`) in sequence.
+
+## Workflow
+
+1. **Before Committing**: Always run `make fmt` and `make ruff`.
+2. **Major Changes**: Run `make ci` to ensure no regressions in types or dead code.
+3. **Continuous Integration**: These checks are enforced in the CI pipeline. Ensure all pass before opening a PR.

.devcontainer/devcontainer.json

@@ -0,0 +1,33 @@
+{
+  "name": "Python-Template DevContainer",
+  "image": "mcr.microsoft.com/devcontainers/python:3.12-bookworm",
+  "features": {
+    "ghcr.io/devcontainers/features/common-utils:1": {
+      "configureZsh": true
+    }
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "charliermarsh.ruff",
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "tamasfe.even-better-toml",
+        "mkhl.direnv"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": ".venv/bin/python",
+        "python.testing.pytestEnabled": true,
+        "python.testing.pytestArgs": [
+          "tests"
+        ],
+        "[python]": {
+          "editor.formatOnSave": true,
+          "editor.defaultFormatter": "charliermarsh.ruff"
+        }
+      }
+    }
+  },
+  "postCreateCommand": "curl -LsSf https://astral.sh/uv/install.sh | sh && . $HOME/.cargo/env && make setup",
+  "remoteUser": "vscode"
+}