← Dashboard

How I write comments

Mark Barnett · St. Francis Middle School · built with Claude Code · revised 2026-05-21 with raw transcripts

Every grading cycle, I talk through each student into a voice recorder — what's working, what isn't, what I want a parent to take away. Nothing polished. Tangents, restarts, "ums", reminders to myself, judgments I'd never put in writing, meta-instructions to myself about how to handle a particular kid carefully — all of it. A brain-dump app I built called Bidet AI transcribes the recording verbatim. That's the left column below: my actual voice, exactly as Bidet captured it. First names only — last names anonymized.

The hard part was always sitting down and writing 27 polished comments in my voice, in the FACTs format the school expects, without getting numb to it by student #5. So I built a comment generator inside Claude Code. It's a project with custom instructions that hold all the voice rules I've worked out over the years — what to say, what to never say, the closing phrase that has to be in every comment, the format the school's grade book wants. Every cycle, all I do is paste three things in: the FACTs HTML format spec, the gradebook CSV, and my brain dump transcript. The model reads my voice off the brain dump, pulls the grades off the CSV, and writes a comment per student that sounds like me — because the voice rules are mine, the source material is mine, and the constraints are mine. I check it, push it into FACTs, done.

The previous version of this report had the brain-dump column already cleaned up. That defeats the point. What follows is what I actually said into the recorder before any cleaning — including the things that would never reach a parent. The right column shows what the model did with it. The reasoning section at the bottom explains the rules the model worked through.

What I fed it

Side by side — raw brain dump → comment

raw brain dump (verbatim)
Lauren
"All right. Lauren. Lauren is just awesome. She is so much fun. She has so much personality in class. She is highly engaged and really helps out the whole class with her, like I said, her engagement. She kind of makes other people think as well as asks great questions. You know, she needs confirmations on things that help confirm stuff for everybody. She has really, really worked hard. She has put a lot of effort into into this class and it's paid off. Right. Yeah. Just an incredibly high average. High A on the final exam. Just very, very impressed with her work ethic and desire to do well. So we do need to put 96 in the grade for her final. And I think I want to keep her in support. So for the next year, either it's S or T, I would like to keep Lauren in support for next year."
generated comment
Lauren · Final 96.0 · S

Lauren has brought tremendous personality and engagement to class all year, the kind of energy that lifts everyone around her and pushes the conversation forward. She asks great questions, helps confirm material for the whole room, and her work ethic shows in an outstanding average and a 96 on the final exam. I have appreciated her drive and her willingness to do the work, and I am looking forward to seeing where she takes that next year. It has been a pleasure teaching Lauren, and she is finishing the year strong.

raw brain dump (verbatim)
Grayson
"Grayson. Boy, we got to be careful in writing this one. Mom is a teacher at a different school. Grayson just struggles. Grayson is immature. Grayson, and you can't put it, but Grayson is very dishonest. You just can't trust him. He rushes through his work. He does okay. What I really don't like, and I've mentioned to him before, is that he seems to kind of settle for okay grades. He gets an 80. He gets a low B and says, yep, I passed. And he's, and I get that. You work to what your ability is and what your skill is and that kind of thing. And a part of this is what he's doing is kind of compensating. He's low. Right. He did, I'm not even going to say he finished strong. He just, yep. Yeah. No, no, no. All right. Back at it. Took a little pause there. Time to talk. All right. So Grayson. Yeah. I mean, he squeaked by. And it's all kind of almost cliche. I really need him to slow down and, and, and put the effort into doing it right. Instead of just doing it. And I'm not sure how to phrase all this really nice. Like I said, his mom is a teacher, so she kind of gets it. So you need to work with all of that. And when, when we try and turn that into a comment, we need to be positive. We need to end the year strong. Um, um, I don't need to call anybody out. It's the end of the year. Um, this is the one time where I'm okay with some of the cliches and stuff. Um, so, um, that'll be an interesting one."
generated comment
Grayson · Final 70.0 · S

Grayson has had a steady year and worked through the material with a willingness to keep moving forward, even when the content got more challenging in the later chapters. He has shown he can do the work when he slows down and gives himself the time to do it right, and that is something that will serve him well next year. I have enjoyed having him in class, and there is real ability there to build on going forward. Grayson is finishing the year strong.

