AIToday
Large Language ModelsAI Coding AssistantsZenn AI/MLPublished: Oct 14, 2026, 22:00 JST

Claude Code harness: start with CLAUDE.md and Skills only

Claude Code harness: start with CLAUDE.md and Skills only

3 Key Points

  1. What happened

    Miyatchi of AI Orchestra, who teaches Claude Code to a course of over 200 students, laid out four harness mechanisms — CLAUDE.md, Skills, subagents, and hooks — and said beginners should start with only the first two.

  2. Why it matters

    CLAUDE.md and Skills materials come straight from daily work conversations, so learners can save a fixed rule with one phrase like "write this in CLAUDE.md" without studying file formats first, while subagents and hooks only pay off once work patterns are visible.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Context & Analysis

Miyatchi's framing separates two ideas that are easy to confuse. Knowledge is what the AI is given — judgment criteria, rules, policies, and procedure documents kept as markdown files in the work folder, which he calls an "AI company" with departments for strategy, marketing, sales, and finance. The harness is how that content is made to take effect: when it is loaded, and whether the AI can decide to follow it.

That distinction drives the recommended order. CLAUDE.md is read in full at the start of every session, so it is the place for rules that should apply everywhere, and the official documentation suggests keeping it under 200 lines, moving job-specific content to Skills as it grows. Skills load only their name and description normally, with the body read when the related work comes up or when invoked by name, which makes them the natural home for a settled procedure.

Miyatchi also places the harness as the sixth of seven steps, after knowledge is organized and tools are connected, but before routines that run on a schedule. His own routine generates a YouTube report every Sunday at 8:00, and an access analysis for his company website was turned into a routine only after the method and report format were settled. The same logic, he argues, applies to subagents and hooks: adding them before the work pattern is clear risks stopping work that should not be stopped or cutting off context the main conversation still needs.

FAQ
What are the four Claude Code harness mechanisms?
They are CLAUDE.md, Skills, subagents, and hooks. CLAUDE.md is a file of rules, Skills bundle work procedures, subagents work in a separate context and return only summaries, and hooks run automatically at set timings.
How do I decide between CLAUDE.md and Skills?
Ask whether you want Claude to know something for every task. Company name spellings and forbidden actions go in CLAUDE.md; proposal-writing or invoice procedures used only for that job go in Skills.
When should I add subagents or hooks?
Add hooks when a rule written in CLAUDE.md is not followed or must never be broken, and add subagents when research or review work fills up the main conversation. Both require your work pattern to be visible first, so CLAUDE.md and Skills come first.

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleGemini skills, not ChatGPT GPTs: 30分 no-code agent guide