code-styleguides

# Code Styleguides Language-specific coding standards and best practices. ## How It Works Reads project-level styleguides from `conductor/code_styleguides/` (copied during `/conductor:setup` based on tech stack). ## Supported Languages | Language | Extensions | Styleguide File | |----------|------------|-----------------| | TypeScript | `.ts`, `.tsx`, `.mts`, `.cts` | `conductor/code_styleguides/typescript.md` | | Python | `.py`, `.pyi` | `conductor/code_styleguides/python.md` | | Go | `.go` | `conductor/code_styleguides/go.md` | | JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | `conductor/code_styleguides/javascript.md` | | HTML/CSS | `.html`, `.css`, `.scss`, `.sass` | `conductor/code_styleguides/html-css.md` | ## When to Activate Writing new code, reviewing code, refactoring, or setting up new files/modules. ## Universal Principles | Aspect | Guideline | |--------|-----------| | **Naming** | Descriptive, meaningful; clarity over brevity; consistency | | **Structure** | Single responsibility; max 3-4 nesting levels; group related code | | **Documentation** | Document "why" not "what"; keep updated; docstrings for public APIs | | **Errors** | Handle explicitly; fail fast with clear messages; never swallow | | **Testing** | Write alongside code (TDD); test behavior not implementation; high coverage on critical paths | ## Quick Reference | Setting | Recommendation | |---------|----------------| | Line length | 80-120 characters | | Indentation | 2 spaces (JS/TS), 4 spaces (Python), tabs (Go) | | Naming | Follow language conventions | | Imports | Organized and grouped | | Comments | Minimal, meaningful | ## Setup If styleguides missing: 1. Run `/conductor:setup` to initialize 2. Or copy from `templates/code-styleguides/` to `conductor/code_styleguides/` Check: `ls conductor/code_styleguides/` ## Integration Works with: **conductor-context** (project overrides), **tdd-workflow** (language test patterns)