Update References
Ensure naming and documentation consistency across all codebase locations.
Checklist
When updating terminology, feature names, descriptions, or counts, check ALL locations:
- User-Facing Messages
Location What to Check
launcher/banner.py
Welcome banner text, feature descriptions
launcher/cli.py
Pilot CLI help text and messages
installer/cli.py
Installer CLI help text, prompts
installer/steps/finalize.py
Post-install instructions
installer/ui.py
UI banner and status messages
- Documentation & Website
Location What to Check
README.md
Feature descriptions, usage examples, counts (rules, hooks, skills, commands)
docs/site/index.html
SEO meta tags, page title, structured data
docs/site/src/pages/Index.tsx
SEO description, structured data counts
docs/site/src/components/HeroSection.tsx
Stats bar counts (rules, hooks, skills, LSPs, MCP)
docs/site/src/components/WhatsInside.tsx
Feature cards, descriptions, item counts
docs/site/src/components/DeepDiveSection.tsx
Under the Hood subtitle counts, hooks pipeline, rules categories
docs/site/src/components/WorkflowSteps.tsx
/spec workflow details, All Commands grid
docs/site/src/components/ComparisonSection.tsx
Before & After comparison table
docs/site/src/components/PricingSection.tsx
Standard plan feature counts, value proposition
docs/site/src/components/InstallSection.tsx
Installation instructions
docs/site/src/components/Footer.tsx
Footer links
docs/site/src/components/NavBar.tsx
Navigation links
- Package & Install
Location What to Check
pyproject.toml
Package name, description, metadata
install.sh
Shell installer script messages
launcher/init.py
Package docstring
- Claude Configuration (Plugin Source)
Location What to Check
pilot/commands/*.md
Command descriptions in frontmatter (spec , sync , vault , learn , plus internal phases)
pilot/skills/*/SKILL.md
Skill descriptions in frontmatter
pilot/rules/*.md
Standard rules content
pilot/hooks/hooks.json
Hook configuration and event triggers
pilot/hooks/*.py
Hook script messages and logic
pilot/agents/*.md
Sub-agent definitions (plan-verifier, spec-verifier)
pilot/settings.json
LSP server configuration
pilot/modes/*.json
Language mode definitions
- Project-Level Claude Config
Location What to Check
.claude/rules/*.md
Project-specific rules (git-commits.md, project.md)
.claude/skills/*/SKILL.md
Project-specific skills (lsp-cleaner, pr-review, update-refs)
No Hardcoded Counts
Do NOT add specific counts (e.g., "22 rules", "7 hooks", "14 skills") to user-facing text.
The project deliberately avoids quantity-focused messaging. Use qualitative descriptions instead:
❌ Don't ✅ Do
"22 rules loaded every session" "Production-tested rules loaded every session"
"7 hooks auto-lint on every edit" "Hooks auto-lint, format, type-check on every edit"
"14 coding skills" "Coding skills activated dynamically"
"5 MCP servers + 3 LSP servers" "MCP servers + language servers pre-configured"
"2,900+ lines of best practices" "Production-tested best practices"
Why: Quality over quantity. Counts become stale and create maintenance burden across many files. The value is in what the system does, not how many components it has.
Workflow
Search first - Use Grep to find all occurrences:
Grep pattern="old term" glob="*.{md,py,tsx,json,ts}"
Update systematically - Work through checklist above, section by section
Verify consistency - Search again to confirm no misses:
Grep pattern="old term" glob="*.{md,py,tsx,json,ts}"
Build website - Verify site compiles after changes:
cd docs/site && npm run build
Common Updates
Change Type Key Locations
Command rename/add pilot/commands/*.md, README.md, WorkflowSteps.tsx, WhatsInside.tsx, counts table
Skill rename pilot/skills/*/SKILL.md, README.md, WhatsInside.tsx, DeepDiveSection.tsx
Rule add/remove pilot/rules/*.md, README.md, all count locations (see table above)
Hook change pilot/hooks/hooks.json, pilot/hooks/*.py, DeepDiveSection.tsx, README.md
Feature description launcher/banner.py, README.md, site components, Index.tsx structured data
Workflow change pilot/commands/.md, pilot/rules/.md, README.md, WorkflowSteps.tsx
Package rename pyproject.toml, install.sh, launcher/init.py, README.md
Installer message installer/.py, installer/steps/.py
Terminology change Search all locations in checklist above — grep for old term, replace everywhere