1---2name: update-refs3description: Update naming and documentation references across the Claude CodePro codebase. Use when renaming features, updating descriptions, changing terminology, or ensuring consistency after modifying commands, skills, or workflows. Triggers on "update references", "rename X to Y across codebase", "sync documentation", or "update all mentions of X".4---5
6# Update References
7
8Ensure naming and documentation consistency across all codebase locations.
9
10## Checklist
11
12When updating terminology, feature names, or descriptions, check ALL locations:
13
14### 1. User-Facing Messages
15
16| Location | What to Check |
17|----------|---------------|
18| `ccp/banner.py` | Welcome banner text, feature descriptions |
19| `ccp/cli.py` | CCP CLI help text and messages |
20| `installer/cli.py` | Installer CLI help text, prompts |
21| `installer/steps/finalize.py` | Post-install instructions |
22| `installer/ui.py` | UI banner and status messages |
23
24### 2. Documentation & Site
25
26| Location | What to Check |
27|----------|---------------|
28| `README.md` | Feature descriptions, usage examples, quick start |
29| `docs/site/index.html` | SEO meta tags, page title, descriptions |
30| `docs/site/src/components/*.tsx` | Marketing site content (WhatsInside, etc.) |
31
32### 3. Package & Install
33
34| Location | What to Check |
35|----------|---------------|
36| `pyproject.toml` | Package name, description, metadata |
37| `install.sh` | Shell installer script messages |
38| `ccp/__init__.py` | Package docstring |
39
40### 4. Claude Configuration
41
42| Location | What to Check |
43|----------|---------------|
44| `.claude/commands/*.md` | Command descriptions in frontmatter |
45| `.claude/skills/*/SKILL.md` | Skill descriptions in frontmatter |
46| `.claude/rules/standard/*.md` | Rule references to features |
47| `.claude/rules/custom/*.md` | Project-specific rule content |
48| `.claude/hooks/*.py` | Hook script messages |
49
50### 5. Bundled Installer Copy
51
52| Location | What to Check |
53|----------|---------------|
54| `.claude/installer/installer/*.py` | Bundled installer copy (mirrors installer/) |
55
56## Workflow
57
581. **Search first** - Use grep to find all occurrences:
59 ```bash
60 grep -r "old term" --include="*.md" --include="*.py" --include="*.tsx" .
61 ```
62
632. **Update systematically** - Work through checklist above
64
653. **Verify consistency** - Search again to confirm no misses:
66 ```bash
67 grep -r "old term" . | grep -v node_modules | grep -v .git
68 ```
69
70## Common Updates
71
72| Change Type | Key Locations |
73|-------------|---------------|
74| Command rename | commands/*.md, README.md, banner.py, rules/*.md |
75| Skill rename | skills/*/SKILL.md, README.md, WhatsInside.tsx |
76| Feature description | banner.py, README.md, site components, index.html |
77| Workflow change | commands/*.md, rules/*.md, README.md |
78| Package rename | pyproject.toml, install.sh, ccp/__init__.py, README.md |
79| Installer message | installer/*.py, .claude/installer/installer/*.py |