Vocabulary for Describing a Broken Layout to Claude Code
Region, element, and state words that keep their meaning when your feedback reaches Claude Code as markdown. Use these instead of vague pointing.
Posts tagged “terminology”
Words to Use When Pointing at a Button or Region
Say "the primary button in the modal header" instead of "that thing at the top." A working vocabulary for naming buttons, labels, and regions in feedback.
The Words to Use When Describing a Screen to an Agent
Frame, crop, pin, item, review link. Define the words you use to describe a screen so your prompt to an agent or a teammate points at the exact spot you mean.
When an AI Coding Agent Reads Your Feedback
A short glossary for reviewers whose feedback ends up in an agent's context window. Define the artifact, the pin, the prompt, and what each one changes.
Agent Feedback as an Artifact Format, Defined
Agent feedback is not a vibe or a workflow buzzword. It is a specific artifact with a specific shape. Here is what it contains and why each piece is there.
What an Agent-Readable Bug Report Actually Contains
The precise vocabulary for bug reports a coding agent can fix without follow-up questions. Each term defined, with practical notes on when it matters.