# @prodkit/op guides

Extended documentation for `@prodkit/op`. These files ship in the npm tarball alongside
[`README.md`](../README.md) (hub + core API).

| Guide | Topic |
| --- | --- |
| [api-contract.md](api-contract.md) | Authoritative export inventory by tier (beta freeze) |
| [better-result.md](better-result.md) | Result boundary, split imports, and retry/cancellation overlap |
| [comparison.md](comparison.md) | Tradeoffs vs Promise, neverthrow, fp-ts, Effect |
| [faq.md](faq.md) | Objection-handling FAQ (Effect, better-result, maintenance, readiness) |
| [performance.md](performance.md) | Benchmark snapshot, bundle size, regression tooling |
| [di.md](di.md) | `@prodkit/op/di` tokens, provide/inject, token identity, runtime errors |
| [policy.md](policy.md) | `@prodkit/op/policy` attachments, exports, ordering with core |
| [hkt.md](hkt.md) | `@prodkit/op/hkt` encoding and custom `Policy.define` checklist |
| [internal.md](internal.md) | `@prodkit/op/internal` extension surface |
| [lifecycle.md](lifecycle.md) | `Op.defer`, release, enter/exit hooks, finalizer ordering |
| [cancellation.md](cancellation.md) | Cancellation guarantees and composed-run wiring |