claude-code-best-practice

od intuicyjnego kodowania do inżynierii agentowej - praktyka czyni Claude'a doskonałym

= Agenty · = Komendy · = Skille

Boris Cherny on X (tweet 1 · tweet 2 · tweet 3)

Tip

Odwiedź sekcję Jak używać aby w pełni wykorzystać to repozytorium.

🧠 KONCEPCJE

Funkcja	Lokalizacja	Opis
Subagenty	`.claude/agents/<name>.md`
Komendy	`.claude/commands/<name>.md`
Skille	`.claude/skills/<name>/SKILL.md`	Oficjalne skille · Skille dla monorepo
Przepływy pracy	`.claude/commands/weather-orchestrator.md`
Hooki	`.claude/hooks/`	Przewodnik
Serwery MCP	`.claude/settings.json`, `.mcp.json`
Wtyczki	distributable packages	Marketplace · Tworzenie marketplace
Ustawienia	`.claude/settings.json`	Uprawnienia · Konfiguracja modelu · Style wyjścia · Sandboxing · Skróty klawiaturowe · Auto Mode
Status Line	`.claude/settings.json`
Pamięć	`CLAUDE.md`, `.claude/rules/`, `~/.claude/rules/`, `~/.claude/projects/<project>/memory/`	Auto pamięć · Głęboka analiza auto pamięci · Zasady
Checkpointing	automatyczny (śledzenie edycji plików)
Sesje	`--resume`, `--continue`, `/resume`, `/branch`
Okno kontekstu	`/compact`, `/clear`, `/context`
Flagi startowe CLI	`claude [flags]`	Tryb interaktywny · Zmienne środowiskowe
Terminologia AI
Best practices		Inżynieria promptów · Rozszerzanie Claude Code
Biblioteka promptów

🔥 Na topie

Funkcja	Lokalizacja	Opis
Ultrareview	`/code-review ultra`, `claude ultrareview [target]`	Śledzenie zadań
Devcontainery	`.devcontainer/`
Kanały	`--channels`, oparte na wtyczkach	Dokumentacja
Tryb bez migotania	`/tui fullscreen`, `CLAUDE_CODE_NO_FLICKER=1`
Auto Mode	`--permission-mode auto`, `Shift+Tab`	Blog
Power-upy	`/powerup`
Fast Mode	`/fast`, `"fastMode": true`
Advisor	`/advisor`, `advisorModel`, `--advisor`	Blog
Computer Use	serwer MCP `computer-use`	Desktop
Agent SDK	pakiet `npm` / `pip`	Szybki start · Przykłady
Pętla Ralph Wiggum	wtyczka
Chrome	`--chrome`, rozszerzenie
Claude Code Web	`claude.ai/code`	Routines
Artefakty	`/share`, narzędzie `Artifact`
Slack	`@Claude` w Slacku
Code Review	GitHub App (zarządzany)	Blog Lokalne /code-review
GitHub Actions	`.github/workflows/`	GitLab CI/CD
Zdalne sterowanie	`/remote-control`, `/rc`	Tryb headless
Deep Links	`claude-cli://open?repo=…&q=…`
Dynamiczne workflow	`/workflows`, słowo kluczowe `ultracode`, `/effort ultracode`, `.claude/workflows/`	Deep Research
Zespoły agentów	wbudowane (zmienna środowiskowa)
Agent View	`claude agents`, `--bg`, `/bg`
Komunikacja między sesjami	`SendMessage`, `ListAgents`, `/list-agents`
Zadania zaplanowane	`/loop`, `/schedule`, narzędzia cron	Zadania zaplanowane w Desktop · Ogłoszenie
Routines	`claude.ai/code/routines`, `/schedule`	Zadania w Desktop
Zadania	`/tasks`, `~/.claude/tasks/`	Śledzenie Ultrareview
Goal	`/goal <condition>`, `/goal clear`
Dyktowanie głosem	`/voice`
Wbudowane skille	`/code-review`, `/batch`
Git Worktrees	`--worktree`/`-w`, `.worktreeinclude`, `EnterWorktree`/`ExitWorktree`, `isolation: "worktree"`, hooki `WorktreeCreate`/`WorktreeRemove`

Zobacz orchestration-workflow po szczegóły implementacji wzorca Komenda → Agent → Skill.

claude
/weather-orchestrator

⚙️ WORKFLOW DEWELOPERSKIE

Wszystkie ważniejsze workflow zbiegają się do tego samego wzorca architektonicznego: Research → Plan → Execute → Review → Ship

