Files

T

fargo 1a822493ba format: apply repo prettier (3.8.1) to the folded skills tree

963 markdown files reformatted with the repository's pinned prettier so
pnpm format:check covers the folded tree like every other repo file.

The formatter's embedded-language pass also normalized code fences
(TS semicolons, closed HTML tags in examples, lowercased CSS hex colors,
one renumbered list that skipped an index). Alphanumeric token deltas vs
the fold commit were audited file-by-file; all are formatter-equivalent
markup normalizations plus the four sanitized skills.

2026-08-19 14:37:17 -05:00

rules

format: apply repo prettier (3.8.1) to the folded skills tree

2026-08-19 14:37:17 -05:00

AGENTS.md

format: apply repo prettier (3.8.1) to the folded skills tree

2026-08-19 14:37:17 -05:00

metadata.json

feat: Complete fleet — 94 skills across 10+ domains

2026-02-16 16:27:42 -06:00

README.md

feat: Complete fleet — 94 skills across 10+ domains

2026-02-16 16:27:42 -06:00

SKILL.md

format: apply repo prettier (3.8.1) to the folded skills tree

2026-08-19 14:37:17 -05:00

README.md

React Composition Patterns

A structured repository for React composition patterns that scale. These patterns help avoid boolean prop proliferation by using compound components, lifting state, and composing internals.

Structure

rules/ - Individual rule files (one per rule)
- _sections.md - Section metadata (titles, impacts, descriptions)
- _template.md - Template for creating new rules
- area-description.md - Individual rule files
metadata.json - Document metadata (version, organization, abstract)
AGENTS.md - Compiled output (generated)

Rules

Component Architecture (CRITICAL)

architecture-avoid-boolean-props.md - Don't add boolean props to customize behavior
architecture-compound-components.md - Structure as compound components with shared context

State Management (HIGH)

state-lift-state.md - Lift state into provider components
state-context-interface.md - Define clear context interfaces (state/actions/meta)
state-decouple-implementation.md - Decouple state management from UI

Implementation Patterns (MEDIUM)

patterns-children-over-render-props.md - Prefer children over renderX props
patterns-explicit-variants.md - Create explicit component variants

Core Principles

Composition over configuration — Instead of adding props, let consumers compose
Lift your state — State in providers, not trapped in components
Compose your internals — Subcomponents access context, not props
Explicit variants — Create ThreadComposer, EditComposer, not Composer with isThread

Creating a New Rule

Copy rules/_template.md to rules/area-description.md
Choose the appropriate area prefix:
- architecture- for Component Architecture
- state- for State Management
- patterns- for Implementation Patterns
Fill in the frontmatter and content
Ensure you have clear examples with explanations

Impact Levels

CRITICAL - Foundational patterns, prevents unmaintainable code
HIGH - Significant maintainability improvements
MEDIUM - Good practices for cleaner code