AGENTS.md, HUMAN.md என்றால் என்ன? முழு விளக்கம்

AGENTS.md என்றால் என்ன

AGENTS.md என்பது repository-யின் root-இல் இருக்கும் ஒரு எளிய markdown கோப்பு. அந்த project-இல் coding agent எவ்வாறு செயல்பட வேண்டும் என்பதை இது தெரிவிக்கிறது. அதிகாரப்பூர்வ site இதை “agents-க்கான README: உங்கள் project-இல் AI coding agents செயல்பட உதவும் context மற்றும் instructions-ஐ வழங்குவதற்கான தனிப்பட்ட, முன்கூட்டியே அறியக்கூடிய இடம்” என்று விவரிக்கிறது. இந்த format, Linux Foundation-ன் கீழ் உள்ள Agentic AI Foundation-ஆல் பராமரிக்கப்படுகிறது. July 2026 நிலவரப்படி Codex, Cursor, Jules, Devin மற்றும் GitHub Copilot உட்பட 20-க்கும் மேற்பட்ட agents இதைப் படிக்கின்றன.

இந்த convention இருப்பதற்கான காரணம் நடைமுறையானது. உங்கள் குழுவில் புதிதாக சேரும் ஒருவர் README-ஐ படித்து, build command-ஐ ஊகிப்பார். அந்த ஊகம் தவறாக இருந்தால், அவர் மற்றொருவரிடம் கேட்பார். ஒரு agent-ஆல் கேட்க முடியாது. அது pnpm test பயன்படுத்தும் project-இல் npm test-ஐ ஊகித்து இயக்கும். தோல்வியைப் படித்து, வேறு ஒன்றை முயற்சிக்கும். அந்த ஒவ்வொரு token-க்கும் நீங்கள் செலுத்த வேண்டும். உண்மையான command-ஐ ஒருமுறை எழுதிவைப்பது, இந்த வகையான தோல்விகளை முழுமையாகத் தவிர்க்கிறது.

கட்டாயமான fields எதுவும் இல்லை. Site இதைத் தெளிவாகக் குறிப்பிடுகிறது: “AGENTS.md என்பது standard Markdown மட்டுமே. நீங்கள் விரும்பும் headings-ஐ பயன்படுத்தலாம்; நீங்கள் வழங்கும் text-ஐ agent parse செய்யும்.” இதுவே முழு specification. இதன் மதிப்பு format-இல் இல்லை. ஒவ்வொரு tool-மும் ஏற்கனவே பார்க்கும் path-இல் அந்தக் கோப்பு இருப்பதில்தான் உள்ளது.

கோப்பு எங்கு இருக்க வேண்டும், எந்த கோப்பு முன்னுரிமை பெறும்

முதல் கோப்பை repository root-ல் வைக்கவும். Monorepo-வில் ஒவ்வொரு subproject-க்குள்ளும் கூடுதல் கோப்புகளைச் சேர்க்கலாம். விதி எளிமையானது: "agents directory tree-ல் தங்களுக்கு மிக அருகிலுள்ள கோப்பைத் தானாகப் படிக்கும்; எனவே அருகிலுள்ள கோப்புக்கே முன்னுரிமை கிடைக்கும்." இரண்டு கோப்புகளுக்கு இடையே முரண்பாடு இருந்தால், திருத்தப்படும் கோப்புக்கு அருகிலுள்ள கோப்பே பயன்படுத்தப்படும். Chat-ல் நீங்கள் type செய்யும் எதுவும் இந்த இரண்டு கோப்புகளையும் மீறும்.

my-repo/
├── AGENTS.md              # project-wide rules
├── services/
│   ├── api/
│   │   └── AGENTS.md      # wins for edits under services/api/
│   └── web/
│       └── AGENTS.md      # wins for edits under services/web/
└── README.md

இந்த nesting முறையைப் பயன்படுத்துவது பயனுள்ளது. ஏனெனில், ஒரு folder-ல் உண்மையாகவும் அடுத்த folder-ல் தவறாகவும் இருக்கும் விதியைச் சொல்வதற்கான ஒரே வழி இதுதான். "ஒவ்வொரு endpoint-மும் தனது input-ஐ validate செய்ய வேண்டும்" போன்ற விதியை endpoints-க்கு அருகில் வைக்க வேண்டும். அதை root கோப்பில் வைத்தால், தொடர்பில்லாத ஒவ்வொரு task-லும் அது load ஆகும்; எந்தப் பயனும் கிடைக்காது.

