# Project Instructions

## Overview

This is a small Python project named `itti-adb`. 

This project is a workshop for Oracle Autonomous Database 26ai and its features workshop.

Source files are labs using Python and SQL scripts.

## Environment

- Python version: 3.12 or newer
- Project metadata: `pyproject.toml`

## Common Commands

Run the application:

use `uv` and not `pip` for installing packages

- When running PowerShell commands, prefer `-NoProfile` or `login:false` to avoid loading the user profile. The profile enables `PSReadLine` predictive options that can print `Identificador inválido.` in redirected/non-interactive Codex sessions.

## Development Notes

- Keep changes scoped and consistent with the existing simple project layout.
- Prefer adding tests when behavior grows beyond the current minimal entry point.
- Do not introduce new dependencies unless they are needed for the requested feature.
- Update `README.md` when adding user-facing behavior or setup steps.
- Code comments only in spanish.
- Always include comments because source files are for lab/workshop, in order to teach how features/functions work.
- Don`t be too long in the comments, be concise.