Nazwa	★	Workflow
Superpowers	288k	→ → → → → →	0	0	14
Matt Pocock Skills	264k	→ → → → → →	0	0	37
Everything Claude Code	260k	→ → → → → → → →	68	94	286
Spec Kit	137k	→ → → → →	0	10	0
gstack	133k	→ → → → → → → → →	0	0	53
agent-skills	89k	→ → → → →	3	7	21
OpenSpec	69k	→ → → → → → →	0	12	7
Get Shit Done	64.6k	→ → → → → → →	33	85	0
BMAD-METHOD	53k	→ → → → → → →	0	0	35
oh-my-claudecode	39.2k	→ → → → → →	19	0	39
Compound Engineering	25.1k	→ → → → →	0	1	36
HumanLayer	11.6k	→ → → → → → →	6	27	0

Uwaga: żółte znaczniki to sub-pętle — kroki powtarzające się wewnątrz nadrzędnego kroku (np. na zadanie, na historyjkę, lub dopóki warunek weryfikacji nie zostanie spełniony).

Inne

RPI
Pętla Ralph Wiggum
Workflow Andrej Karpathy (Founding Member, OpenAI)
Workflow Peter Steinberger (Creator of OpenClaw)
Workflow Boris Cherny (Creator of Claude Code) — 13 tipów · 10 tipów · 12 tipów · 2 tipy · 15 tipów · 6 tipów
Workflow Thariq (Anthropic) — Skille · Zarządzanie sesjami

🔀 WORKFLOW MIĘDZYMODELOWE

Używaj Claude Code razem z innymi modelami — Codex, Gemini, GPT, Kimi, DeepSeek, lokalne — poprzez trzy mechanizmy:

Plugin — CLI innego modelu działa wewnątrz Claude Code (komendy slash jak /codex:review)
MCP — Claude Code wywołuje inny model jako narzędzie przez Model Context Protocol
Router — endpoint API Claude Code zostaje podmieniony na innego dostawcę

Metodologia: Workflow międzymodelowy (Claude Code + Codex) — ręczny przepływ dwuterminałowy z Planem w Claude, QA-Review w Codex.

📊 RAPORTY

Raport	Opis
Claude Code — najlepsze praktyki	Podstawowe zasady: kontekst, spójność, weryfikacja, autonomia
Pamięć agenta Claude	Trzy zakresy pamięci: user, project, local
Pluginy Claude (`eval` + MCP)	Jak budować pluginy z testami, sandboxem i CI
Integracja MCP	Instalacja, konfiguracja, używanie serwerów MCP
Workflow błędów budowania w Claude Code	Jak debugować błędy budowania w Claude Code
Serwer MCP Context7	Jak zintegrować Context7 jako źródło dokumentacji
Claude LLM vs Claude Code vs Cursor	Porównanie narzędzi programistycznych Claude
Workflow PR Claude + Codebuddy	Pull requesty w dwóch edytorach: Claude CLI + Codebuddy (IDE)

📚 NAJLEPSZE PRAKTYKI

Przewodnik	Opis
Pamięć agenta Claude	Trzy zakresy pamięci: user, project, local. Używaj do trwałych instrukcji projektowych, preferencji, dostosowań.
Pluginy Claude (`eval` + MCP)	Jak budować pluginy z testami, sandboxem, CI/CD. Zawiera przykład Hello World, pattern ewaluacyjny, strukturę plików.
Polecenia Claude	Jak tworzyć komendy slash, dostosowywać argumenty, komponować przepływy pracy. Zawiera dokumentację pól frontmatter.
Hooki Claude	Zarządzanie cyklem życia: PreToolUse, PostToolUse, Stop, SessionStart, inne. Zawiera wzorce powiadomień, formatowania, kompilacji.
CLAUDE.md	Instrukcje projektowe dla Claude: kiedy używać, jak strukturyzować, granice rozmiaru, priorytety frontmatter.
Rozszerzenia MCP	Jak rozszerzać Claude poprzez Model Context Protocol: narzędzia, zasoby, prompty, zarządzanie kontekstem.
Reguły Claude	Globalne zasady w `~/.claude/rules/` plus reguły na ścieżce; leniwołądowane względem ścieżek plików.
Ustawienia Claude	Hierarchia plików ustawień, konfiguracja per-projekt i globalna, dostosowywanie zachowania narzędzi.
Skille Claude	Jak projektować skille: granulacja, kompozycja, kontekst, parametry. Zawiera wzorce buforowania, frontmatter, wdrażania.
Subagenty Claude	Jak delegować pracę do subagentów: hooki, narzędzia, modele, limity kontekstu. Zawiera wzorce orkiestracji, błędów, budżetu.

🛠️ IMPLEMENTACJA

Podstawowe

Przełączanie wersji Claude — jak przełączać się między wersjami Claude
Stos Claude + Prompt Caching — jak cachować instrukcje systemowe i CLAUDE.md
Konfiguracja linii statusu Claude — jak dostosować linię statusu Claude
Szablony CLAUDE.md — szablony dla różnych typów projektów
Ustawienia Claude dla teamów — jak konfigurować wspólne ustawienia zespołu
Przegląd kodu z Claude: implementacja agenta — jak zbudować agenta do przeglądu kodu