AGENTS.md கோப்பில் என்ன இடம்பெற வேண்டும்

Code-ஐப் படிப்பதன் மூலம் agent கண்டறிய முடியாதவற்றை எழுதுங்கள். Terminal-ல் ஒட்டிப் பயன்படுத்தும் வடிவில், துல்லியமான build, test மற்றும் lint commands-ஐ முதலில் குறிப்பிடுங்கள். ஒரு test-ஐ மட்டும் இயக்குவதற்கான command-ஐயும் சேர்க்குங்கள். முழு test suite-ஐ எவ்வாறு இயக்குவது மட்டுமே தெரிந்த agent, முழு suite-ஐ நாற்பது முறை இயக்கக்கூடும். Tool-ன் default-இலிருந்து மாறுபடும் conventions-ஐப் பெயரிட்டு குறிப்பிடுங்கள். Agent-க்கு default ஏற்கனவே தெரியும்; உங்கள் மாற்றம் மட்டுமே அவசியம். Commit message-ன் வடிவத்தையும், இருந்தால் pull request விதிகளையும் சேர்க்குங்கள்.

ஒரு கூற்று சரிபார்க்கக்கூடிய அளவுக்கு துல்லியமாக இருங்கள். "2-space indentation பயன்படுத்துங்கள்" என்பது பயன்படுத்தக்கூடிய instruction. அது நடைமுறைப்படுத்தப்பட்டதா இல்லையா என்பதைச் சரிபார்க்கலாம். "Code-ஐ முறையாக format செய்யுங்கள்" என்பது சரிபார்க்க முடியாதது. Locations-க்கும் இதே விதி பொருந்தும்: "API handlers src/api/handlers/-ல் உள்ளன" என்பது "Files-ஐ ஒழுங்காக வைத்திருங்கள்" என்பதைக் காட்டிலும் தெளிவானது.

Negative rules-க்கும் இடம் ஒதுக்குங்கள். "npm run build மூலம் உருவாக்கப்படும் dist/-ன் கீழுள்ள files-ஐ ஒருபோதும் edit செய்யாதீர்கள்" என்பது ஒரு குறிப்பிட்ட தவறைத் தடுக்கும். மேலும், அது காரணத்தைக் குறிப்பிடுவதால், நீங்கள் எழுதாத அதற்கு இணையான நிலையை agent தானாகக் கண்டறிய முடியும்.

ஒருபோதும் இதில் இடம்பெறக் கூடாதவை

இந்தக் கோப்புகளில் எதிலும் ரகசியத்தை ஒருபோதும் வைக்காதீர்கள். கோப்பு git-ல் commit செய்யப்படுகிறது, ஒவ்வொரு session தொடக்கத்திலும் context-ல் ஏற்றப்படுகிறது, மேலும் ஒவ்வொரு request-லும் model provider-க்கு அனுப்பப்படுகிறது. AGENTS.md-ல் உள்ள API key, உங்கள் repository history-லுள்ள API key ஆகவும், third party-யின் logs-லுள்ள API key ஆகவும் இருக்கும். ரகசியத்தை paste செய்வதற்குப் பதிலாக, அதன் இருப்பிடத்தைக் குறிப்பிடுங்கள்: "database password .env-ல் உள்ளது; அது gitignored; அதை வாசிப்பதற்கு முன் கேளுங்கள்." இதற்கான விரிவான நடைமுறை agent அணுகக்கூடிய வரம்பிற்கு வெளியே credentials-ஐ வைத்திருத்தல் என்பதில் விளக்கப்பட்டுள்ளது.

Agent பார்ப்பதன் மூலம் கண்டறியக்கூடிய எதையும் சேர்க்க வேண்டாம். Paste செய்யப்பட்ட directory listing, dependency list-ன் நகல், folder names-ஐ மீண்டும் கூறும் architecture overview ஆகிய அனைத்தும், எழுதப்பட்ட அடுத்த வாரத்திலேயே காலாவதியாகிவிடும். அதற்கிடையில் ஒவ்வொரு session-லும் அவை context-ஐப் பயன்படுத்தும். சிக்கல்களையும் அவற்றிற்கான காரணங்களையும் வைத்திருங்கள். Inventory-ஐ நீக்குங்கள்.

CLAUDE.md என்பது அதே கருத்தின் Claude Code நிகழ்வு

