அமர்வுகளுக்கு இடையே AI முகவரின் நினைவு: முன்னேற்றக் கோப்பு, முடிவுப் பதிவு, git மற்றும் init ஸ்கிரிப்ட்

முகவர் ஏன் எதையும் நினைவில் கொள்வதில்லை

மாதிரி ஓட்டங்களுக்கு இடையே நிலையை வைத்திருப்பதில்லை. முகவர் உங்கள் பணியைப் பற்றி «அறிந்த» அனைத்தும் தற்போதைய அமர்வின் சூழல் சாளரத்தில் உள்ளது: படித்த கோப்புகள், கட்டளைகளின் வெளியீடு, உங்களுடனான உரையாடல். அமர்வு முடிந்தாலோ சூழல் நிரம்பினாலோ, புதிய அமர்வு பூஜ்ஜியத்திலிருந்து தொடங்குகிறது, வட்டில் எழுதப்பட்டதை மட்டுமே பார்க்கிறது.

பயனுள்ள மாதிரி: ஒவ்வொரு காலையும் நினைவு முழுவதும் அழிக்கப்பட்ட நிலையில் அலுவலகத்துக்கு வரும் மிகத் திறமையான பொறியாளர். அவர் குறியீட்டை விரைவாகப் புரிந்துகொள்வார், ஆனால் நேற்று எந்த கட்டமைப்பு மாற்று தேர்ந்தெடுக்கப்பட்டது, ஏன் மற்றவை நிராகரிக்கப்பட்டன, சோதனைகள் எந்த நிலையில் இருக்கின்றன என்பது நினைவுக்கு வராது. எழுதிய குறிப்புகள் இல்லாவிட்டால் அவர் 15–20 நிமிடங்களை ஆய்வுக்குச் செலவிடுவார், நீங்கள் வேண்டுமென்றே நிராகரித்ததையே மீண்டும் செய்யவும் கூடும்.

எனவே AI முகவர் நினைவு மாதிரியின் பண்பு அல்ல, harness-இன் ஒரு பகுதி: நீங்களே வடிவமைக்கும் கோப்புகளும் விதிகளும். நல்ல செய்தி, இதற்கு vector தரவுத்தளங்களோ சிறப்புச் சேவைகளோ தேவையில்லை. சில Markdown கோப்புகளும் git-உம் ஒழுக்கமும் போதும்.

பெரிய சூழல் சாளரம் ஏன் பிரச்சினையைத் தீர்க்காது

இன்னும் பெரிய சாளரம் கொண்ட மாதிரிக்காகக் காத்திருக்கலாம் என்று தோன்றும். ஆனால் சிக்கலான பணி எந்தச் சாளரத்தையும் நிரப்பிவிடும்: முகவர் குறியீட்டுத் தளத்தைப் படிக்கிறது, முடிவுகளின் வரலாற்றைச் சேர்க்கிறது, நீளமான சோதனை வெளியீட்டைப் பெறுகிறது, முழு உரையாடலையும் வைத்திருக்கிறது. தேவைகள் சாளரத்துடன் வளர்கின்றன. இது அளவின் கேள்வி அல்ல, கட்டமைப்புப் பிரச்சினை.

இரண்டாவது விளைவும் உண்டு. சாளரத்தின் எல்லைக்கு அருகில் பல மாதிரிகள் வேகமாக முடிக்க அவசரப்படுகின்றன: சரிபார்ப்பைத் தவிர்க்கின்றன, சரியான தீர்வுக்குப் பதில் எளிய தீர்வைத் தேர்ந்தெடுக்கின்றன. Anthropic தனது மாதிரிகளுக்கு இந்த அவதானிப்பை விவரிக்கிறது; விளைவின் வலிமை மாதிரிக்கு மாதிரி வேறுபடுகிறது. சாளர எல்லையில் உள்ள நீண்ட அமர்வு தகவலை இழக்கும் அபாயம் மட்டுமல்ல, வேலையின் தரத்தையும் குறைக்கும் அபாயம்.

சுருக்கம் (compaction): எது தக்கவைக்கப்படுகிறது, எது இழக்கப்படுகிறது

