Open History to see the last commit
1schema_version: 1
2status: reviewed
3library:
4 name: TanStack Form v2
5 version: '0.0.0'
6 repository: https://github.com/TanStack/form-v2
7 description: 'Headless form state, validation, schema, and adapter APIs for TanStack Form v2, with React as the primary skill target.'
8generated_from:
9 domain_map: _artifacts/domain_map.yaml
10 skill_spec: _artifacts/skill_spec.md
11generated_at: '2026-06-25'
12layout:
13 kind: flat
14 reason: 'The reviewed skills are task-focused and independently discoverable; no router skill is needed for 8 skills.'
15 default_package: packages/react-form
16 adapter_first: true
17skills:
18 - name: React Form Composition Setup
19 slug: react-form-composition-setup
20 type: framework
21 domain: react-adapter-composition
22 path: packages/react-form/skills/react-form-composition-setup/SKILL.md
23 package: packages/react-form
24 description: 'Use when building adapter-first React forms with useForm, form.Field, form.ArrayField, form.Subscribe, AppForm, ReactFormType, field groups, reusable field components, or UI-library bindings.'
25 sources:
26 - packages/react-form/src/ReactForm/Components.public.ts
27 - packages/react-form/src/ReactForm/fieldSubscriptions.lib.ts
28 - packages/react-form/src/AppForm/createFormHook.public.ts
29 - packages/react-form/src/FieldGroup/withFields.public.ts
30 - packages/react-form/tests/submit-return.test-d.tsx
31 - packages/form-core/src/FormApi/FormApiArrayMethods.types.public.ts
32 - packages/form-core/src/FieldApi/fieldState.lib.ts
33 - examples/react/array/src/index.tsx
34 - examples/react/basic-splitting-form/src/index.tsx
35 - examples/react/ui-integration-shadcn/src/components/form/app-form.ts
36 - name: Reusable Form Policies
37 slug: reusable-form-policies
38 type: framework
39 domain: validation-and-error-visibility
40 path: packages/react-form/skills/reusable-form-policies/SKILL.md
41 package: packages/react-form
42 description: 'Use when extracting ReactFormType split-form props, createErrorVisibility policies, createValidator/createValidators configs, shared formOptions, or appFormOptions into named reusable helpers with documented intent.'
43 requires:
44 - react-form-composition-setup
45 - error-visibility-workflows
46 sources:
47 - examples/react/basic-splitting-form/src/FormSection.tsx
48 - examples/react/basic-splitting-form/src/sharedForm.ts
49 - packages/react-form/tests/submit-return.test-d.tsx
50 - packages/form-core/tests/validation.test.ts
51 - packages/form-core/tests/validation.test-d.ts
52 - examples/react/ui-integration-shadcn/src/app/booking/shared-form.tsx
53 references:
54 - references/reusable-policy-boundaries.md
55 - name: Choosing Form Options Modes
56 slug: choosing-form-options-modes
57 type: framework
58 domain: schema-driven-forms
59 path: packages/react-form/skills/choosing-form-options-modes/SKILL.md
60 package: packages/react-form
61 description: 'Use when choosing between default formOptions, formOptions.strictSchema, formOptions.looseSchema, appFormOptions, and schema-source typing for React forms.'
62 sources:
63 - packages/form-core/src/utils.public.ts
64 - packages/react-form/src/AppForm/appFormOptions.public.ts
65 - packages/form-core/tests/validation.test.ts
66 - packages/form-core/tests/validation.test-d.ts
67 - examples/react/ui-integration-shadcn/src/app/booking/schema.ts
68 - examples/react/ui-integration-shadcn/src/app/booking/shared-form.tsx
69 - https://standardschema.dev/
70 - https://zod.dev/library-authors
71 - https://valibot.dev/guides/integrate-valibot/
72 - https://arktype.io/docs/integrations
73 - https://effect.website/docs/schema/standard-schema/
74 references:
75 - references/schema-option-modes.md
76 - references/standard-schema-library-leanings.md
77 - name: Schema Driven Forms
78 slug: schema-driven-forms
79 type: framework
80 domain: schema-driven-forms
81 path: packages/react-form/skills/schema-driven-forms/SKILL.md
82 package: packages/react-form
83 description: 'Use when wiring Standard Schema-compatible validators, validators arrays, schemaOutputs, parseIssues, createValidationError, nested issue paths, and schema submit output into React forms.'
84 requires:
85 - choosing-form-options-modes
86 sources:
87 - packages/form-core/src/standardSchema.public.ts
88 - packages/form-core/src/standardSchema.lib.ts
89 - packages/form-core/src/FormApi/FormApi.public.ts
90 - packages/form-core/tests/validation.test.ts
91 - packages/form-core/tests/validation.test-d.ts
92 - packages/form-core/tests/FormApi/submission-handling.spec.ts
93 - examples/react/field-groups/src/index.tsx
94 references:
95 - references/schema-validation-and-submit-output.md
96 - name: Query Backed Forms
97 slug: query-backed-forms
98 type: composition
99 domain: async-data-and-submit
100 path: packages/react-form/skills/query-backed-forms/SKILL.md
101 package: packages/react-form
102 description: 'Use when combining React forms with query-like async defaults, maybe-undefined incoming data, emptyFormValues fallbacks, gated field mounting, async onSubmit, mutation calls, and transient-vs-validation errors.'
103 requires:
104 - react-form-composition-setup
105 sources:
106 - packages/react-form/tests/useForm.spec.tsx
107 - packages/form-core/src/FormApi/FormApi.lib.ts
108 - packages/form-core/src/FormApi/FormApi.public.ts
109 - packages/form-core/src/FormApi/handleSubmit.lib.ts
110 - packages/form-core/tests/FormApi/default-value.spec.ts
111 - packages/form-core/tests/FormApi/submission-handling.spec.ts
112 - maintainer_guidance.query_shape
113 references:
114 - references/query-backed-defaults-and-submit.md
115 - name: Error Visibility Workflows
116 slug: error-visibility-workflows
117 type: framework
118 domain: validation-and-error-visibility
119 path: packages/react-form/skills/error-visibility-workflows/SKILL.md
120 package: packages/react-form
121 description: 'Use when implementing errorVisibility callbacks, createErrorVisibility helpers, show-after-blur, show-after-submit, grouped submission attempts, fieldState.meta visibility, or reusable validation trigger policies.'
122 sources:
123 - packages/form-core/src/validation.public.ts
124 - packages/form-core/src/FieldApi/fieldState.lib.ts
125 - packages/form-core/src/utils.public.ts
126 - packages/form-core/tests/validation.test-d.ts
127 - packages/form-core/tests/FormApi/validation.spec.ts
128 - packages/form-core/tests/FormGroupApi/FormGroupApi.spec.ts
129 - examples/react/ui-integration-shadcn/src/app/booking/shared-form.tsx
130 references:
131 - references/error-visibility-policies.md
132 - name: Type Error Debugging
133 slug: type-error-debugging
134 type: framework
135 domain: diagnostics-and-examples
136 path: packages/react-form/skills/type-error-debugging/SKILL.md
137 package: packages/react-form
138 description: 'Use when explaining large TypeScript errors from ReactFormType, FieldWithValue, AnyFieldApi, formOptions, appFormOptions, createErrorVisibility, createValidators, field groups, DeepKeys, DeepValue, or schema modes.'
139 requires:
140 - react-form-composition-setup
141 - choosing-form-options-modes
142 sources:
143 - packages/form-core/tests/validation.test-d.ts
144 - packages/form-core/tests/deep-keys.test-d.ts
145 - packages/react-form/tests/submit-return.test-d.tsx
146 - packages/react-form/tests/FormGroup.test-d.tsx
147 - packages/react-form/tests/FieldGroupApi.test-d.tsx
148 - packages/react-form/src/AppForm/getFormHookHelpers.public.ts
149 - packages/react-form/src/FieldGroup/withFields.public.ts
150 references:
151 - references/type-error-boundaries.md
152 - name: Examples Authoring
153 slug: examples-authoring
154 type: lifecycle
155 domain: diagnostics-and-examples
156 path: packages/react-form/skills/examples-authoring/SKILL.md
157 package: packages/react-form
158 description: 'Use when scaffolding realistic React examples for TanStack Form v2, including schema-driven forms, query-backed forms, error visibility workflows, app-form UI integrations, field groups, arrays, and reorder behavior.'
159 requires:
160 - react-form-composition-setup
161 sources:
162 - examples/react/basic/src/index.tsx
163 - examples/react/array/src/index.tsx
164 - examples/react/basic-splitting-form/src/index.tsx
165 - examples/react/field-groups/src/index.tsx
166 - examples/react/ui-integration-shadcn/src/app/booking/shared-form.tsx
167 - examples/react/ui-integration-shadcn/src/app/booking/booking-form.tsx
168 - examples/react/ui-integration-dnd-kit/src/singleList/index.tsx
169 - examples/react/ui-integration-dnd-kit/src/twoLists/index.tsx
170 references:
171 - references/example-scenarios.md
172tensions:
173 - name: schema_strictness_vs_editable_defaults
174 skills:
175 - choosing-form-options-modes
176 - schema-driven-forms
177 - type-error-debugging
178 implication: 'Generated skills must warn against fighting nullish editable defaults with assertions or reading raw value for pipeline output.'
179 - name: query_loading_ui_vs_form_initialization
180 skills:
181 - query-backed-forms
182 - examples-authoring
183 implication: 'Generated skills must tie the default-values plan to the visual loading workflow.'
184 - name: validation_state_vs_transient_state
185 skills:
186 - query-backed-forms
187 - schema-driven-forms
188 - error-visibility-workflows
189 implication: 'Generated skills must keep transient query/network failures out of form validation state.'
190 - name: reuse_vs_inference_boundaries
191 skills:
192 - react-form-composition-setup
193 - reusable-form-policies
194 - type-error-debugging
195 - examples-authoring
196 implication: 'Generated skills must prefer inference, helper types, and field groups over assertions, hand-written field shims, or ReactFormType unions.'
197cross_references:
198 - from: react-form-composition-setup
199 to: examples-authoring
200 - from: react-form-composition-setup
201 to: reusable-form-policies
202 - from: reusable-form-policies
203 to: react-form-composition-setup
204 - from: reusable-form-policies
205 to: error-visibility-workflows
206 - from: reusable-form-policies
207 to: type-error-debugging
208 - from: examples-authoring
209 to: react-form-composition-setup
210 - from: choosing-form-options-modes
211 to: schema-driven-forms
212 - from: choosing-form-options-modes
213 to: type-error-debugging
214 - from: schema-driven-forms
215 to: query-backed-forms
216 - from: query-backed-forms
217 to: error-visibility-workflows
218 - from: type-error-debugging
219 to: react-form-composition-setup
220gaps:
221 - id: missing-tanstack-query-example
222 skill: query-backed-forms
223 status: open
224 note: 'No checked-in examples/react/tanstack-query example existed during discovery; query-backed form guidance is reviewed from tests and maintainer interview.'