Builders use Claude Code as an enhanced autocomplete system. They open a file, sort a immediate, and hope for one of the best. The system produces first rate output which typically reaches nice high quality. The output displays inconsistent outcomes. The system loses observe of context and repeats its preliminary errors.
The answer wants a extra organized undertaking, not an prolonged immediate.
This text showcases a undertaking construction which develops into an AI-powered system used for incident response, that follows Claude Code’s greatest practices.
The Lie Most AI Builders Consider
Probably the most important misunderstanding that builders have with AI at present is:
“Merely use an LLM and also you’re completed!”
Flawed! AI is a system. Not a characteristic.
A production-grade AI system requires:
- information pipelines: ingestion → chunking → embedding
- retrieval: hybrid search with re-ranking
- reminiscence: semantic caching, in-memory recall
- routing: appropriate supply choice with fallbacks
- technology: structured outputs
- analysis: offline and on-line
- safety: enter and output safeguards
- observability: full question traceability
- infrastructure: async, container-based
Most builders cease at API calls. That’s simply the primary degree! What’s not often mentioned:
repository construction determines how properly Claude Code helps you construct these layers.
Repair the construction. Every thing else falls in place.
AI Incident Response System
This undertaking could be a cloud-based incident administration system powered by AI. I’ll be calling it respondly.
- Features: alert ingestion, severity classification, runbook technology, incident routing, decision monitoring.
- Focus: not the system, however repository design.
- Objective: present how construction allows Claude Code to function with context, guidelines, and workflows.
- Listing construction: reference sample beneath. Relevant to any AI system.
Let’s analyze how the general construction creates a greater expertise with Claude Code after which analyze every bit of the construction.
The 4 Issues Each Claude Code Mission Wants
Earlier than diving into creating folders, let’s assessment the essence of Claude Code. In an effort to assume like an engineer, Claude Code primarily wants 4 items of data:
- The Why – what this part does and why it exists
- The Map – the place every thing is positioned
- The Guidelines – what’s permitted and what’s prohibited
- The Workflow – how work is accomplished
All of the folders inside respondly/ listing performs one of many above roles. There is no such thing as a unintended folder placement.
CLAUDE.md: ROOT Reminiscence
CLAUDE.md is without doubt one of the most crucial information for this undertaking, not documentation however mainly the mannequin’s reminiscence. Claude is taking a look at CLAUDE.md when it begins every time. You’ll be able to consider it like giving a brand new engineer an summary of the system on day one (besides Claude is given it each time). You need to be temporary, to the purpose and preserve it to max three sections.
What respondly/CLAUDE.md comprises:

That’s all there may be to it. There aren’t any philosophies or prolonged descriptions. It’s all simply to inform the mannequin.
If CLAUDE.md will get too lengthy, then the mannequin won’t have the power to comply with the essential directions it’s speculated to comply with. Readability is at all times extra necessary than measurement.
.claude/abilities: Reusable Skilled Modes
On this folder, it’s straightforward to see how Claude Code transitions from generalist to specialist. Reusable instruction codes allow Claude to create workflows that are repeatable.
When Claude learns a brand new course of, there’s no want to clarify it every time. Outline it as soon as, then Claude will load that course of on demand. Claude ships with three distinctive abilities:
- triage-review/SKILL.md: Tips on how to precisely examine severity of alerts, escalate, and assessment for false constructive patterns and whether or not or not the alert has a classification code that precisely describes the alert.
- runbook-gen/SKILL.md: Tips on how to generate a Runbook. Particulars on output format, required fields, and tone might be included within the directions.
- eval-run/SKILL.md: Tips on how to run the offline analysis pipeline. Consists of metrics to make use of, thresholds that may set off a assessment, and directions for logging outcomes.