Compaction என்பது உரையாடலின் ஆரம்பப் பகுதியை ஒரு சுருக்கமான சாராம்சமாக மாற்றுவது, அதே அமர்வில் இடத்தை விடுவிக்க. Claude Code-இல் அதை /compact கட்டளை செய்கிறது, வரம்பை நெருங்கும்போது தானாகவும் நடக்கிறது. மாறாக /clear வரலாற்றை அழித்து உரையாடலை மீண்டும் தொடங்குகிறது.

Compaction-இன் பிரச்சினை என்னவென்றால், சாராம்சம் பொதுவாக «என்ன» என்பதைத் தக்கவைத்து «ஏன்» என்பதை இழக்கிறது. தயார் குறியீடு கோப்புகளில் இருக்கும், ஆனால் பகுத்தறிவு — ஏன் விருப்பம் B தேர்ந்தெடுக்கப்பட்டது, ஏன் நூலகம் எடுக்கப்படவில்லை, ஏன் மேம்படுத்தல் வேண்டுமென்றே தவிர்க்கப்பட்டது — இரண்டு சொற்களுக்குச் சுருங்கும் அல்லது மறையும். முகவரின் அடுத்த படி உணர்வுடன் எடுக்கப்பட்ட முடிவை «மேம்படுத்தும்», ஏனெனில் அதற்குக் காரணங்கள் இனி தெரியாது.

சிக்கலான அளவீடுகள் இல்லாத நடைமுறை விதி: பணி சாளரத்தின் ஏறத்தாழ 60%-ஐ எடுத்தால், குறியீடு எழுதுவதை நிறுத்திவிட்டு ஒப்படைப்பைத் தயாரியுங்கள். சூழல் 40% ஆக இருந்து பணியின் முடிவு அருகில் இருந்தால், compaction போதும்.

முகவரின் நினைவைக் கொண்ட நான்கு கலைப்பொருட்கள்

முகவரின் நினைவை மாதிரியின் நினைவு மீது நம்பிக்கை வைப்பதற்குப் பதில், ஒரு பயண நாட்குறிப்பை வைத்திருங்கள். அதில் நான்கு பகுதிகள், ஒவ்வொன்றுக்கும் அதன் சொந்தப் பங்கு.

1. PROGRESS.md — இப்போது எங்கே இருக்கிறோம்.
2. DECISIONS.md — ஏன் இப்படிச் செய்தோம், வேறு விதமாக அல்ல.
3. Git commit-கள் — நிலையின் இலவசச் சோதனைச் சாவடிகள்.
4. AGENTS.md-இல் மாற்றல் நெறிமுறை — வரும்போதும் போகும்போதும் என்ன செய்வது.

PROGRESS.md: முன்னேற்றக் கோப்பு

ஒரே கேள்விக்குப் பதில் சொல்கிறது: திட்டம் இப்போது எந்த நிலையில் இருக்கிறது. அமர்வின் தொடக்கத்தில் முகவர் அதை முதலில் படிக்கிறது, புறப்படும் முன் கடைசியாகப் புதுப்பிக்கிறது. கோப்பு சுருக்கமானது, தொடர்ந்து சேர்ப்பதற்குப் பதில் மீண்டும் எழுதப்படுகிறது: வரலாறு git-இல் வாழ்கிறது.

# PROGRESS.md

## Текущая цель
Поиск по каталогу товаров (фича search-01)

## Состояние
- HEAD: 4f2a9c1
- make check: зелёный, 142/142 теста
- Сделано: индекс в PostgreSQL (tsvector), ручка GET /search
- Проверено: юнит-тесты + ручной запрос curl по 3 запросам

## Блокеры
- Нет данных о морфологии для казахского языка — ждём решения

## Следующий шаг
Добавить пагинацию в GET /search, критерий: тест на 2-ю страницу

ஒப்படைப்புக்குப் போதுமான நான்கு புலங்களைக் கவனியுங்கள்: commit hash, சோதனைகள் தேறும் விகிதம், தடைகள், அடுத்த படி. புதிய அமர்வு இந்தக் கோப்பிலிருந்து தெளிவாகத் தொடர முடியாவிட்டால், வார்ப்புருவில் ஒரு புலம் குறைவு.

DECISIONS.md: முடிவுகளின் பதிவேடு

Compaction-இல் இழக்கப்படும் அந்த «ஏன்» இங்கே வைக்கப்படுகிறது. பதிவின் வடிவம்: முடிவு, காரணம், நிராகரித்தவை மற்றும் ஏன், கட்டுப்பாடுகள்.

