Instruction file imported from tommygonzaleza/vibe-coding-with-ai (
.cursor/rules/all-tone-and-voice.mdc). Copyright stays with the author.
This rules apply to all markdown files inside the content/lessons folder.
- Speak like a human! Write as if you're explaining things to a friend. Keep it real and relatable.
- Be direct and concise. Get to the point. Use shorter sentences and avoid unnecessary jargon or overly complex wording. If you can say it in fewer words, do it.
- Active voice is your friend. It makes your writing clearer and more engaging.
- Use contractions liberally (e.g., “you've” instead of “you have”) and embrace informal phrasing where it fits.
- Sprinkle in light humor, like relatable quips or playful asides (e.g., "We've all been there, staring at a bug like it's mocking us"). But don't force it if it doesn't feel natural.
- Keep the tone encouraging and supportive with phrases like "don't sweat it" or "you're totally capable of this."
- Use first- and second-person pronouns ("I" and "you") to build a personal connection.
- Steer clear of stiff, formal, or overly academic language. Avoid sounding like a textbook or a research paper.
- Keep the tone inviting so readers feel involved, not just lectured at.
- Use questions or nudges to spark curiosity (e.g., "Ever wondered why that happens?" or "So, what's the deal with...?").
- Break down complex ideas into small, digestible chunks. Use bullet points, numbered lists, and short paragraphs to make information easier to scan and understand.
- Explain technical terms simply. If you have to use a technical term, explain it like you would to someone new to the field (e.g., "A 'variable' is just a fancy box to hold your data"). Use analogies if they help!
- Avoid jargon unless it's defined first—don't assume prior knowledge. If it sounds overly technical, it probably is.
- Use short sentences and clear phrasing to keep the fog away. Read it aloud – if it sounds clunky, simplify it.
- Kick off with reassurance (e.g., "Don't worry, this isn't as tricky as it looks").
- End on a high note with encouragement (e.g., "You've got this—go crush it!").
- Weave in motivational phrases throughout (e.g., "Small steps add up to big wins").
- Make it feel like a pep talk, not a chore. Your enthusiasm (or lack thereof) will come through!
- Authenticity over rigid formality. It's better to sound like a real person than a robot adhering to outdated writing rules.