Claude Code, CLAUDE.md-ஐப் படிக்கும்; AGENTS.md-ஐத் தானாகப் படிக்காது. திட்டக் கோப்பு ./CLAUDE.md அல்லது ./.claude/CLAUDE.md இல் இருக்கும். ஒவ்வொரு திட்டத்திற்குமான தனிப்பட்ட விருப்பங்கள் ~/.claude/CLAUDE.md இல் வைக்கப்படும். Linux-இல் நிறுவனம் முழுவதற்குமான கோப்பை /etc/claude-code/CLAUDE.md இல் இயந்திர அளவில் வைக்கலாம். கண்டறியப்பட்ட கோப்புகள் filesystem root முதல் உங்கள் working directory வரை இணைக்கப்படுகின்றன. எனவே நீங்கள் session-ஐத் தொடங்கிய இடத்திற்கு அருகிலுள்ள கோப்பு கடைசியாகப் படிக்கப்படும்.

உங்கள் repository-யில் ஏற்கனவே AGENTS.md இருந்தால், இரண்டாவது பிரதியைப் பராமரிக்க வேண்டாம். அதை import செய்து, Claude-க்கு உரியவற்றை மட்டும் சேர்க்கவும்:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

கூடுதலாகச் சேர்க்க எதுவும் இல்லையெனில் symlink செயல்படும்:

ln -s AGENTS.md CLAUDE.md

வெற்றியடைந்தால் command எதையும் அச்சிடாது. உங்கள் அடுத்த session-இல் /context-ஐ இயக்கி, Memory files என்பதன் கீழ் CLAUDE.md தோன்றுகிறதா என்பதை உறுதிப்படுத்தவும். அந்தப் பட்டியலில் அது இல்லையெனில், கோப்பு ஒருபோதும் load ஆகவில்லை; எனவே அதிலுள்ள எந்த விதியும் செயல்படவில்லை. முதல் draft-ஐ நீங்களே எழுதுவதற்குப் பதிலாக உருவாக்க, /init-ஐ இயக்கவும். இது codebase-ஐப் படித்து தொடக்கக் கோப்பை உருவாக்கும். CLAUDE.md ஏற்கனவே இருந்தால், அதை overwrite செய்வதற்குப் பதிலாக மேம்பாடுகளைப் பரிந்துரைக்கும்.

ஒவ்வொரு கோப்பையும் சுமார் 200 lines-க்குள் வைத்திருக்கவும். நீளமான கோப்புகள் window-இல் அதிக இடத்தைப் பயன்படுத்தும்; இதனால் விதிகளைப் பின்பற்றுதல் குறையும். அந்த இடத்திற்கு வேறு எவை போட்டியிடுகின்றன என்பதைப் பார்க்க விரும்பினால், agent-ன் context window-ஐ உண்மையில் நிரப்புவது எது என்பதைப் பாருங்கள்.

ஒரு அம்சத்தைத் தெளிவாக வலியுறுத்த வேண்டும். AGENTS.md என்பது வழிகாட்டுதல் மட்டுமே; அது permission system அல்ல. அதன் உள்ளடக்கம் சாதாரண context ஆக model-க்கு வழங்கப்படுகிறது. எனவே model அதைப் படித்து வழக்கமாகப் பின்பற்றும். ஆனால் அதற்கு முரணான action-ஐ எதுவும் தடுக்காது. ஒவ்வொரு முறையும் கட்டாயமாகப் பின்பற்ற வேண்டிய விதி இருந்தால், எடுத்துக்காட்டாக "never push to main", hook அல்லது permission setting-ஐப் பயன்படுத்தவும். அவை code ஆக இயங்குவதால், model அதைப் பின்பற்ற முடிவு செய்வதைச் சார்ந்திருக்காது.

இந்தக் கோப்புகளை உங்களுக்காக எழுதும் கருவிகள்

30 July 2026 அன்று GitHub trending பட்டியலில் இருந்த இரண்டு projects, இந்த convention எந்தத் திசையில் செல்கிறது என்பதை காட்டுகின்றன.

agent0ai/dox (July 2026 நிலவரப்படி 1,368 stars) என்பது AGENTS.md கோப்புகளின் tree-ஐ புதுப்பித்த நிலையில் வைத்திருக்கும் framework ஆகும். இது எந்த package-ஐயும் runtime-ஐயும் வழங்காது. அதன் AGENTS.md உள்ளடக்கத்தை உங்கள் root AGENTS.md-க்குள் copy செய்வதே installation ஆகும். ஏற்கனவே உள்ள project-க்கு, உங்கள் agent-க்கு இதைப் பின்வருமாறு கூறுங்கள்:

