oh-my-customcode 0.1.4 → 0.2.0

package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript/type-system.md

@@ -1,219 +0,0 @@
-# TypeScript Type System
-
-> Reference for TypeScript type fundamentals
-
-## Basic Types
-
-```typescript
-// Primitives
-const name: string = 'TypeScript';
-const version: number = 5.0;
-const isActive: boolean = true;
-
-// Arrays
-const numbers: number[] = [1, 2, 3];
-const items: Array<string> = ['a', 'b', 'c'];
-
-// Tuples
-const pair: [string, number] = ['key', 42];
-
-// Enums
-enum Status {
-  Pending = 'pending',
-  Active = 'active',
-  Completed = 'completed',
-}
-
-// Any and Unknown
-const flexible: any = 'anything';
-const safe: unknown = 'must narrow';
-
-// Void and Never
-function log(message: string): void {
-  console.log(message);
-}
-
-function fail(message: string): never {
-  throw new Error(message);
-}
-```
-
-## Interfaces
-
-```typescript
-interface User {
-  readonly id: string;
-  name: string;
-  email: string;
-  age?: number; // optional
-}
-
-// Extending interfaces
-interface Admin extends User {
-  permissions: string[];
-}
-
-// Implementing interfaces
-class UserImpl implements User {
-  readonly id: string;
-  name: string;
-  email: string;
-
-  constructor(id: string, name: string, email: string) {
-    this.id = id;
-    this.name = name;
-    this.email = email;
-  }
-}
-```
-
-## Type Aliases
-
-```typescript
-// Union types
-type Status = 'pending' | 'active' | 'completed';
-
-// Intersection types
-type Employee = User & { department: string };
-
-// Function types
-type Handler = (event: Event) => void;
-
-// Object types
-type Point = {
-  x: number;
-  y: number;
-};
-```
-
-## Generics
-
-```typescript
-// Generic function
-function identity<T>(arg: T): T {
-  return arg;
-}
-
-// Generic interface
-interface Container<T> {
-  value: T;
-  getValue(): T;
-}
-
-// Generic class
-class Box<T> {
-  private content: T;
-
-  constructor(content: T) {
-    this.content = content;
-  }
-
-  getContent(): T {
-    return this.content;
-  }
-}
-
-// Generic constraints
-function getLength<T extends { length: number }>(item: T): number {
-  return item.length;
-}
-
-// Default type parameters
-function createArray<T = string>(length: number, value: T): T[] {
-  return Array(length).fill(value);
-}
-```
-
-## Type Guards
-
-```typescript
-// typeof guard
-function processValue(value: string | number) {
-  if (typeof value === 'string') {
-    console.log(value.toUpperCase());
-  } else {
-    console.log(value.toFixed(2));
-  }
-}
-
-// instanceof guard
-function handleError(error: unknown) {
-  if (error instanceof Error) {
-    console.log(error.message);
-  }
-}
-
-// Custom type guard
-function isUser(obj: unknown): obj is User {
-  return (
-    typeof obj === 'object' &&
-    obj !== null &&
-    'id' in obj &&
-    'name' in obj
-  );
-}
-
-// in operator
-function processShape(shape: Circle | Square) {
-  if ('radius' in shape) {
-    console.log('Circle with radius:', shape.radius);
-  } else {
-    console.log('Square with side:', shape.side);
-  }
-}
-```
-
-## Literal Types
-
-```typescript
-// String literals
-type Direction = 'north' | 'south' | 'east' | 'west';
-
-// Numeric literals
-type DiceRoll = 1 | 2 | 3 | 4 | 5 | 6;
-
-// Boolean literal
-type Success = true;
-
-// Template literal types
-type EventName = `on${Capitalize<string>}`;
-type OnClick = `on${'Click' | 'Hover'}`;
-```
-
-## Type Assertions
-
-```typescript
-// as syntax (preferred)
-const input = document.getElementById('input') as HTMLInputElement;
-
-// Angle bracket syntax
-const input2 = <HTMLInputElement>document.getElementById('input');
-
-// Non-null assertion
-const element = document.getElementById('root')!;
-
-// const assertion
-const config = {
-  endpoint: '/api',
-  timeout: 5000,
-} as const;
-```
-
-## Nullability
-
-```typescript
-// Optional property
-interface User {
-  name: string;
-  email?: string;
-}
-
-// Optional chaining
-const email = user?.email?.toLowerCase();
-
-// Nullish coalescing
-const displayName = user.nickname ?? user.name;
-
-// Non-null assertion
-const element = document.getElementById('root')!;
-```

