This website uses cookies

Read our Privacy policy and Terms of use for more information.

You open Claude Code. You type something like: "Build me a supplier engagement tool." with minimal context.

Claude Code starts working. Because Claude code is not a reasoning tool, it is an execution tool. And the output might look impressive, clean and professional.

Until you look closer. It built the wrong thing.

It did not understand who the tool was for. It made assumptions about the data. It added features you never asked for and missed the one thing that actually mattered.

The problem was not Claude Code.

The problem was that you showed up without a brief.

The rule that changes everything:

ggg

95% of your build quality is decided in Claude Chat, before you open Claude Code.

Chat is where you think → Code is where you execute.

Start with the problem. Not the tool.

Most people start by thinking about what they want to build. A dashboard. A calculator. A page for suppliers.

That is the wrong starting point.

The right question is: what problem am I solving, and for whom?

The answer determines the type of tool you need. And the type of tool determines everything else: the functionality, the data sources, how someone interacts with it, what success looks like.

There are four archetypes that cover most of what sustainability professionals build. The dividing line between them is simple: does the user need to give something to the tool, or does the tool work on its own?

These are not just categories. They are completely different builds. A live monitoring tool that feeds from an external source is a fundamentally different technical problem from a data collection tool that captures structured input from suppliers. Getting clear on which one you are building before you open Claude Code is not a nice-to-have. It is what separates a tool that works from one that looks impressive but misses the point.

If you cannot answer "what problem does this solve and which type of tool solves it" before you start, you are not ready to build yet.

WHY THIS MATTERS

The type of tool you are building determines the technical approach, the data structure, the user experience, and the time it takes to build.

Getting clear on this before you open Claude Code is not a nice-to-have. It is what separates a tool that works from one that looks impressive but misses the point.

The 95% that happens in Claude Chat

Here is how most people think about the build process:

  • Open Claude Code

  • Type what you want

  • Get the tool

Here is how it actually works when you build something useful:

  • Spend time in Claude Chat defining the idea properly

  • Refine it until you could hand it to someone and they would build the right thing

  • Open Claude Code with a brief that is clear, complete, and ready to execute

The first approach produces outputs that look like work. The second produces tools you can actually use.

The conversation in Claude Chat is not wasted time. It is the most important part of the build. This is where you get challenged on your assumptions. Where you figure out that the "simple dashboard" you imagined actually has five different user scenarios and three data sources you have not thought about yet.

Better to find that out in a conversation than after you have already built the wrong thing.

A chat can become a complete project inside Claude it all depend on how big of a tool or a deliverable you are building.

The first prompt inside Claude Code should feel almost anticlimactic. Because by then, you already know exactly what you are building.

The three challenges nobody talks about

Even when sustainability professionals understand the value of preparing properly, three things consistently stop them.

"I do not know how to start from scratch."

Staring at a blank page and trying to define a tool you have never built before is genuinely difficult. There is no obvious structure. You do not know what questions to ask yourself. You end up either too vague or going down a rabbit hole of details that do not matter yet.

"I do not know what Claude Code actually needs from me."

Claude Code is powerful, but it needs specific information to build the right thing. What the tool does step by step. Who uses it and how they access it. Where the data comes from and how often it changes. What happens at the end. Most people do not know this is what they need to provide, so they never provide it.

"I do not know the technical terms to explain what I want."

You know what you want the tool to do. You do not know whether that makes it a "single-page app" or a "multi-view dashboard" or a "connected read with external API." That gap between your expertise and the technical language creates friction that stops most people before they start.

The Tool Architect skill

These three challenges are exactly what the Tool Architect is built to solve.

It is a Claude skill that interviews you about your idea in plain language. No technical terms required. It asks the right questions, challenges your assumptions, catches what you have missed, and translates everything you know about your work into a structured brief that Claude Code can execute directly.

You describe your idea. The Tool Architect does the rest.

WHAT THE TOOL ARCHITECT DOES

  1. Asks, not assumes. It interviews you phase by phase: the problem, the audience, the functionality, the data, the design, the scope.

  2. Challenges your thinking. Vague answers get followed up on. "It will show our sustainability data" becomes a specific list of metrics, sources, and update frequencies.

  3. Manages scope. First-time builders often describe systems that are three builds away from where they should start. The skill redirects this, kindly but firmly, every time.

  4. Produces one output. A product-spec.md file. Clean. Structured. Written so that Claude Code has zero need to guess or assume anything. 

Here is what a real conversation looks like.

You tell the Tool Architect: "I want to build something that helps me present our net zero pathway to the board."

It does not start building. It asks: Is this the first time you are building something like this? Is this a chart, a dashboard with multiple sections, or a presentation tool? Who will use it and how will they access it?

You answer. It follows up. Forty minutes later, you have a product-spec.md that defines the tool precisely: a single-view interactive dashboard with three sections, static emissions data from a CSV you already have, branded in your company colors, built to be presented from your laptop.

Claude Code can build that. Correctly. In one session.

You can get The Architect skill for free, using the link below

Subscribe to keep reading

This content is free, but you must be subscribed to SustainOS to continue reading.

I consent to receive newsletters via email. Terms of use and Privacy policy.

Already a subscriber?Sign in.Not now

Reply

Avatar

or to participate

Keep Reading