## 2026-03-14 — Кэш пользовательских настроек в Redis
- Решение: Redis, TTL 5 минут, активная инвалидация при записи.
- Причина: читается на каждом запросе, объём данных крошечный.
- Отвергли: materialized view в PostgreSQL — слишком частые изменения,
  поддержка не окупается.
- Ограничение: не кэшировать настройки оплаты.

இங்குள்ள மிக மதிப்புமிக்க வரி «நிராகரித்தவை». அதுவே அடுத்த அமர்வு ஏற்கனவே பரிசீலித்து நிராகரித்த விருப்பத்துக்கு முடிவைத் திரும்ப «மேம்படுத்துவதை» தடுக்கிறது. முன்னேற்றக் கோப்பைப் போலன்றி, முடிவுப் பதிவு வளர மட்டுமே செய்கிறது: பழைய பதிவுகள் நீக்கப்படுவதில்லை, புதியவற்றால் மாற்றப்பட்டவை எனக் குறிக்கப்படுகின்றன.

git வரலாறு ஒரு சோதனைச் சாவடியாக

Commit-கள் ஏற்கனவே பணியில் பதிப்பிடப்பட்ட நிலைப் படங்கள். முகவர் git log மற்றும் git diff-ஐப் படித்து என்ன மாறியது என்பதை மீட்டெடுக்க முடியும். வரலாறு நினைவாகச் செயல்பட, commit செய்தி diff-ஐ மீண்டும் சொல்லாமல் நோக்கத்தை விளக்க வேண்டும்.

# плохо
git commit -m "update search.py"

# хорошо
git commit -m "search: индекс tsvector вместо LIKE

LIKE '%q%' не использует индекс, на 200k товаров запрос 1.8 с.
Пагинация ещё не сделана, см. PROGRESS.md."

ஒவ்வொரு பச்சை சோதனை ஓட்டத்துக்குப் பின்னும் சிறிய, அடிக்கடி commit-கள் திரும்பும் புள்ளியையும் தருகின்றன. அமர்வு தவறான திசையில் சென்றால், அரைகுறைத் திருத்தங்களைப் பிரிப்பதைவிட கடைசியாகச் சரிபார்க்கப்பட்ட நிலைக்குத் திரும்புவது எளிது.

AGENTS.md-இல் மாற்றல் நெறிமுறை

முகவர் அவற்றைப் பற்றி அறியாவிட்டால் நிலைக் கோப்புகள் பயனற்றவை. எனவே நுழைவு அறிவுறுத்தல் கோப்பில் (AGENTS.md அல்லது CLAUDE.md) வரும்போதும் போகும்போதும் என்ன செய்வது என்ற சுருக்கமான நெறிமுறை எழுதப்படுகிறது.

## Приход на смену
1. Прочитать PROGRESS.md и DECISIONS.md.
2. Найти активную задачу в .agent/feature_list.json.
3. Прогнать make check — убедиться, что репозиторий согласован.
4. Продолжить с «Следующего шага», не переоткрывая решённое.

## Уход со смены
1. Прогнать make check, закоммитить зелёное состояние.
2. Обновить PROGRESS.md: HEAD, тесты, блокеры, следующий шаг.
3. Дописать новые решения в DECISIONS.md.
4. Не оставлять недоделанного в рабочем дереве.

நெறிமுறையைச் சுருக்கமாக வைத்திருப்பது நல்லது: அது நுழைவுக் கோப்பில் சில வரிகள், தனி நீண்ட பக்கம் அல்ல.

Init ஸ்கிரிப்ட்: அமர்வின் தொடக்கத்தை எப்படி வேகப்படுத்துவது

முகவர் படத்தைக் கையால் சேர்க்காமல் இருக்க, சூழலைச் சரிபார்த்து நிலையை அச்சிடும் ஒரே ஸ்கிரிப்டைக் கொடுங்கள். ஸ்கிரிப்ட் idempotent ஆக இருக்க வேண்டும் — எத்தனை முறை ஓடினாலும் பாதிப்பில்லை — தெளிவான தயார் செய்தியுடன் முடிய வேண்டும்.

#!/usr/bin/env bash
set -euo pipefail

