AI-fundamentals: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository overview

AI Fundamentals is a Chinese-language knowledge repository covering the full AI infrastructure stack: GPU architecture, CUDA programming, LLM theory, inference systems, cloud-native AI platforms, agentic systems, RAG, and more. All content is authored in Markdown.

• License: Apache 2.0
• Content is organized in semantically numbered top-level directories (01_hardware_architecture/ through 11_ai_native_everything/, plus 98_llm_programming/ and 99_misc/). Each directory corresponds to a major topic area with its own README.md portal.
• 02_dpu_programming/、02_gpu_programming/ 和 02_npu_programming/ share the 02_ prefix — all three are sub-modules under "底层计算与异构编程."
• AGENTS.md exists alongside this file and covers module-level architecture details for GitHub Copilot. This file focuses on project-level conventions that apply to all work in the repo.

Commit conventions

This repo uses Conventional Commits with Chinese descriptions:

docs(scope): description
chore(scope): description
refactor(scope): description
feat(scope): description

Scopes are derived from directory/topic areas. Common scopes seen in the history: readme, dpu, gpu, npu, training, llm-theory, rag, graph_rag, agentic, agent_infra, inference, kv_cache, vllm, reference_design, storage, gpu_manager, k8s, course, trae, multi_agent, ai-native, smart_customer_service, kvbm, submodule. Look at git log --oneline for recent examples before committing.

File conventions

• All top-level topic directories use zero-padded numeric prefixes (e.g., 01_, 02_, 03_) to maintain ordering.
• Within a topic directory, files may use numeric prefixes for ordering (e.g., 01_concepts.md, 02_practice.md).
• Translated content appends a language suffix to the filename (e.g., file.zh-CN.md).
• Image assets live in img/ at the repo root, or alongside the files that reference them within topic subdirectories.
• Interactive HTML visualizations (e.g., inference pipeline demos) are placed alongside the markdown documents they complement, in the same topic subdirectory.
• README.md files at directory roots serve as navigation portals and contain link trees to content within that directory. When adding a new article, you must update the corresponding directory's README.md portal to include a link to the new file — this is the primary navigation mechanism for readers.