Claude Architect · Pelajaran

Peraturan Monolit berbanding Modular

Pecahkan CLAUDE.md yang besar untuk menjimatkan konteks dan token

Pelajaran 4 daripada 413 langkah

Peraturan Monolit berbanding Modular ialah pelajaran Claude Architect percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Claude Architect, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Claude Architect merangkumi sejumlah 4 pelajaran.

Masalah Monolit

Satu CLAUDE.md gergasi nampak kemas, tetapi setiap token di dalamnya dimuatkan ke dalam tetingkap konteks pada setiap permintaan dalam setiap sesi.

Jika fail anda mengandungi 4,000 baris yang meliputi bahagian belakang, aplikasi iOS, konvensyen CSS dan senarai semak keluaran, Claude menanggung kos tersebut walaupun hanya membaiki satu peraturan CSS. Konteks yang terbazir itu memenuhi ruang yang sepatutnya digunakan oleh kod dan sejarah yang benar-benar penting.

Pelajaran ini berkaitan pemecahan monolit kepada peraturan modular yang hanya dimuatkan apabila berkaitan.

Mengapa Modular Menjimatkan Token

Faedahnya mudah: muatkan peraturan apabila diperlukan, bukannya sentiasa.

CLAUDE.md monolitik menghantar keseluruhan isinya pada setiap giliran.
Fail peraturan modular dalam .claude/rules/ boleh mengisytiharkan laluan yang terpakai padanya, jadi fail tersebut dimuatkan hanya apabila anda menyunting fail yang sepadan.

Teks yang sentiasa aktif dan lebih sedikit bermakna lebih banyak ruang untuk tugasan, serta lebih sedikit token yang dicaj bagi setiap permintaan. Ini menyokong Domain 5 secara langsung: Pengurusan Konteks & Kebolehpercayaan.

Hierarki CLAUDE.md

Sebelum memecahkannya, ketahui lapisan yang dibaca oleh Claude Code:

Peringkat pengguna ~/.claude/CLAUDE.md — peribadi, TIDAK dikongsi melalui VCS. Rakan sepasukan baharu tidak akan melihatnya.
Peringkat projek ./CLAUDE.md atau .claude/CLAUDE.md — dikongsi melalui kawalan versi, jadi seluruh pasukan menerimanya.
Peringkat direktori — CLAUDE.md yang berskop kepada subpepohon dan dimuatkan apabila anda bekerja di dalamnya.

Peraturan seluruh pasukan hendaklah berada pada peringkat projek. Apa-apa sahaja pada peringkat pengguna tidak kelihatan kepada orang lain.

Modulkan dengan Import @path

Alat pemecahan pertama ialah import @path. Kekalkan CLAUDE.md yang ringkas dan masukkan fail terperinci hanya apabila diperlukan.

Hal ini memastikan fail peringkat atas mudah dibaca dan membolehkan anda menggunakan semula piawaian merentas projek. Nota: fail yang diimport tetap dimuatkan apabila CLAUDE.md yang mengimportnya dimuatkan — import menyusun kandungan, bukannya mengehadkan pemuatannya mengikut laluan.

# CLAUDE.md (project root)

## Project Overview
NestJS backend + single-file HTML dashboard.

## Coding Standards
@./standards/coding-style.md
@./standards/git-workflow.md

## Testing
@./standards/testing.md

Fail Peraturan Berskop Laluan

Penjimatan token sebenar datang daripada fail .claude/rules/ dengan frontmatter YAML. Glob paths memberitahu Claude Code supaya memuatkan peraturan hanya apabila anda menyunting fail yang sepadan.

Menyunting komponen .tsx? Peraturan React dimuatkan. Hanya menyentuh SQL? Peraturan itu langsung tidak dimasukkan ke dalam konteks. Inilah pemuatan bersyarat berbanding kos sentiasa aktif bagi monolit.

---
paths:
  - "src/**/*.tsx"
  - "src/**/*.jsx"
---

# React Component Rules
- Use function components and hooks; no class components.
- Co-locate tests as `*.test.tsx` next to the component.
- Keep components under 200 lines; extract subcomponents otherwise.

Perkara yang Kekal dalam Fail Teras

Bukan semua perkara patut berskop laluan. CLAUDE.md teras hendaklah mengekalkan peraturan yang terpakai di mana-mana, setiap masa:

Gambaran keseluruhan projek dan ringkasan seni bina.
Cara membina, menjalankan dan menggunakan.
Peraturan keselamatan merentas bahagian (contohnya "jangan jalankan penggunaan OTA tanpa kelulusan nyata").

Pindahkan butiran khusus domain — konvensyen bahasa, corak setiap rangka kerja dan keunikan subsistem — ke dalam peraturan berskop laluan. Teras = sejagat; peraturan = mengikut keadaan.

Susun Atur Fail yang Dicadangkan

Susun atur modular yang kemas memisahkan teras yang sentiasa aktif daripada peraturan dan piawaian atas permintaan:

Fail akar yang ringkas memberikan orientasi kepada Claude; fail rules/ diaktifkan mengikut laluan; fail standards/ diimport apabila berkaitan. Rakan sepasukan baharu menerima semuanya melalui VCS.

