---

name: template-generation description: Generate connected forms and templates that persist to BizzyForge database and become searchable. Use when farmer asks to create a form, app, template, or data entry screen for equipment maintenance, scouting, spray records, seeding, grain tracking, or any recurring farm task.

Template Generation for BizzyForge

Generate forms that save data to the database - not just pretty HTML that loses everything on refresh.

Quick Start

When user asks for a form/template:

1. Check what entities exist (so dropdowns work)
2. Generate HTML with API integration (so saves work)
3. Include status feedback (so user knows it worked)

Critical Pattern: Connected Forms

Every generated form MUST include:

Copy<!-- Hidden fields for linking -->
<input type="hidden" name="template_type" value="[TYPE]" />
<input type="hidden" name="linked_entity_id" value="" />

<!-- Submit handler that POSTs to API -->
<script>
async function saveToTemplate(form) {
  const formData = Object.fromEntries(new FormData(form));
  
  const response = await fetch('/api/capture/from-template', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      template_type: formData.template_type,
      data: formData,
      linked_entity_id: formData.linked_entity_id
    })
  });
  
  // Show success/error feedback
}
</script>

Template Types

Checklist Before Generating

• Call list_entities() first to populate dropdowns
• Include hidden template_type field
• Include hidden linked_entity_id field
• Use <select> for entities (never free text)
• POST to /api/capture/from-template
• Show loading → success → error states
• Clear form after successful save

For detailed form patterns, see FORMS.md

For the API contract, see API.md