Initialize DOX tree for this project now.

பின்னர் agent, child AGENTS.md கோப்புகளையும் அவற்றின் indexes-ஐயும் உருவாக்கும். ஏதேனும் ஒன்றை edit செய்வதற்கு முன் அந்த tree-ஐச் சரிபார்க்கும். மாற்றம் செய்யப்பட்ட பிறகு, பாதிக்கப்பட்ட documentation-ஐப் புதுப்பிக்கும். இதன் அடிப்படை நம்பிக்கை என்னவென்றால், agent தனது பணியின் ஒரு பகுதியாகப் பராமரிக்கும் documentation உண்மையாகவே இருக்கும்; ஒருவர் கைமுறையாகப் புதுப்பிக்கும் documentation அவ்வாறு இருக்காது.

HUMAN.md, அதே முறையை உங்களை நோக்கிப் பயன்படுத்துவது

Intuition-Lab/personal-model (July 2026 நிலவரப்படி 1,260 stars) இந்த முறையை repository-க்கு பதிலாக ஒரு நபருக்குப் பயன்படுத்துகிறது. உங்கள் HUMAN.md என்பது நீங்கள் தட்டச்சு செய்யும் file அல்ல; அது system-ன் output என்று இந்த project விளக்குகிறது: “இப்போது எது முக்கியம், நீங்கள் எவ்வாறு முடிவெடுக்கிறீர்கள், உங்கள் கவனம் எங்கு நகர்கிறது என்பதற்கான உயிரோட்டமான model.” இது macOS 13 அல்லது அதற்குப் பிந்தைய பதிப்புகளில் local-ஆக இயங்குகிறது. macOS permission வழங்கிய பிறகு activity-ஐ பதிவு செய்கிறது. பின்னர் MCP (model context protocol) மூலம் agents-க்கு முடிவை வழங்குகிறது. சுருக்கமான install முறை:

uv tool install personal-model
persome onboard
persome model open --after 30

பெரும்பாலான பயன்களைப் பெற இவை எதுவும் தேவையில்லை. கையால் எழுதப்பட்ட HUMAN.md சுமார் இருபது வரிகளைக் கொண்டிருக்கும்: உங்கள் role, timezone, நீங்கள் உண்மையில் பயன்படுத்தும் stack, ஏற்கனவே எடுத்த முடிவுகள் மற்றும் மீண்டும் விவாதிக்க விரும்பாதவை, மேலும் உங்களுக்கு எவ்வளவு விளக்கம் தேவை என்பவை. இது project file சேமிக்கும் அதே மீண்டும் மீண்டும் விளக்க வேண்டிய பணியை, ஒரு மட்டம் மேலே, குறைக்கிறது.

ஒரு எச்சரிக்கை. HUMAN.md ஒரு நபரின் profile என்பதால், அது இயல்பாகவே sensitive ஆகும். அதை public repository-க்கு வெளியே வைத்திருங்கள். அதை ~/.claude/CLAUDE.md இல் அல்லது project root-இல் உள்ள gitignored CLAUDE.local.md இல் வையுங்கள். அது committed file-க்கு இணையாக load ஆகி, அதே முறையில் கையாளப்படும்.

நீங்கள் நகலெடுத்து பயன்படுத்தக்கூடிய தொடக்க வார்ப்புரு

இது வேண்டுமென்றே சுருக்கமாக வைக்கப்பட்டுள்ளது. பொருந்தாத பிரிவுகளை நீக்குங்கள். தொடர்ந்து புதுப்பித்து வைத்திருக்க முடியாத பிரிவுகளைச் சேர்ப்பதைத் தவிர்க்குங்கள்.

# AGENTS.md

## Project
A Django API serving the mobile app. Python 3.12, PostgreSQL 16.

## Setup
uv sync
docker compose up -d db
./manage.py migrate

## Commands
Run one test: pytest tests/test_orders.py::test_refund
Run everything: pytest
Lint: ruff check . && ruff format --check .

## Conventions
Type hints on every public function. Line length 100, not 88.
Migrations are generated, never hand-edited.
Never edit files under static/dist/, they come from npm run build.

## Secrets
Local credentials live in .env, which is gitignored. Ask before reading it.

## Pull requests
Title format: [area] short description. Run the linter before opening one.

