instruckt

name	instruckt
description	Visual feedback from users via in-browser annotations. Activates when the user pastes UI feedback markdown starting with '# UI Feedback', when annotations or visual feedback are mentioned, or when you need to check for pending UI feedback via MCP.
license	MIT
metadata	{"author":"joshcirre"}

Instruckt — Visual Feedback for AI Agents

Instruckt lets users annotate elements directly in the browser. The user pastes structured markdown into the chat — everything you need is in the paste.

Workflow

When the user pastes UI feedback:

1. Make the fix — the pasted markdown has the element, component, classes, and text context to find the right code
2. Check for screenshots — if any annotation mentions a screenshot, call instruckt.get_screenshot to see what the user sees
3. Resolve via MCP — call instruckt.get_all_pending to get annotation IDs, then call instruckt.resolve for each one you fixed. This removes the markers from the user's browser automatically (no reload needed).

Recognizing Pasted Feedback

When the user pastes text like this, treat it as instruckt annotations:

# UI Feedback: /dashboard

## 1. Change the heading text
- ID: `01JWXYZ123ABC`
- Element: `h1.text-xl` in `pages::dashboard`
- Source: `app/Livewire/Pages/Dashboard.php:1`
- Classes: `text-xl font-bold`
- Text: "Welcome"
- Screenshot: `storage/app/_instruckt/screenshots/01JWXYZ.png`