SSD Nodes Learn Hosting plans →
கல்வி வழிகாட்டிகள் Matt Connorஆல் Matt Connor · புதுப்பிக்கப்பட்டது 2026-08-30

AGENTS.md மற்றும் HUMAN.md கோப்புகள் என்றால் என்ன?

AGENTS.md கோப்பை எவ்வாறு பயன்படுத்துவது என்பதை அறிக. AI coding agent-களுக்கான அறிவுறுத்தல்கள், CLAUDE.md உடனான வேறுபாடு மற்றும் உங்கள் திட்டத்திற்கான மாதிரி படிவத்தை இங்கே காணலாம்.

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

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

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

இதில் கட்டாயமான புலங்கள் (fields) எதுவும் இல்லை. இது குறித்து அந்தத் தளம் தெளிவாகக் கூறுகிறது: "AGENTS.md என்பது ஒரு சாதாரண Markdown கோப்பு மட்டுமே. நீங்கள் விரும்பும் தலைப்புகளைப் பயன்படுத்தலாம்; நீங்கள் வழங்கும் உரையை அந்த agent அப்படியே பகுப்பாய்வு (parse) செய்துகொள்ளும்." இதுவே அதன் முழுமையான விவரக்குறிப்பு (specification). இதன் மதிப்பு அதன் format-ல் இல்லை. மாறாக, அனைத்துக் கருவிகளும் ஏற்கனவே தேடும் ஒரு பாதையில் (path) இந்தக் கோப்பு இருப்பதுதான் இதன் முக்கியத்துவம்.

கோப்பு எங்கு அமையும் மற்றும் எந்தக் கோப்பு முன்னுரிமை பெறும்

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

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-ஐ சரிபார்க்க வேண்டும்" போன்ற ஒரு விதி, அந்த endpoint-களுக்கு அருகிலேயே இருக்க வேண்டும். Root கோப்பில் இதை வைத்தால், அது தொடர்பில்லாத அனைத்து பணிகளின் போதும் load ஆகி எந்தப் பயனும் தராது. உங்கள் root கோப்பில் ஒவ்வொரு service-க்கும் தனித்தனி பகுதி உருவாகிவிட்டதென்றால், அதை nested layout-ஆகப் பிரிப்பது சரியான தீர்வாகும்; எந்த விதிகள் கீழே செல்ல வேண்டும், எவை மேலே இருக்க வேண்டும் என்பதை இது தீர்மானிக்கிறது.

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

குறியீட்டை (code) வாசிப்பதன் மூலம் ஒரு agent-ஆல் கண்டறிய முடியாத தகவல்களை இதில் குறிப்பிடவும். முதலில், terminal-ல் நீங்கள் உள்ளிடும் அதே வடிவில் build, test மற்றும் lint கட்டளைகளைக் குறிப்பிடவும். ஒரு குறிப்பிட்ட test-ஐ மட்டும் இயக்குவதற்கான கட்டளையைச் சேர்க்கவும்; ஏனெனில், முழு தொகுப்பையும் (suite) இயக்கும்படி அறிவுறுத்தப்பட்டால், agent அதைத் தேவையற்ற முறையில் பலமுறை இயக்கும். கருவியின் இயல்புநிலை (default) அமைப்பிலிருந்து மாறுபடும் மரபுகளை (conventions) மட்டும் குறிப்பிடவும்; ஏனெனில், இயல்புநிலை அமைப்புகள் agent-க்கு ஏற்கனவே தெரியும். உங்களிடம் commit message வடிவம் மற்றும் pull request விதிகள் இருந்தால், அவற்றையும் சேர்க்கவும்.

ஒரு கூற்றைச் சரிபார்க்கும் வகையில் தகவல்கள் தெளிவாக இருக்க வேண்டும். "2-space indentation பயன்படுத்தவும்" என்பது ஒரு பயனுள்ள அறிவுறுத்தல், ஏனெனில் அது பின்பற்றப்பட்டதா இல்லையா என்பதை உறுதிப்படுத்த முடியும். "குறியீட்டைச் சரியாக வடிவமைக்கவும்" என்பது பயனுள்ளதல்ல, ஏனெனில் அதைச் சரிபார்க்க முடியாது. கோப்புகளின் இருப்பிடத்திற்கும் இது பொருந்தும்: "API handlers src/api/handlers/-ல் உள்ளன" என்பது "கோப்புகளை ஒழுங்காக வைக்கவும்" என்பதை விடச் சிறந்தது.

