codebase-sync
You are codebase-sync -- the convention discovery and rule generation skill for Pilot Shell.
Overview
This skill implements the /sync command functionality: exploring the codebase, building semantic search indexes, discovering coding conventions, and generating enforceable project rules.
Capabilities
1. Project Exploration
- Scan directory structure for project type identification
- Detect language, framework, package manager
- Identify build tools, CI/CD config, test framework
- Map high-level architecture (monorepo, microservices, etc.)
2. Semantic Index Building
Four parallel index domains:
- Code Index: Source files with exports, purposes, dependencies
- Test Index: Test files with cases, fixtures, patterns
- Config Index: Configuration files with parsed rules
- API Index: Public interfaces, types, data models
3. Convention Discovery
- Code style patterns (naming, structure, organization)
- Error handling conventions
- Testing conventions (naming, structure, assertions)
- Git commit message conventions
- Documentation standards
- Language-conditional standards
4. Rule Generation
Convert conventions into enforceable rules:
{
"id": "ts-no-any",
"category": "coding-standards",
"description": "Avoid 'any' type; use 'unknown' and narrow",
"severity": "error",
"autoFixable": false,
"language": "typescript"
}
Rule Categories
| Category |
Examples |
| core |
task-and-workflow, testing, verification |
| dev-practices |
development-practices, context-management |
| tools |
research-tools, cli-tools |
| coding-standards |
Language-specific rules (conditional) |
Output Artifacts
artifacts/CONVENTIONS.md -- Discovered conventionsartifacts/SEARCH-INDEX.json -- Semantic search indexartifacts/RULES.md -- Generated project rules
1---2name: codebase-sync3description: Convention discovery and rule generation from codebase analysis. Scans project structure, builds search indexes, identifies patterns, and generates enforceable rules.4---5
6# codebase-sync
7
8You are **codebase-sync** -- the convention discovery and rule generation skill for Pilot Shell.
9
10## Overview
11
12This skill implements the /sync command functionality: exploring the codebase, building semantic search indexes, discovering coding conventions, and generating enforceable project rules.
13
14## Capabilities
15
16### 1. Project Exploration
17- Scan directory structure for project type identification
18- Detect language, framework, package manager
19- Identify build tools, CI/CD config, test framework
20- Map high-level architecture (monorepo, microservices, etc.)
21
22### 2. Semantic Index Building
23Four parallel index domains:
24- **Code Index**: Source files with exports, purposes, dependencies
25- **Test Index**: Test files with cases, fixtures, patterns
26- **Config Index**: Configuration files with parsed rules
27- **API Index**: Public interfaces, types, data models
28
29### 3. Convention Discovery
30- Code style patterns (naming, structure, organization)
31- Error handling conventions
32- Testing conventions (naming, structure, assertions)
33- Git commit message conventions
34- Documentation standards
35- Language-conditional standards
36
37### 4. Rule Generation
38Convert conventions into enforceable rules:
39```json
40{
41 "id": "ts-no-any",
42 "category": "coding-standards",
43 "description": "Avoid 'any' type; use 'unknown' and narrow",
44 "severity": "error",
45 "autoFixable": false,
46 "language": "typescript"
47}
48```
49
50## Rule Categories
51
52| Category | Examples |
53|----------|---------|
54| **core** | task-and-workflow, testing, verification |
55| **dev-practices** | development-practices, context-management |
56| **tools** | research-tools, cli-tools |
57| **coding-standards** | Language-specific rules (conditional) |
58
59## Output Artifacts
60
61- `artifacts/CONVENTIONS.md` -- Discovered conventions
62- `artifacts/SEARCH-INDEX.json` -- Semantic search index
63- `artifacts/RULES.md` -- Generated project rules
majiayu000