@1dolinski/fastforms 0.1.2 → 0.3.0

package/README.md

@@ -1,61 +1,89 @@
 # fastforms
 
-Fill any form fast. Manage personas locally, fill forms from your terminal.
+Fill any form fast. Manage multiple personas locally, pick the right ones at fill time.
 
 ## Quick start
 
 ```bash
-# 1. Create your personas
+# 1. Create your first user + business persona
 npx @1dolinski/fastforms init
 
-# 2. Enable remote debugging in Chrome
+# 2. Add a form persona (org context + form-specific answers)
+npx @1dolinski/fastforms add form
+
+# 3. Enable remote debugging in Chrome
 #    Open chrome://inspect/#remote-debugging and toggle it on
 
-# 3. Fill any form (never submits)
+# 4. Fill any form — select which personas to use
 npx @1dolinski/fastforms fill https://example.com/apply
 ```
 
 ## How it works
 
 1. **`fastforms init`** walks you through creating user + business personas interactively
-2. Personas are saved as simple JSON in `.fastforms/user.json` and `.fastforms/business.json`
-3. **`fastforms fill <url>`** connects to Chrome, opens the form, fills it by label matching
-4. **Review and submit manually** in Chrome
+2. **`fastforms add form`** captures the form's org, purpose, and form-specific answers
+3. Personas are saved as individual JSON files in `.fastforms/`
+4. **`fastforms fill <url>`** connects to Chrome, picks personas, fills by label matching
+5. Form personas auto-match by URL — no need to specify which one
+6. **Review and submit manually** in Chrome
 
 ## Requirements
 
 - Chrome >= 144
 - Node.js >= 18
 
+## Persona types
+
+| Type | What it captures | Example |
+|---|---|---|
+| **User** | Who you are | Name, email, role, GitHub, bio |
+| **Business** | What you're building | Company, product, traction, one-liner |
+| **Form** | Who's asking & why | Org, purpose, form-specific answers |
+
+Form persona facts **override** user/business data. "What attracts you to Nitro" belongs on the Nitro form persona, not on your user persona.
+
 ## Commands
 
 | Command | Description |
 |---|---|
-| `fastforms init` | Create personas interactively |
-| `fastforms fill <url>` | Fill any form |
-| `fastforms edit` | Update existing personas |
+| `fastforms init` | Create your first user + business persona |
+| `fastforms add user` | Add another user persona |
+| `fastforms add business` | Add another business persona |
+| `fastforms add form` | Add a form persona (org + answers) |
+| `fastforms list` | Show all saved personas |
+| `fastforms fill <url>` | Fill any form (pick from personas) |
+| `fastforms edit` | Edit an existing persona |
+| `fastforms remove` | Remove a persona |
 | `fastforms personas` | Open web persona manager in Chrome |
 
 ### Fill options
 
 | Option | Description |
 |---|---|
+| `--user <hint>` | Pre-select user persona by name |
+| `--business <hint>` | Pre-select business persona by name |
+| `--form <hint>` | Pre-select form persona by name |
 | `--web` | Use web app personas instead of local files |
 | `--dir <path>` | Custom persona directory path |
 | `--port <port>` | Chrome debug port (auto-detected) |
-| `--user <hint>` | User persona hint (web mode) |
-| `--business <hint>` | Business persona hint (web mode) |
 
 ## `.fastforms/` directory
 
 ```
 .fastforms/
-  user.json           # Your user persona
-  business.json       # Your business persona
-  dumps/              # Optional: raw text context files
+  users/
+    chris.json
+    work-chris.json
+  businesses/
+    apinow.json
+    sideproject.json
+  forms/
+    nitro-accelerator.json
+    yc-application.json
+  defaults.json
 ```
 
-`user.json` — just fill in what you have:
+### User persona (`users/chris.json`)
 
 ```json
 {
@@ -74,7 +102,7 @@ npx @1dolinski/fastforms fill https://example.com/apply
 }
 ```
 
-`business.json`:
+### Business persona (`businesses/apinow.json`)
 
 ```json
 {
@@ -86,6 +114,27 @@ npx @1dolinski/fastforms fill https://example.com/apply
 }
 ```
 
