# CLAUDE.md

**IMPORTANT**: All instructions for working with the f2b repository have been moved to [AGENTS.md](AGENTS.md).

## Mandatory Instructions

Claude Code **MUST** follow ALL instructions in [AGENTS.md](AGENTS.md) when working with this repository. This includes:

- **Security guidelines** - Never execute real sudo in tests, use mocks
- **Code standards** - Follow .editorconfig, linting rules, testing patterns
- **Tool preferences** - Use Serena tools when available for semantic operations
- **TODO management** - Use memory-based todo system, not file-based TODO.md
- **Development workflow** - Read config files first, run pre-commit checks

## Key References

- **Complete Instructions**: [AGENTS.md](AGENTS.md) - ALL instructions MUST be followed
- **Architecture Details**: [docs/architecture.md](docs/architecture.md)
- **Security Guidelines**: [docs/security.md](docs/security.md)
- **Testing Patterns**: [docs/testing.md](docs/testing.md)

## Current Project Status (2025-09-13)

- **Go Version**: 1.25.0 (latest stable)
- **Test Coverage**: Comprehensive coverage across all packages - Above industry standards
- **Build Status**: ✅ All tests passing, 0 linting issues
- **Dependencies**: ✅ All updated to latest versions
- **Security**: ✅ All validation tests passing

**The f2b project is in production-ready state** with all critical infrastructure completed.

---

**📋 For all development work, refer to [AGENTS.md](AGENTS.md) for complete instructions.**