آموزش Claude Code برای توسعه نرم‌افزارهای سازمانی - آخرین آپدیت

سرفصل ها و درس ها

مقدمه Introduction

• خوش‌آمدگویی به دوره Welcome to the Course

• Claude Code چیست؟ What Is Claude Code?

• سیستم کدنویسی AI (Coding Harness) چیست؟ What Is an AI Coding Harness?

• چرا Claude Code در کدبیس‌های بزرگ دچار مشکل می‌شود؟ Why Claude Code Struggles with Large Codebases

• اجزای یک سیستم سازمانی Claude Code Components of a Claude Code Enterprise Harness

• معماری پلتفرم تجارت سازمانی Enterprise Commerce Platform Architecture

• نصب و پیکربندی Claude Code Installing and Configuring Claude Code

• پیمایش در مخزن با Claude Code Navigating a Repository with Claude Code

• پرامپت‌نویسی برای وظایف کدبیس در Claude Code Prompting Claude Code for Codebase Tasks

• آزمایشگاه عملی پایه: پلتفرم تجارت سازمانی Hands on Lab Baseline: Enterprise Commerce Platform

کشف کدبیس و نقشه‌برداری از مخزن Codebase Discovery and Repository Mapping

• نحوه کاوش Claude Code در یک مخزن How Claude Code Explores a Repository

• درک کانتکست و ساختار مخزن Understanding Context and Repository Structure

• چرا مخازن بزرگ باعث ایجاد نویز کانتکست می‌شوند؟ Why Large Repositories Create Context Noise

• نقشه‌برداری از اپلیکیشن‌ها، سرویس‌ها و پکیج‌های مشترک Mapping Applications, Services, and Shared Packages

• شناسایی مالکیت و وابستگی‌ها Identifying Ownership and Dependencies

• شناخت دایرکتوری‌های تولید شده، قدیمی و پرخطر Recognizing Generated, Legacy, and High-Risk Directories

• طراحی یک نقشه کدبیس موثر Designing an Effective Codebase Map

• افزودن CODEBASE_MAP.md Add CODEBASE_MAP.md

دستورالعمل‌های سراسری پروژه با CLAUDE.md Global Project Instructions with CLAUDE.md

• فایل CLAUDE.md چیست؟ What Is CLAUDE.md?

• نحوه بارگذاری دستورالعمل‌های پروژه توسط Claude Code How Claude Code Loads Project Instructions

• کانتکست سراسری در مقابل کانتکست وظیفه Global Context Versus Task Context

• چه مواردی باید در CLAUDE.md باشند؟ What Belongs in CLAUDE.md?

• چه مواردی نباید در CLAUDE.md قرار گیرند؟ What Should Stay Out of CLAUDE.md?

• نوشتن دستورالعمل‌های واضح و عملی Writing Clear and Actionable Instructions

• اجتناب از فایل‌های دستورالعمل حجیم و متضاد Avoiding Large and Conflicting Instruction Files

• به‌روزرسانی CLAUDE.md همزمان با تکامل پروژه Maintaining CLAUDE.md as the Project Evolves

• آزمایشگاه عملی: افزودن CLAUDE.md ریشه Hands-on Lab: Add the Root CLAUDE.md

کانتکست لایه‌بندی شده برای سرویس‌ها و اپلیکیشن‌ها Layered Context for Services and Applications

• چرا یک فایل CLAUDE.md کافی نیست؟ Why One CLAUDE.md Is Not Enough

• نحوه عملکرد فایل‌های CLAUDE.md تو در تو How Nested CLAUDE.md Files Work

• جداسازی قوانین سراسری از قوانین محلی Separating Global Rules from Local Rules

• مستندسازی مسئولیت‌های سرویس Documenting Service Responsibilities

• افزودن دستورات و مرزهای مختص هر سرویس Adding Service-Specific Commands and Boundaries

• جلوگیری از تضاد بین فایل‌های دستورالعمل Preventing Conflicts Between Instruction Files

• طراحی استراتژی کانتکست لایه‌بندی شده Designing a Layered Context Strategy