+### Form persona (`forms/nitro-accelerator.json`)
+
+```json
+{
+  "name": "Nitro Accelerator",
+  "urls": ["nitroacc.xyz"],
+  "organization": "Nitro",
+  "purpose": "Crypto accelerator application for early-stage founders",
+  "notes": "NYC-based, 1-month residency",
+  "deadline": "2026-04-01",
+  "facts": {
+    "attracts": "The density of high-signal founders and the NYC residency",
+    "mentor": "Vitalik — his work on public goods aligns with our mission",
+    "spend": "Engineering hires and infrastructure for mainnet launch",
+    "last week": "Shipped v2 of the API, onboarded 3 beta customers"
+  }
+}
+```
+
+The `facts` on a form persona are form-specific answers keyed by label hints. They override user/business data when a form field matches.
+
 ## Web app (optional)
 
 You can also manage personas in the web UI at [293-fastforms.vercel.app/persona](https://293-fastforms.vercel.app/persona) and use `--web` flag to pull from there. The web app has an "Export for CLI" button to download your personas as local JSON files.
@@ -104,7 +153,7 @@ node bin/fastforms.js fill https://example.com/apply
 
 ### Adding a new form mapping
 
-1. Add a `buildXxxData(user, biz)` function in `lib/fill.js`
+1. Add a `buildXxxData(user, biz, form)` function in `lib/fill.js`
 2. Add a URL check in `fillForm()`
 3. Test with `node bin/fastforms.js fill <url>`
 

package/SKILL.md

@@ -11,25 +11,33 @@ Use this skill when the user says any of:
 - "fill this form with my persona"
 - "use fastforms", "fastforms fill"
 - "set up my personas", "init fastforms"
+- "add a persona", "add a form persona"
 
 ## What it does
 
 `fastforms` is a CLI tool that:
 
-1. Manages personas locally in a `.fastforms/` directory (simple JSON files)
+1. Manages three types of personas locally in `.fastforms/`:
+   - **User** — who you are (name, email, bio, skills)
+   - **Business** — what you're building (company, product, traction)
+   - **Form** — who's asking and why (org, purpose, form-specific answers)
 2. Connects to Chrome via the DevTools Protocol
-3. Fills any form using label-matching — never submits
+3. Lets you pick which user + business + form persona to use at fill time
+4. Fills any form using label-matching — never submits
 
 ## Quick start
 
 ```bash
-# 1. Create your personas interactively
+# 1. Create your first user + business persona
 npx @1dolinski/fastforms init
 
-# 2. Enable remote debugging in Chrome
+# 2. Add a form persona with org context and form-specific answers
+npx @1dolinski/fastforms add form
+
+# 3. Enable remote debugging in Chrome
 #    Open chrome://inspect/#remote-debugging
 
-# 3. Fill any form
+# 4. Fill any form — pick from your personas
 npx @1dolinski/fastforms fill https://example.com/apply
 ```
 
@@ -37,43 +45,73 @@ npx @1dolinski/fastforms fill https://example.com/apply
 
 ### `npx @1dolinski/fastforms init`
 
-Conversational persona builder. Walks through user + business persona fields, saves to `.fastforms/user.json` and `.fastforms/business.json`.
+Walks through creating a user + business persona (optionally a form persona too).
+
+### `npx @1dolinski/fastforms add user|business|form`
+
+Add another persona of any type.
+
+### `npx @1dolinski/fastforms list`
+
+Show all saved personas across all types.
 
 ### `npx @1dolinski/fastforms fill <url>`
 
-Fills any form. Reads personas from local `.fastforms/` directory by default.
+Fills any form. If you have multiple personas, prompts you to pick. Form personas auto-match by URL.
 
 Options:
+- `--user <hint>` — pre-select a user persona by name
+- `--business <hint>` — pre-select a business persona by name
+- `--form <hint>` — pre-select a form persona by name
 - `--web` — use web app personas (https://293-fastforms.vercel.app) instead of local files
 - `--dir <path>` — custom path to persona directory
 - `--port <port>` — Chrome debug port (auto-detected by default)
 
 ### `npx @1dolinski/fastforms edit`
 
-Re-run the persona builder with current values pre-filled.
+Pick any persona to edit interactively.
+
+### `npx @1dolinski/fastforms remove`
 
-### `npx @1dolinski/fastforms personas`
+Pick any persona to delete.
 
-Opens the web persona manager in Chrome.
+## Persona types
 
-## Persona sources
+### User persona
+Who you are. Name, email, role, GitHub, LinkedIn, bio, custom facts.
 
-1. **Local `.fastforms/` directory** (default) — simple JSON files, no web app needed
-2. **Web app** (`--web` flag) — https://293-fastforms.vercel.app/persona manages personas in localStorage, CLI reads via CDP
+### Business persona
+What you're building. Company, product, one-liner, traction, business model.
+
+### Form persona
+Who's asking and why. The organization that owns the form, the form's purpose, and **form-specific answers** that override user/business data. For example, "what attracts you to Nitro" is a Nitro-specific answer — it belongs on the form persona, not on your user or business persona.
+
+Form personas auto-match by URL. If your form persona has `urls: ["nitroacc.xyz"]` and you fill `https://nitroacc.xyz/apply`, it auto-selects.
 
 ## How it works
 
-1. Reads personas from `.fastforms/user.json` and `.fastforms/business.json`
-2. Auto-discovers Chrome's debug port from `DevToolsActivePort`
-3. Opens (or reuses) the target form URL tab
-4. Fills using label-matching heuristics. Has site-specific mappings for known forms.
-5. Shows what was filled, what was skipped. **Never submits.**
+1. Reads all personas from `.fastforms/users/`, `.fastforms/businesses/`, and `.fastforms/forms/`
+2. If multiple, prompts you to pick which user + business persona to use
+3. Auto-matches form persona by URL (or prompts if multiple)
+4. Auto-discovers Chrome's debug port from `DevToolsActivePort`
+5. Opens (or reuses) the target form URL tab
+6. Fills using label-matching. Form persona facts are checked first as overrides.
+7. Shows what was filled, what was skipped. **Never submits.**
 
 ## Agent instructions
 
 When the user asks you to fill a form:
 
 1. Check if `.fastforms/` exists. If not, run `npx @1dolinski/fastforms init`
-2. Run `npx @1dolinski/fastforms fill <the-url>`
-3. If Chrome debugging isn't enabled, tell the user to open `chrome://inspect/#remote-debugging`
-4. After filling, tell the user to review in Chrome and submit manually
+2. If the form is new, suggest `npx @1dolinski/fastforms add form` to capture form-specific context
+3. Run `npx @1dolinski/fastforms fill <the-url>`
+4. If Chrome debugging isn't enabled, tell the user to open `chrome://inspect/#remote-debugging`
+5. After filling, tell the user to review in Chrome and submit manually
+
+When the user wants to add a persona:
+
+1. Run `npx @1dolinski/fastforms add user|business|form`
+
+When the user wants to see their personas:
+
+1. Run `npx @1dolinski/fastforms list`