This offers everybody engaged on the undertaking with Claude Code, a constant, high-quality output from all customers, because it pertains to Claude’s use and execution.
.claude/guidelines: Guardrails That By no means Overlook
Fashions, as you already know, will typically overlook. Hooks and guidelines won’t. The foundations listing comprises the principles that MUST ALWAYS occur, no want for anybody to be reminded.
- code-style.md will make sure that all formatting, import ordering, sort and type necessities are adopted for ALL python information.
- testing.md will outline when exams ought to run (and defend what modules), how a lot take a look at protection should be achieved to move (i.e. it units the benchmark on protection after which nothing else will matter).
Think about the principles NON-NEGOTIABLES which can be inherently a part of the undertaking. Subsequently, any undertaking created from Claude will robotically embrace the principles with none reminders.
.claude/Docs: Progressive Context, Not Immediate Overload
You do not want to place all the data into one single immediate. This creates an anti-pattern. Slightly, construct a documentation that Claude can entry the required sections on the acceptable time. The respondly/docs listing consists of:
- structure.md – general design, relationship between elements, information stream diagrams
- api-reference.md – endpoint specs, request/response schema, authentication patterns
- deployment.md – infrastructure setup, surroundings variables, Docker Compose setup
Claude doesn’t want to recollect all this documentation; it solely must know the place to acquire the data it requires. Subsequently, this alone will scale back a considerable variety of errors.
Native CLAUDE.md Recordsdata: Context for Hazard Zones
There are particular areas of any given codebase that include hidden complexity. Although on the floor, they initially appear fairly simple, they aren’t.
For respondly/, these areas of complexity are as follows:
- app/safety/ – immediate injection prevention mechanisms, content material filtering strategies, output validation processes
- app/brokers/ – orchestration logic for LLMs, calling exterior instruments, and adaptive routing of requests
- analysis/ – validity of golden dataset, correctness of analysis pipeline
Every of those areas has its personal native CLAUDE.md file:
App/safety/CLAUDE.md
app/brokers/CLAUDE.md
analysis/CLAUDE.md
Inside these information, the CLAUDE system will get a transparent understanding of what elements of this space pose a risk, what errors to avoid, and what conventions are important on the time CLAUDE is working throughout the confines of that listing.
This remoted course of reduces the prevalence of LLM-enabled bugs considerably inside high-stakes modules.
Why the brokers/Layer is the Actual Intelligence Layer?
Respondly/ has created a multi-agent framework. Contained in the respondly/brokers/ folder are 4 information:
- triage_agent.py, which classifies alerts primarily based on severity and makes use of a structured output and a golden dataset to repeatedly recalibrate itself;
- runbook_generator.py to create incident runbooks by determining what the duty is after which producing step-by-step directions primarily based on a “study and adapt” mannequin using LLMs in addition to templates and validates outputs;
- adaptive_router.py, which selects an acceptable information supply to question (i.e. PagerDuty, Datadog, or inner knowledgebase) primarily based on context;
- instruments/, which is the place all exterior integrations plugged into the system reside. Every instrument is a standalone module, thus creating a brand new integration merely requires an addition of 1 file.
It’s these traits that set an AI manufacturing system other than an AI demo system (i.e. The power to be modular with respect to intelligence; to have the ability to run varied exams on every particular person part of the system; and the power to view the chain of occasions that led as much as a selected determination being made).
The Shift That Adjustments Every thing
What most people are likely to overlook:
Prompting is a momentary measure, whereas construction is a long-lasting criterion.
An expertly written immediate will solely final you all through one particular person session, nevertheless an expertly constructed repository will final for the whole thing of the undertaking.
Whenever you undertaking is correctly structured:
- Claude understands the aim of the system with out having to be informed.
- Claude at all times abides by the established coding requirements in use.
- Claude steers away from any dangerous modules with out being particularly warned towards the utilization of mentioned module.
- Claude can implement advanced workflows at a gradual charge on a session-by-session foundation
This isn’t a chatbot. That is an engineer who’s native to the undertaking.
Conclusion
Probably the most important mistake folks make whereas creating AI is treating it as a comfort or superior search characteristic. Claude just isn’t that; it’s a reasoning engine, which requires context, construction, and reminiscence. Every of the respondly/ folders solutions one query: What does Claude have to make his judgment on this second? If you’re constant together with your reply, it is going to not be only a instrument; you should have created an engineer inside your codebase.
The execution plan is simple: create a grasp CLAUDE.md, develop three abilities to be reused for repetitive processes. Then set up guidelines for what you can’t change; drop a set of native context information in your 4 largest modules to begin the creation of your structure. After you’ve got created these 4 information, you’ve got established your foundational constructing blocks for improvement. Then you must concentrate on having your structure in place earlier than scaling up the variety of information and/or capabilities that you simply create to assist your software. You’ll discover that every thing else will comply with.
Steadily Requested Questions
A. Builders assume utilizing an LLM is sufficient, however actual AI wants structured engineering layers.
A. It acts as mannequin reminiscence, giving concise context on objective, construction, and guidelines every session.
A. It organizes context and workflows, enabling constant, engineer-like reasoning from the mannequin.
Login to proceed studying and luxuriate in expert-curated content material.