• آزمایشگاه عملی: افزودن فایل‌های CLAUDE.md در سطح سرویس Hands-on Lab: Add Service-Level CLAUDE.md Files

محدود کردن جلسات Claude Code Scoping Claude Code Sessions

• تاثیر دایرکتوری کاری بر عملکرد Claude Code How the Working Directory Affects Claude Code

• جلسات در سطح مخزن در مقابل جلسات در سطح سرویس Repository-Level Versus Service-Level Sessions

• کاهش نویز کانتکست Reducing Context Noise

• انتخاب دایرکتوری شروع صحیح Choosing the Correct Starting Directory

• تحقیق گسترده در مقابل پیاده‌سازی محدود شده Broad Investigation Versus Scoped Implementation

• مدیریت تغییرات بین سرویسی Managing Cross-Service Changes

• چه زمانی یک جلسه جدید Claude Code شروع کنیم؟ When to Start a New Claude Code Session

• متمرکز نگه داشتن جلسات طولانی Keeping Long Sessions Focused

• آزمایشگاه عملی: محدود کردن صحیح جلسات Claude Code Hands-on Lab: Scope Claude Code Sessions Correctly

بخش ۶ — دستورات اعتبارسنجی و تعریف اتمام (Definition of Done) Section 6 — Validation Commands and Definition of Done

• چرا Claude به دستورالعمل‌های اعتبارسنجی صریح نیاز دارد؟ Why Claude Needs Explicit Validation Instructions

• دستورات تست، لینت، بررسی نوع و بیلد Test, Lint, Type-Check, and Build Commands

• اعتبارسنجی سراسری در مقابل اعتبارسنجی محدود Repository-Wide Versus Scoped Validation

• ایجاد بازخورد سریع برای تغییرات کوچک Creating Fast Feedback for Small Changes

• تعریف معیارهای تکمیل Defining Completion Criteria

• جلوگیری از ادعاهای موفقیت تایید نشده Preventing Unverified Success Claims

• مدیریت تست‌های شکست خورده یا در دسترس نبودن تست‌ها Handling Failed or Unavailable Tests

• گزارش نتایج اعتبارسنجی Reporting Validation Results

• آزمایشگاه عملی: افزودن دستورات تست، لینت و بیلد Hands-on Lab: Add Test, Lint, and Build Instructions

بخش ۷ — مجوزها، مرزها و استفاده امن از ابزارها Section 7 — Permissions, Boundaries, and Safe Tool Use

• درک مدل مجوزهای Claude Code Understanding Claude Code’s Permission Model

• ریسک‌های خواندن، نوشتن و اجرای دستورات Read, Write, and Command-Execution Risks

• محافظت از اسرار و فایل‌های محیطی (env) Protecting Secrets and Environment Files

• حذف وابستگی‌ها و فایل‌های تولید شده Excluding Dependencies and Generated Files

• شناسایی دستورات ترمینال امن و خطرناک Identifying Safe and Dangerous Terminal Commands

• اعمال دسترسی با حداقل امتیاز Applying Least-Privilege Access

• بازبینی درخواست‌های ابزاری Claude Code Reviewing Claude Code Tool Requests

• طراحی سیاست‌های مجوز سازمانی Designing Enterprise Permission Policies

• آزمایشگاه عملی: افزودن قوانین نادیده گرفتن و مجوزها Hands-on Lab: Add Ignore and Permission Rules

بخش ۸ — اتوماسیون جریان‌های کاری با هوک‌ها Section 8 — Automating Workflows with Hooks

• هوک‌های Claude Code چیستند؟ What Are Claude Code Hooks?

• درک رویدادهای هوک و چرخه حیات آن‌ها Understanding Hook Events and Lifecycle

• هوک‌ها در مقابل دستورالعمل‌های زبان طبیعی Hooks Versus Natural-Language Instructions

• هوک‌های قبل از ابزار (Pre Tool) و بعد از ابزار (Post Tool) Pre-Tool and Post-Tool Hooks

• اتوماسیون فرمت‌بندی و لینت Automating Formatting and Linting

