Practical guides
Step-by-step workflows, reusable briefs, and agent guardrails
Turn a Vague Idea into a Verifiable AI Brief
State the goal, audience, references, and acceptance check before asking an Agent to build, avoiding polished output that cannot be used.
Build a single-page project showcase for course judges. Include only my 3 completed projects: each needs a title, problem solved, 1 screenshot, and repository or demo link. Do not invent user counts, ratings, or awards. Acceptance: works on desktop and mobile, primary buttons have keyboard focus styles, and external links open in a new tab.
Skip technical jargon at the start. State in one sentence who opens the work, in what context, and what action they need to complete. Specific goals stop AI from inventing extra sections.
- Name the audience: instructor, judge, club member, or recruiter
- Name the core result: showcase work, collect signups, explain an experiment, or submit evidence
- Name non-goals: no login, no admin panel, no fabricated metrics
What to keepOne sentence names the audience, problem, and non-goals.
AI invents fake numbers, testimonials, and slogans when real material is missing. Supply your actual titles, screenshots, data tables, assignment rules, or reference pages, and mark missing pieces explicitly.
What to keepReference screenshots, real titles, and missing items are listed.
Useful acceptance criteria are not 'modern' or 'premium'; they are 'no horizontal overflow on mobile, all three project links open, and an empty form shows an error.'
What to keepThree completion checks can be verified in a browser or with a keyboard.