oh-my-customcode 0.1.3 → 0.2.0

package/templates/agents/manager/supplier/refs/guides/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/manager/supplier/refs/guides/web-design/accessibility.md

@@ -1,66 +0,0 @@
-# Accessibility Best Practices
-
-> Reference guide for web-design-guidelines skill
-
-## Core Principles
-
-### WCAG 2.1 Compliance
-```
-Level A: Minimum accessibility
-Level AA: Standard compliance (recommended)
-Level AAA: Enhanced accessibility
-```
-
-### POUR Principles
-```
-Perceivable: Content available to senses
-Operable: Interface navigable
-Understandable: Clear and predictable
-Robust: Works across technologies
-```
-
-## Quick Reference
-
-### Color Contrast
-```
-Normal text: 4.5:1 minimum
-Large text: 3:1 minimum
-UI components: 3:1 minimum
-```
-
-### Keyboard Navigation
-```
-Tab: Move forward
-Shift+Tab: Move backward
-Enter/Space: Activate
-Escape: Close/Cancel
-Arrow keys: Navigate within component
-```
-
-### ARIA Landmarks
-```html
-<header role="banner">
-<nav role="navigation">
-<main role="main">
-<aside role="complementary">
-<footer role="contentinfo">
-```
-
-### Common ARIA Attributes
-```html
-aria-label="Description"
-aria-labelledby="element-id"
-aria-describedby="description-id"
-aria-hidden="true|false"
-aria-expanded="true|false"
-aria-selected="true|false"
-aria-live="polite|assertive"
-```
-
-## Testing Tools
-
-- axe DevTools
-- WAVE
-- Lighthouse
-- VoiceOver (macOS)
-- NVDA (Windows)

package/templates/agents/manager/supplier/refs/guides/web-design/index.yaml

@@ -1,20 +0,0 @@
-# Web Design Guide
-
-metadata:
-  name: web-design
-  description: Web design best practices and accessibility reference
-
-source:
-  type: external
-  origin: github
-  url: https://github.com/vercel-labs/agent-skills
-  related_skill: web-design-guidelines
-
-documents:
-  - name: accessibility
-    title: Accessibility Best Practices
-    path: ./accessibility.md
-
-  - name: performance
-    title: Performance Guidelines
-    path: ./performance.md

package/templates/agents/manager/supplier/refs/guides/web-design/performance.md

@@ -1,102 +0,0 @@
-# Performance Guidelines
-
-> Reference guide for react-best-practices skill
-
-## Core Web Vitals
-
-### LCP (Largest Contentful Paint)
-```
-Good: < 2.5s
-Needs improvement: 2.5s - 4s
-Poor: > 4s
-```
-
-### FID (First Input Delay)
-```
-Good: < 100ms
-Needs improvement: 100ms - 300ms
-Poor: > 300ms
-```
-
-### CLS (Cumulative Layout Shift)
-```
-Good: < 0.1
-Needs improvement: 0.1 - 0.25
-Poor: > 0.25
-```
-
-## Optimization Strategies
-
-### JavaScript
-```
-- Code splitting
-- Tree shaking
-- Lazy loading
-- Minimize main thread work
-```
-
-### Images
-```
-- Modern formats (WebP, AVIF)
-- Responsive images
-- Lazy loading
-- Proper sizing
-```
-
-### CSS
-```
-- Critical CSS inline
-- Defer non-critical
-- Remove unused
-- Minimize specificity
-```
-
-### Fonts
-```
-- font-display: swap
-- Preload critical fonts
-- Subset fonts
-- System font fallback
-```
-
-## Next.js Specific
-
-### Server Components
-```tsx
-// Default: Server Component (no directive)
-export default function Page() {
-  return <div>Server rendered</div>
-}
-```
-
-### Client Components
-```tsx
-'use client'
-// Only when needed for interactivity
-export default function Button() {
-  return <button onClick={...}>Click</button>
-}
-```
-
-### Data Fetching
-```tsx
-// Server: fetch in component
-async function Page() {
-  const data = await fetch(...)
-  return <div>{data}</div>
-}
-
-// Client: use SWR/React Query
-'use client'
-function Component() {
-  const { data } = useSWR('/api/data', fetcher)
-  return <div>{data}</div>
-}
-```
-
-## Measurement Tools
-
-- Lighthouse
-- WebPageTest
-- Chrome DevTools Performance
-- Next.js Analytics

