Vibe-Coding Center / Field guide

Write a better starting brief

Define one observable learning task, the intended audience, and the information the tool needs. Copy the template into your project and replace the questions with real decisions.

Download PROJECT_BRIEF.md

Full reference

Project brief

This is your project's plan: what you are building, who it serves, its data boundaries, and the evidence of success. It is separate from WEB_DESIGN.md, which tells the assistant how to approach design.

Copy this file to your project root as PROJECT_BRIEF.md. Replace the prompts below with your decisions. Keep student information out of the brief. Put it alongside WEB_DESIGN.md, EDU_COMPLIANCE.md, and securevcc.md before using the starting prompt.

One useful task

What should an educator, learner, or family member accomplish? Describe one observable outcome. Example: a teacher creates a printable vocabulary activity without signing in.

Audience and setting

• Intended users and age band:
• Reading level and languages:
• Devices, bandwidth, and school restrictions:
• Accessibility needs and alternative ways to complete the task:

Boundaries

• Information the task actually needs:
• Information we will not ask for:
• Where information exists: browser memory, device storage, hosting logs, server, or a vendor:
• Accounts, sharing, uploads, AI services, analytics, or embeds:
• Who can approve any proposed student-data processing:

Unknown answers remain unverified. Prototype with invented examples while decisions are unresolved.

Experience

• Most important action:
• Second and third tasks:
• Page structure that fits those tasks:
• Design references and what general principles they illustrate:
• What happens when something fails:

Technical decisions

• Existing stack and hosting:
• Dependencies and permissions allowed:
• Budget or external-service limits:
• Working features that must be preserved:

Evidence of success

• Main journey to test:
• Keyboard journey to test:
• Phone and high-zoom/reflow checks:
• Data-flow and relevant security checks:
• School/vendor/contract questions that need a human owner:

AI invocation

Read WEB_DESIGN.md, EDU_COMPLIANCE.md, and securevcc.md. Apply them to this brief. Start by inspecting the project. Do not invent approvals, test results, or legal claims. Explain the proposed structure, build a small working version, and report evidence and limitations.