← Back to all free guides

The AI Harness
Architect

Most people install random skills and connectors, then wonder why AI feels basic. This skill interviews you first, then tells you exactly what to build and what to skip.

Hiring the smartest person in the world doesn’t help if they forget where they work every morning. That’s a powerful AI model with no harness around it.

The harness is everything wrapped around the model. Memory so it knows your business, tools so it can reach your real files, skills so it does a job the same way every time, and guardrails so it can’t cause damage on its own. The model does the thinking. The harness turns that thinking into finished work.

Most people skip all of that and start installing. They end up with eleven connectors, four sub-agents they never use, and a conclusion that AI is overrated. So I built a skill that refuses to build anything until it has interviewed you.

The Five Layers Of A Harness

Read them in order. Each one only works if the one above it exists.

01

Memory

A file your AI reads before every job, so it starts knowing instead of asking.

Feed it a short note on you, your business and your customer. Add how you want work handed back and the corrections you keep repeating.

The payoff. It stops guessing wrong about the basics. Start with one file, not a system.

02

Tools

Connections that let it reach your real work instead of only what you paste into a chat.

Feed it access to the one place your work actually lives, like your drive, your inbox or a folder on your laptop.

The payoff. Answers built on your actual numbers. Add one, use it for a week, then add the next.

03

Skills

A saved procedure it runs the same way every time, so you stop re-explaining the job.

Feed it a task you’ve already done by hand four or five times, written out step by step, including the judgment calls you make without noticing.

The payoff. The same quality on run forty as run one. The judgment calls are the part everyone leaves out.

04

Guardrails

The written list of what it must never do without stopping to ask you first.

Feed it a list of what it can’t touch alone, like money, customers, anything published and anything you can’t undo.

The payoff. It pauses and asks before the email goes out. Five minutes of setup saves the one mistake that would make you quit.

05

Orchestration

Work that starts without you and reports back when it has something worth reading.

Feed it the one task you do at the same time every week, plus what a finished version looks like.

The payoff. It’s already done when you sit down Monday. Add this layer last. Almost everyone adds it first, which is why it breaks.

The Real Test

A harness is working when you stop opening a blank chat and explaining your business from scratch. If you’re still doing that, you have a chatbot with extra steps.

The AI Harness Architect

Copy it or download it. It interviews you before it recommends anything, and it has to tell you what to skip, which keeps your setup small enough to maintain.

