Dropstone Docs

விதிகள்

dropstone க்கான தனிப்பயன் வழிமுறைகளை அமைக்கவும்.

AGENTS.md கோப்பை உருவாக்குவதன் மூலம் dropstone க்கு தனிப்பயன் வழிமுறைகளை வழங்கலாம். இது Cursor இன் விதிகளைப் போன்றது. இது உங்கள் குறிப்பிட்ட திட்டத்திற்கான LLM இன் சூழலில் சேர்க்கப்படும் வழிமுறைகளைக் கொண்டுள்ளது.

தொடங்குதல்

புதிய AGENTS.md கோப்பை உருவாக்க, dropstone இல் /init கட்டளையை இயக்கலாம்.

குறிப்பு:

உங்கள் திட்டத்தின் AGENTS.md கோப்பை Git இல் கமிட் செய்யவும், இதனால் உங்கள் குழுவின் மற்ற உறுப்பினர்கள் அதே விதிகளைப் பெறுவார்கள்.

/init உங்கள் repo இல் உள்ள முக்கியமான கோப்புகளை ஸ்கேன் செய்கிறது, கோডபேஸ் அவற்றுக்கு பதிலளிக்க முடியாதபோது சில লক্ష்যযுক்த கேள்விகளைக் கேட்கலாம், பின்னர் AGENTS.md ஐ சுருக்கமான திட்ட-குறிப்பிட்ட வழிகாட்டுதலுடன் உருவாக்கி அல்லது புதுப்பிக்கிறது.

இது ভবிষ்யত agent அமர்வுகளுக்கு மிகவும் தேவைப்படக்கூடிய விஷயங்களில் கவனம் செலுத்துகிறது:

  • build, lint, மற்றும் test கட்டளைகள்
  • கட்டளை வரிசை மற்றும் அவை முக்கியமாக இருக்கும்போது கவனம் செலுத்திய சரிபார்ப்பு படிகள்
  • கோப்பு பெயர்களிலிருந்து தெளிவாக இல்லாத স்থাপত்யம் மற்றும் repo கட்டமைப்பு
  • திட்ட-குறிப்பிட்ட மரபுகள், அமைப்பு quirks, மற்றும் செயல்பாட்டு gotchas
  • 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 கோப்பைப் படிப்பதையும் ஆதரிக்கிறது. இது வெவ்வேறு நோக்கங்களுக்கு பணிபுரிகிறது.

திட்டம்

திட்ட-குறிப்பிட்ட விதிகளுக்கு உங்கள் திட்ட root இல் AGENTS.md ஐ வைக்கவும். இவை நீங்கள் இந்த கோப்பகத்தில் அல்லது அதன் துணை-கோப்பகங்களில் பணிபுரியும்போது மட்டுமே பொருந்தும்.

உலகளாவிய

~/.config/dropstone/AGENTS.md கோப்பில் உலகளாவிய விதிகளையும் வைக்கலாம். இது அனைத்து dropstone அமர்வுகளிலும் பொருந்தும்.

இது Git இல் கமிட் செய்யப்படாமல் அல்லது உங்கள் குழுவுடன் பகிரப்படாமல் இருப்பதால், LLM பின்பற்ற வேண்டிய ব்যক்তিগত விதிகளைக் குறிப்பிட இதைப் பயன்படுத்த பரிந்துரைக்கிறோம்.

Claude Code সামঞ்சस்யம்

Claude Code இலிருந்து மாற்றம் செய்யும் பயனர்களுக்கு, Dropstone Claude Code இன் கோப்பு மரபுகளை fallbacks ஆக படிக்கிறது:

  • திட்ட விதிகள்: உங்கள் திட்ட கோப்பகத்தில் CLAUDE.md (AGENTS.md இல்லாவிட்டால் பயன்படுத்தப்படுகிறது)
  • உலகளாவிய விதிகள்: ~/.claude/CLAUDE.md (~/.config/dropstone/AGENTS.md இல்லாவிட்டால் பயன்படுத்தப்படுகிறது)
  • திறன்கள்: ~/.claude/skills/ (திறன்கள் ஐ பார்க்கவும்)

Dropstone Claude Code இடங்களிலிருந்து படிப்பதை நிறுத்த, அந்த கோப்புகளை அகற்றவோ அல்லது பெயர் மாற்றவோ (அல்லது AGENTS.md இல் சமமான உள்ளடக்கத்தை கமிட் செய்யவோ, இதனால் திட்டம் முன்னுரிமை பெறுகிறது).

முன்னுரிமை

Dropstone தொடங்கும்போது, இந்த வரிசையில் விதி கோப்புகளைத் தேடுகிறது:

  1. உள்ளூர் கோப்புகள் தற்போதைய கோப்பகத்திலிருந்து மேலே பயணம் செய்வதன் மூலம் (AGENTS.md, CLAUDE.md)
  2. உலகளாவிய கோப்பு ~/.config/dropstone/AGENTS.md இல்
  3. 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"]
}

வலை থেকে வழிமுறைகளை ஏற்ற தொலைதூர URLs ஐயும் பயன்படுத்தலாம்.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
}

தொலைதூர வழிமுறைகள் 5 வினாடி timeout உடன் பெறப்படுகின்றன.

அனைத்து வழிமுறை கோப்புகளும் உங்கள் 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.

இந்த அணுகுமுறை உங்களை அனுமதிக்கிறது:

  • மডுலர், மீண்டும் பயன்படுத்தக்கூடிய விதி கோப்புகளை உருவாக்கவும்
  • symlinks அல்லது git submodules மூலம் திட்டங்களில் விதிகளைப் பகிரவும்
  • AGENTS.md ஐ சுருக்கமாக வைத்திருக்கும்போது விস்தரிக்கப்பட்ட வழிகாட்டுதல்களுக்கான குறிப்புகளை வைக்கவும்
  • dropstone குறிப்பிட்ட பணிக்கு தேவைப்படும்போது மட்டுமே கோப்புகளை ஏற்றுவதை உறுதிசெய்யவும்

குறிப்பு:

monorepos அல்லது பகிரப்பட்ட தரங்களைக் கொண்ட திட்டங்களுக்கு, glob patterns (packages/*/AGENTS.md போன்ற) உடன் dropstone.json ஐ பயன்படுத்துவது கைமுறை வழிமுறைகளை விட மிகவும் பராமரிக்கக்கூடியது.

Ctrl+I