The single biggest problem in communication is the illusion that it has taken place.

George Bernard Shaw

Why a Framework?

The single most important thing that we do at work is communicating with other people. It’s generally how we are able to come up with ideas and execute them in ways that a single person could not.

It does seem that this whole “talking to each other” thing can get complicated. “Miscommunication” seems to be the number one excuse for something getting messed up in a knowledge worker environment. There are a whole host of reasons why this is the case. But one of the easiest ways to combat the lack of retention, the lack of comprehension, or simple miscommunications is to start with the way that we express ourselves.

At Sourcetoad, we use an adapted communications framework that has made life a lot easier for everyone involved. We have set up some basic rules for communication that are easy to remember, and we use keywords so that people receiving the information can context switch into the receiving framework mode. In other words, when people incite the framework, everyone changes their mental stance and prepares to communicate.

An Adapted Simple Model

This framework has been adapted from an amalgamation of numerous other frameworks. It takes a lot from military communication tactics (where being understood can be the difference between life and death) and a number of other popular communication frameworks. This is just the simplest way that we’ve been able to express it. It has been hacked together from too many sources to cite, but it is still simple enough to work well for us.

The Framework

Our framework has only four key pieces:

  • Intent
  • Context
  • A sketch of the desired outcome
  • A sketch of a strategy to get to that outcome

These four items can be placed in various orders, but typically they start with intent and end with a strategy.

Intent

Stating your intent, or at least clearly knowing what your intent is, is the most powerful part of this framework. Understanding your own intent in everything is extremely powerful, but that’s another blog post. Conversations that do not have a well-understood intent are just “chats.” They’re not the type of communication that will solve any problem.

Stating your intent at the beginning of a conversation does two very important things:

  1. It switches the receiver’s brain into “communications framework mode.” It allows the other person to understand that you are about to use the framework.
  2. Stating your intent allows the person to whom you are speaking with to know why you are talking. If I don’t know what you want right at the beginning, we’re probably not going to have a fruitful conversation.

Context

Context is the backstory or history that your receiver may need to fully understand the conversation. Telling the person you’re talking to about the players involved, what previous conversations touched on, or what the stakes are can be extremely useful.

The three main questions you should ask yourself when giving context are:

  • What are we talking about?
  • What do you need to know about this?
  • Have I told you everything you need to know?

When saying this bit out loud, you can use the following trigger phrases to make sure your receiver knows you are using the framework:

  • “For a little background…”
  • “For context…”

Sketch Desired Outcome (End State)

After you’ve laid out your intentions and the context the receiver needs, it’s time to actually tell them what you want. This involves explaining your vision of the outcomes, or the “end state.”

An outcome or end state might be as complicated as: “I think what I want is for the company to open a new line of business, complete with staff and warehousing. I also think we’re going to need to custom build an entire logistics software system over the next few years.”

Or it could be as simple as: “What I would like is that at the end of this conversation, we set up a time to have a formal meeting about it with the team.”

You need to be flexible here because even though you might know what type of outcome you are looking for, you need to leave room for the solution to include new ideas from your audience. That’s why we call it a “sketch.”

When saying this bit out loud, you can use the following trigger phrases to make sure the receiver can envision what you want to happen:

  • “What I see happening…”
  • “My desired outcome is…”

Sketch a Strategy

You know what you want (intent), the receiver knows what you want (end state), and they have the backstory (context) to understand what you’re talking about — we can now move on to action.

In this phase, we outline a possible method of getting to that end state I mentioned earlier. This is up for discussion, of course. The person you’re speaking with is not required to follow your sketch. Rather, this phase invites them to build a strategy with you to accomplish the desired outcome.

The person you’re speaking with might have a much better idea of how to get there than you do, especially since they now understand your intentions and what the end goal is. So keep an open mind, and enjoy the brainstorming.

When describing the strategy you envision, Use triggers like:

  • “A rough strategy we could take is…”
  • “A path I see is…”
  • “I’d suggest x as the next steps. What do you think?”

Example 1

Intention: I want a dashboard to show the ten most important KPIs for our internal product. I want the team to manage the build-out and timing to balance client needs. I’m prepared to invest about 100 hours for the MVP.

Context: Hi Joe, some quick context: I would like for the team to build a dashboard that provides a brief overview of the system – I want this to show the variety of features for sales calls and to be useful for current clients.

Outcome: My desired end state is I get a demo-able dashboard on our test instance within the next four months. It should have 70% of the functionality shown in the mockups.

Strategy: I think the rough path to getting there is for you and Jane to meet and work out which features are doable in the next four months while balancing client requests. Then you can create tickets for the segments and decide how flexible the dashboard could be. Let’s get together for a review and approval meeting when that’s done. After that, we can start handing out the tickets to the team.

Example 2

Intention: I want to get James to switch the DNS servers for a client.

Context: Hey James, for some context, Martin asked me to help him with their new mail server. They’re going to be setting this up on their side with Office365. I’m not sure what is required 100%, though.

Outcome: I would like to send Martin an email with the steps he needs to take to prepare for the switchover and the dates when we plan on doing it. If we have any questions for him, I’d like to include those in the email by the end of the day tomorrow.