package/templates/agents/manager/supplier/refs/rules/MAY-optimization.md

@@ -1,93 +0,0 @@
-# [MAY] Optimization Guide
-
-> **Priority**: MAY - Optional
-> **Apply when**: Basic functionality is stable
-
-## Efficiency Optimization
-
-### Parallel Processing
-```
-Apply when:
-- 3+ independent tasks
-- Each task is I/O bound
-
-Example:
-- Read multiple files simultaneously
-- Run independent searches in parallel
-```
-
-### Caching
-```
-Apply when:
-- Same data accessed repeatedly
-- Data changes infrequently
-
-Example:
-- Cache file contents
-- Reuse search results
-```
-
-### Lazy Loading
-```
-Apply when:
-- Large datasets
-- Only portion actually used
-
-Example:
-- Read only needed files
-- Stream results
-```
-
-## Token Optimization
-
-### Context Management
-```
-✓ Include only necessary info
-✓ Remove duplicates
-✓ Use summaries
-```
-
-### Response Optimization
-```
-✓ Concise expressions
-✓ Minimize code blocks
-✓ Remove unnecessary repetition
-```
-
-## Task Optimization
-
-### Batch Processing
-```
-Group similar tasks together
-Example: Edit 10 files → Process at once
-```
-
-### Incremental Processing
-```
-Process only changed parts
-Example: Full build → Incremental build
-```
-
-## Apply Criteria
-
-### Do Optimize
-```
-✓ Repetitive tasks
-✓ Clear performance bottleneck
-✓ Measurable improvement
-```
-
-### Don't Optimize
-```
-✗ One-time tasks
-✗ Already fast enough
-✗ Complexity increase outweighs benefit
-```
-
-## Caution
-
-```
-⚠ Premature optimization is root of evil
-⚠ Readability > Optimization
-⚠ No optimization without measurement
-```

package/templates/agents/manager/supplier/refs/rules/MUST-agent-design.md

@@ -1,107 +0,0 @@
-# [MUST] Agent Design Rules
-
-> **Priority**: MUST - Never violate
-> **ID**: R006
-
-## Agent Structure
-
-### Required Files
-```
-agents/{type}/{name}/
-├── AGENT.md          # Agent definition (REQUIRED)
-├── index.yaml        # Agent metadata (REQUIRED)
-└── refs/             # Symlinks to guides/skills (OPTIONAL)
-```
-
-### AGENT.md Must NOT Contain
-```
-✗ Detailed skill instructions (use skills/ instead)
-✗ Reference documentation (use guides/ instead)
-✗ Implementation scripts (use skills/scripts/ instead)
-```
-
-### AGENT.md Should Contain
-```
-✓ Agent purpose and role
-✓ Capabilities overview (not details)
-✓ Required skills (by reference)
-✓ Workflow description
-✓ Source info (if external)
-```
-
-## External Agent Requirements
-
-External agents (from GitHub, npm, etc.) MUST include:
-
-### index.yaml Fields
-```yaml
-metadata:
-  name: agent-name
-  type: worker | orchestrator
-  source:
-    type: external
-    origin: github | npm | other
-    url: https://github.com/org/repo
-    version: 1.0.0
-    last_updated: 2025-01-22
-    update_command: "npx add-skill org/repo"
-```
-
-### Update Tracking
-```
-- version: Current version installed
-- last_updated: Date of last sync
-- update_command: Command to update
-- changelog_url: Where to check updates
-```
-
-## Separation of Concerns
-
-### agents/
-```
-Purpose: Define WHAT the agent does
-Content: Role, capabilities, workflow
-NOT: How to do it (that's skills/)
-```
-
-### skills/
-```
-Purpose: Define HOW to do tasks
-Content: Instructions, scripts, rules
-Location: skills/{category}/{name}/
-```
-
-### guides/
-```
-Purpose: Reference documentation
-Content: Best practices, tutorials
-Location: guides/{topic}/
-```
-
-## Linking
-
-### Agent → Skills
-```yaml
-# In AGENT.md or index.yaml
-skills:
-  - category: development
-    name: react-best-practices
-    path: ../../../../skills/development/react-best-practices
-```
-
-### Agent → Guides
-```bash
-# Symlink in refs/
-ln -s ../../../../guides/web-design refs/web-design
-```
-
-## Naming Conventions
-
-| Type | Pattern | Example |
-|------|---------|---------|
-| Agent folder | `kebab-case` | `vercel-agent` |
-| Skill folder | `kebab-case` | `react-best-practices` |
-| Guide folder | `kebab-case` | `web-design` |
-| AGENT.md | UPPERCASE | `AGENT.md` |
-| SKILL.md | UPPERCASE | `SKILL.md` |
-| index.yaml | lowercase | `index.yaml` |

