language-conventions

name	language-conventions
description	Language and project convention references for Python, TypeScript, and Terraform. Use when setting up new projects, reviewing code conventions, or ensuring consistency. Covers tooling, configs, patterns, testing, and project structure. Use when this capability is needed.
metadata	{"author":"dtsong"}

Language & Project Conventions

Convention references for consistent, opinionated project setup. Each reference provides inline configs, patterns, and gotchas learned from production use.

Language References

Language	File	Key Topics
Python	references/python.md	uv, ruff (88-char), ty, FastAPI, SQLAlchemy async, Pydantic, pytest
TypeScript	references/typescript.md	pnpm, Vitest, Prettier, Next.js App Router, Tailwind, shadcn/ui, React Query
Terraform	references/terraform.md	GCS/S3 backend, tflint, tfsec, modules, OIDC CI/CD

Project References

Topic	File	Key Topics
CLAUDE.md	references/project-claude-md.md	Project-level AI assistant config template
CODEMAP	references/codemap.md	Token-efficient codebase navigation doc
Memory System	references/memory-system.md	Three-layer persistent memory for AI sessions
PRD	references/prd.md	Product Requirements Document template
Developer CLI	references/developer-cli.md	Unified CLI pattern for developer tooling

Usage

These references are consumed by:

• /new-python, /new-typescript, /new-terraform scaffolding commands
• Direct reading during code reviews and convention discussions
• Council/Academy agents for project context

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.