• افزودن یادآورهای تست و اعتبارسنجی Adding Test and Validation Reminders

• ایجاد هوک‌های خلاصه جلسه Creating Session Summary Hooks

• مدیریت امن شکست‌های هوک Handling Hook Failures Safely

• اجتناب از اتوماسیون‌های کند یا بیش از حد Avoiding Slow or Excessive Automation

• آزمایشگاه عملی: افزودن هوک‌های Claude Code Hands-on Lab: Add Claude Code Hooks

بخش ۹ — جریان‌های کاری قابل استفاده مجدد با مهارت‌های عامل Section 9 — Reusable Workflows with Agent Skills

• مهارت‌های عامل (Agent Skills) چیستند؟ What Are Agent Skills?

• مقایسه CLAUDE.md و مهارت‌های عامل CLAUDE.md Versus Agent Skills

• چه زمانی یک مهارت ایجاد کنیم؟ When to Create a Skill

• درک ساختار مهارت Understanding Skill Structure

• افشای تدریجی کانتکست Progressive Disclosure of Context

• طراحی جریان‌های کاری مختص هر وظیفه Designing Task-Specific Workflows

• تست و نگهداری مهارت‌ها Testing and Maintaining Skills

• اشتراک‌گذاری مهارت‌ها بین پروژه‌ها Sharing Skills Across Projects

• آزمایشگاه عملی: افزودن مهارت‌های مهندسی قابل استفاده مجدد Hands-on Lab: Add Reusable Engineering Skills

بخش ۱۰ — هوش کد برای کدبیس‌های بزرگ Section 10 — Code Intelligence for Large Codebases

• جستجوی متنی در مقابل درک در سطح نماد (Symbol) Text Search Versus Symbol-Level Understanding

• چرا هوش کد اهمیت دارد؟ Why Code Intelligence Matters

• یافتن تعاریف، ارجاعات و پیاده‌سازی‌ها Finding Definitions, References, and Implementations

• درک وابستگی‌های بین ماژولی Understanding Cross-Module Dependencies

• هوش کد برای پایتون Python Code Intelligence

• هوش کد برای تایپ‌اسکریپت TypeScript Code Intelligence

• هوش کد برای جاوا و سی شارپ Java and C# Code Intelligence

• عیب‌یابی نمادهای گم شده یا نادرست Diagnosing Missing and Incorrect Symbols

• ترکیب جستجو با هوش کد Combining Search with Code Intelligence

• آزمایشگاه عملی: افزودن LSP و هوش کد Hands-on Lab: Add LSP and Code Intelligence

بخش ۱۱ — اتصال دانش داخلی با MCP Section 11 — Connecting Internal Knowledge with MCP

• پروتکل کانتکست مدل (MCP) چیست؟ What Is the Model Context Protocol?

• نحوه استفاده Claude Code از MCP How Claude Code Uses MCP

• سرورها، ابزارها و منابع MCP MCP Servers, Tools, and Resources

• کانتکست مخزن در مقابل کانتکست خارجی Repository Context Versus External Context

• اتصال اطلاعات معماری و مالکیت Connecting Architecture and Ownership Information

• طراحی یک سرور دانش مهندسی Designing an Engineering Knowledge Server

• امنیت و کنترل دسترسی MCP MCP Security and Access Control

• مرتبط نگه داشتن کانتکست بازیابی شده Keeping Retrieved Context Relevant

• تست ادغام‌های MCP Testing MCP Integrations

• آزمایشگاه عملی: ساخت سرور MCP مهندسی داخلی Hands-on Lab: Build Internal Engineering MCP Server

• آزمایشگاه عملی: افزودن سرور MCP مهندسی داخلی Hands-on Lab: Add an Internal Engineering MCP Server

بخش ۱۲ — تحقیق با استفاده از زیر-عامل‌ها Section 12 — Investigation with Subagents

• زیر-عامل‌های Claude Code چیستند؟ What Are Claude Code Subagents?

• عامل‌های اصلی در مقابل زیر-عامل‌های تخصصی Main Agents Versus Specialized Subagents

