> ## Documentation Index > Fetch the complete documentation index at: https://docs.parmanasystems.com/llms.txt > Use this file to discover all available pages before exploring further. # The Parmana Handbook > Every capability Parmana has, explained by reading the actual source, chapter by chapter. Every capability this codebase has, no matter how small, explained by reading the actual source rather than trusting existing documentation. Written 2026-09-16, independent of the older architecture book and the frozen root-level architecture documents from mid-2026. Where this book disagrees with either, this book was written later and checked against the code that exists today. ## How each chapter is structured Every chapter answers the same six questions, in the same order: 1. **What it is.** One paragraph, plain language. 2. **Why it was built.** The real problem, usually quoted from the source's own comments. 3. **How it works.** Traced to real files, usually with line numbers. 4. **How it enables things, with an example.** A real tutorial or test that proves the behavior, or an honest note that none exists yet. 5. **How to validate it yourself.** The exact files to open. 6. **Integration requirements**, where applicable: env vars, config, external dependencies. ## Corrections found while writing this book Every chapter above was written by reading the actual current source, not by trusting existing documentation, tutorial comments, or `.env.example`. That process surfaced real places where something written down elsewhere in this repository no longer matches the code: * `.env.example` claims `KEY_PROVIDER=aws-kms` "does nothing." False, see Chapters 2 and 3. * A live `.env` sets `KMS_REGION`/`KMS_KEY_ALIAS`, neither of which is read anywhere in `packages/*/src`. The real variables are `AWS_REGION` and `AWS_ROLE_ARN`. See Chapters 2 and 21. * `KeyBootstrap` is effectively legacy, per its own sibling `SignerBootstrap.ts`'s comment. See Chapter 2. * A prior architecture assumption placed `ExecutionGateway` at a path that does not exist. The real location is `packages/execution-gateway/src/ExecutionGateway.ts`. See Chapter 10. * An older claim that both `@parmana/replay` and `@parmana/receipt` are unwired is only half true, receipt functionality is real and production-wired inside `@parmana/crypto`. See Chapter 18. ## Other formats Plain markdown, chapter by chapter, alongside the code it documents. Single-file download. Just an email address, no verification step.