package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript-best-practices/SKILL.md

@@ -1,320 +0,0 @@
-# TypeScript Best Practices Skill
-
-> **Category**: Development
-> **Source**: Internal (based on Google TypeScript Style Guide and TypeScript Handbook)
-
-## Purpose
-
-Apply type-safe TypeScript patterns and best practices from industry standards.
-
-## Core Principles
-
-```
-Type safety over convenience
-Explicit over implicit
-Prefer strict mode
-Use inference wisely
-```
-
-## Rules
-
-### 1. Type System
-
-```yaml
-type_inference:
-  rely_on: trivially inferred types (primitives, literals)
-  annotate: complex expressions, return types, public APIs
-
-any_vs_unknown:
-  prefer: unknown (requires type narrowing)
-  avoid: any (disables type checking)
-  if_any_needed: add suppressing comment
-
-nullable:
-  prefer: "field?: Type"
-  avoid: "field: Type | undefined"
-  compare_enums: explicitly, not boolean coercion
-
-patterns: |
-  // Good: unknown with narrowing
-  function process(data: unknown): void {
-    if (typeof data === 'string') {
-      console.log(data.toUpperCase());
-    }
-  }
-
-  // Avoid: any
-  function process(data: any): void {
-    console.log(data.toUpperCase()); // No type checking!
-  }
-```
-
-### 2. Interfaces vs Types
-
-```yaml
-prefer_interfaces:
-  - Object type definitions
-  - Public API contracts
-  - Extendable types
-
-use_types_for:
-  - Union types
-  - Intersection types
-  - Mapped types
-  - Utility types
-
-patterns: |
-  // Interface for objects
-  interface User {
-    id: string;
-    name: string;
-    email: string;
-  }
-
-  // Type for unions/utilities
-  type Status = 'pending' | 'active' | 'completed';
-  type ReadonlyUser = Readonly<User>;
-```
-
-### 3. Arrays and Generics
-
-```yaml
-array_syntax:
-  simple_types: "T[]"
-  complex_types: "Array<T>"
-
-generics:
-  naming: single uppercase (T, K, V) or descriptive (TItem, TResult)
-  constraints: use extends for type bounds
-  defaults: provide when appropriate
-
-patterns: |
-  // Array syntax
-  const numbers: number[] = [1, 2, 3];
-  const items: Array<{ id: string; value: number }> = [];
-
-  // Generic constraints
-  function getProperty<T, K extends keyof T>(obj: T, key: K): T[K] {
-    return obj[key];
-  }
-```
-
-### 4. Variables and Constants
-
-```yaml
-declarations:
-  prefer: const
-  when_needed: let
-  never: var
-
-one_per_statement: true
-
-patterns: |
-  // Good
-  const name = 'TypeScript';
-  const version = 5.0;
-
-  // Avoid
-  var name = 'TypeScript', version = 5.0;
-```
-
-### 5. Functions
-
-```yaml
-function_declarations:
-  named_functions: function declaration
-  callbacks: arrow functions
-  methods: shorthand syntax
-
-parameters:
-  prefer_rest: "...args: T[]"
-  avoid: arguments object
-
-this_handling:
-  prefer: arrow functions or explicit parameter
-  avoid: rebinding with bind/call/apply
-
-patterns: |
-  // Function declaration
-  function processData(data: Data): Result {
-    return transform(data);
-  }
-
-  // Arrow function for callbacks
-  items.map((item) => item.value);
-
-  // Rest parameters
-  function concat(...strings: string[]): string {
-    return strings.join('');
-  }
-```
-
-### 6. Classes
-
-```yaml
-visibility:
-  prefer: explicit modifiers (public, private, protected)
-  avoid: private fields (#)
-
-initialization:
-  prefer: at declaration site
-  use: parameter properties in constructors
-
-readonly:
-  apply_to: non-reassigned properties
-
-patterns: |
-  class User {
-    readonly id: string;
-    private email: string;
-
-    constructor(
-      public name: string,
-      email: string,
-    ) {
-      this.id = generateId();
-      this.email = email;
-    }
-  }
-```
-
-### 7. Naming Conventions
-
-```yaml
-UpperCamelCase:
-  - Classes
-  - Interfaces
-  - Type aliases
-  - Enums
-  - Type parameters
-
-lowerCamelCase:
-  - Variables
-  - Parameters
-  - Functions
-  - Methods
-  - Properties
-
-CONSTANT_CASE:
-  - Global constants
-  - Enum values
-  - Static readonly fields
-
-rules:
-  - No leading/trailing underscores
-  - No abbreviations (except universal: URL, ID, DNS)
-  - Acronyms as whole words: loadHttpUrl, not loadHTTPURL
-  - Single-letter names only in 10-line scopes
-```
-
-### 8. Control Flow
-
-```yaml
-braces:
-  always: use braces for all control statements
-
-equality:
-  always: "=== and !=="
-  never: "== and !="
-
-loops:
-  arrays: for...of
-  objects: for...in with hasOwnProperty check
-
-patterns: |
-  // Always braced
-  if (condition) {
-    doSomething();
-  }
-
-  // for...of for arrays
-  for (const item of items) {
-    process(item);
-  }
-
-  // for...in with check
-  for (const key in obj) {
-    if (Object.prototype.hasOwnProperty.call(obj, key)) {
-      process(obj[key]);
-    }
-  }
-```
-
-### 9. Error Handling
-
-```yaml
-throwing:
-  only: Error instances
-  with_message: descriptive error messages
-
-catching:
-  type: unknown
-  validate: before use
-
-empty_catch:
-  require: rationale comment
-
-patterns: |
-  // Throw Error instances
-  throw new Error('Invalid input');
-
-  // Catch with unknown
-  try {
-    riskyOperation();
-  } catch (error: unknown) {
-    if (error instanceof Error) {
-      console.error(error.message);
-    }
-    throw error;
-  }
-```
-
-### 10. Imports and Exports
-
-```yaml
-imports:
-  prefer: named imports
-  use_namespace: for large APIs
-  prefer_relative: within project
-
-exports:
-  prefer: named exports
-  avoid: default exports
-
-patterns: |
-  // Named imports
-  import { User, UserService } from './user';
-
-  // Namespace import for large APIs
-  import * as fs from 'fs';
-
-  // Named exports
-  export interface User { }
-  export function createUser() { }
-```
-
-### 11. Disallowed Features
-
-```yaml
-never_use:
-  - eval() or dynamic code evaluation
-  - with statements
-  - const enum (use plain enum)
-  - debugger statements in production
-  - Modifying built-in prototypes
-  - Wrapper objects (new String(), new Boolean())
-  - Automatic semicolon insertion reliance
-```
-
-## Application
-
-When writing or reviewing TypeScript code:
-
-1. **Always** enable strict mode
-2. **Always** use explicit return types for public APIs
-3. **Prefer** unknown over any
-4. **Prefer** interfaces for object types
-5. **Use** const by default
-6. **Use** triple equals exclusively
-7. **Handle** errors with typed catch blocks
-8. **Avoid** default exports