Zaawansowane

Analiza logów Claude — jak debugować i analizować logi sesji Claude
Workflow orkiestracji Claude — jak implementować złożone wieloagentowe przepływy pracy
Zarządzanie kontekstem Claude — strategie dla dużych repozytoriów i długich sesji
Benchmarki wydajności Claude — jak mierzyć i optymalizować wydajność Claude

💡 TIPY

🔧 KONFIGURACJA REPOZYTORIUM

`.claude/`

.claude/
├── agents/                    # Definicje subagentów
│   ├── weather-agent.md
│   └── ...
├── commands/                  # Komendy slash
│   ├── weather-orchestrator.md
│   └── ...
├── hooks/                     # Hooki cyklu życia
│   ├── scripts/
│   │   └── hooks.py
│   ├── config/
│   │   ├── hooks-config.json
│   │   └── hooks-config.local.json
│   └── sounds/
├── rules/                     # Reguły załadowane na ścieżce
│   └── presentation.md
├── skills/                    # Definicje skilli
│   ├── weather-fetcher/
│   │   └── SKILL.md
│   ├── weather-svg-creator/
│   │   └── SKILL.md
│   └── ...
├── CLAUDE.md                  # Instrukcje projektowe
├── settings.json              # Ustawienia zespołu
└── settings.local.json        # Ustawienia osobiste (git-ignored)

System powiadomień hookowych

Hooki w .claude/hooks/ pokazują międzyplatformowy system powiadomień dźwiękowych:

scripts/hooks.py — główny handler zdarzeń hooków
config/hooks-config.json — wspólna konfiguracja zespołu
config/hooks-config.local.json — nadpisania osobiste (git-ignored)
sounds/ — pliki audio zorganizowane według zdarzeń hookowych

Zdarzenia: PreToolUse, PostToolUse, UserPromptSubmit, Notification, Stop, SubagentStart, SubagentStop, PreCompact, SessionStart, SessionEnd, Setup, PermissionRequest, TeammateIdle, TaskCompleted, ConfigChange.

Specjalna obsługa: commity git uruchamiają dźwięk pretooluse-git-committing.

🗺️ MAPA DROGOWA

W realizacji

Planowane

🤝 WKŁAD

Wkład jest mile widziany! Zobacz CONTRIBUTING.md dla wytycznych.

Priorytety wkładu

Przepływy pracy deweloperskie — nowe workflow lub usprawnienia istniejących
Najlepsze praktyki — wzorce rozwiązywania rzeczywistych problemów
Implementacja — gotowe do użycia przykłady agentów, komend, hookow, skilli
Raporty — dogłębna analiza funkcji lub narzędzi Claude
Tipy — praktyczne porady dla codziennego użytkowania

Jak dodać workflow

Stwórz nowy katalog w development-workflows/[nazwa-workflow]/
Dodaj [nazwa-workflow]-workflow.md z dokumentacją
Dodaj znacznik implementacji: ![Implemented](!/tags/implemented.svg) lub ![TODO](!/tags/todo.svg)
Zaktualizuj tabelę w sekcji ⚙️ DEVELOPMENT WORKFLOWS w README
Zgłoś pull request

Jak dodać przewodnik najlepszych praktyk

Stwórz nowy plik w best-practice/[nazwa-tematu].md
Użyj struktury: Problem → Rozwiązanie → Przykład → Pułapki
Zaktualizuj tabelę w sekcji 📚 BEST PRACTICE w README
Zgłoś pull request

Jak dodać przewodnik implementacji

Stwórz nowy plik w implementation/[nazwa-funkcji].md
Dołącz: Przegląd → Implementacja → Testowanie → Wdrożenie
Zaktualizuj tabelę w sekcji 🛠️ IMPLEMENTATION w README
Zgłoś pull request

📝 LICENCJA

MIT

📧 KONTAKT

GitHub Issues: affaan-m/claude-code-best-practice
Dyskusje: affaan-m/claude-code-best-practice/discussions

🌟 PODZIĘKOWANIA

Claude i zespół Anthropic za Claude Code
@bcherny (Boris Cherny) za stworzenie Claude Code i ciągłe tipy
@trq212 (Thariq) z Anthropic za wnikliwe tipy i guidance
Społeczność open source za wkład w najlepsze praktyki

Zbudowane z ❤️ przez społeczność Claude Code

Name		Name	Last commit message	Last commit date
!		!
.claude		.claude
.codex		.codex
.github		.github
agent-teams		agent-teams
best-practice		best-practice
changelog		changelog
development-workflows		development-workflows
implementation		implementation
orchestration-workflow		orchestration-workflow
presentation		presentation
reports		reports
tips		tips
tutorial		tutorial
videos		videos
.gitignore		.gitignore
.mcp.json		.mcp.json
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md

Navigation Menu

Repository files navigation

claude-code-best-practice