Kurulan dosyalar
Kuralların nereye yazıldığı, AGENTS.md bloğunda ne olduğu ve manifestin dosyaları nasıl izlediği.
Dosya ağacı
.claude/rules/virastack/*.md # --agent claude
.cursor/rules/virastack/*.mdc # --agent cursor
.agents/rules/virastack/*.md # --agent none
.virastack/ai.json # manifest
AGENTS.md # virastack-ai block
CLAUDE.md # @AGENTS.md (--agent claude)Kural dosyaları sadece seçtiğiniz araçlar için yazılır. AGENTS.md ve .virastack/ai.json her zaman yazılır.
AGENTS.md bloğu
ViraStack AI sadece BEGIN:virastack-ai ve END:virastack-ai işaretleri arasındaki kısmı yönetir:
<!-- BEGIN:virastack-ai -->
# ViraStack AI
## Persona
## Commands
## Operational Guardrails
## Rules
<!-- END:virastack-ai -->- Komutlar lockfile’dan bulunan paket yöneticisini kullanır (
pnpm lint && pnpm typecheck,npm test, …). - Rules bölümü her aracın kuralları nereden okuduğunu ve her kuralın ne zaman kullanılacağını gösteren tabloyu içerir.
- Bloğun üstündeki veya altındaki kendi metniniz ve Next.js bloğu (
BEGIN:nextjs-agent-rules) birebir korunur.
CLAUDE.md
--agent claude ile CLAUDE.md dosyasına @AGENTS.md import satırı eklenir. Böylece Claude Code bloğu okur. Dosya yoksa oluşturulur. Varsa satır en üste eklenir, geri kalanı aynen kalır. remove sadece yapılanı geri alır.
Manifest
.virastack/ai.json neyin kurulduğunu kaydeder. Commit edin ve elle düzenlemeyin.
| Alan | Anlamı |
|---|---|
$schema | Editör doğrulaması için JSON şeması. |
version | Manifest biçim sürümü (1). |
cliVersion | Dosyayı yazan @virastack/ai sürümü. |
framework | nextjs veya tanstack. |
agents | Seçilen araçlar: claude, cursor veya none. |
claudeImport | created veya inserted: @AGENTS.md satırının CLAUDE.md içine nasıl girdiği. |
files | Yönetilen her dosya ve yazılan içeriğin sha256 özeti. Özet farklıysa dosyayı siz değiştirmişsiniz demektir. |
Neler yönetilir
ViraStack AI sadece şunları oluşturur, günceller ve siler:
virastack/klasörlerindeki kural dosyaları. Her biri “Managed by @virastack/ai” yorumuyla başlar.AGENTS.mdiçindekivirastack-aibloğu ve manifest.CLAUDE.mdiçindeki@AGENTS.mdsatırı.
Geri kalan her şeye, virastack/ klasörlerinin yanındaki kendi kural dosyalarınız dahil, asla dokunulmaz.
