patterns

Reference for Outfitter Dev Kit conventions including Result types, Handler contract, Error taxonomy, and transport-agnostic patterns. Use when learning the stack, looking up patterns, understanding @outfitter/* packages, or when "Result", "Handler", "error taxonomy", or "OutfitterError" are mentioned.

Ir a la instalación

Repositorio: outfitter-dev/outfitter
Última actividad en el origen: 17 de marzo de 2026 a las 17:22
Idioma detectado de SKILL.md: inglés
Estrellas: 6
Forks: 1

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/outfitter-dev/outfitter --skill patterns

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

4 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

outfitter-daemon

Patterns for @outfitter/daemon including lifecycle management, IPC communication, health checks, and PID files. Use when building background services, daemons, or when "daemon", "IPC", "health check", "background service", or "@outfitter/daemon" are mentioned.

2026-03-24

scaffold

Creates handlers, CLI commands, MCP tools, and daemon services following Outfitter Dev Kit conventions. Use when adding new components to a project, scaffolding code, or when "create handler", "new command", "add tool", or "daemon service" are mentioned.

2026-03-24

outfitter-mcp

Deep patterns for @outfitter/mcp including tool registration, Zod schemas, resources, and server configuration. Use when building MCP servers, registering tools, defining resources, or when "MCP server", "MCP tool", "registerTool", or "@outfitter/mcp" are mentioned.

2026-03-18

Ver todos los de este repositorio

import { Result, NotFoundError, type Handler } from "@outfitter/contracts";

export const getUser: Handler<{ id: string }, User, NotFoundError> = async (
  input,
  ctx
) => {
  ctx.logger.debug("Fetching user", { userId: input.id });
  const user = await db.users.findById(input.id);

  if (!user) {
    return Result.err(NotFoundError.create("user", input.id));
  }
  return Result.ok(user);
};

import { NotFoundError, Result } from "@outfitter/contracts";

// Create
const ok = Result.ok({ name: "Alice" });
const err = Result.err(NotFoundError.create("user", "123"));

// Check
if (result.isOk()) {
  console.log(result.value); // TypeScript knows T
} else {
  console.log(result.error); // TypeScript knows E
}

// Pattern match
const message = result.match({
  ok: (user) => `Found ${user.name}`,
  err: (error) => `Error: ${error.message}`,
});

// Combine
const combined = combine2(result1, result2); // tuple or first error

Category	Exit	HTTP	When to Use
`validation`	1	400	Invalid input, schema failures
`not_found`	2	404	Resource doesn't exist
`conflict`	3	409	Already exists, version mismatch
`permission`	4	403	Forbidden action
`timeout`	5	504	Operation took too long
`rate_limit`	6	429	Too many requests
`network`	7	502	Connection failures
`internal`	8	500	Unexpected errors, bugs
`auth`	9	401	Authentication required
`cancelled`	130	499	User interrupted (Ctrl+C)

import {
  ValidationError,
  NotFoundError,
  getExitCode,
} from "@outfitter/contracts";

ValidationError.create("email", "invalid");
NotFoundError.create("user", "user-123");

getExitCode(error.category); // 2 for not_found
getStatusCode(error.category); // 404 for not_found

import { createValidator } from "@outfitter/contracts";
import { z } from "zod";

const InputSchema = z.object({
  name: z.string().min(1),
  email: z.string().email(),
});

const validateInput = createValidator(InputSchema);

// In handler
const inputResult = validateInput(rawInput);
if (inputResult.isErr()) return inputResult;
const input = inputResult.value; // typed as z.infer<typeof InputSchema>

import { createContext } from "@outfitter/contracts";

const ctx = createContext({
  logger: myLogger, // structured logger
  config: resolvedConfig, // merged configuration
  signal: controller.signal, // cancellation
  workspaceRoot: "/project",
});

// ctx.requestId is auto-generated UUIDv7 for tracing

Field	Type	Description
`requestId`	`string`	Auto-generated UUIDv7
`logger`	`Logger`	Structured logger
`config`	`ResolvedConfig`	Merged config
`signal`	`AbortSignal`	Cancellation signal
`workspaceRoot`	`string`	Project root
`cwd`	`string`	Current directory

Need	Bun API
Hashing	`Bun.hash()`
Globbing	`Bun.Glob`
Semver	`Bun.semver`
Shell	`Bun.$`
Colors	`Bun.color()`
String width	`Bun.stringWidth()`
SQLite	`bun:sqlite`
UUID v7	`Bun.randomUUIDv7()`

patterns

Opciones de instalación

Revisa los archivos de origen

Outfitter Dev Kit Patterns

Handler Contract

Outfitter Dev Kit Patterns

Handler Contract

Example

Result Types

Error Taxonomy

Validation

Context

Bun-First APIs

References

name	patterns
version	0.1.0
description	Reference for Outfitter Dev Kit conventions including Result types, Handler contract, Error taxonomy, and transport-agnostic patterns. Use when learning the stack, looking up patterns, understanding @outfitter/* packages, or when "Result", "Handler", "error taxonomy", or "OutfitterError" are mentioned.
allowed-tools	Read Grep Glob

patterns

Datos de origen

Opciones de instalación

Revisa los archivos de origen

Más de este repositorio

Outfitter Dev Kit Patterns

Handler Contract

Outfitter Dev Kit Patterns

Handler Contract

Example

Result Types

Error Taxonomy

Validation

Context

Bun-First APIs

References

Más de este repositorio