raw brain dump (verbatim)
Beau
"Next is Beau. Um, phenomenal. Um, he, uh, he also kind of works too fast. He has real messy handwriting. Um, but he figured it out. Um, and so this last quarter, uh, he has really turned it on. He figured out how to study for tests. He has learned how to study for these tests. He has learned how to prepare for these tests. Um, yeah. He got a B and then two A's on the last final test. So he is, um, he's another one that, that, uh, in a way similar to Grayson, and, and, and just the, the, the doing fast and go. Um, but, um, Beau was super engaged this last half of the year, um, asking questions, trying to do his best. He really put forth the effort and I recognized it. Um, and it paid off because his grades did pop up and you can tell that he understood more and you can, and it shows in, in, um, in the, uh, in the tests. So super, super, super, super proud of Beau. I mean, got a 91 on the final exam. I mean, um, that is not where Beau was at the beginning of the year. So he has made some great progress and I'm looking forward to see what he can do in seventh grade, um, history. Um, still need to keep him in support."
generated comment
Beau · Final 91.0 · S

Beau has made some of the most noticeable growth in the class this year, particularly in the last quarter where he really turned it on and figured out how to study and prepare for tests. His effort showed up in his grades, and that 91 on the final exam is genuine proof of how far he has come from where he started. I have appreciated his engagement and the questions he brings to class, and I am excited to see what he does in seventh grade history. Beau is finishing the year strong.

raw brain dump (verbatim)
Hadley
"Next is Hadley. Um, another one I am just so proud of. She's another one that during the year, she figured it out. She figured out how to properly study. She figured out what she needed to study. She did her essays. She's learned how to write a proper essay. Um, and once again, much so engaged towards the end, asking questions. Um, her confidence has really, really grown. Um, it's great to see her confidence grow from quiet at the beginning of the year to asking questions. And, and pushing me on questions kind of thing, um, making sure she gets the answer that she needs. Um, and it shows in her grades. Once again, um, she has dominated testing. She has figured it out in the last few grades. We're all high A's. She absolutely earned this 96 average in the class. And I'm very, very proud of what she's accomplished this year, right? All the same, looking forward to next year. Um, and she is one I will put into T. I will recommend her for T. It may not. Um, yeah, let's go ahead and put her for T for right now. Right? And she earned a 96 on the final exam. Make sure that gets recorded."
generated comment
Hadley · Final 96.0 · T

Hadley has been a quiet powerhouse all year, and watching her grow into asking questions and pushing for the answers she needs has been one of the highlights of my year. She has figured out how to study, how to write a proper essay, and how to dominate testing — her 96 average and 96 on the final exam are her own. Her confidence has grown alongside her grades, and I am proud of what she has accomplished. Hadley is finishing the year strong.

raw brain dump (verbatim)
Harrison
"Harrison. Um, he did fine. He did great. I don't think he worked up to his ability. Um, he was making some not so great, some poor choices towards the end. Uh, uh, behaviorally, but we don't need to include that. He's, he's got all the right stuff. Um, um, let's just be generic with him. Um, had a good year, worked hard, um, understood everything he's going to go into. I'll recommend him for traditional. Um, and he earned an 87 on the exam. Um, I really think he could have done better. He could have worked a little harder, pushed a little, put a little more effort into it. Um, and had a high A, but I mean, he's got a low A. You can't really complain about that. Right? Um, so we can just kind of be generic, did a good job. Um, you know, it's been a great year. Uh, that's that whole thing we get to include. Right?"
generated comment
Harrison · Final 87.0 · T

Harrison has had a good year in history with consistent work and a solid understanding of the material end to end. His grades reflect a student who comes in prepared and follows through, and he earned every bit of his low A average and an 87 on the final exam. There is plenty here to build on for next year, and I have enjoyed having him in class. Harrison is finishing the year strong.

