# LLM-WP-0001 — Foundation & GAAF Baseline

**status:** active  
**owner:** llm-connect  
**repo:** llm-connect  
**created:** 2026-04-01  

## Purpose

Establish the structural foundation required before any Core modifications.
Covers repo orientation files, GAAF-2026 compliance artifacts, test suite, CI,
and state-hub housekeeping.

## Tasks

| ID  | Title | Priority | Status |
|-----|-------|----------|--------|
| T01 | Create `SCOPE.md` | high | done |
| T02 | Fill `.claude/rules/` stubs: `architecture.md`, `stack-and-commands.md`, `repo-boundary.md` | high | done |
| T03 | Create `ARCHITECTURE-LAYERS.md` with layer map, scorecard stub, next-review date | high | done |
| T04 | Create `/contracts/` tree (`core/`, `functional/`, `config/`) | high | done |
| T05 | Core contract doc: `LLMAdapter` interface invariants, `RunConfig`/`LLMResponse` field contracts | high | done |
| T06 | Functional contract stubs for all 4 adapters + embedding adapters (maturity: Beta) | medium | done |
| T07 | Create `tests/` with `conftest.py`, wire pytest in `pyproject.toml` | high | done |
| T08 | Unit tests: `RunConfig`, `LLMResponse`, `MockLLMAdapter`, full exception hierarchy | high | done |
| T09 | Unit tests: `create_adapter` (all providers + unknown provider error), `create_embedding_adapter` | high | done |
| T10 | Add `ruff`, `mypy` to dev deps in `pyproject.toml` | medium | done |
| T11 | CI workflow: pytest + ruff + mypy | medium | done |
| T12 | State hub: register this host path, SBOM refresh | low | done |

## Exit criteria

- `ARCHITECTURE-LAYERS.md` and `/contracts/core/` exist and describe the current Core surface
- pytest passes with coverage of Core and factory
- ruff + mypy clean
- CI green on push