எதிர்மறை விதிகளும் (negative rules) இதில் முக்கியம். "dist/-க்குக் கீழ் உள்ள கோப்புகளைத் திருத்த வேண்டாம், அவை npm run build மூலம் உருவாக்கப்படுபவை" என்ற விதி ஒரு குறிப்பிட்ட பிழையைத் தடுக்கும். அதற்கான காரணத்தைக் குறிப்பிடுவதால், நீங்கள் குறிப்பிடாத பிற ஒத்த சூழல்களையும் agent-ஆல் புரிந்துகொள்ள முடியும். வரம்பு (scope) குறித்த விதிகளும் இதில் இடம்பெற வேண்டும், ஏனெனில் தன்னிச்சையாகச் செயல்படும் agent நீங்கள் கேட்டதை விட அதிகமான மாற்றங்களைச் செய்யக்கூடும்: பரவலாகப் பின்பற்றப்படும் ஒரு திறன், செயல்படக்கூடிய மிகச்சிறிய மாற்றத்தை மட்டும் வலியுறுத்துவதாகும்.

எவற்றையெல்லாம் இதில் சேர்க்கக்கூடாது

இக்கோப்புகளில் ரகசியத் தகவல்களை ஒருபோதும் சேர்க்க வேண்டாம். இக்கோப்பு git-ல் commit செய்யப்படுகிறது, ஒவ்வொரு session தொடக்கத்திலும் context-ல் ஏற்றப்படுகிறது, மேலும் ஒவ்வொரு கோரிக்கையின்போதும் model provider-க்கு அனுப்பப்படுகிறது. AGENTS.md கோப்பில் உள்ள ஒரு API key என்பது, உங்கள் repository வரலாற்றிலும் மூன்றாம் தரப்பினரின் logs-லும் பதிவாகும் ஒரு API key ஆகும். ரகசியத்தை நேரடியாகப் பதிவிடுவதற்குப் பதிலாக, அதைச் சுட்டிக்காட்டுங்கள்: "database password .env-ல் உள்ளது, இது gitignore செய்யப்பட்டுள்ளது; இதைப் படிக்கும் முன் அனுமதி கேட்கவும்." இது குறித்த விரிவான நடைமுறைகள் keeping credentials out of an agent's reach பகுதியில் விளக்கப்பட்டுள்ளன.

Agent தானாகவே கண்டறியக்கூடிய தகவல்களைத் தவிர்க்கவும். நீங்கள் நகலெடுத்த directory பட்டியல், dependency பட்டியல், அல்லது folder பெயர்களை மீண்டும் குறிப்பிடும் architecture விளக்கம் ஆகிய அனைத்தும் நீங்கள் எழுதிய ஒரு வாரத்திலேயே காலாவதியாகிவிடும்; அதுவரை ஒவ்வொரு session-லும் context-ஐ வீணடிக்கும். சிக்கல்களையும் அதற்கான காரணங்களையும் மட்டும் வைத்திருங்கள். விவரப்பட்டியலை (inventory) நீக்கிவிடவும். காரணங்களை மட்டும் தனியாக வைத்திருப்பது அவசியம்; ஏனெனில், ஒரு கட்டமைப்பு ஏன் வழக்கத்திற்கு மாறான வடிவில் உள்ளது என்று தெரியாத பட்சத்தில், agent அதைத் தவறுதலாக மாற்றியமைக்கக்கூடும். இதனால்தான் a DESIGN.md next to this one கோப்பை வைத்திருப்பது அவசியமாகிறது.

CLAUDE.md என்பது அதே கருத்தின் Claude Code பதிப்பாகும்