project/
  CLAUDE.md                  # lean: overview + build/deploy + safety
  .claude/
    rules/
      react.md               # paths: src/**/*.tsx
      sql.md                 # paths: **/*.sql
      api.md                 # paths: src/api/**
  standards/
    coding-style.md          # @-imported from CLAUDE.md
    testing.md

Skop Pengguna berbanding Projek, Sekali Lagi

Apabila memecahkan fail, tentukan skop dengan sengaja. Peraturan yang mesti dipatuhi oleh rakan sepasukan hendaklah berada dalam fail peringkat projek atau .claude/rules/, dan diserahkan kepada VCS.

Keutamaan yang benar-benar peribadi — tabiat editor dan pintasan tempatan anda — hendaklah berada dalam ~/.claude/CLAUDE.md peringkat pengguna. Meletakkan piawaian dikongsi di situ ialah kesilapan klasik: piawaian tersebut secara senyap tidak sampai kepada ahli pasukan yang lain.

Risiko Hilang di Tengah

Terdapat juga sebab kebolehpercayaan untuk memecahkan fail, bukan sekadar kos. Model memberikan perhatian paling banyak kepada permulaan dan penghujung konteks serta paling sedikit kepada bahagian tengah — kesan "hilang di tengah".

Monolit 4,000 baris menenggelamkan peraturan penting di bahagian tengah yang kurang diberi perhatian itu. Fail berskop laluan yang lebih kecil mengekalkan setiap peraturan berhampiran bahagian atas kandungan yang dimuatkan, jadi arahan yang terpakai sekarang lebih berkemungkinan dipatuhi.

Menyunting Peraturan dengan Selamat

Anda tidak perlu menyunting fail ini secara manual tanpa panduan. Di dalam Claude Code, /memory membuka dan menyunting CLAUDE.md serta mengekalkan perubahan merentas sesi.

Berhati-hati dengan /compact: ia memampatkan konteks yang sedang berjalan dan boleh menyebabkan nombor, tarikh serta ambang tertentu menjadi kabur. Ia bukan pengganti untuk memecahkan peraturan secara berstruktur — pemampatan meringkaskan perbualan, manakala fail modular mengurangkan perkara yang dimuatkan sejak awal.

# Inside an interactive Claude Code session
/memory          # open CLAUDE.md to add or refine a rule (persists)
/compact         # compress context — may blur exact numbers/dates

Strategi Migrasi

Untuk memecahkan monolit sedia ada tanpa kehilangan peraturan:

Kekalkan peraturan sejagat (gambaran keseluruhan, binaan, penggunaan, keselamatan) dalam CLAUDE.md teras.
Kelompokkan selebihnya mengikut domain — satu fail peraturan bagi setiap bahasa atau subsistem.
Tambahkan glob paths pada setiap fail supaya ia dimuatkan hanya apabila suntingan sepadan dibuat.
Import piawaian dikongsi dengan @path di tempat yang berkenaan secara meluas.
Sahkan tiada yang tercicir — setiap peraturan terdahulu mesti berada di suatu tempat yang boleh dicapai melalui VCS.

Semakan Ringkas: Memilih Pemecahan

CLAUDE.md anda telah berkembang menjadi kira-kira 3,500 baris yang merangkumi lima bahasa dan panduan operasi penggunaan. Kebanyakan sesi hanya melibatkan satu bahasa pada satu-satu masa, dan konteks semakin terhad. Sebagai arkitek, apakah penyusunan semula yang terbaik?

Jawab dalam pelajaran interaktif

Imbas Kembali: Monolit berbanding Modular

Perkara utama:

CLAUDE.md monolitik dimuatkan sepenuhnya bagi setiap permintaan, membazirkan token dan menenggelamkan peraturan di bahagian tengah yang kurang diberi perhatian.
Fail .claude/rules/ dengan glob frontmatter paths dimuatkan hanya apabila fail yang sepadan disunting — inilah penjimatan token utama.
Import @path memodulkan dan menggunakan semula piawaian; fail teras mengekalkan peraturan sejagat (gambaran keseluruhan, binaan, penggunaan, keselamatan).
Kongsi peraturan pasukan pada peringkat projek melalui VCS; simpan hanya keutamaan peribadi dalam ~/.claude/CLAUDE.md pada peringkat pengguna.
Suntingan /memory kekal; /compact bukan pengganti kepada pemecahan peraturan secara berstruktur.

Percuma untuk bermula

Pelajari Python dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 26
Pelajaran: 104

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Peraturan Monolit berbanding Modular” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Claude Architect, termasuk “Peraturan Monolit berbanding Modular”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Claude Architect merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Peraturan Monolit berbanding Modular”?

Pecahkan CLAUDE.md yang besar untuk menjimatkan konteks dan token Anda berlatih Claude Architect menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Claude Architect?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Claude Architect di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Peraturan Monolit berbanding Modular” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Claude Architect ini?

Ya. Setiap pelajaran Claude Architect menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

Tahap Pengguna, Projek dan Direktori
Sintaks Import @path
.claude/rules/ dengan Laluan Frontmatter
Peraturan Monolit berbanding Modular

← Kembali ke Claude Architect