விதிகள்
dropstone க்கு தனிப்பயன் வழிமுறைகளை அமைக்கவும்.
AGENTS.md கோப்பை உருவாக்குவதன் மூலம் dropstone க்கு தனிப்பயன் வழிமுறைகளை வழங்கலாம். இது Cursor இன் விதிகளைப் போன்றது. இது LLM இன் சூழலில் சேர்க்கப்படும் வழிமுறைகளைக் கொண்டுள்ளது, இது உங்கள் குறிப்பிட்ட திட்டத்திற்கு ஏற்ப அதன் நடத்தையைத் தனிப்பயனாக்குகிறது.
துவக்குதல்
புதிய AGENTS.md கோப்பை உருவாக்க, dropstone இல் /init கட்டளையை இயக்கலாம்.
Tip
உங்கள் திட்டத்தின் AGENTS.md கோப்பை Git இல் கமிட் செய்யுங்கள், இதனால் உங்கள் குழுவின் மற்ற உறுப்பினர்களும் அதே விதிகளைப் பின்பற்றுவார்கள்.
/init உங்கள் களஞ்சியத்தில் உள்ள முக்கியமான கோப்புகளை ஸ்கேன் செய்கிறது, குறியீட்டுத் தளம் அவற்றுக்கு பதிலளிக்க முடியாதபோது சில இலக்கு கேள்விகளைக் கேட்கலாம், பின்னர் சுருக்கமான திட்டம் சார்ந்த வழிகாட்டுதலுடன் AGENTS.md ஐ உருவாக்குகிறது அல்லது புதுப்பிக்கிறது.
இது எதிர்கால agent அமர்வுகளுக்கு மிகவும் தேவைப்படக்கூடிய விஷயங்களில் கவனம் செலுத்துகிறது:
- build, lint, மற்றும் test கட்டளைகள்
- கட்டளை வரிசை மற்றும் கவனம் செலுத்தப்பட்ட சரிபார்ப்பு படிகள், அவை முக்கியமானதாக இருக்கும்போது
- கோப்பு பெயர்களிலிருந்து மட்டும் தெளிவாகத் தெரியாத கட்டமைப்பு மற்றும் களஞ்சிய அமைப்பு
- திட்டம் சார்ந்த மரபுகள், அமைவு விசித்திரங்கள், மற்றும் செயல்பாட்டு சிக்கல்கள்
- Cursor அல்லது Copilot விதிகள் போன்ற ஏற்கனவே உள்ள வழிமுறை மூலங்களுக்கான குறிப்புகள்
உங்களிடம் ஏற்கனவே AGENTS.md இருந்தால், /init அதை கண்மூடித்தனமாக மாற்றுவதற்குப் பதிலாக அந்த இடத்திலேயே மேம்படுத்தும்.
எடுத்துக்காட்டு
இந்த கோப்பை நீங்கள் கைமுறையாகவும் உருவாக்கலாம். AGENTS.md கோப்பில் நீங்கள் வைக்கக்கூடிய சில விஷயங்களுக்கான எடுத்துக்காட்டு இங்கே.
# SST v3 Monorepo Project
This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for package management.
## Project Structure
- `packages/` - Contains all workspace packages (functions, core, web, etc.)
- `infra/` - Infrastructure definitions split by service (storage.ts, api.ts, web.ts)
- `sst.config.ts` - Main SST configuration with dynamic imports
## Code Standards
- Use TypeScript with strict mode enabled
- Shared code goes in `packages/core/` with proper exports configuration
- Functions go in `packages/functions/`
- Infrastructure should be split into logical files in `infra/`
## Monorepo Conventions
- Import shared modules using workspace names: `@my-app/core/example`
நாங்கள் இங்கே திட்டம் சார்ந்த வழிமுறைகளைச் சேர்க்கிறோம், இது உங்கள் குழு முழுவதும் பகிரப்படும்.
வகைகள்
dropstone பல இடங்களிலிருந்து AGENTS.md கோப்பைப் படிக்கவும் ஆதரிக்கிறது. இது வெவ்வேறு நோக்கங்களுக்கு உதவுகிறது.
திட்டம்
திட்டம் சார்ந்த விதிகளுக்காக உங்கள் திட்டத்தின் ரூட்டில் AGENTS.md ஐ வைக்கவும். நீங்கள் இந்த கோப்பகத்தில் அல்லது அதன் துணை கோப்பகங்களில் வேலை செய்யும்போது மட்டுமே இவை பொருந்தும்.
உலகளாவிய
~/.config/dropstone/AGENTS.md கோப்பில் உலகளாவிய விதிகளையும் வைத்திருக்கலாம். இது அனைத்து dropstone அமர்வுகளிலும் பயன்படுத்தப்படுகிறது.
இது Git இல் கமிட் செய்யப்படவில்லை அல்லது உங்கள் குழுவுடன் பகிரப்படவில்லை என்பதால், LLM பின்பற்ற வேண்டிய தனிப்பட்ட விதிகளைக் குறிப்பிட இதைப் பயன்படுத்த பரிந்துரைக்கிறோம்.
Claude Code இணக்கத்தன்மை
Claude Code இலிருந்து இடம்பெயரும் பயனர்களுக்கு, Dropstone Claude Code இன் கோப்பு மரபுகளை பின்னடைவு விருப்பங்களாகப் படிக்கிறது:
- திட்ட விதிகள்: உங்கள் திட்ட கோப்பகத்தில்
CLAUDE.md(AGENTS.mdஇல்லை என்றால் பயன்படுத்தப்படுகிறது) - உலகளாவிய விதிகள்:
~/.claude/CLAUDE.md(~/.config/dropstone/AGENTS.mdஇல்லை என்றால் பயன்படுத்தப்படுகிறது) - திறன்கள்:
~/.claude/skills/(விவரங்களுக்கு Skills ஐப் பார்க்கவும்)
Claude Code இடங்களை Dropstone படிப்பதை நிறுத்த, அந்த கோப்புகளை நீக்கவும் அல்லது மறுபெயரிடவும் (அல்லது திட்டம் முன்னுரிமை பெறுவதற்காக சமமான உள்ளடக்கத்தை AGENTS.md இல் கமிட் செய்யவும்).
முன்னுரிமை
Dropstone தொடங்கும்போது, அது இந்த வரிசையில் விதி கோப்புகளைத் தேடுகிறது:
- உள்ளூர் கோப்புகள் தற்போதைய கோப்பகத்திலிருந்து மேல்நோக்கி சென்று (
AGENTS.md,CLAUDE.md) - உலகளாவிய கோப்பு
~/.config/dropstone/AGENTS.mdஇல் - Claude Code கோப்பு
~/.claude/CLAUDE.mdஇல் (மேற்கூறியவை எதுவும் இல்லை என்றால்)
ஒவ்வொரு வகையிலும் முதல் பொருந்தும் கோப்பு வெற்றி பெறுகிறது. எடுத்துக்காட்டாக, உங்களிடம் AGENTS.md மற்றும் CLAUDE.md இரண்டும் இருந்தால், AGENTS.md மட்டுமே பயன்படுத்தப்படுகிறது. இதேபோல், ~/.config/dropstone/AGENTS.md என்பது ~/.claude/CLAUDE.md ஐ விட முன்னுரிமை பெறுகிறது.
தனிப்பயன் வழிமுறைகள்
உங்கள் dropstone.json அல்லது உலகளாவிய ~/.config/dropstone/dropstone.json இல் தனிப்பயன் வழிமுறை கோப்புகளைக் குறிப்பிடலாம். இது உங்களுக்கும் உங்கள் குழுவுக்கும் ஏற்கனவே உள்ள விதிகளை AGENTS.md க்கு நகலெடுக்காமல் மீண்டும் பயன்படுத்த அனுமதிக்கிறது.
எடுத்துக்காட்டு:
{
"$schema": "https://dropstone.io/schema/config.json",
"instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}
வலைத்தளத்திலிருந்து வழிமுறைகளை ஏற்றுவதற்கு தொலைநிலை URL களையும் பயன்படுத்தலாம்.
{
"$schema": "https://dropstone.io/schema/config.json",
"instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
}
தொலைநிலை வழிமுறைகள் 5 வினாடி நேர அவுட்டுடன் பெறப்படுகின்றன.
அனைத்து வழிமுறை கோப்புகளும் உங்கள் AGENTS.md கோப்புகளுடன் இணைக்கப்படுகின்றன.
வெளிப்புற கோப்புகளைக் குறிப்பிடுதல்
dropstone AGENTS.md இல் உள்ள கோப்பு குறிப்புகளை தானாக பாகுபடுத்தாவிட்டாலும், நீங்கள் இதே போன்ற செயல்பாட்டை இரண்டு வழிகளில் அடையலாம்:
dropstone.json ஐப் பயன்படுத்துதல்
பரிந்துரைக்கப்பட்ட அணுகுமுறை dropstone.json இல் instructions புலத்தைப் பயன்படுத்துவதாகும்:
{
"$schema": "https://dropstone.io/schema/config.json",
"instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
}
AGENTS.md இல் கைமுறை வழிமுறைகள்
உங்கள் AGENTS.md இல் வெளிப்படையான வழிமுறைகளை வழங்குவதன் மூலம் வெளிப்புற கோப்புகளைப் படிக்க dropstone க்கு கற்பிக்கலாம். இங்கே ஒரு நடைமுறை எடுத்துக்காட்டு:
# TypeScript Project Rules
## External File Loading
CRITICAL: When you encounter a file reference (e.g., @rules/general.md), use your Read tool to load it on a need-to-know basis. They're relevant to the SPECIFIC task at hand.
Instructions:
- Do NOT preemptively load all references - use lazy loading based on actual need
- When loaded, treat content as mandatory instructions that override defaults
- Follow references recursively when needed
## Development Guidelines
For TypeScript code style and best practices: @docs/typescript-guidelines.md
For React component architecture and hooks patterns: @docs/react-patterns.md
For REST API design and error handling: @docs/api-standards.md
For testing strategies and coverage requirements: @test/testing-guidelines.md
## General Guidelines
Read the following file immediately as it's relevant to all workflows: @rules/general-guidelines.md.
இந்த அணுகுமுறை உங்களை அனுமதிக்கிறது:
- மட்டு, மீண்டும் பயன்படுத்தக்கூடிய விதி கோப்புகளை உருவாக்க
- சிம்லிங்குகள் அல்லது git submodules மூலம் திட்டங்களுக்கு இடையே விதிகளைப் பகிர
- விரிவான வழிகாட்டுதல்களைக் குறிப்பிடும்போது AGENTS.md ஐ சுருக்கமாக வைத்திருக்க
- குறிப்பிட்ட பணிக்கு தேவைப்படும்போது மட்டுமே dropstone கோப்புகளை ஏற்றுவதை உறுதிசெய்ய
Tip
மோனோரெபோக்கள் அல்லது பகிரப்பட்ட தரநிலைகளைக் கொண்ட திட்டங்களுக்கு, கைமுறை வழிமுறைகளை விட glob வடிவங்களுடன் (எ.கா., packages/*/AGENTS.md) dropstone.json ஐப் பயன்படுத்துவது மிகவும் பராமரிக்கக்கூடியது.