Bundle Root
Bundle OKF 0.2 · 9 conceitos · duizendstra/alexandria
Open source Repository Open in the app JSON README (API)
About
# Bundle Root
Alexandria's `docs/` tree is an OKF v0.2 bundle. Each domain folder carries its
own `index.md` listing the concepts it holds.
* [README.md](README.md) - Entry point to the vault: the 8-folder standard, the conventions it follows, and where the OKF profile lives.
# Domains
* [01-governance/](01-governance/) - GOVERN. Licensing, contributing, changelog, and release policy.
* [02-strategy/](02-strategy/) - STRATEGIZE. Vision, roadmap, and long-term direction.
* [03-architecture/](03-architecture/) - DESIGN. Package design, module boundaries, and shared patterns.
* [04-decisions/](04-decisions/) - DECIDE. Architecture Decision Records in MADR format.
* [05-security/](05-security/) - PROTECT. Data classification, secret management, and dependency policy.
* [06-operations/](06-operations/) - RUN. CI/CD, release automation, and recovery procedures.
* [07-playbooks/](07-playbooks/) - GUIDE. How-to guides, migration recipes, and troubleshooting.
* [08-reference/](08-reference/
Details
- Kind
- OKF bundles
- Topic
- Security & identity
- Publisher
- duizendstra
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Open pull requests
- 19
- Last push
- 2026-09-08T13:45:24Z
- Repository state
- ativo
- Language
- Go
- License
- Apache-2.0
- Added
- 2026-09-08 16:02:35
- Updated
- 2026-09-08 16:02:35
- Origin id
duizendstra/alexandria:docs/index.md
README
# Alexandria > The arctic vault. One canonical place for everything I use to build software. [](LICENSE) [](https://github.com/duizendstra/alexandria/actions/workflows/ci.yml) Alexandria owns the shared knowledge, libraries, contracts, and tooling of the [duizendstra](https://github.com/duizendstra) ecosystem. ## What's Inside | Directory | Concern | Description | |---|---|---| | [`go/`](go/) | **BUILD** | Go modules — each with its own `go.mod`, independently versioned | | [`contracts/`](contracts/) | **DEFINE** | API contracts — Protocol Buffer and ConnectRPC service definitions | | [`skills/`](skills/) | **TEACH** | Antigravity AI skills — shareable agent instructions | | [`blueprints/`](blueprints/) | **SCAFFOLD** | Golden configuration templates — ko service builds, git hooks, golangci profiles | | [`docs/`](docs/) | **KNOW** | Documentation vault — full 8-folder OKF structure | ## Go Modules | Module | Import Path | Status | Description | |---|---|---|---| | [retry](go/retry/) | `github.com/duizendstra/alexandria/go/retry` | v1.1.0 | Exponential backoff/jitter retries and transient HTTP roundtrip retries | | [retry/gcp](go/retry/gcp/) | `github.com/duizendstra/alexandria/go/retry/gcp` | v1.1.1 | GCP/Google API error classification and retry utilities | | [slog-gcp](go/slog-gcp/) | `github.com/duizendstra/alexandria/go/slog-gcp` | v0.1.1 | `slog.Handler` decorator for GCP Cloud Logging (trace URLs, error reporting) | | [slog-gcp/otelgcp](go/slog-gcp/otelgcp/) | `github.com/duizendstra/alexandria/go/slog-gcp/otelgcp` | v0.1.0 | OpenTelemetry trace-context bridge for slog-gcp | | [google](go/google/) | `github.com/duizendstra/alexandria/go/google` | v0.4.3 | Google Workspace authenticator builders, client factories, CRM & Service Usage clients | | [dataquality/datadiff](go/dataquality/datadiff/) | `github.com/duizendstra/alexandria/go/dataquality/datadiff` | v0.3.1 | Proves two datasets equivalent through layered comparison | | [observability/audit](go/observability/audit/) | `github.com/duizendstra/alexandria/go/observability/audit` | v1.1.0 | Structured append-only audit logging | | [contracts](go/contracts/) | `github.com/duizendstra/alexandria/go/contracts` | v1.0.0 | Compiled Protocol Buffer messages and ConnectRPC services | | [discovery/privacyfilter](go/discovery/privacyfilter/) | `github.com/duizendstra/alexandria/go/discovery/privacyfilter` | v0.1.1 | Content filtering before indexing | | [discovery/search](go/discovery/search/) | `github.com/duizendstra/alexandria/go/discovery/search` | v0.2.0 | Core types and port interfaces for the Discovery bounded context | | [discovery/search/searchtest](go/discovery/search/searchtest/) | `github.com/duizendstra/alexandria/go/discovery/search/searchtest` | v0.0.2 | Reusable contract tests for `search.Index` adapters | | [platform/apierr](go/platform/apierr/) | `github.com/duizendstra/alexandria/go/platform/apierr` | v0.1.0 | Sentinel errors for vendor API interactions | | [platform/async](go/platform/async/) | `github.com/duizendstra/alexandria/go/platform/async` | v0.1.1 | In-memory async task runner with lifecycle states | | [platform/buildstamp](go/platform/buildstamp/) | `github.com/duizendstra/alexandria/go/platform/buildstamp` | v0.3.0 | Build provenance stamping and strict pre-run verification (commit, dirty tree, dependency revisions) | | [platform/cache](go/platform/cache/) | `github.com/duizendstra/alexandria/go/platform/cache` | v0.0.2 | Generic, concurrent-safe in-memory TTL cache | | [platform/coordination](go/platform/coordination/) | `github.com/duizendstra/alexandria/go/platform/coordination` | v0.2.0 | Interfaces and primitives for process and workload mutual exclusion and coordination | | [platform/gcpenv](go/platform/gcpenv/) | `github.com/duizendstra/alexandria/go/platform/gcpenv` | v0.1.0 | Canonical GCP project ID resolution (env vars + metadata service) | | [platform/passstore](go/platform/passstore/) | `github.com/duizendstra/alexandria/go/platform/passstore` | v0.1.0 | Deploy-time secret retrieval from the local pass store | | [platform/procrun](go/platform/procrun/) | `github.com/duizendstra/alexandria/go/platform/procrun` | v0.3.1 | Run external commands under a controlled environment (scrubbed env, fixed PATH, output to file) | | [platform/runstate](go/platform/runstate/) | `github.com/duizendstra/alexandria/go/platform/runstate` | v0.4.0 | Per-subject run lock and short-lived, fingerprint-bound leases on disk | | [platform/web](go/platform/web/) | `github.com/duizendstra/alexandria/go/platform/web` | v0.1.1 | Project-agnostic HTTP server, client, and response utilities | | [platform/workflow](go/platform/workflow/) | `github.com/duizendstra/alexandria/go/platform/workflow` | v0.2.0 | Context-aware sequential step procedure engine with panic recovery, skip predicates, and lifecycle hooks | | [governance](go/governance/) | `github.com/duizendstra/alexandria/go/governance` | v1.0.2 | Pure-Go governance domain model (scope, tiers, hierarchy, classification) | | [iac/pulumi/gcpinfra](go/iac/pulumi/gcpinfra/) | `github.com/duizendstra/alexandria/go/iac/pulumi/gcpinfra` | v1.1.0 | Pulumi adapter packages for Google Cloud infrastructure | | [iac/pulumi/runner](go/iac/pulumi/runner/) | `github.com/duizendstra/alexandria/go/iac/pulumi/runner` | v0.2.2 | Programmatic Pulumi CLI automation engine built on procrun | | [iac/pulumi/stackref](go/iac/pulumi/stackref/) | `github.com/duizendstra/alexandria/go/iac/pulumi/stackref` | v0.1.0 | Typed readers for Pulumi stack reference outputs | | [iac/delivery](go/iac/delivery/) | `github.com/duizendstra/alexandria/go/iac/delivery` | v0.1.2 | Configuration-driven Pulumi blueprint provisioning a CI/CD project (registry, Git connection, build triggers, consumer grants) | | [iac/finops](go/iac/finops/) | `github.com/duizendstra/alexandria/go/iac/finops` | v0.1.1 | Configuration-driven Pulumi blueprint provisioning a FinOps project (billing dataset, org budget with alerts) | | [iac/governance](go/iac/governance/) | `github.com/duizendstra/alexandria/go/iac/governance` | v0.1.2 | Configuration-driven Pulumi blueprint provisioning GCP governance | | [iac/identity](go/iac/identity/) | `github.com/duizendstra/alexandria/go/iac/identity` | v0.1.1 | Configuration-driven Pulumi blueprint provisioning an identity project (secrets, SAs, IAM) | | [iac/observability](go/iac/observability/) | `github.com/duizendstra/alexandria/go/iac/observability` | v0.3.2 | Configuration-driven Pulumi blueprint provisioning an observability project (log dataset, org audit-log sink, optional uptime checks + alert channel) | | [iac/workloads](go/iac/workloads/) | `github.com/duizendstra/alexandria/go/iac/workloads` | v0.1.0 | Configuration-driven Pulumi blueprint provisioning multi-project workload environments with per-concern exports | Version numbers signal maturity: `v0.0.x` modules are experimental; `v0.1.x` means the API shape has been validated by at least one real consumer (see [ADR-0001](docs/04-decisions/adr-0001-monorepo-strategy.md)). ## Documentation The `docs/` directory is an [Open Knowledge Format (OKF)](https://okf.md) bundle with an 8-domain structure designed for both human and agentic consumption. See the [Alexandria OKF Profile](docs/08-reference/okf-profile.md) for details. | # | Domain | Verb | |---|---|---| | 01 | governance | GOVERN | | 02 | strategy | STRATEGIZE | | 03 | architecture | DESIGN | | 04 | decisions | DECIDE | | 05 | security | PROTECT | | 06 | operations | RUN | | 07 | playbooks | GUIDE | | 08 | reference | LOOK UP | ## License Code (`go/`, `contracts/`, `.github/`, `.githooks/`) is licensed under [Apache-2.0](LICENSE). Documentation, skills, and blueprints (`docs/`, `skills/`, `blueprints/`) are licensed under [CC-BY-4.0](docs/LICENSE). Copyright 2026 Jasper Duizendstra.