Claude Code ஆனது CLAUDE.md-ஐ வாசிக்கும், ஆனால் தானாகவே AGENTS.md-ஐ வாசிக்காது. ஒரு project file ./CLAUDE.md அல்லது ./.claude/CLAUDE.md-ல் அமையும், ஒவ்வொரு project-க்குமான தனிப்பட்ட விருப்பத்தேர்வுகள் ~/.claude/CLAUDE.md-ல் அமையும், மேலும் ஒரு நிறுவனம் Linux-ல் /etc/claude-code/CLAUDE.md-க்கு machine-wide கோப்பை அனுப்ப முடியும். கண்டறியப்பட்ட கோப்புகள் filesystem root-லிருந்து உங்கள் working directory வரை இணைக்கப்படுகின்றன, எனவே நீங்கள் session-ஐத் தொடங்கிய இடத்திற்கு மிக அருகில் உள்ள கோப்பு கடைசியாக வாசிக்கப்படும். அந்த directory-ல் நீங்கள் தொடங்கும் ஒவ்வொரு session-ம் ஒரே stack-ஐ ஏற்றுகிறது, இதுவே ஒரே machine-ல் இரண்டையும் அருகருகே இயக்குவதைச் சாத்தியமாக்குகிறது, மேலும் அந்த 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 தோன்றுகிறதா என்பதை உறுதிப்படுத்தவும். அந்தப் பட்டியலில் அது இல்லை என்றால், கோப்பு ஏற்றப்படவில்லை என்று அர்த்தம், எனவே அதில் உள்ள எதுவும் செயல்படாது. ஒரு கோப்பை நீங்களே எழுதுவதற்குப் பதிலாக முதல் வரைவை உருவாக்க, /init-ஐ இயக்கவும்: இது codebase-ஐ வாசித்து ஒரு தொடக்கக் கோப்பை உருவாக்குகிறது, மேலும் ஏற்கனவே CLAUDE.md இருந்தால், அது மேலெழுதாமல் மேம்பாடுகளைப் பரிந்துரைக்கும்.

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

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

இக்கோப்புகளை உங்களுக்காக உருவாக்கும் கருவிகள்

2026 ஜூலை 30 அன்று GitHub trending பட்டியலில் இருந்த இரண்டு திட்டங்கள், இந்த நடைமுறை எந்த திசையை நோக்கிச் செல்கிறது என்பதைக் காட்டுகின்றன.

agent0ai/dox (2026 ஜூலை நிலவரப்படி 1,368 stars) என்பது AGENTS.md கோப்புகளின் கட்டமைப்பைப் பராமரிப்பதற்கான ஒரு framework ஆகும். இது எந்தவொரு package-ஐயும் அல்லது runtime-ஐயும் கொண்டிருக்கவில்லை. நீங்கள் அதன் AGENTS.md உள்ளடக்கத்தை உங்கள் root AGENTS.md கோப்பில் நகலெடுத்துக் கொள்வதே அதன் நிறுவல் (install) ஆகும். ஏற்கனவே உள்ள ஒரு திட்டத்திற்கு, உங்கள் agent-இடம் பின்வருமாறு கூற வேண்டும்:

Initialize DOX tree for this project now.

அதன்பிறகு, அந்த agent துணை AGENTS.md கோப்புகளையும் அவற்றின் குறியீடுகளையும் (indexes) உருவாக்குகிறது. எதையும் திருத்துவதற்கு முன்பு அந்த கட்டமைப்பை முழுமையாக ஆய்வு செய்கிறது. ஒரு மாற்றம் நடைமுறைக்கு வந்த பிறகு, அது தொடர்பான ஆவணங்களை (documentation) மேம்படுத்துகிறது. இதன் பின்னணியில் உள்ள நம்பிக்கை என்னவென்றால், ஒரு agent தனது பணியின் ஒரு பகுதியாகப் பராமரிக்கும் ஆவணங்கள் துல்லியமாக இருக்கும், ஆனால் மனிதர்கள் கையால் புதுப்பிக்கும் ஆவணங்கள் அவ்வாறு இருப்பதில்லை.

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