echo "== 1. Окружение =="
command -v uv >/dev/null || { echo "FAIL: uv не установлен"; exit 1; }
uv sync --frozen

echo "== 2. Репозиторий =="
if [ -n "$(git status --porcelain)" ]; then
  echo "WARN: рабочее дерево грязное"
else
  echo "OK: чисто"
fi
echo "HEAD: $(git log -1 --oneline)"

echo "== 3. Проверка =="
make check

echo "== 4. Состояние =="
cat PROGRESS.md

echo "Готов к работе"

அப்போது மாற்றல் நெறிமுறையில் ஒரே வரி போதும்: «scripts/init.sh-ஐ இயக்கு». Claude Code-இல் அத்தகைய ஓட்டத்தை அமர்வுத் தொடக்கத்தில் (நிகழ்வு SessionStart) hook மூலம் தானியங்கியாக்கலாம், ஆனால் hook இல்லாமலேயே கோப்பிலுள்ள அறிவுறுத்தலின்படி முகவர் ஸ்கிரிப்டை இயக்கும்.

முகவரின் நினைவில் எதை வைப்பது, எதை வைக்கக்கூடாது

முக்கிய பிழை: நினைவைக் குப்பைத் தொட்டியாக மாற்றுவது. முகவர் தொடக்கத்தில் படிக்கும் ஒவ்வொரு வரியும் சூழலில் இடத்தை எடுக்கிறது, அதிகப்படியானது முக்கியத்தை மறைக்கிறது.

வாழ்நாள் அடிப்படையிலும் பிரிக்கவும். திட்ட விதிகள் அரிதாக மாறும், எல்லாப் பணிகளுக்கும் பொருந்தும் — அவை நுழைவு அறிவுறுத்தல் கோப்பில் இருக்க வேண்டும். நிலை ஒவ்வொரு அமர்வும் மாறுகிறது — அது முன்னேற்றக் கோப்பில் இருக்க வேண்டும். இரண்டையும் கலந்தால் நுழைவுக் கோப்பு காலாவதியான குறிப்புகளால் விரைவில் பெருகிவிடும்.

முதல் அமர்வு: துவக்கம் தனிக் கட்டமாக

முதல் அமர்வு குழப்பத்தில் முடிந்தால் அடுத்தடுத்த நினைவு உதவாது. வழக்கமான காட்சி: வெற்று களஞ்சியத்தில் «தேடலைச் சேர்» என்று எழுதுகிறீர்கள், அரை மணி நேரம் கழித்துச் சோதனைக் கட்டமைப்பு தவறாக அமைக்கப்பட்டிருப்பதும் migration வடிவம் பொருந்தாததும் தெரிகிறது. தேடல் வந்துவிடுகிறது, ஆனால் அடித்தளம் கோணலாக இருக்கிறது.

காரணம், செயல்படுத்தலும் துவக்கமும் வெவ்வேறு விஷயங்களை உகப்பாக்குகின்றன: முதலாவது இந்த அமர்வில் முடிந்த அம்சங்களின் எண்ணிக்கையை, இரண்டாவது அடுத்தடுத்த அனைத்தின் வேகத்தையும் நம்பகத்தன்மையையும். முகவர் தெரியும் முடிவை நோக்கிச் சாய்கிறது, அதாவது குறியீட்டை நோக்கி. எனவே துவக்கத்தைத் தனி அமர்வாக, நான்கு நிபந்தனைகளுடன் கூடிய தெளிவான தயார் அளவுகோலுடன் பிரிக்கவும்.

• இயக்கம்: சுத்தமான clone-இலிருந்து make setup மற்றும் make dev வேலை செய்கின்றன.
• சரிபார்ப்பு: make test உள்ளது, குறைந்தது ஒரு உண்மையான தேறும் சோதனை உள்ளது.
• முன்னேற்றம் தெரிகிறது: நிலைக் கோப்பு உள்ளது, படிக்க முடிகிறது.
• வேலையைத் தொடர்கிறது: ஏற்பு அளவுகோல்களுடன் பணிப் பட்டியல் உள்ளது.

புதிய திட்டங்களை அடிக்கடி தொடங்கினால், களஞ்சிய வார்ப்புருவை உருவாக்குங்கள்: Makefile, சோதனைக் கட்டமைப்பு, AGENTS.md எலும்புக்கூடு, .agent/ கோப்புறை, scripts/init.sh, lint மற்றும் CI. அப்போது துவக்கம் குறிப்பிட்ட திட்டத்தின் தனித்தன்மைக்கு மட்டும் சுருங்கும்.

