python-scaffold

name	python-scaffold
description	Add Python VS Code workspace config to a project. Composable — works standalone or merges into existing .vscode/ from a prior kit scaffold.
argument-hint
allowed-tools	Bash, Write, Read, Glob, Grep

Purpose

Configure VS Code for Python development by creating or merging .vscode/settings.json and .vscode/extensions.json. Designed to compose with /mern-scaffold, /nean-scaffold, or /ios-scaffold — or run standalone for Python-only projects.

Template-first rule

Use files from templates/ as the source of truth for Python VS Code config.

Templates provide:

• VS Code workspace settings (interpreter path, pytest, Ruff, Black formatter)
• VS Code extension recommendations (Python, Pylance, Ruff, Black, mypy, coverage gutters)

What gets created or merged

<project>/
└── .vscode/
    ├── settings.json      # Python workspace settings (merged if exists)
    └── extensions.json    # Python extension recommendations (merged if exists)

Scaffold steps

1. Detect virtual environment location

• Check if .venv/ directory exists in the project root
• If not, check if venv/ directory exists