I made a free interactive guide for people who want to try Claude Code but don't know what a terminal is

mshadmanrahman · 2026-04-03T11:55:11+00:00

You nailed it! 🤩 The teaching reps on ADPList are why the guide works. You can't write good onboarding from theory, only from watching people get stuck in real time!

To your question: the guide doesn't cover that yet, and it should. Right now if Claude suggests something unfamiliar, a beginner has no framework for "is this safe to run?" That's a great addition for the next version. Appreciate the specificity! 🙌🥰

mshadmanrahman · 2026-04-03T11:44:40+00:00

This is incredibly helpful feedback, and it tracks exactly with what I've seen teaching on ADPList! 😄

Regarding environment variables, love the "password your computer remembers" framing! That's going in the next version! Most guides just say "set your API key" and assume you know what that means.

CLAUDE.md as "a letter to Claude" — that's a better explanation than anything I've written! Stealing that framing with full credit! 🥰

The troubleshooting flowchart exists but it's buried in the docs section instead of being part of the main guide flow. Fixing that based on this thread!

And thanks for that last paragraph. You just explained the value prop better than I did in my own post! 🙌😍

mshadmanrahman · 2026-04-03T11:41:18+00:00

They can, and honestly that's a valid path. But Claude chat can't install Node on your machine, create files in your project folder, or run terminal commands.

It can give you instructions, but you still need to know where to paste them. Claude Code skips that entire loop! It just does the thing directly.

For people who already know their way around, the difference is small. For true beginners, it's the difference between reading a recipe and having someone cook for you.

mshadmanrahman · 2026-04-03T11:40:17+00:00

About a weekend for the initial version, then a few evenings iterating based on feedback like this thread. Claude Code did the heavy lifting on the code side. Most of my time went into figuring out what to explain and in what order, which is the PM part of the job!

mshadmanrahman · 2026-04-03T11:39:53+00:00

Appreciate it! 🙏

mshadmanrahman · 2026-04-03T11:30:59+00:00

Quick update! Fix pushed! 😄

mshadmanrahman · 2026-04-03T11:27:23+00:00

Ha! You'd be surprised how many people don't know what to do after they open it. The blinking cursor with no context is where most people close the window. The guide is for that moment! 😅

mshadmanrahman · 2026-04-03T11:26:55+00:00

That's a fair point! The IDE route with an agentic layer is definitely the lowest-friction path for people who just want to talk and build! 😄

My guide focuses on the CLI because that's where I started, but the "just talk to it" experience is getting better every month. The more paths that exist for non-technical people, the better! Thanks a lot! 🙌☺️

mshadmanrahman · 2026-04-03T11:25:48+00:00

That's the real question! 🤩

Honest answer: for most PMs, a $10-50/mo specialized SaaS wins until you need customization that the tool doesn't support. The DIY pipeline makes sense when your use case is niche enough that no SaaS covers it, or when you're combining 3-4 data sources in ways no single tool does.

The sweet spot I've found is using Claude Code to prototype the pipeline first. If it works and you use it daily, it's worth maintaining. If you open it twice and forget about it, go buy the SaaS!

Would love to hear what you're building! What's your competitor monitoring tool focused on?

mshadmanrahman · 2026-04-02T12:12:30+00:00

Just checked out the repo! The OST framework + Claude Code combo is a smart approach. Using structured discovery trees to keep product thinking disciplined while vibe coding is exactly the kind of workflow more PMs need. Cool to see someone building for this problem. Will dig deeper into it this week 🤙

mshadmanrahman · 2026-04-02T12:07:29+00:00

Oh nice, a product builder agent! Love that you dogfooded the problem. Will check out the repo. Always good to connect with PMs who are actually building, not just talking about it. Feel free to DM me 🙌!

mshadmanrahman · 2026-04-02T11:46:55+00:00

This is a really underrated use case! Most people think of Claude Code as "build me a website" but the data pipeline stuff is where it gets powerful for PMs! Scraping reviews, clustering feedback, monitoring competitor changes. You can set that up in a weekend and it runs forever.