Intuition-Lab/personal-model (2026 ஜூலை நிலவரப்படி 1,260 நட்சத்திரங்கள்) இந்த முறையை ஒரு repository-க்கு பதிலாக ஒரு நபருக்குப் பயன்படுத்துகிறது. இந்தத் திட்டம் உங்கள் HUMAN.md கோப்பை நீங்கள் தட்டச்சு செய்யும் கோப்பாகப் பார்க்காமல், ஒரு அமைப்பின் வெளியீடாகக் கருதுகிறது: "தற்போது எது முக்கியம், நீங்கள் எவ்வாறு முடிவெடுக்கிறீர்கள், உங்கள் கவனம் எங்கே செல்கிறது என்பதைக் காட்டும் ஒரு வாழும் மாதிரி." இது macOS 13 அல்லது அதற்குப் பிந்தைய பதிப்புகளில் இயங்குகிறது, நீங்கள் அனுமதி அளித்த பிறகு செயல்பாடுகளைப் பதிவு செய்கிறது, மேலும் MCP (model context protocol) மூலம் முடிவுகளை agents-க்கு வழங்குகிறது. சுருக்கமான நிறுவல் பாதை:

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

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

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

நீங்கள் நகலெடுக்கக்கூடிய ஒரு தொடக்க வார்ப்புரு (starter template)

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

# 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) இயங்கும்போது இது மிக முக்கியமானது: உங்கள் சொந்த server-ல் coding agent-ஐ இயக்குதல் அந்த அமைப்பைப் பற்றி விளக்குகிறது.

FAQ

AGENTS.md மற்றும் CLAUDE.md ஆகிய இரண்டும் ஒரே கோப்பா?

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

AGENTS.md-ஐ எழுதுவது, அந்த ஏஜென்ட் அதைப் பின்பற்றுவதை உறுதிப்படுத்துமா?

இல்லை. இதன் உள்ளடக்கம் சூழலாக (context) வழங்கப்படுகிறது, எனவே மாதிரி (model) அதைப் படித்து பொதுவாகப் பின்பற்றும், ஆனால் அதற்கு முரணான செயலை எதுவும் தடுக்காது. தெளிவற்ற அறிவுறுத்தல்கள் மிகக் குறைவாகவே பின்பற்றப்படுகின்றன, மேலும் இரண்டு கோப்புகள் முரண்பட்ட வழிகாட்டுதலை வழங்கினால், ஏஜென்ட் ஏதேனும் ஒன்றை தன்னிச்சையாகத் தேர்ந்தெடுக்கும். ஒவ்வொரு முறையும் கட்டாயம் பின்பற்றப்பட வேண்டிய விதிக்கு, ஒரு hook அல்லது permission rule-ஐப் பயன்படுத்தவும்; மாதிரி என்ன முடிவெடுத்தாலும், இவை client மூலம் அமல்படுத்தப்படும்.

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

ஆம், திட்டத்தைப் பற்றிய உண்மையான தகவல்களுக்கு—build commands, layout, conventions—இதைச் செய்ய வேண்டும். இதுவே இந்தக் கோப்பின் நோக்கம், ஏனெனில் உங்கள் குழு உறுப்பினர்களின் ஏஜென்ட்களும் உங்களுடைய அதே சூழலில் இருந்து தொடங்க முடியும். தனிப்பட்ட அல்லது ஒரு குறிப்பிட்ட கணினிக்குரிய தகவல்களை gitignore செய்யப்பட்ட தனி கோப்பில் வைக்கவும்; நற்சான்றிதழ்களை (credentials) எதிலும் சேர்க்க வேண்டாம்.

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

HUMAN.md என்பது ஒரு திட்டத்தைப் பற்றியது அல்ல, ஒரு நபரைப் பற்றிய இயந்திரத்தால் வாசிக்கக்கூடிய சுயவிவரம் (profile) ஆகும். இது உங்கள் பங்கு, கட்டுப்பாடுகள் மற்றும் நீங்கள் ஏற்கனவே எடுத்த முடிவுகளைக் கொண்டிருக்கும், இதனால் ஒவ்வொரு அமர்விலும் (session) அவை மீண்டும் விவாதிக்கப்படாது. இதைத் தொடங்க எந்தக் கருவியும் தேவையில்லை: உங்கள் பயனர்-நிலை அறிவுறுத்தல் கோப்பில் (user-level instructions file) கையால் எழுதப்பட்ட இருபது வரிகள் உங்களுக்குப் பெரும்பாலான பலன்களைத் தரும். இதைத் தனிப்பட்ட தரவாகக் கருதி, நீங்கள் push செய்யும் எந்த repository-யிலும் சேர்க்க வேண்டாம்.