# Team Init

> Use when bootstrapping team knowledge from a brownfield codebase — reverse-engineers CDRs for contribution to team-ai-directives adlc branch.

- Skill: `tikalk/team-init` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add tikalk/team-init`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tikalk/team-init/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tikalk (https://skillmd.com/u/tikalk)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/tikalk/team-init

---


# team-init

## What this skill does

Reverse-engineer **Context Directive Records (CDRs)** from an **existing
codebase** (brownfield) to document reusable patterns for contribution to
`team-ai-directives`.

Replaces the former `team-init` skill. Drafts are written to the `adlc`
orphan branch of `team-ai-directives` (not project-local `.adlc/drafts/`).

## When to use

- **Brownfield projects**: Existing code without team-wide directives
- **Legacy modernization**: Extract reusable patterns before refactoring
- **Team onboarding**: Turn implicit conventions into explicit directives

### When NOT to use

- **Greenfield (session complete)**: Use `/team-levelup` to extract from session
- **Mining git history**: Use `/change-init` for past decisions

## Process

### Phase 0: Environment Setup

Run: `scripts/bash/team-init.sh --setup`

Resolves `REPO_ROOT`, `TEAM_AI_DIRECTIVES`, `NEXT_CDR`, `ADLC_BRANCH`.

### Phase 1: Sub-System Detection

Analyze codebase for distinct sub-systems (same detection as former team-init):
- `src/auth/` → Authentication
- `services/payment/` → Payment
- etc.

### Phase 2: Load Team Directives

Read existing `team-ai-directives` main branch for comparison (avoid duplicates).

### Phase 3: Multi-Agent Analysis

1. **Discovery Agent**: Scan each sub-system for raw patterns
2. **Pattern Agent**: Classify and score patterns for reusability
3. **Synthesis Agent**: Cross-sub-system analysis and CDR generation

### Phase 4: Write CDRs

Write to `adlc` branch `drafts/cdr/` using the shared CDR draft template at `skills/team/templates/cdr-draft-template.md`.

### Phase 5: Handoff

Suggest running `/team-levelup` to review and publish the discovered CDRs.

## Verification

- [ ] CDRs written to `adlc` branch `drafts/cdr/`
- [ ] No CDRs in `.adlc/drafts/` (old location)
- [ ] `cdr.md` index regenerated in `adlc` branch