raw brain dump (verbatim)
Massimo
"Next is Massimo. Um, he earned a 96 on the final exam and I would recommend him for traditional, but T. Right? Um, Massimo is another one who figured it out this last half of the year. He learned, um, how to study, how to prepare for these exams. He learned what he needed to do in class. Uh, very, very proud of him. Right? Um, he did great on the exams towards the end. Um, he prepared always. He practiced the essays. He did what he needed to do in order to get good grades. Um, I'm proud of him also from a, um, um, behavior standpoint that, um, he knew he might have some behavior issues sitting where he did. And because I don't have a seating chart, um, he, he chose to sit away, um, from students that he might, uh, um, have gotten in trouble with type of thing. So that was a very mature kind of decision that he made. Um, so Massimo is another one I'll recommend for T."
generated comment
Massimo · Final 96.0 · T

Massimo really figured it out this last half of the year — he learned how to study, how to prepare for exams, and what he needed to do in class to be successful. His effort and maturity showed up across the board, ending in a 96 average and a 96 on the final exam. I am proud of how he handled himself, the questions he asked, and the decisions he made about how to engage with the material. Massimo is finishing the year strong.

raw brain dump (verbatim)
Macy
"Macy. Um, she struggles in this class. Um, she struggles in general academically. Uh, she earned an 83 on the final. Um, I will recommend her for support. Um, yeah, she has trouble on the tests. Um, she does study. She puts in the work. I respect her effort. Um, but this is one of those things that just doesn't come naturally to her. Um, it gets kind of complicated with a lot of the names and proper nouns of stuff in the later, um, chapters, um, and the proper nouns and things can be harder, um, for a lot of students. Um, but she's great, um, love her attitude, love her, she's always helpful, um, she's prepared and organized, um, she's doing what she needs to do, um, it's just that it doesn't come naturally to her in struggles. Now, we can't write it that way, but, you know, it's just, I'm trying to give you some context."
generated comment
Macy · Final 83.0 · S

Macy has been a wonderful student to have in class — always prepared, always organized, always helpful, and consistently willing to put in the work. She studies hard, she asks for what she needs, and her effort showed up in an 83 on the final exam. The later chapters were demanding with their proper nouns and dense material, but she handled them with the same steady attitude she has brought all year. Macy is finishing the year strong.

raw brain dump (verbatim)
Henley
"Henley. I have had nothing but, but wonderful things to say about her ever since she joined the class. Um, she is incredibly hardworking and the, and these are all the same things I've said before, which is kind of, uh, um, makes it tough. But I mean, just a wonderful, wonderful student. I'm going to recommend her for traditional deal with the work effort, the work ethic that she has and the effort that she puts forward is impressive. She earned a 96 on the final, um, and I will recommend her for traditional and history, right? Um, just a phenomenal, phenomenal student. I can't praise her enough."
generated comment
Henley · Final 96.0 · T

Henley has been an absolute joy to teach this year and one of the hardest-working students I could ask for. Her work ethic and the effort she puts into everything she does are genuinely impressive, and they show up in a 98 average and a 96 on the final exam. She is engaged, she is kind, and she models for the rest of the class what it looks like to take the work seriously. Henley is finishing the year strong.

raw brain dump (verbatim)
Emily
"Emily. She actually earned a 100 on the final exam, had the best essays I read all year. I looked forward to reading her essays on the test. They were that thorough and that good. Emily is a natural storyteller. Um, and that works extremely well for history and essays where I teach, tell me the story. And Emily learned to tell me the story. Right. And in learning to tell the story, she also learned all the facts and vocabulary. Now she works hard. She does the effort. She, she, I love the way that she has bought into the St. Francis style. She is as organized as she can be. Um, and it pays off. She follows the whole system. Um, and it pays off in her grades, um, her attitude. She is always helpful and always kind and always thinking of others. Um, Emily and Henley are, are both. I mean, we can pretty much write the exact same comments for both of them. Um, and they'll get it. Um, hopefully I got everything, didn't leave anything out. Let's see what we can do with this."
generated comment
Emily · Final 100.0 · T

Emily is a natural storyteller, and that quality has made her writing on history essays some of the best I read all year — I genuinely looked forward to grading her tests. She has bought into the St. Francis style fully, stays as organized as she can be, and her 100 on the final exam earned with the best essay work in the class speaks for itself. She is always kind, always helpful, and thinks about the other students around her. Emily is finishing the year strong.

The reasoning the model worked through

The universal rules — applied to every comment:
Where the rules earn their keep — three examples:
What I didn't have to do this cycle: