polyGeek.

#AI #ClaudeCode #AIAgents #SoftwareDevelopment #DeveloperProductivity

Treat Your AI Like a Longtime Employee, Not a Daily Temp Hire

Your AI doesn't have a memory problem. You have an onboarding problem.

What would you rather do:

  1. Hire a new person from Upwork every morning who requires some minimal amount of onboarding before they can do anything useful for you.

Or

  1. Work with a longtime teammate who knows you and your project better every day?

We both know the obvious answer, so why would you treat your AI like a new hire with every session? If you treat your AI like a longtime employee who has institutional knowledge of where you've been, where you are now, and crucially, your future plans, then you'll be in a better place than if you try to advance your project with the equivalent of a temp-hire every day.

What this looks like in practice

No matter what stage your project is in, you need to capture a snapshot of that and add it somewhere to your prompt. If you're just starting out with your project, then lean on that. The AI needs to know if your project is in alpha with only one, or a few, users testing an app. The reason is that if you ask the AI to refactor something so that it works differently, and it doesn't know that you're in an alpha stage, then it will write some migration code that will bridge changes in data structures from one to another. But that's not needed. You can just delete everything and start again. But if the AI doesn't know that, your app will end up filled with migration scripts that waste tokens and time, and add cruft to the codebase.

If your app is a legacy project that has a million users, it really needs to know that. The AI needs to know where it could break things for active users and where it's safe to work. You're asking for trouble if you just assume your AI will figure this out on their own.

Information like this is crucial for the AI to have in every session, no matter the task. But it doesn't need to soak up a bunch of tokens. If you're in alpha, a simple addition to the CLAUDE.md file will do:

Alpha Prompt Example

## Project status
RunPee is in **alpha**. ~15 users, all friends/family, all replaceable.
There is no production data worth protecting. If a refactor would be cleaner
with a different data shape, just change the shape — do NOT write migration
code, compatibility shims, or backfill scripts. We will wipe and reseed.

Legacy Prompt Example

## Project status
RunPee is a **live production app** with ~1M installs. Treat all user data as
sacred. Before changing any schema, table, or stored format, STOP and flag the
migration path — what breaks for existing users, and how we ship it safely.
Never delete or rewrite a field that production reads from without a plan.

Big Picture: Your AI needs to know your endgame

I can't tell you how many times this has saved my ass. I'm building a new app (PERA) and Claude Code has an outline of what the end product will be capable of. This is of course broad, because we're making up a lot of details as we explore new features, but because Claude Code has an image of what the app will look like in a year it can surface things that it might otherwise miss. This helps Claude Code know how to spec out new features that won't conflict with the big picture.

Small Picture: Your AI needs to know the work history of every feature

If you're working on a feature it helps if the AI can read the original spec that was used to create this feature, what updates have been made along the way, and what bugs were discovered and how they were fixed. But, you can't include the work history of every feature you've built. You have to be choosy.

You can start each session by telling the AI: we're going to work on feature such-and-such; ask a subagent to search for the original spec and all of your notes from previous sessions that touch on this feature. The subagent should create a concise report on the history and current status of this feature. If Claude knows that this is the fifth session you two have had trying to fix a troublesome bug, it will react differently than if it's the first session. Just like any person would need to remember what they've tried before and what didn't work. Otherwise, you're likely going to get the same bug over and over.

I have a /command that instructs Claude Code on how to use a subagent to create the report it will need to start each session.

Conclusion

The difference between a temp-hire AI and a teammate AI isn't the model — it's the memory you build around it. Every project-status line in your CLAUDE.md, every spec you save, every session note is onboarding you never have to repeat. Start small: tell your AI what stage your project is in, where it's headed, and what you two worked on last week. Do that consistently and in a month you'll have a teammate with institutional knowledge. Skip it, and you'll be onboarding a stranger off Upwork every single morning — forever.

Comments

No comments yet — be the first.

Join the conversation