Współpraca zespołowa: Wskazówki 86-95

Skalowanie użycia Claude Code od indywidualnej produktywności do zespołowej doskonałości wymaga przemyślanej koordynacji i wspólnych praktyk. Te wskazówki pomogą ci ustanowić efektywne przepływy pracy zespołowe, utrzymać spójność między programistami i zmaksymalizować zbiorowe korzyści z rozwoju wspomaganego AI.

Współdzielona infrastruktura i standardy

Wskazówka 86: Udostępniaj pliki CLAUDE.md zespołowi

Stwórz wspólną bazę wiedzy, która przynosi korzyści wszystkim:

Struktura do użycia zespołowego

project/
├── CLAUDE.md                    # Standardy zespołowe
├── CLAUDE.local.md             # Osobiste preferencje (git-ignored)
├── docs/
│   └── claude/
│       ├── onboarding.md       # Przewodnik nowego członka
│       ├── patterns.md         # Wspólne wzorce
│       └── troubleshooting.md  # Znane problemy

Integracja kontroli wersji

# Dodaj pliki zespołowe do git
git add CLAUDE.md
git add .claude/commands/
git add .claude/settings.json
git add .mcp.json

# Ignoruj pliki osobiste
echo "CLAUDE.local.md" >> .gitignore
echo ".claude/personal/" >> .gitignore

Regularne aktualizacje

# Prompt retrospektywy zespołowej
"Przejrzyj nasz CLAUDE.md i zasugeruj ulepszenia
 oparte na najnowszych wzorcach rozwoju"

Najlepsze praktyki zespołowego CLAUDE.md

Dokumentuj uzgodnione wzorce
Uwzględniaj decyzje architektoniczne
Określ obszary skupienia przeglądu kodu
Wylistuj wspólne komendy i przepływy pracy
Aktualizuj na podstawie retrospektyw

Przykład sekcji zespołowego CLAUDE.md:

Standardy kodu
Architektura

# Standardy kodowania zespołu

## TypeScript
- ZAWSZE używaj trybu strict
- PREFERUJ interfejsy nad typami dla obiektów
- WYMAGAJ jawnych typów zwracanych
- UŻYWAJ branded types dla ID

## Testowanie
- MINIMUM 80% pokrycia dla nowego kodu
- ZAWSZE testuj ścieżki błędów
- UŻYWAJ data-testid dla testów E2E
- MOCKUJ usługi zewnętrzne

# Decyzje architektoniczne

## Projektowanie API
- REST nad GraphQL (zdecydowano 2024-03)
- Wersjonowanie via ścieżka URL (/v1/, /v2/)
- Standardowy format błędów (RFC 7807)
- Rate limiting na wszystkich endpointach

## Baza danych
- PostgreSQL dla głównych danych
- Redis tylko do cache'owania
- Brak bezpośredniego SQL, używaj Prisma
- Soft deletes dla ścieżki audytu

Wskazówka 87: Twórz niestandardowe komendy dla całego zespołu

Standardyzuj wspólne przepływy pracy za pomocą współdzielonych komend:

Rozpocznij nową funkcję podążając za procesem zespołowym:

Funkcja: $ARGUMENTS

1. Stwórz gałąź z najnowszego main
2. Zaktualizuj tablicę projektu
3. Stwórz feature flag (jeśli potrzeba)
4. Skonfiguruj monitoring
5. Stwórz początkowe testy
6. Szkicuj opis PR

Podążaj za naszą listą kontrolną rozwoju funkcji.

Więcej przykładów komend zespołowych:

# .claude/commands/hotfix.md
# .claude/commands/release.md
# .claude/commands/incident-response.md
# .claude/commands/performance-check.md

Wskazówka 88: Ustanów polityki uprawnień zespołu

Stwórz spójne praktyki bezpieczeństwa:

{
  "allowedTools": [
    "Edit",
    "View",
    "Create",
    "Delete",
    "Bash(*)",
    "mcp__*"
  ],
  "autoAllow": [
    "git status",
    "git diff",
    "npm test"
  ]
}

{
  "allowedTools": [
    "View",
    "Bash(git:*)",
    "Bash(npm:test)",
    "mcp__github__*"
  ],
  "requireApproval": [
    "database migrations",
    "deployment commands"
  ]
}

{
  "allowedTools": [
    "View"
  ],
  "blocked": [
    "all write operations",
    "all execute operations"
  ]
}

Dokumentuj uzasadnienie uprawnień:

# Wytyczne uprawnień

## Środowisko deweloperskie
- Pełne uprawnienia do szybkiego rozwoju
- Auto-zezwalaj na bezpieczne operacje odczytu
- Ręczne zatwierdzenie dla operacji destrukcyjnych

## Środowisko stagingowe
- Ograniczone do testowania i debugowania
- Brak bezpośrednich modyfikacji bazy danych
- Wdrożenie wymaga zatwierdzenia

## Środowisko produkcyjne
- Dostęp tylko do odczytu
- Wszystkie zmiany przez CI/CD
- Dostęp awaryjny wymaga dwóch zatwier

