fly-conventions

name	fly-conventions
description	Development conventions and patterns for fly. JavaScript project with freeform commits.

Fly Conventions

Generated from drewsephski/fly on 2026-08-18

Overview

This skill teaches Claude the development patterns and conventions used in fly.

Tech Stack

• Primary Language: JavaScript
• Architecture: hybrid module organization
• Test Location: separate

When to Use This Skill

Activate this skill when:

• Making changes to this repository
• Adding new features following established patterns
• Writing tests that match project conventions
• Creating commits with proper message format

Commit Conventions

Follow these commit message conventions based on 1 analyzed commits.

Commit Style: Free-form Messages

Message Guidelines

• Average message length: ~50 characters
• Keep first line concise and descriptive
• Use imperative mood ("Add feature" not "Added feature")

Commit message example

Initialize Impeccable design context for portfolio

Architecture

Project Structure: Single Package

This project uses hybrid module organization.

Guidelines

• This project uses a hybrid organization
• Follow existing patterns when adding new code

Code Style

Language: JavaScript

Naming Conventions

Element	Convention
Files	kebab-case
Functions	camelCase
Classes	PascalCase
Constants	SCREAMING_SNAKE_CASE

Import Style: Relative Imports

Export Style: Named Exports

Preferred import style

// Use relative imports
import { Button } from '../components/Button'
import { useAuth } from './hooks/useAuth'

Preferred export style

// Use named exports
export function calculateTotal() { ... }
export const TAX_RATE = 0.1
export interface Order { ... }

Error Handling

Error Handling Style: Try-Catch Blocks

Standard error handling pattern

try {
  const result = await riskyOperation()
  return result
} catch (error) {
  console.error('Operation failed:', error)
  throw new Error('User-friendly message')
}

Best Practices

Based on analysis of the codebase, follow these practices:

Do

• Use kebab-case for file names
• Prefer named exports

Don't

• Don't deviate from established patterns without discussion

---

This skill was auto-generated by ECC Tools. Review and customize as needed for your team.