Files

T

History

calesthio 1918be6526 fix: reconcile .claude/skills blobs with hardlinked .agents/skills

The skill SKILL.md files are hardlinked across .agents/skills/ and
.claude/skills/ (same inode, two paths), but git had committed divergent
blobs: the .agents/ copies carried an "Extended reference: AGENTS.md"
note that the .claude/ copies lacked. Because one physical file cannot
match two different blobs, the working tree was permanently dirty on the
three .claude/skills paths.

Stage the .claude copies so both paths commit identical content (with the
AGENTS.md reference note, the fuller intended version). Restores a clean
git status and keeps it clean across checkouts.

Affected skills: flux-best-practices, vercel-composition-patterns,
vercel-react-best-practices.

2026-06-29 22:58:56 -07:00

rules

Initial release — OpenMontage: the first open-source agentic video production system

2026-03-29 08:25:17 -07:00

AGENTS.md

Initial release — OpenMontage: the first open-source agentic video production system

2026-03-29 08:25:17 -07:00

README.md

Initial release — OpenMontage: the first open-source agentic video production system

2026-03-29 08:25:17 -07:00

SKILL.md

fix: reconcile .claude/skills blobs with hardlinked .agents/skills

2026-06-29 22:58:56 -07: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