package/templates/agents/manager/supplier/refs/rules/MUST-agent-identification.md

@@ -1,108 +0,0 @@
-# [MUST] Agent Identification Rules
-
-> **Priority**: MUST - ENFORCED, NO EXCEPTIONS
-> **ID**: R007
-> **Violation**: Immediate correction required
-
-## CRITICAL
-
-**EVERY response MUST start with agent identification. This is NON-NEGOTIABLE.**
-
-Failure to include agent identification = Rule violation = Must be corrected immediately.
-
-## Purpose
-
-Display which agent is responding and which skills are being used for transparency and traceability.
-
-## Response Header Format
-
-Every response MUST start with an agent identification block:
-
-```
-┌─ Agent: {agent-name} ({agent-type})
-├─ Skill: {skill-name} (if applicable)
-└─ Task: {brief-task-description}
-```
-
-## Examples
-
-### Single Agent Response
-```
-┌─ Agent: creator (manager)
-└─ Task: Creating new agent
-
-[Response content...]
-```
-
-### With Skill Usage
-```
-┌─ Agent: vercel-agent (worker)
-├─ Skill: react-best-practices
-└─ Task: Optimizing React component
-
-[Response content...]
-```
-
-### Multiple Skills
-```
-┌─ Agent: vercel-agent (worker)
-├─ Skills: react-best-practices, web-design-guidelines
-└─ Task: Full code review
-
-[Response content...]
-```
-
-### No Specific Agent (Default)
-```
-┌─ Agent: claude (default)
-└─ Task: General assistance
-
-[Response content...]
-```
-
-## When to Display
-
-| Situation | Display |
-|-----------|---------|
-| Agent-specific task | Full header with agent |
-| Using skill | Include skill name |
-| General conversation | "claude (default)" |
-| Multiple agents | Show primary agent |
-
-## Agent Types
-
-| Type | Symbol | Example |
-|------|--------|---------|
-| manager | 🔧 | creator, updater |
-| worker | ⚙️ | vercel-agent |
-| orchestrator | 🎯 | (future) |
-| default | 💬 | claude |
-
-## Simplified Format (Optional)
-
-For brief responses, use inline format:
-
-```
-[creator] Creating agent structure...
-```
-
-Or with skill:
-
-```
-[vercel-agent → react-best-practices] Analyzing performance...
-```
-
-## Status Updates
-
-During long tasks, show progress with agent context:
-
-```
-┌─ Agent: updater (manager)
-└─ Task: Checking external updates
-
-[Progress] Scanning agents/index.yaml (1/3)
-[Progress] Scanning skills/index.yaml (2/3)
-[Progress] Scanning guides/index.yaml (3/3)
-
-[Done] Found 2 updates available
-```