What is the Handler Contract in the Outfitter Stack?

It is a pattern for creating pure functions that accept typed input and context, returning a Result type, making them independent of transport layers like CLI or HTTP.

Does this skill support Bun-native APIs?

Yes, it prioritizes Bun-native APIs for tasks like hashing, globbing, and file operations to ensure high performance and modern standards.

How does the Error Taxonomy work?

It classifies errors into 10 specific categories that automatically map to appropriate CLI exit codes and HTTP status codes for consistent reporting.

Why use the Result type instead of try/catch?

The Result type makes error handling explicit in the type system, forcing developers to handle failures and avoiding the unpredictability of thrown exceptions.

Which @outfitter packages are essential for starting?

Most projects start with @outfitter/contracts for core types, then add @outfitter/cli for tools or @outfitter/mcp for AI agent capabilities.

Outfitter Stack Patterns

Name: Outfitter Stack Patterns
Author: outfitter-dev

byoutfitter-dev

•

API開発

Standardizes development patterns for the Outfitter ecosystem using type-safe handlers, explicit error handling, and modular packages.

概要

This skill provides a comprehensive reference for building applications within the Outfitter Stack, ensuring architectural consistency across CLI tools, MCP servers, and backend services. It guides developers through implementing pure function handlers, utilizing the Result pattern for robust error management, and leveraging a specialized error taxonomy that maps directly to exit codes and HTTP statuses. By standardizing these patterns, the skill helps maintain high-quality, testable, and composable codebases that integrate seamlessly with AI agents and modern TypeScript environments like Bun.

主な機能

Comprehensive guidance for @outfitter/* packages including CLI, MCP, and Config.
Handler Contract implementation for transport-agnostic, pure function logic.
Standardized 10-category error taxonomy mapped to HTTP and CLI exit codes.
18 GitHub stars
Zod-powered validation patterns for runtime safety and auto-typed inputs.
Type-safe Result pattern integration for explicit error handling without exceptions.

ユースケース

Building consistent CLI tools with standardized output and error reporting.
Developing MCP servers for AI agents with type-safe tool registrations.
Refactoring legacy TypeScript codebases into testable, composable handler patterns.

概要

主な機能

Comprehensive guidance for @outfitter/* packages including CLI, MCP, and Config.
Handler Contract implementation for transport-agnostic, pure function logic.
Standardized 10-category error taxonomy mapped to HTTP and CLI exit codes.
18 GitHub stars
Zod-powered validation patterns for runtime safety and auto-typed inputs.
Type-safe Result pattern integration for explicit error handling without exceptions.

ユースケース

Building consistent CLI tools with standardized output and error reporting.
Developing MCP servers for AI agents with type-safe tool registrations.
Refactoring legacy TypeScript codebases into testable, composable handler patterns.