@ox0/guides

LLM-facing guidance for TypeScript and React development.

These guides give language models the context to write correct, idiomatic code from the first attempt. They are dense and directive by design — written for LLMs, not human tutorials.

How to Use

In your project's AGENTS.md, add a pointer to this entry point:

## Guides

Read the relevant guide before working in these areas:

- [TypeScript](./node_modules/@ox0/guides/guides/typescript.md)
- [React Hooks](./node_modules/@ox0/guides/guides/react-hooks.md)
- [React Components](./node_modules/@ox0/guides/guides/react-components.md)
- [Validation](./node_modules/@ox0/guides/guides/validation.md)
- [Library Choices](./node_modules/@ox0/guides/guides/library-choices.md)
- [Regression Prevention](./node_modules/@ox0/guides/guides/regression-prevention.md)

Guides

• TypeScript — type safety at boundaries, any and as policy, state modeling, error shapes
• React Hooks — when to use effects, dependency rules, cleanup, async work, common loops
• React Components — component authoring rules, provider values, form labels, render purity
• Validation — boundary validation pattern, storage, API responses, schema libraries
• Library Choices — opinionated defaults for the ox0 stack across tooling, UI, state, and data
• Regression Prevention — common React failure modes, authoring rules, pre-merge checklist

Companion

@ox0/guards is the automated enforcement companion. Guards are deterministic AST checks that catch violations without consuming context. Use guides to avoid writing bad code; use guards to catch it when it slips through.

For guard-by-guard LLM guidance, see node_modules/@ox0/guards/guides/guards.md.