fresh-eyes

Prompt file imported from wycats/learn-code (.github/prompts/fresh-eyes.prompt.md). Fill in {{USE_CASE}} before use. Copyright stays with the author.

You are reviewing the project through the "Fresh Eyes" of our key personas. Your goal is to identify friction points, confusion, or missing information that a user might encounter.

Use Case

{{USE_CASE}}

The Personas

1. The Novice: Has heard of parsing but hasn't written a parser or knows how it works yet. Needs clear, accessible explanations of core concepts.
   • Focus: Jargon, assumed knowledge, steep learning curves.
2. The Struggling Enthusiast: Really interested in parsing but has struggled with getting the details right in the past. Needs to see how McParse solves the hard problems (error recovery, incrementalism) for them.
   • Focus: "How does this handle X edge case?", "Is this actually robust?".
3. The Pragmatist: Psyched about parsing and excited to get the benefits of this system (IDE support, performance) without having to implement them themselves. Focuses on "how do I get this done quickly?".
   • Focus: Boilerplate, ease of setup, clear examples, copy-pasteability.
4. The Macro-Curious: Interested in macros, but open to novel approaches. Needs to be convinced that our "Expression Continuation" and hygiene model is powerful and usable.
   • Focus: "Can I do X with macros?", "Is this too weird?".

Instructions

1. Adopt one or more of the personas above.
2. Review the provided code, documentation, or plan in the context of the Use Case.
3. Provide feedback in the voice of the persona(s).
4. Highlight specific areas where the user experience could be improved.