AI & Agent Resources

📖 Table of Contents

Agent Knowledge Files
How to Use These Files When Prompting an AI
- Quick Reference Prompts
Prompt Templates

Agent Knowledge Files

File	Best for
SmarkForm Forms	Implementing forms — CDN/npm/downloaded-copy snippets, common component patterns, lists, actions, hotkeys, prompt templates, agent checklist
SmarkForm Usage	Deep internals — component types, list template roles, `exportEmpties`, `@action` decorator, `find()` timing, CSS grid layout

Both files are versioned alongside the library and always reflect the deployed release.

How to Use These Files When Prompting an AI

Decide which task you need help with (implement a form, update docs, write tests, etc.).
Open the relevant page from the table above and copy its content.
Paste it at the top of your prompt (or attach it as context), then describe your specific request.
Include your desired schema — field names, types, list structure — so the AI can generate matching HTML immediately.

Quick Reference Prompts

You can also link the agent directly to the versioned page:

Read https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms
then implement a contact form with fields: name, email, message.
Load SmarkForm from CDN (pin to the latest stable version).

Prompt Templates

The following ready-to-use prompts are reproduced from the SmarkForm Forms reference page. Copy, adapt, and paste into your AI assistant.

Simple form

Using SmarkForm (CDN ESM: https://cdn.jsdelivr.net/npm/smarkform/dist/SmarkForm.esm.js),
create a contact form with fields: name (text), email (email), phone (text, optional),
message (textarea). Include Export and Reset buttons. Log exported data to the console.
Follow patterns from https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms.

Form with a repeating list

Using SmarkForm loaded via CDN (UMD: https://cdn.jsdelivr.net/npm/smarkform/dist/SmarkForm.umd.js),
create an invoice form with:
- Header fields: client name (text), date (date)
- A line-items list (name it "items") where each item has: description (text),
  quantity (number, SmarkForm null-aware), unit_price (number, null-aware).
- min_items:1, max_items:10 on the list.
- Add/Remove hotkeys + and -.
- Export and Reset buttons outside the list.
Output exported JSON to a <pre> element on the page.
Refer to https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms for patterns.

Adding SmarkForm to an existing page

I have an existing HTML page. Add a SmarkForm registration form to the
#registration-section div. Fields: username (text), password (input type="password",
plain input — not a SmarkForm type), role (radio: admin / editor / viewer).
Load SmarkForm from npm (already installed as "smarkform"). Use ESM import.
Set defaultValue for role to "editor". After export, POST the data to /api/register.
See https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms for patterns.