package/templates/agents/sw-engineer/language/typescript-expert/refs/typescript-best-practices/index.yaml

@@ -1,28 +0,0 @@
-# TypeScript Best Practices Skill
-
-metadata:
-  name: typescript-best-practices
-  category: development
-  description: Type-safe TypeScript patterns from industry standards
-
-source:
-  type: internal
-  reference:
-    - https://www.typescriptlang.org/docs/handbook/
-    - https://google.github.io/styleguide/tsguide.html
-    - https://basarat.gitbook.io/typescript/
-
-provides:
-  - TypeScript type system patterns
-  - Interface and type design
-  - Generic usage guidelines
-  - Variable and constant rules
-  - Function design patterns
-  - Class structure guidelines
-  - Naming conventions
-  - Control flow patterns
-  - Error handling patterns
-  - Import/export organization
-
-used_by:
-  - typescript-expert

package/templates/agents/sw-engineer/tooling/bun-expert/index.yaml

@@ -1,46 +0,0 @@
-# Bun Expert Agent
-
-metadata:
-  name: bun-expert
-  type: sw-engineer/tooling
-  description: Expert Bun runtime developer for high-performance JS/TS applications
-
-source:
-  type: internal
-
-capabilities:
-  - Write optimized code for Bun runtime
-  - Configure bunfig.toml settings
-  - Set up and execute Bun tests
-  - Optimize Bun build configurations
-  - Migrate from Node.js to Bun
-  - Manage Bun workspaces
-
-triggers:
-  keywords:
-    - bun
-    - bunx
-    - bun.js
-    - bunfig
-    - bun runtime
-  file_patterns:
-    - bunfig.toml
-    - "*.bun.ts"
-    - bun.lockb
-  actions:
-    - run
-    - build
-    - test
-    - migrate
-
-skills: []
-  # Planned:
-  # - name: bun-best-practices
-  #   path: ../../../../skills/development/bun-best-practices/
-  #   required: true
-
-guides: []
-  # Planned:
-  # - name: bun
-  #   path: ../../../../guides/bun/
-  #   required: true