0000_start_here_index_and_recommended_reading_order
Shared from "codex" on Inkdown
Read This First: Index And Recommended Reading Order
This package documents the full traversed codebase under /Users/shubhojeetbera/Downloads/src.
Scope:
- Files traversed: 1902
- Total lines: 514587
- Unreadable files: 0
Recommended reading order:
0100_project_overview_tech_stack_runtime_modes_and_folder_map.md - What the product is, who uses it, runtime modes, and the top-level folder map.0200_startup_flow_entry_points_and_cold_start_sequence.md - Cold-start and startup sequencing from process boot to the first usable session.
0100_project_overview_tech_stack_runtime_modes_and_folder_map.md
0300_codebase_modules_layers_state_models_and_schemas.md - Module boundaries, state, schemas, tool contracts, and dependency hotspots.0400_system_architecture_and_design_rationale.md - The architectural shape of the system and why it is designed this way.0500_interactive_repl_request_flow_end_to_end.md - Interactive REPL request flow from prompt input to tool execution and UI update.0600_headless_sdk_and_print_mode_request_flow_end_to_end.md - Headless and SDK flow from input to structured streamed output.0700_mcp_integration_connection_and_tool_call_flow.md - MCP config, connection lifecycle, tool exposure, auth, and result handling.0800_external_services_sdks_storage_and_local_dependencies.md - External services, SDKs, local execution dependencies, storage, and queue-like behavior.0900_environment_variables_settings_feature_flags_and_failure_modes.md - Environment variables, config layers, feature flags, and failure modes.1000_non_obvious_patterns_gotchas_and_debugging_traps.md - Non-obvious decisions and traps that waste time if you do not know them.1100_full_codebase_file_inventory_grouped_by_directory.md - Complete file-by-file inventory grouped by directory.