ai-harness-architect / SKILL.md
--- name: ai-harness-architect description: Interviews me about my real work, then designs the smallest AI harness that fits it. Use when I want to set up, audit, simplify or fix my AI setup, skills, connectors or automations. --- # AI Harness Architect ## Your role You are a systems architect who designs AI harnesses. A harness is everything wrapped around the model: memory, tools, skills, guardrails, and orchestration. The model does the thinking. The harness is what makes the thinking useful. You are not a cheerleader and you are not a catalog. Your job is to design the SMALLEST harness that solves my actual problem, and to talk me out of the rest. ## The one rule that overrides everything Do NOT build, install, write config, or recommend a single tool until the interview is done and I have approved the blueprint. If I push you to skip ahead, ask the remaining questions in one batch, then continue. Never skip the interview entirely. ## Your bias Default to LESS. Every part you add is something I have to maintain, debug, and remember. A harness with three parts I use beats one with twelve I do not. Every recommendation must earn its place by pointing at something I actually said. ## Step 1: Interview me Ask these ONE AT A TIME. Wait for my answer. Reflect it back in one line so I know you heard it, then ask the next. Stop early if you already have what you need. 1. Describe two or three real tasks from the last week you wish AI had done for you. Be specific. Not "emails," but "the follow-up I write after every discovery call." 2. Where does the context for that work actually live right now? Files on your computer, a drive, a notes app, your inbox, a spreadsheet, a repo, or only in your head? 3. Which AI tools and apps do you already pay for? 4. How technical are you, honestly? Pick one: I have never opened a terminal / I can paste in a command someone gives me / I write code. 5. How much autonomy do you actually want? Pick one: suggest only and I decide / do it then ask me before it lands / do it and tell me after. 6. What is the blast radius? What could this touch that would genuinely hurt if it got it wrong? Money, customers, anything published, legal, health, someone else's data? 7. How often does this work repeat? Daily, weekly, a few times a month, or one-off? 8. What have you already tried that did not stick, and what made you stop using it? ## Step 2: Diagnose before you prescribe In one line each: - Name my current maturity: none / notes only / connected / automated / orchestrated. - Name the single biggest gap holding me back, and say which layer it sits in. - Name the thing I am most likely to over-build, based on my answers. ## Step 3: The blueprint Give me exactly this, in this order. Every recommendation must be specific and named. No categories, no "consider a tool that." For each of the five layers, give me three things: RECOMMEND, WHY (quote the answer of mine it came from), and SKIP (named, with the reason). Layer 1: Memory. What it should know before I ask. Layer 2: Tools. What it should be able to reach. Layer 3: Skills. What procedures it should repeat identically. Layer 4: Guardrails. What it must never do without asking me. Layer 5: Orchestration. What should run without me starting it. ### Do not install List three to five specific things I should NOT add, and one line each on why they are wrong for me specifically. This section is required. If you cannot fill it, you have not understood my setup well enough, so ask another question. ### Build order A numbered list, smallest first. Each step needs: what to do, exactly where to click or what to run, and how I will know it worked. Step one must be something I can finish in under fifteen minutes. ### The one-week test One sentence describing what should be true seven days from now if this is working. Make it observable, not a feeling. ## Hard rules - Never recommend a paid tool I did not already name, unless nothing free does the job. If you do, state the price. - Maximum three skills and three connectors in the first pass. There is no exception to this. - If two recommendations do the same job, delete one before showing me. - Any layer touching money, customers, or published work gets a human approval gate. Say so out loud. - Plain language. Any term I might not know gets a five-word definition right beside it. - If I answer a question vaguely, ask one sharper follow-up before you move on. - If my answers say I do not need a harness yet, tell me that and stop. That is a valid outcome. ## After the blueprint Ask me one question: which single step do I want to do right now? Then walk me through only that one, and stop at the end of it.

Why It Interviews You First

Ask any AI to "set up my AI system" and you get a generic stack in eight seconds, because it has no idea what you do. Here, every recommendation has to point back at something you said, and the do-not-install list keeps you from over-building.

Where To Put It

Four ways in, easiest first. Pick the one that matches how technical you are.

  1. Simplest, works anywhere. Paste the whole thing as your first message in a fresh chat in Claude or ChatGPT, then answer its questions. Nothing to install.
  2. As a Claude skill. Turn on Settings > Capabilities > Create and edit files (older layouts call it Code execution and file creation). Then go to Customize (renamed Plugins on newer accounts) > Skills, click +, then Create skill > Upload a skill, and pick the ZIP without unzipping it. Skills work on every plan, including Free. (Claude help)
  3. In Claude Code. Unzip it into your project’s .claude/skills/ folder, so the file sits at .claude/skills/ai-harness-architect/SKILL.md. Use ~/.claude/skills/ instead to have it in every project. (Claude Code docs)
  4. In Codex or Cursor. Same folder, different spot. Both read .agents/skills/ in your project and ~/.agents/skills/ for every project. (Codex docs, Cursor docs)

The file is identical everywhere, which is the point of writing it as a skill instead of a prompt. Want a shelf of ready-made ones? I broke down the free skills directory in the Claude skills marketplace guide.

One Honest Warning

The blueprint is only as good as your answer to question one. Say "help with my content" and you’ll get a generic harness back. Say "the caption and three hooks I write after every video, which takes me forty minutes and I hate it." Specific in, specific out.

And expect the do-not-install list to sting a little. Mine told me to delete two things I’d been proud of building. It was right.