codeflash-ai/codeflash
1
0
Fork 0
Code Issues 18 Pull requests 33 Projects Releases Packages Wiki Activity Actions 4.9k
codeflash/tiles/codeflash-rules/rules/architecture.md
Kevin Turcios 6718e66582 feat: add private tessl tiles for codeflash rules, docs, and skills 
Three private tiles in the codeflash workspace:
- codeflash-rules: 6 steering rules (code-style, architecture, optimization-patterns, git-conventions, testing-rules, language-rules)
- codeflash-docs: 7 doc pages (domain-types, optimization-pipeline, context-extraction, verification, ai-service, configuration)
- codeflash-skills: 2 skills (debug-optimization-failure, add-codeflash-feature)
2026-02-14 20:55:06 -05:00

2.5 KiB
Raw Blame History

Architecture

codeflash/
├── main.py                 # CLI entry point
├── cli_cmds/               # Command handling, console output (Rich)
├── discovery/              # Find optimizable functions
├── context/                # Extract code dependencies and imports
├── optimization/           # Generate optimized code via AI
│   ├── optimizer.py        # Main optimization orchestration
│   └── function_optimizer.py  # Per-function optimization logic
├── verification/           # Run deterministic tests (pytest plugin)
├── benchmarking/           # Performance measurement
├── github/                 # PR creation
├── api/                    # AI service communication
├── code_utils/             # Code parsing, git utilities
├── models/                 # Pydantic models and types
├── languages/              # Multi-language support (Python, JavaScript/TypeScript)
├── setup/                  # Config schema, auto-detection, first-run experience
├── picklepatch/            # Serialization/deserialization utilities
├── tracing/                # Function call tracing
├── tracer.py               # Root-level tracer entry point for profiling
├── lsp/                    # IDE integration (Language Server Protocol)
├── telemetry/              # Sentry, PostHog
├── either.py               # Functional Result type for error handling
├── result/                 # Result types and handling
└── version.py              # Version information

Key Entry Points

Task Start here
CLI arguments & commands cli_cmds/cli.py
Optimization orchestration optimization/optimizer.py → Optimizer.run()
Per-function optimization optimization/function_optimizer.py → FunctionOptimizer
Function discovery discovery/functions_to_optimize.py
Context extraction context/code_context_extractor.py
Test execution verification/test_runner.py, verification/pytest_plugin.py
Performance ranking benchmarking/function_ranker.py
Domain types models/models.py, models/function_types.py
Result handling either.py (Result, Success, Failure, is_successful)
AI service communication api/aiservice.py → AiServiceClient
Configuration constants code_utils/config_consts.py
Language support languages/registry.py → get_language_support()