அதை எழுதுங்கள். பின்னர் அதே இடத்தில் திருத்துங்கள். ஒரு வரியைச் சேர்க்க வேண்டியதற்கான அறிகுறி, அதே திருத்தத்தை chat-இல் இரண்டு முறை தட்டச்சு செய்திருப்பதாகும். இந்த ஒரு விதி கோப்பைப் பயனுள்ளதாக வைத்திருக்கிறது. மேலும், இயந்திரங்களையும் சேர்த்து யாரும் படிக்காத ஆவணமாக கோப்பு வளர்வதைத் தடுக்கிறது. கோப்பு நிலைத்த பிறகு, அது repository-உடன் பயணிக்கும். Agent உங்கள் laptop-க்கு பதிலாக வேறு இடத்தில் இயங்கும்போது இது மிகவும் முக்கியமானது: உங்கள் சொந்த server-இல் coding agent-ஐ இயக்குதல் அந்த setup-ஐ விளக்குகிறது.

FAQ

AGENTS.md, CLAUDE.md என்ற அதே கோப்பா?

இவை இரண்டு கோப்புப் பெயர்களில் உள்ள ஒரே கருத்தாகும். Claude Code, CLAUDE.md-ஐ படிக்கும்; அவற்றை இணைக்காவிட்டால் AGENTS.md-ஐ புறக்கணிக்கும். ஒரு கோப்பை நம்பகமான முதன்மை ஆதாரமாக வைத்துக்கொண்டு, மற்றொன்றை அதனுடன் link செய்யுங்கள். இதை உங்கள் CLAUDE.md கோப்பின் தொடக்கத்தில் @AGENTS.md என்ற வரியைச் சேர்ப்பதன் மூலமாகவோ அல்லது ln -s AGENTS.md CLAUDE.md பயன்படுத்தியோ செய்யலாம். தனித்தனியாக பராமரிக்கப்படும் இரண்டு முழு நகல்கள், ஒரு மாதத்திற்குள் ஒன்றுக்கொன்று முரண்படும்.

AGENTS.md எழுதினால் agent அதை கண்டிப்பாகப் பின்பற்றுமா?

இல்லை. அதன் உள்ளடக்கம் context ஆக வழங்கப்படுகிறது. எனவே model அதைப் படித்து பொதுவாகப் பின்பற்றும். ஆனால் அதற்கு முரணான action-ஐ அது தடுக்காது. தெளிவற்ற instructions மிகக் குறைந்த நம்பகத்தன்மையுடன் பின்பற்றப்படும். எதிர்மறையான guidance வழங்கும் இரண்டு கோப்புகள் இருந்தால், agent அவற்றில் ஒன்றைத் தன்னிச்சையாகத் தேர்ந்தெடுக்கும். ஒவ்வொரு முறையும் கட்டாயமாகப் பின்பற்ற வேண்டிய rule-க்கு hook அல்லது permission rule பயன்படுத்துங்கள். Model எதைத் தீர்மானித்தாலும் client அவற்றை அமல்படுத்தும்.

AGENTS.md-ஐ git-ல் commit செய்ய வேண்டுமா?

ஆம். Project-ஐப் பற்றிய உண்மையான தகவல்களுக்கு இதைச் செய்யுங்கள்: build commands, layout மற்றும் conventions. இந்தக் கோப்பின் நோக்கம் அதுவே. இதனால் உங்கள் teammates-ன் agents, உங்கள் agent தொடங்கும் அதே context-உடன் தொடங்கும். தனிப்பட்ட தகவல்கள் அல்லது ஒரு machine-க்கு மட்டும் உரிய தகவல்கள் தனி gitignored கோப்பில் இருக்க வேண்டும். Credentials எந்தக் கோப்பிலும் இருக்கக்கூடாது.

HUMAN.md என்றால் என்ன? எனக்கு அது தேவையா?

HUMAN.md என்பது project-ஐப் பற்றிய profile அல்ல; ஒரு நபரைப் பற்றிய machine-readable profile ஆகும். இதில் உங்கள் role, constraints மற்றும் ஏற்கனவே முடிவு செய்த decisions ஆகியவை இருக்கும். இதனால் ஒவ்வொரு session-லும் அவற்றை மீண்டும் பரிசீலிக்க வேண்டியதில்லை. தொடங்குவதற்கு எந்த tooling-மும் தேவையில்லை. உங்கள் user-level instructions file-ல் நீங்கள் எழுதும் இருபது வரிகள் பெரும்பாலான பயனை வழங்கும். இதை personal data ஆகக் கருதி, நீங்கள் push செய்யும் எந்த repository-யிலிருந்தும் விலக்கி வையுங்கள்.