Menu
Python coding best practices. Use when writing or reviewing Python code. Covers type hints, error handling, and common patterns.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Hybrid architecture combining Ralph's PRD format with Planning-with-Files' structured approach. Auto-generates PRDs from task descriptions, manages parallel story execution with dependency resolution, and provides context-filtered agents for efficient multi-story development.
Project-level multi-task orchestration system. Manages multiple hybrid:worktree features in parallel with dependency resolution, coordinated PRD generation, and unified merge workflow.
Implements Manus-style file-based planning for complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when starting complex multi-step tasks, research projects, or any task requiring >5 tool calls. Now with automatic session recovery after /clear and optional Git worktree mode.
Go coding best practices. Use when writing or reviewing Go code. Covers error handling, concurrency, and idiomatic patterns.
Java coding best practices. Use when writing or reviewing Java code (17+). Covers modern features, error handling, and patterns.
TypeScript/Node.js best practices. Use when writing or reviewing TypeScript code. Covers type safety, async patterns, and error handling.
| name | python-best-practices |
| description | Python coding best practices. Use when writing or reviewing Python code. Covers type hints, error handling, and common patterns. |
| license | MIT |
| metadata | {"author":"plan-cascade","version":"1.0.0"} |
| Rule | Guideline |
|---|---|
| Formatter | ruff format or black |
| Linter | ruff check with strict rules |
| Type hints | Always for public APIs |
| Docstrings | Google or NumPy style |
def process(items: list[str], max_count: int = 10) -> dict[str, int]: ...
def find_user(user_id: int) -> User | None: ...
| Rule | Guideline |
|---|---|
| Specific exceptions | Never bare except: |
| Context managers | Use with for resources |
| Early return | Validate inputs, fail fast |
# Good
try:
result = process(data)
except ValidationError as e:
logger.warning(f"Validation failed: {e}")
return default
src/package_name/
├── __init__.py
├── core/
└── py.typed
tests/
├── conftest.py
└── test_*.py
pyproject.toml
| Pattern | Usage |
|---|---|
@dataclass | Data containers |
@property | Computed attributes |
| Generators | Memory-efficient iteration |
functools.cache | Memoization |
| Avoid | Use Instead |
|---|---|
| Mutable default args | None default, create inside |
import * | Explicit imports |
| Global state | Dependency injection |
# Bad: def add(item, items=[]): ...
# Good:
def add(item, items=None):
items = items or []
items.append(item)
return items
| Tool | Purpose |
|---|---|
pytest | Testing |
ruff | Linting + formatting |
mypy | Type checking |
uv | Dependencies |