Weekend Agent Challenge: Word Coach

Hi there. Let me tell you about the little agent I built this weekend, because I
think you'll like how gentle it turned out to be. It's called word-coach,
and the whole idea is simple: it reads a sentence you're about to send, and it
tells you — kindly — how the tone is going to land. No red ink. No scolding.
Just a friend reading over your shoulder before you hit send.

---------------------------------------------

You know that moment. You've typed "we regret to inform you the feature is
delayed" and something feels off, but you can't name it. word-coach can. You
paste the line, and it says, warmly, "this one lands a little heavy — try naming
the fix, not just the problem." It doesn't rewrite your words for you. It just
nudges, so the next sentence is yours and better.

I built it for you if you ever stare at a Slack message, a support reply, or a
release note and wonder does this sound as warm (or as neutral) as I meant?
Writers, support folks, anyone who cares how their words feel to the person on
the other end. It's not a grammar checker — plenty of those exist. It's a tone
checker, and tone is the part we usually get wrong when we're tired or rushed.

---------------------------------------------

Here's the nice part: there are only two pieces, and nothing to deploy.

The first piece is Node.js, running right there in your terminal. No server
to babysit, no stack to stand up, nothing humming in the background while you
sleep. You run node index.js, and the agent is simply there, line by line,
until you type bye.

The second piece is Amazon Comprehend — specifically its DetectSentiment
call. This is the clever bit I leaned on. AWS reads the mood of your text and
hands back four numbers: positive, neutral, negative, and mixed. My job was to
turn those cold scores into plain, encouraging language a human would actually
want to hear. So instead of "negative: 0.82," word-coach says "this reads a
little sharp — want to soften the opening?"

For AWS tools, that's the whole list: the AWS SDK for JavaScript talking to
Amazon Comprehend, and your own credentials (aws configure or aws sso login,
whichever your team uses). I kept it deliberately tiny. There's no
CloudFormation here, no always-on anything — you pay only for the words you
actually check, which for everyday use is pennies, often nothing.

The first time you run it, I ask you just two gentle questions — your region and
an optional profile — and I remember the answers in ~/.word-coach.json so you
never have to think about it again.

---------------------------------------------

The one thing I'm proudest of is that word-coach never alarms you. Every
message, even an error, is written to reassure rather than scare. No credentials?
It doesn't throw a stack trace — it says, plainly, "I can't find your AWS login
yet; try aws configure." No Comprehend permission? It names the exact one to
ask your admin for. Forgot to npm install? It reminds you in one friendly line.

How do I know it worked? I handed it the harshest message I could write — a curt
rejection email — and instead of a wall of red, it gave me one calm sentence:
"this lands cold; a single warm line up top will carry the bad news better." I
softened the email, re-ran it, and watched the tone shift from negative to
neutral in word-coach's own words. The agent didn't fix my writing. It made me
want to. That small lift — encouragement instead of correction — is the entire
point, and it held up every time I tried to break it.

---------------------------------------------

---------------------------------------------

There's nothing to tear down when you're done — it's just a script. Delete
~/.word-coach.json if you'd like it to forget you. Thanks for reading along;
go write something kind.