/codebase-sync

name: codebase-sync
description: Convention discovery and rule generation from codebase analysis. Scans project structure, builds search indexes, identifies patterns, and generates enforceable rules.
allowed-tools: Bash(*) Read Write Edit Glob Grep
metadata:
  author: babysitter-sdk
  version: "1.0.0"
  category: pilot-shell-sync
  attribution: "Adapted from Pilot Shell by Max Ritter (https://github.com/maxritter/pilot-shell)"
graph:
  domains: [domain:software-engineering]
  skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]
  workflows: [workflow:feature-development]
  topics: [topic:developer-experience]
  roles: [role:tech-lead, role:backend-engineer]

• 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 conventions
• `artifacts/SEARCH-INDEX.json` -- Semantic search index
• `artifacts/RULES.md` -- Generated project rules