book-library.git · AGENTS.md

revision b74ab7882c763c01c2c66e5245c3979a47c88a49 · complete file
# Book Library — Agent Guide

Scope: portable Fountain-Coach Book Library source provider and its maintenance server.

Invariants
- Published source remains read-only to writers; maintenance operations are a separate authenticated boundary.
- `FountainMaintenanceKit` is the shared typed contract; do not copy its request/receipt vocabulary.
- Server authorization and idempotency are server-owned; denied operations never become successful receipts.
- Git objects remain in the managed Git boundary, not FountainStore or public source responses.
- Host paths, IPs, credentials, and repository scans never become project, release, or operation identities.
- Public source and maintenance responses contain no secrets, prompts, manuscript material, or unrestricted host output.
- Tests are deterministic; MCP is optional and correctness cannot depend on it.

Routing
- Multi-step or high-risk changes require `PLANS.md` before edits.
- Package procedures belong in `.codex/skills/*/SKILL.md`.
- Reusable maintenance types belong in `Fountain-Coach/FountainMaintenanceKit`.