feat: initial scaffold (Python framework on Microsoft Agent Framework)

Plan-fase: repo-skjelett, dokumentasjon (research + inkrementell plan),
Python/uv-oppsett, MAF-avhengighet. Ingen rammeverkskode ennå.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01H9FyyENxebxVThjrn9et8C

CLAUDE.md

@@ -0,0 +1,48 @@
+# portfolio-optimiser
+
+## Kontekst
+Generisk, åpent Python-rammeverk på **Microsoft Agent Framework (MAF)** som finner kostnadsbesparelser INNI hvert prosjekt i en portefølje av uavhengige prosjekter. Multi-agent samarbeid genererer kandidat-tiltak; en obligatorisk deterministisk validator avgjør verdiene; fageksperter vurderer via HITL, og systemet lærer av dommene. Publiseres på Forgejo for alle som har MAF.
+
+Bakgrunn og beslutninger: [research](docs/research/2026-06-23-prior-art-platform.md) (§15 implementeringsregister), [plan](docs/plan/2026-06-23-incremental-plan.md). Løpende state: `STATE.md` (local-only).
+
+## Stack
+Python ≥3.10. MAF (`agent-framework` 1.8.0). Pakkehåndtering: `uv`. To backend-profiler: Azure/Foundry (full) + lokal (fallback).
+
+## Konvensjoner
+- Type hints overalt (`mypy` der mulig). Pydantic for validering/IR.
+- `ruff` for lint+format. `pytest` for test.
+- Modell-valg som konfig (modell-map rolle→Foundry-deployment), ikke spredt i kode.
+- Metode kodifiseres som **Agent Skill** (`agentskills.io`: `SKILL.md` + `scripts/` + `references/`).
+- Datatilgang via **MCP**-servere; data-source-konfig JSON-Schema-validert, fail-fast.
+
+## Kommandoer
+- Sync: `uv sync`
+- Test: `uv run pytest`
+- Lint: `uv run ruff check .` + `uv run ruff format .`
+- Type: `uv run mypy src`
+
+## Arbeidsflyt (invarianter)
+- **Rent teknisk rammeverk:** deployer eier DPIA/ROS/behandlingsformål. Bygg IKKE compliance-funksjoner — kun tekniske forutsetninger (lokal-only, provenance, ingen stille egress) + disclaimer.
+- **90%-prinsipp:** bygg den generiske kjernen + tydelige extension points; jakt IKKE de siste 10 %.
+- **Deterministisk validator er obligatorisk og blokkerende** — aldri valgfri plugin.
+- **Stoppkriterier + budsjett-tak påkrevd ved oppstart** (fail-fast, aldri ubegrenset loop).
+- **Group Chat maker-checker** som debatt-default (IKKE Magentic, som er eksperimentell).
+- **STATE.md er local-only** (gitignored). Voyage session-state er efemert; STATE.md er kanonisk kontinuitet.
+- Prosess: Voyage-plugin (`/trekbrief → /trekplan → /trekexecute → /trekreview`) per større fase.
+
+## Communication patterns
+
+### Linking to local files
+
+When pointing to local files in responses, always use markdown link syntax with a descriptive name:
+
+- Use `[Human-friendly name](file:///absolute/path)` — never bare `file:///...` URLs or autolinks `<file://...>`.
+- Always use absolute paths. Never `~/` or relative paths.
+- For multiple files, render as a bullet list of named markdown links.
+
+Why: bare `file://` URLs only render the first as clickable across multiple lines. Named markdown links make each entry independently clickable and look cleaner.
+
+Example:
+
+- [Research report](file:///Users/ktg/repos/portfolio-optimiser/docs/research/2026-06-23-prior-art-platform.md)
+- [Incremental plan](file:///Users/ktg/repos/portfolio-optimiser/docs/plan/2026-06-23-incremental-plan.md)