RƏSƏDXANA

Həftə 1 · 01/23

Kontekst işin özüdür

6 dəqiqəlik oxu

Yeni bir köməkçi işə götürmüsən. Çox bacarıqlıdır, amma şirkətin qaydalarını heç kim ona yazılı verməyib. Hər səhər gəlir, öz bildiyi kimi işləyir — və hər dəfə başqa cür.

AI-ın «yaddaşı» yoxdur; yalnız o an ona verilən mətni bilir. Qaydaları bir fayla yazırsan və agent hər sessiyada onu oxuyur — köməkçinin masasındakı təlimat kimi.

# CLAUDE.md  — the agent reads this every session
## Commands
npm run check:all      # must be green before any commit
## Invariants
- Identity comes only from the session. Never from the request body.
## Never
- Never commit to master.
Kod deyil, qayda faylıdır — və layihənin kökündə durur. «Təmiz kod yaz» kimi cümlələr buraya yazılmır: onlar heç nəyi dəyişmir.

Çox deyilən söz: Hər söhbət sıfırdan başlayır, hər şeyi yenidən izah edirəm.

AI yalnız kontekstində olanı bilir. Təcrübəli istifadəçilər layihə qaydalarını agentin həmişə oxuduğu bir faylda saxlayır (CLAUDE.md və ya AGENTS.md): stack, konvensiyalar, əmrlər, təkrarlanmamalı səhvlər. Yeni işə yeni sessiya ilə başlayırlar, vəziyyəti isə yazılı şəkildə ötürürlər.

Qaydalar faylına nə yazılır

Yalnız agentin koddan oxuya bilmədiyi və səhv ediləndə baha başa gələn şeylər: əmrlər, invariantlar, «heç vaxt etmə» siyahısı. «Təmiz kod yaz» kimi ümumi məsləhət heç nəyi dəyişmir, amma kontekst yeyir.

AI belə yazır

Be a senior engineer. Write clean, scalable code.
Follow best practices.

Sən bunu istə

## Commands
npm run check:all      # must be green before any commit

## Invariants
- Identity comes only from the session (lib/session.ts), never body/query.
- Every visible string goes through L(az, tr, en).

## Never
- Never commit to master.

Yeni sessiya, yazılı ötürmə

Uzun sessiyada köhnəlmiş qərarlar toplanır. Agent özünə zidd danışmağa və ya artıq cavablanmış sualı verməyə başlayanda dayan. Nə edildiyini, nə qaldığını və qərarları fayla yaz, sonra təmiz sessiya ilə davam et.

Sən bunu istə

# Handoff — 2026-09-19
Done:  vote list reads identity from session only (commit 5a76477)
Left:  same fix for the circle list; deploy the Worker
Decided: no identity fallback for signed-out readers
Watch: communities.ts builds memberKey in two places

Axtarış köməkçiyə, qərar əsas söhbətə

Geniş axtarış və review kontekstə yüzlərlə sətir fayl tökür. Bunları ayrıca agentə (subagent) ver və ondan faylları yox, nəticəni istə. Əsas söhbət qərarlar üçün təmiz qalır.

Diff oxuyanda soruş: AI-ın verdiyi cavaba bax və soruş: bu, layihənin qaydalarına əməl edir, yoxsa öz ümumi vərdişini gətirib?

Terminlər

context window
Modelin bir anda «gördüyü» mətnin həcmi; dolduqca köhnə detallar itə bilər.
project memory file
Agentin hər sessiyada oxuduğu qaydalar faylı: CLAUDE.md, AGENTS.md və s.
subagent
Əsas söhbəti doldurmadan ayrıca bir işi (axtarış, review) görən köməkçi agent.
handoff note
Növbəti sessiyaya qalan vəziyyət: nə edildi, nə qaldı, nəyə diqqət etmək lazımdır.

İndi sən yoxla

1CLAUDE.md faylına nə yazılmalıdır?

2Üç saatdan sonra agent əvvəlki qərarları unutmağa başlayır. Ən yaxşı addım?

Hazır prompt

İngiliscədir, çünki terminlər ingiliscədir. Tərcümə etsən də terminləri saxla.

prompt
Read this repository and draft a rules file for AI agents:

- the stack, and how to run, build and check it
- the folder structure and what belongs where
- the invariants (who owns auth and identity, where authorization happens)
- conventions visible in the existing code (naming, comments, i18n)
- a «never do» list drawn from past bugs in the git history

Keep it under 150 lines. Only include what isn't obvious from the code.

Öz kodunda

  1. 1Faylı yarat və özün oxuyub düzəlt.
  2. 2Yeni sessiyada faylın cavab verməli olduğu bir sual ver və agentin qaydalara əməl edib-etmədiyinə bax.
  3. 3Agentin məhəl qoymadığı hissələri qısalt və ya daha dəqiq yaz.

Bunu görəndə bitib: Yeni sessiya qaydalarını sən təkrar etmədən onlara əməl edir.

Daha dərinə

context engineering AI agentsCLAUDE.md project memorycontext window compactionsubagents Claude Code

Oxumaq üçün