நினைவு வேலை செய்கிறதா என்பதை எப்படிச் சரிபார்ப்பது

மிக நேர்மையான அளவீடு — புதிய அமர்வு தொடங்குவதிலிருந்து முதல் அர்த்தமுள்ள குறியீட்டு மாற்றம் வரையிலான நேரம். கலைப்பொருட்கள் இல்லாவிட்டால் இது பொதுவாக 15–20 நிமிட ஆய்வு; நல்ல ஒப்படைப்புடன் இரண்டு-மூன்று நிமிடங்கள். ஒருமுறை முன்னும் பின்னும் அளந்து பாருங்கள், ஒழுக்கம் பயனளிக்கிறதா என்பது தெரியும்.

இரண்டாவது வழி — குளிர் தொடக்கச் சோதனை. புதிய அமர்வைத் திறந்து «தொடர்» என்று எழுதி ஐந்து கேள்விகளைக் கேளுங்கள்: தற்போதைய இலக்கு என்ன, சோதனைகள் எந்த நிலையில் உள்ளன, முக்கிய தலைப்பில் எந்த முடிவு எடுக்கப்பட்டது, ஏன், எது தடுக்கிறது, அடுத்த படி என்ன. முகவர் ஐந்துக்கும் கோப்புகளின் அடிப்படையில், யூகம் இல்லாமல் பதிலளித்தால் — நினைவு சரியாக அமைக்கப்பட்டுள்ளது. ஒவ்வொரு நிச்சயமற்ற பதிலும் வார்ப்புருவில் காணாமல் போன புலம்.

பொதுவான தவறுகள்

• முன்னேற்றக் கோப்பு தொடர்ந்து வளர்கிறது. ஒரு மாதத்தில் அதில் நூற்றுக்கணக்கான வரிகள் வரலாறு. தற்போதைய நிலைக்கு ஏற்ப மீண்டும் எழுதுங்கள், வரலாறு git-இல் உள்ளது.
• «நிராகரித்தவை» வரி இல்லை. நிராகரித்த விருப்பங்கள் இல்லாத முடிவுப் பதிவு மீண்டும் வாதங்களிலிருந்து பாதுகாக்காது.
• முகவர் நிலையை «கண்ணால்» புதுப்பிக்கிறது. எப்படிச் சரிபார்க்கப்பட்டது என்று எழுதுங்கள்: கட்டளையும் அதன் வெளியீடும், «எல்லாம் வேலை செய்கிறது» அல்ல.
• சூழல் எல்லையில் ஒப்படைப்பு. சாளர எல்லையில் முகவர் ஏற்கனவே அவசரப்படுகிறது; ஏறத்தாழ 60%-இல் இருந்தே handoff-ஐத் தொடங்குங்கள்.
• வெளியேறும்போது சுத்தமற்ற வேலை நகல். commit செய்யப்படாத அரைகுறைத் திருத்தங்கள் அடுத்த அமர்வைக் குழப்புகின்றன.

சுருக்கமாக

AI முகவரின் அமர்வுகளுக்கு இடையேயான நினைவு மாதிரியின் மேல் அல்ல, கோப்புகளின் மேல் கட்டப்படுகிறது: PROGRESS.md தற்போதைய நிலையைச் சேமிக்கிறது, DECISIONS.md காரணங்களையும் நிராகரித்த விருப்பங்களையும், git commit-கள் நோக்கத்தை விளக்கும் சோதனைச் சாவடிகளையும், AGENTS.md-இல் உள்ள மாற்றல் நெறிமுறை இவை அனைத்தையும் படிக்கவும் புதுப்பிக்கவும் வைக்கிறது. Init ஸ்கிரிப்ட் தொடக்கத்தை ஒரு கட்டளைக்குச் சுருக்குகிறது; குளிர் தொடக்கச் சோதனை பதிவுகள் போதுமா என்பதைக் காட்டுகிறது. முகவரின் பதிவேடும் bootstrap ஒப்பந்தமும் பாடத்தில் நடைமுறையில் விளக்கப்பட்டுள்ளன.