# CleverAgents Core Documentation

CleverAgents is a standalone Python automation platform. This documentation covers developer workflows, CLI usage, and architecture decisions.

## Current Deliverables

- `src/cleveragents` package providing the `cleveragents` and `agents` CLI entry points
- Updated benchmarks targeting CLI startup behavior
- Behave scenarios verifying help and version metadata
- Robot placeholder suites ready for integration parity tests
- Nox sessions orchestrating linting, typing, testing, docs, builds, and benchmarks

## Getting Started

```bash
python -m venv .venv
source .venv/bin/activate
pip install -e .[tests,docs]
nox -s unit_tests
nox -s integration_tests
```

## Contributor Notes

- Document discoveries and open questions directly in `implementation_plan.md` under the appropriate phase.

## Next Steps

- Follow the Implementation Checklist in `implementation_plan.md` for current priorities.

For detailed progress, follow the living checklist in `implementation_plan.md`.