• جداسازی تحقیق از پیاده‌سازی Separating Investigation from Implementation

• طراحی عامل‌های کاوش فقط-خواندنی Designing Read-Only Exploration Agents

• حفظ کانتکست جلسه اصلی Preserving the Main Session’s Context

• سپردن بازبینی‌های امنیتی و تست به زیر-عامل‌ها Delegating Security and Testing Reviews

• ساختاردهی به گزارش‌های زیر-عامل Structuring Subagent Reports

• ساختاردهی به گزارش‌های زیر-عامل Structuring Subagent Reports

• زمانی که زیر-عامل‌ها پیچیدگی غیرضروری ایجاد می‌کنند When Subagents Add Unnecessary Complexity

• آزمایشگاه عملی: افزودن جریان کاری زیر-عامل فقط-خواندنی Hands-on Lab: Add a Read-Only Subagent Workflow

بخش ۱۳ — بسته‌بندی سیستم برای تیم‌ها Section 13 — Packaging the Harness for Teams

• از پیکربندی فردی به استاندارد تیمی From Individual Configuration to Team Standard

• درک پلاگین‌های Claude Code Understanding Claude Code Plugins

• بسته‌بندی مهارت‌ها، هوک‌ها و ادغام‌ها Packaging Skills, Hooks, and Integrations

• استانداردسازی جریان‌های کاری بازبینی Standardizing Review Workflows

• نسخه‌بندی اجزای سیستم (Harness) Versioning Harness Components

• تست تغییرات قبل از استقرار تیمی Testing Changes Before Team Rollout

• ایجاد مستندات آنبوردینگ تیم Creating Team Onboarding Documentation

• به‌روزرسانی سیستم مشترک Updating the Shared Harness

• جلوگیری از انحراف پیکربندی (Configuration Drift) Preventing Configuration Drift

• آزمایشگاه عملی: پلاگین استایل سازمانی Hands-0n Lab: Organization Style Plugin

• آزمایشگاه عملی: بسته‌بندی سیستم به عنوان یک پلاگین تیمی Hands-on Lab: Package the Harness as a Team Plugin

بخش ۱۴ — حاکمیت سازمانی و استقرار Section 14 — Enterprise Governance and Rollout

• چرا پذیرش Claude Code به حاکمیت نیاز دارد؟ Why Claude Code Adoption Needs Governance

• انتخاب تیم پایلوت سازمانی Selecting an Enterprise Pilot Team

• تعریف ابزارها و مجوزهای مجاز Defining Allowed Tools and Permissions

• برقراری الزامات بازبینی انسانی Establishing Human Review Requirements

• کنترل‌های امنیتی، حریم خصوصی و مدیریت داده‌ها Security, Privacy, and Data-Handling Controls

• اندازه‌گیری اثربخشی Claude Code Measuring Claude Code Effectiveness

• ردیابی کیفیت، بازکاری‌ها و حوادث Tracking Quality, Rework, and Incidents

• تعیین مالکان و افراد مسئول مستقیم (DRI) Assigning Owners and DRIs

• ایجاد چرخه بازبینی و بهبود Creating a Review and Improvement Cadence

• مقیاس‌بندی Claude Code در بین تیم‌های مهندسی Scaling Claude Code Across Engineering Teams

• آزمایشگاه عملی: ایجاد دفترچه راهنمای استقرار سازمانی Hands-on Lab: Create the Enterprise Rollout Playbook

بخش ۱۵ — پروژه نهایی عملی Section 15 — Final Capstone

• بازبینی سیستم تکمیل شده Claude Code Reviewing the Completed Claude Code Harness

• آزمایشگاه عملی: پیاده‌سازی ویژگی بازگشت وجه با سیستم تکمیل شده Hands-on Lab: Implement the Refund Feature with the Completed Harness

• مقایسه Claude Code قبل و بعد از استفاده از سیستم Compare Claude Code Before and After the Harness

• اندازه‌گیری دقت، ایمنی و بهره‌وری توسعه Measuring Accuracy, Safety, and Development Efficiency

• خلاصه دوره و گام‌های بعدی Course Summary and Next Steps