trails-dogfood-check

Audit Trails framework components for boundary violations and Result-shaped failures.

4|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/outfitter-dev/trails --skill trails-dogfood-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trails-dogfood-check
Source: https://github.com/outfitter-dev/trails/tree/main/plugin/skills/trails-dogfood-check
Command: npx skills add https://github.com/outfitter-dev/trails --skill trails-dogfood-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify boundary violations and Result-shaped failures in Trails framework code during dogfood reviews.

Core Features & Use Cases

  • Audits Trails-owned components (trails, CLI helpers, loaders, and generators) for boundary correctness, ambient state access, and proper Result vs host-exception behavior.
  • Documents findings and provides actionable recommendations to fix drift, add tests, and clarify host construction constraints.
  • Supports risk assessment of code changes by highlighting potential error shapes and boundary risks.

Quick Start

Run a dogfood review against a Trails component and report any boundary violations, Result-shape drift, or host-construction issues.

Frequently Asked Questions about trails-dogfood-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit Trails framework code for Result boundary violations?

Audit Trails framework code for boundary violations by running dogfood reviews against components like CLI helpers, loaders, and generators to verify explicit boundary classification, proper Result handling, and host construction constraints.

What is a Result-shaped failure in Trails runtime code?

A Result-shaped failure in Trails runtime code occurs when boundary classification drifts, causing improper Result versus host-exception handling. Audits identify this drift to ensure components correctly separate Result values from host exceptions.

How do I check ambient state access during a Trails dogfood review?

Check ambient state access during a Trails dogfood review by auditing component code to verify boundary correctness. The process highlights potential error shapes and ambient state violations that affect runtime behavior.

Does the Trails audit cover CLI helpers, loaders, and generators?

Yes, the Trails audit covers CLI helpers, loaders, and generators. It verifies host construction, runtime behavior, and boundary decisions across all Trails-owned components to document findings and provide actionable recommendations.

What's the best way to assess boundary risks in Trails component changes?

Assess boundary risks in Trails component changes by running a dogfood review that highlights potential error shapes, verifies boundary correctness, and documents actionable recommendations to fix drift and add tests.

Why does my Trails component fail host construction during runtime audits?

Trails components fail host construction during runtime audits when boundary decisions and Result versus host-exception handling are misclassified. Dogfood reviews identify these violations and provide guidance to clarify host construction constraints.