# portfolio-optimiser-claude

> Claude Agent SDK sibling implementation of the portfolio-optimiser method: an open Python
> framework that finds cost savings *inside* each project in a portfolio. Agents propose
> measures, a mandatory deterministic validator gates every number before it leaves the
> system, domain experts judge via human-in-the-loop, and the loop learns from the verdicts.
> A technical framework only — the deployer owns DPIA, risk assessment, and legal basis.

Not published to a package index. This is the way in — from a clean clone, offline, without
an API key:

```bash
git clone https://git.fromaitochitta.com/open/portfolio-optimiser-claude.git
cd portfolio-optimiser-claude
uv sync
uv run pytest    # the full suite, offline, no API key
```

## Docs

- [README.md](README.md): what the framework does, the seams it is built from, the operator CLI, and the one budgeted live run
- [shared/method-spec.md](shared/method-spec.md): the normative method specification (RFC 2119) both reference implementations build
- [shared/ingest-spec.md](shared/ingest-spec.md): the normative ingest specification — connectors and bundle materialization
- [CLAUDE.md](CLAUDE.md): the invariants of this repo — offline test suite, load-bearing tests, budget ceilings
- [CHANGELOG.md](CHANGELOG.md): released versions

## Optional

- [docs/extending.md](docs/extending.md): how the ingest layer is implemented here and how to extend it
- [docs/oppskrift-kunnskapsbase.md](docs/oppskrift-kunnskapsbase.md): recipe for building a knowledge base for a project
- [CONTRIBUTING.md](CONTRIBUTING.md): how to propose changes
- [SECURITY.md](SECURITY.md): how to report a vulnerability