Strategy: My strategy here is that I will follow your advice and guidance to the letter because I’m not the expert.

Recap

If you are talking to someone at work, they might not actually be paying attention. Having a communications framework with key phrases and trigger words can make a huge impact on changing the mindset of the sender and the receiver. When both parties know that information is going to be transmitted in a certain way, retention and accuracy rates are way higher.

At Sourcetoad, we use the trigger words and key phrases below to help change our thinking, speaking, and listening modes:

  • Intent
    • “My intention is…”
    • “What I’m looking to do is…”
    • “What I want is…”
  • Context
    • “For some context…”
    • “A little background…”
  • Sketch of my desired outcome
    • “The outcome I’m looking for is…”
    • “When this is all done, I’d like to see…”
  • Sketch of a strategy to get there
    • “I think a rough path to get here is…”
    • “The strategy I imagine is…”

That’s it! It’s a very simple yet powerful tool to help improve communication. You can alter this plan or invent your own, but the key is that both parties know the rules. The idea that people can switch between a conversation and “communication” is life-changing – but it requires training on both sides.

Previous ArticleNext Article
I help companies turn their technical ideas into reality.

CEO @Sourcetoad and @OnDeck

Founder of Thankscrate and Data and Sons

Author of Herding Cats and Coders

Fan of squash, whiskey, aggressive inline, and temperamental British sports cars.

Leave a Reply

The State of AI-Coded Software, May 2025

I’ll probably regret writing this. At the very least, I’ll cringe reading it in a few months. But here we are.

Lately, we’ve been getting a wave of client requests asking us to evaluate software they built using AI tools. These aren’t engineers. These are business folks using increasingly powerful AI products to try and build functioning systems. And to be completely honest, the results are both impressive and a bit alarming.

People are building whole applications on their own. Backends, frontends, user interfaces, even some database logic. Sometimes they even look good. These are smart people who don’t know how to code but have managed to produce working systems.

The problems show up immediately when we start reviewing the internals. The code is usually a mess. In many cases, it would be extremely difficult to maintain or extend. And if you need to move that code from the platform it was created in to a cloud provider like AWS, you’re going to hit a wall. These platforms wrap everything in layers of scaffolding that make portability a nightmare.

Security is worse. We’ve found plaintext credentials scattered across files. We’ve seen SQL injection vulnerabilities that shouldn’t even be possible in modern frameworks. We’ve seen structural issues that would get flagged in a freshman CS class.

Despite all that, what people are creating are legitimate prototypes. They’re functional. They run. But when you’ve put a few weeks into building something, and you show it to a software engineer, it’s hard to hear that your shiny new thing needs to be rebuilt from scratch.

I want to be clear. I am not anti-AI. Almost everyone at my company uses AI tools every day. We use Copilot, Cursor, ChatGPT, Claude, and more. We build out frontends with tools like v0 and Lovable. These tools have changed how we work.

Some of our engineers report productivity improvements of 30 to 40 percent. That’s not a rounding error. That is a major shift. But they are still writing the code. They are reviewing it. They are checking for performance, clarity, security, and maintainability. They are not letting the tools decide architecture. They are using AI like they use autocomplete or linters, but with more power behind it.

This is also where expectations need to be adjusted. These systems will not save you 90 percent on development. They will not let you skip engineering altogether. But if they save you 30 percent, that’s a real gain. Imagine you’re building a house. The general contractor says it’s going to be $500,000. You tell them you already did the blueprints, filled out all the permits, and figured out the site plan using some AI tools. If they came back and said, “Alright, I’ll knock 30 percent off,” that would be the best deal of your life. That’s where we are today with AI-generated software. A solid start. A real value. Not a replacement.

For me personally, AI has made it fun to write code again. I haven’t been a working programmer in over a decade, and most modern toolchains are enough to scare me off. Now, with the right assistance, I can build something without getting stuck on Docker configs and dependency mismatches. That’s a big deal.

In the startup world, AI-first development is everywhere. Most of the current Y Combinator batch is using AI tools to write the bulk of their code. But those teams are highly technical. These are engineers using better tools, not tools replacing engineers.

So for non-developers using AI to build products, here are three things you should keep in mind:

  1. These tools are great for building prototypes. If you build something yourself, you will understand it better and will be a better partner to your engineering team. That matters.
  2. These tools can help you build usable frontend components. You probably won’t want to go live with them, but they can get you close enough to work with a real development team.
  3. If your app is small, non-critical, doesn’t store sensitive data, and lives entirely in its native platform, you can probably keep it running. That’s fine for internal use or personal projects.

One day, you’ll be able to speak an app into existence and deploy it with a voice command. It will be fast, secure, and beautiful. But today, you still need an experienced software engineer to check your work before you send real data through it. That’s just where we are right now.

The upside is huge. We can now get experts from other domains to build working prototypes and test ideas without needing an engineering team on day one. That’s powerful. But if your product is going to handle sensitive data or support real users, bring in someone who knows what they’re doing. Not because the AI is bad. Because the stakes are high.