# Documentation

This directory contains reference documentation and guides for AI-assisted development workflows.

## Available Documents

| Document | Description |
|----------|-------------|
| [DEVELOPMENT_WORKFLOW.md](DEVELOPMENT_WORKFLOW.md) | Local tooling requirements, git editor safety, pre-commit checklist, IDE configuration |
| [python_style_pep8_pep257.md](python_style_pep8_pep257.md) | Python style guide (PEP 8) and docstring conventions (PEP 257) |
| [uv.md](uv.md) | UV package manager quick reference and migration guide |

## Quick Links

### Development Workflow
- [Use Local Tooling](DEVELOPMENT_WORKFLOW.md#1-always-use-local-tooling) - Never use system-wide tools
- [Prevent Interactive Git Editors](DEVELOPMENT_WORKFLOW.md#2-always-prevent-interactive-git-editors) - Critical for AI workflows
- [Pre-Commit Checklist](DEVELOPMENT_WORKFLOW.md#3-always-test-and-lint-before-commitpush) - Test and lint requirements

### Python Style
- [PEP 8 Key Rules](python_style_pep8_pep257.md#key-rules-operational-cheat-sheet) - Indentation, naming, imports
- [PEP 257 Docstrings](python_style_pep8_pep257.md#pep-257-docstring-conventions) - Documentation standards
- [Quick Reference Table](python_style_pep8_pep257.md#quick-reference-summary-table) - At-a-glance rules

### UV Package Manager
- [Quick Start](uv.md#quick-start-macoszsh) - Install and create venv
- [Common Commands](uv.md#common-commands) - Daily workflow commands
- [Migration from pip/venv](uv.md#migration-from-pipvenv) - Transition guide

## Related Resources

- [Agent Skills](../.github/skills/) - On-demand specialized capabilities
- [Immediate Directives](../.github/rules/) - Mid-execution agent control
- [Copilot Instructions](../.github/copilot.instructions.md) - Universal guidelines