llm-connect/.claude/rules/repo-boundary.md

## Repo boundary

This repo owns **llm-connect** — the multi-provider LLM client library — only.

It does NOT own:

- **API key storage / secret management** → caller's environment (env vars,
  key files, vault). llm-connect resolves keys but does not store them.
- **Consumer routing logic** → `inter-hub/AgentBridge.hs`, `markitect` etc.
  `RoutingPolicy` (WP-0003) provides primitives; policy data belongs in the consumer.
- **The Claude Code CLI binary** → installed separately; `ClaudeCodeAdapter`
  shells out to it.
- **markitect application code** → `markitect.llm` is a shim that re-exports
  from here; all implementation lives in this repo.
- **State hub / custodian infrastructure** → `the-custodian/state-hub/`
- **IHF bridge scripts** → `inter-hub/scripts/llm_bridge.py` lives in inter-hub,
  not here. llm-connect is a dependency of that script.
chore(custodian): add CLAUDE.md and .claude/rules/ orientation files Registers llm-connect with the Custodian agent system: - CLAUDE.md: thin @-import index pointing to modular rules - .claude/rules/session-protocol.md: orient with get_domain_summary("custodian") - .claude/rules/repo-identity.md: domain=custodian, slug=llm-connect - .claude/rules/first-session.md, workplan-convention.md, stack-and-commands.md, architecture.md, repo-boundary.md, agents.md, scope.md (stubs to fill in) - session-protocol notes both local (:8000) and CoulombCore bridge (:18000) URLs Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-04-01 23:15:29 +02:00			`## Repo boundary`

feat: WP-0001 foundation + WP-0002 core extensions WP-0001 — Foundation & GAAF Baseline - SCOPE.md, ARCHITECTURE-LAYERS.md, contracts/ tree - .claude/rules/ stubs filled (architecture, stack, boundary) - 57 tests (pytest), pyproject.toml with ruff+mypy, CI workflow WP-0002 — Core Extensions (FR-4 + FR-3) - FR-4: BudgetTracker (thread-safe) + LLMBudgetExceededError + optional RunConfig.budget_tracker + enforcement in all adapters - FR-3: async_execute_prompt on LLMAdapter ABC (asyncio.to_thread fallback) + native asyncio.create_subprocess_exec in ClaudeCodeAdapter 81 tests passing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-04-01 22:24:14 +00:00			`This repo owns llm-connect — the multi-provider LLM client library — only.`
chore(custodian): add CLAUDE.md and .claude/rules/ orientation files Registers llm-connect with the Custodian agent system: - CLAUDE.md: thin @-import index pointing to modular rules - .claude/rules/session-protocol.md: orient with get_domain_summary("custodian") - .claude/rules/repo-identity.md: domain=custodian, slug=llm-connect - .claude/rules/first-session.md, workplan-convention.md, stack-and-commands.md, architecture.md, repo-boundary.md, agents.md, scope.md (stubs to fill in) - session-protocol notes both local (:8000) and CoulombCore bridge (:18000) URLs Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-04-01 23:15:29 +02:00
feat: WP-0001 foundation + WP-0002 core extensions WP-0001 — Foundation & GAAF Baseline - SCOPE.md, ARCHITECTURE-LAYERS.md, contracts/ tree - .claude/rules/ stubs filled (architecture, stack, boundary) - 57 tests (pytest), pyproject.toml with ruff+mypy, CI workflow WP-0002 — Core Extensions (FR-4 + FR-3) - FR-4: BudgetTracker (thread-safe) + LLMBudgetExceededError + optional RunConfig.budget_tracker + enforcement in all adapters - FR-3: async_execute_prompt on LLMAdapter ABC (asyncio.to_thread fallback) + native asyncio.create_subprocess_exec in ClaudeCodeAdapter 81 tests passing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-04-01 22:24:14 +00:00			`It does NOT own:`

			`- API key storage / secret management → caller's environment (env vars,`
			`key files, vault). llm-connect resolves keys but does not store them.`
			- Consumer routing logic → `inter-hub/AgentBridge.hs`, `markitect` etc.
			`RoutingPolicy` (WP-0003) provides primitives; policy data belongs in the consumer.
			- The Claude Code CLI binary → installed separately; `ClaudeCodeAdapter`
			`shells out to it.`
			- markitect application code → `markitect.llm` is a shim that re-exports
			`from here; all implementation lives in this repo.`
			- State hub / custodian infrastructure → `the-custodian/state-hub/`
			- IHF bridge scripts → `inter-hub/scripts/llm_bridge.py` lives in inter-hub,
			`not here. llm-connect is a dependency of that script.`