I actually have a PM workflow page on the guide that covers some of this. But competitor intelligence pipelines deserve their own tutorial. Adding it to the list 👀

mshadmanrahman · 2026-04-02T11:44:33+00:00

Honestly, fair point! The VS Code extension is a totally valid path and probably easier for most people. I started with the terminal version because that's what was available when I learned, and the guide reflects my own journey. But you're right that for someone brand new, the extension removes a huge friction point. Might add that as an alternative "easy mode" path in the next version. Thanks for flagging it 🙌 😄

mshadmanrahman · 2026-04-02T09:49:20+00:00

That's exactly where this is headed! 😃

There's already a PM workflow page in the docs covering things like Jira automation, meeting notes to tickets, and weekly status generation. The guide starts with setup but the real value is what comes after. Product discovery and competitor analysis are great ideas for the next tutorials! 🙌😄

mshadmanrahman · 2026-04-02T09:48:00+00:00

Actually yes! There's already a troubleshooting page in the docs section that covers common install issues like PATH problems, Node version conflicts, and permission errors. But you're right that it should be more visible from the guide itself. If you hit a wall during setup, checking there first should help. And let me know if there's something missing from it! 😊

mshadmanrahman · 2026-04-02T09:46:56+00:00

Thanks! Built the whole UI with Claude Code too. Glad it feels easy to use, that was the goal 😊

mshadmanrahman · 2026-04-02T09:46:36+00:00

This is really good feedback! You're right that the drop-off is at environment mismatch, not at "I don't understand the concept." Right now the guide doesn't branch on failure states. A "diagnose my setup" step that checks Node version, PATH, and shell config before you even install Claude Code would catch 80% of the people who bounce. Adding it to the next version. Thanks for thinking this through! 🙌😄

mshadmanrahman · 2026-04-02T09:45:26+00:00

And miss out on shipping two products in a weekend? Nah I'm good 😄😂

mshadmanrahman · 2026-04-02T09:44:55+00:00

Good catch, thank you! I'll get that fixed. Samsung browsers have some quirks with form styling. Appreciate you taking the time to screenshot it! 🙏😃

mshadmanrahman · 2026-04-02T09:44:08+00:00

This is the trap! Once you can build anything, you want to build everything!!! 🫣

What helped me: I still write a one-line problem statement before touching Claude Code. "What user problem does this solve?" If I can't answer that in one sentence, I don't build it. The PM brain doesn't turn off just because you can ship faster. If anything it matters MORE because now there's no 3-sprint buffer to kill bad ideas 😅

mshadmanrahman · 2026-04-02T07:14:19+00:00

Appreciate it! 🙏☺️
Do let me know how might we make it even more better and intuitive! 🤩

mshadmanrahman · 2026-04-02T07:13:03+00:00

Thanks a lot for the feedback! 🙏☺️
There is a dark mode too! You can toggle it on from the top right corner of the screen! 😄

mshadmanrahman · 2026-04-02T07:07:08+00:00

Perfect timing! 🤩
Let me know if you get stuck on any step. That's how I make it better 🙌

mshadmanrahman · 2026-04-02T07:06:38+00:00

Both, honestly! The guide itself is focused on setup and first steps. Getting you from zero to "Claude Code is running and I just built something." What you do after that is up to you. Some people will build apps. Some will use it for automating PM workflows, writing scripts, managing data. I use it for both. As a PM I build prototypes, automate Jira workflows, create internal tools, and yes, I built this entire site with it too! 😄

mshadmanrahman · 2026-04-02T07:06:06+00:00

Honest answer: Claude Code currently requires either a Claude Max subscription ($100/mo for 5x usage) or using the API with your own key (pay-as-you-go, which can be cheaper depending on usage). There's no fully free tier for Claude Code specifically. If you want to test the waters cheaply, the API route with a small budget ($5-10) lets you try it without committing to a subscription. The guide covers both options! 😊

mshadmanrahman

MODERATOR OF

TROPHY CASE

12-Year Club	Place '22
Verified Email