Context Capture (Scripts and Selections)
Context quality directly affects response quality. Build 53 simplifies capture around two deliberate paths: Add Selection for Script Workspace text and Metadata Explorer for schema/script context.
Capture actions
Section titled “Capture actions”| Action | Best use case | Result |
|---|---|---|
| Add Selection | Capture selected Script Workspace lines through the clipboard, or capture the active script when no multi-line range is selected. | Updates the live Script Workspace context and related metadata for the current chat. |
| Metadata Explorer | Manually select tables, fields, relationships, layouts, scripts, value lists, or custom functions when you want to guide context. | Adds precise metadata/script references that can make AI work faster and more accurate. |
| Attach files | Add text-first reference files such as notes, XML, JSON, CSV, SQL, logs, or markdown. | Attaches supporting context for the current chat without creating an editable Script Workspace target. |
| Remove badge | Detach one attached context item when it no longer belongs to the task. | Removes that individual badge without resetting the whole conversation. |
The old Add Scripts and Clear Context toolbar buttons were removed. If you need script context beyond the active selection, use Metadata Explorer > Scripts to add known scripts, or remove individual badges when context becomes stale.
Recommended flow for live script context
Section titled “Recommended flow for live script context”- In Script Workspace, ensure the target script is visible.
- If you want a focused edit, select the exact lines you want Genie to consider.
- In Genie, click Add Selection.
- Confirm the live context badge appears above the composer with the correct script and line info.
- Send your prompt in ASK, CODE, QUERY, DATA, LAYOUT, or AGENT.
Scope detection logic for Add Selection
Section titled “Scope detection logic for Add Selection”Genie decides the live capture scope from Script Workspace:
- Selected lines: captures only the selected rows through the clipboard.
- No multi-line selection: captures the active script.
- Metadata extraction: selection capture also refreshes related table, field, layout, and script metadata when available.
Add Selection can refresh the active project’s reusable cache. That cache is separate from the current chat session and from the Generic/Project Personalization settings.
Using Metadata Explorer for context
Section titled “Using Metadata Explorer for context”Metadata Explorer is the manual context surface. Use it when selecting known schema or scripts would save discovery time or make the result more precise.
Manual metadata selection is optional for AGENT. AGENT should normally navigate available metadata and MCP resources automatically before asking you to select context. If you already know the important tables, fields, layouts, scripts, or custom functions, selecting them can make the next request sharper.
Context badges
Section titled “Context badges”Context appears above the composer as removable badges:
- Live context badge: current Script Workspace script or selected rows captured with Add Selection.
- Attached script/metadata badges: scripts or metadata references added from Metadata Explorer.
- Attached file badges: text files attached with the paperclip button.
For badges:
- Preview: click a badge to inspect the captured text or reference.
- Remove: click
xto detach that item.
Attached files and metadata references are supporting context. They help Genie understand examples, schemas, requirements, or surrounding logic, but they do not widen CODE’s FileMaker edit scope or apply authority.
Pre-send checklist
Section titled “Pre-send checklist”- Captured context matches the task scope.
- Old, unrelated badges are removed.
- Metadata selection, if needed, matches the same table, field, script, or layout scope.
- Project-specific guidance lives in Settings > Personalization, not a separate Project Rules modal.
Quick recovery logic
Section titled “Quick recovery logic”- If capture fails, click Script Workspace and run one manual
Cmd+C, then retry Add Selection. - If Genie is minimized, restore it from Dock or menu bar first. See Mac Menu Bar and Dock Access.
- If results are too generic, select relevant items in Metadata Explorer or clear your Script Workspace selection and click Add Selection to capture the active script.
- If results are too broad, select a smaller range in Script Workspace and click Add Selection again.