Wskazówka 89: Dokumentuj standardy kodowania zespołu

Używaj CLAUDE.md do wymuszania spójności:

# Standardy kodowania zespołu

## Konwencje nazewnictwa
- Komponenty: PascalCase (UserProfile, LoginForm)
- Narzędzia: camelCase (formatDate, validateEmail)
- Stałe: UPPER_SNAKE_CASE (MAX_RETRIES)
- Pliki: kebab-case (user-service.ts)

## Organizacja kodu
\`\`\`
src/
├── components/     # Komponenty UI
├── services/       # Logika biznesowa
├── utils/          # Współdzielone narzędzia
├── types/          # Typy TypeScript
└── constants/      # Stałe aplikacji
\`\`\`

## Obsługa błędów
\`\`\`typescript
// ZAWSZE używaj niestandardowych klas błędów
class ValidationError extends AppError {
  constructor(field: string, message: string) {
    super(`Walidacja nie powiodła się dla ${field}: ${message}`);
  }
}

// ZAWSZE obsługuj błędy jawnie
try {
  await riskyOperation();
} catch (error) {
  logger.error('Operacja nie powiodła się', { error, context });
  throw new OperationError('Przyjazna użytkownikowi wiadomość');
}
\`\`\`

## Standardy testowe
- Nazewnictwo plików testowych: *.test.ts lub *.spec.ts
- Bloki opisujące dla klasy/modułu
- Bloki It dla konkretnych zachowań
- Wzorzec AAA: Arrange, Act, Assert

Wskazówka 90: Udostępniaj konfiguracje MCP

Standardyzuj dostęp do narzędzi w zespole:

// .mcp.json (commitowane do git)
{
  "servers": {
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "jira": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-jira"],
      "env": {
        "JIRA_HOST": "company.atlassian.net",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_TOKEN": "${JIRA_TOKEN}"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_TOKEN": "${SLACK_TOKEN}"
      }
    }
  }
}

Korzyści zespołowego MCP

Spójna dostępność narzędzi
Współdzielone możliwości automatyzacji
Standardowe integracje
Zmniejszony czas konfiguracji
Zespołowe zyski produktywności

Przepływy pracy i procesy zespołowe

Wskazówka 91: Stwórz dokumentację wdrożeniową

Pomóż nowym członkom zespołu szybko stać się produktywnymi:

# Przewodnik wdrożenia Claude Code

## Początkowa konfiguracja (30 minut)
1. Zainstaluj Claude Code: `npm install -g @anthropic-ai/claude-code`
2. Skonfiguruj uwierzytelnianie: `claude auth login`
3. Sklonuj repozytorium zespołu
4. Uruchom skrypt konfiguracji: `./scripts/claude-setup.sh`

## Zadania pierwszego dnia
1. Przeczytaj plik CLAUDE.md zespołu
2. Wypróbuj przykładowe komendy:
   - `/feature-start my-first-feature`
   - `/team-standards`
3. Sparuj z członkiem zespołu na prawdziwym zadaniu
4. Dołącz do kanału #claude-code Slack

## Najlepsze praktyki
- Zawsze używaj `--dangerously-skip-permissions` dla efektywności
- Czyść kontekst między niepowiązanymi zadaniami
- Sprawdzaj `/cost` codziennie, aby zrozumieć użycie
- Używaj komend zespołowych z `.claude/commands/`

## Częste problemy
- Monity o uprawnienia: Używaj flagi skip
- MCP nie działa: Sprawdź zmienne środowiskowe
- Wysokie koszty: Używaj Sonnet do rutynowych zadań

## Zasoby
- Baza wiedzy zespołu: /docs/claude/
- Tutoriale wideo: /onboarding/claude-code/
- Kanał Slack: #claude-code

Wskazówka 92: Ustanów przepływy pracy przeglądu kodu

Zintegruj Claude Code z procesem przeglądu:

Automatyczne przeglądy
Ręczne przeglądy

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropic/claude-code-review@v1
        with:
          focus: |
            - Luki bezpieczeństwa
            - Błędy logiczne
            - Problemy wydajności
            - Brakujące testy
          ignore: |
            - Problemy stylu
            - Nazewnictwo zmiennych
            - Dokumentacja

# Komenda przeglądu zespołowego
Przejrzyj PR pod adresem $ARGUMENTS skupiając się na:

1. Poprawności logiki biznesowej
2. Lukach bezpieczeństwa
3. Implikacjach wydajności
4. Pokryciu testami
5. Obsłudze błędów

Ignoruj problemy stylu - te są obsługiwane przez linting.
Bądź konkretny co do problemów i sugeruj poprawki.

Spostrzeżenia z przeglądów od zespołów:

“Claude Code wychwytuje błędy, które przegapiamy. Ludzie wychwytują problemy projektowe, które Claude przegapia. Razem są niezwyciężeni.” - Zespół bezpieczeństwa Anthropic

Wskazówka 93: Dziel się naukami i najlepszymi praktykami

Stwórz kulturę ciągłego doskonalenia:

Cotygodniowe sesje wskazówek

# Cotygodniowe wskazówki Claude Code
- 15-minutowy standup zespołowy
- Jedna osoba dzieli się odkrytą techniką
- Dokumentuj w bazie wiedzy zespołu
- Wypróbuj technikę razem

Pokaz przepływu pracy

# Eksportuj rozmowę do dzielenia
/export > session.md
# Podziel się z zespołem do nauki

Przeglądy optymalizacji kosztów

# Miesięczny przegląd kosztów
"Przeanalizuj użycie Claude Code naszego zespołu i zasugeruj
 strategie optymalizacji"

Wydobywanie wzorców

# Kwartalny przegląd wzorców
"Przejrzyj naszą bazę kodu i zidentyfikuj wzorce, które
 powinniśmy dodać do CLAUDE.md"

Wskazówka 94: Koordynuj duże wysiłki refaktoryzacyjne

Używaj wielu członków zespołu z Claude Code do dużych projektów:

# Plan migracji mikrousług

## Przydzielenie zespołu
- Alicja: Serwis użytkowników (Terminal 1)
- Bob: Serwis zamówień (Terminal 2)
- Karol: Serwis płatności (Terminal 3)
- Danuta: Testy integracyjne (Terminal 4)

## Koordynacja
1. Poranne synchronizowanie przydziału serwisów
2. Współdzielone definicje interfejsów w .claude/shared/
3. Godzinne sprawdzenia na Slack
4. Końcowy test integracyjny

## Konfiguracja Claude Code
\`\`\`bash
# Każdy programista
claude --add-dir ./services/[assigned-service]
\`\`\`

## Współdzielone zasoby
- Kontrakty API: .claude/shared/api/
- Narzędzia testowe: .claude/shared/testing/
- Przewodnik migracji: .claude/shared/migration.md

Narzędzia koordynacji

Współdzielony system plików dla kontraktów
Integracja Slack dla aktualizacji
Gałęzie Git dla izolacji
Regularne spotkania synchronizacyjne
Automatyczne testy integracyjne

Wskazówka 95: Twórz komendy slash specyficzne dla zespołu

Opracuj komendy dopasowane do przepływu pracy twojego zespołu:

Wygeneruj raport standup:

Co robiłem wczoraj:
- Sprawdź commity git z ostatnich 24 godzin
- Podsumuj ukończoną pracę

Co robię dzisiaj:
- Sprawdź aktualną gałąź
- Wylistuj zaplanowane zadania

Blokery:
- Sprawdź nieudane testy
- Zanotuj jakikolwiek dług techniczny

Więcej komend zespołowych:

# Planowanie sprintu
.claude/commands/team/sprint-plan.md

# Reakcja na incydenty
.claude/commands/team/incident.md

# Notatki wydania
.claude/commands/team/release-notes.md

# Śledzenie długu technicznego
.claude/commands/team/tech-debt.md

Budowanie kultury Claude Code

Udana adoptacja zespołowa wymaga więcej niż tylko konfiguracji technicznej:

Przywództwo i rzecznictwo

Zidentyfikuj championów Claude Code
Dziel się historiami sukcesu
Świętuj zwycięstwa produktywności
Otwarte adresowanie obaw

Szkolenia i wsparcie

Regularne warsztaty
Sesje programowania w parach
Dokumentacja wewnętrzna
Kanał wsparcia Slack

Metryki i ulepszenia

Śledź metryki produktywności
Monitoruj koszt na programistę
Mierz ulepszenia jakości kodu
Regularne retrospektywy

Wspólne wzorce adoptacji

Tydzień 1: Indywidualna eksploracja
Tydzień 2: Dzielenie się odkryciami
Tydzień 3: Standardyzacja przepływów pracy
Tydzień 4: Pełna adoptacja zespołowa

Skupienie: Szybkie eksperymentowanie

Miesiąc 1: Pilot z wczesnymi adoptorami
Miesiąc 2: Opracowanie standardów zespołowych
Miesiąc 3: Stopniowe wdrażanie
Miesiąc 4: Pełna adoptacja

Skupienie: Standardyzacja

Kwartał 1: Zespoły pilotażowe
Kwartał 2: Wdrożenie departamentowe
Kwartał 3: Ogólnoorganizacyjne
Kwartał 4: Optymalizacja

Skupienie: Zarządzanie i skala

Metryki sukcesu zespołu

Śledź te wskaźniki udanej adoptacji zespołowej:

Wzrost prędkości: Typowo 2-4x
Jakość kodu: Mniej błędów w produkcji
Pokrycie testami: Wyższe i bardziej kompleksowe
Dokumentacja: Zawsze aktualna
Czas wdrożenia: 50% redukcji
Satysfakcja programistów: Zwiększone zaangażowanie

Następne kroki

Po opanowaniu współpracy zespołowej, jesteś gotowy na ostatni zestaw wskazówek. Przejdź do Rozwiązywanie problemów i najlepsze praktyki po częste problemy i sprawdzone wzorce długoterminowego sukcesu.