Documentation
From checkout to a passing gate.
Everything between "we subscribed" and "the auditor left happy", in order. Full reference documentation lives inside the library itself.
1. Activate your team
On the activation page, enter your checkout email — it shows
how many engineer accounts your plan includes and how many are in use. Add each
engineer's GitHub username, now or whenever someone joins; every one receives a
read-only repository invitation from terrasov. Startup includes 5
accounts, Company 15; if you outgrow them,
ask.
2. Clone and look around
git clone https://github.com/terrasov/library.git cd library && cat docs/getting-started.md
docs/getting-started.md covers deployment order (org foundation first,
baselines next, workload modules last) and what each module costs to run.
3. Pin modules by tag
Every module is released with its own semver tag. Reference them pinned — never
track main:
module "data_bucket" {
source = "git::https://github.com/terrasov/library.git//modules/s3-secure?ref=s3-secure/v1.2.0"
bucket_name = "acme-prod-customer-data"
kms_key_arn = module.kms.key_arn
data_classification = "confidential"
environment = "prod"
}
The secure posture is not configurable — if a setting matters to a control, the module enforces it and the annotation above the resource cites the exact clauses.
4. Install the gate
Copy workflows/gate.yml from the library into each repo that holds
Terraform, and point it at the policy pack. From then on, any pull request that
breaks a control fails with a review comment citing the violated clauses across
all six frameworks — the reviewer argues with the regulation, not with a colleague.
Want to see it before subscribing? The public gate-demo repository keeps an open pull request that the gate is failing right now, clause citations included.
5. Evidence day
python tools/collect_evidence.py --framework iso27001
The collector runs every control's live AWS CLI check against your account and
writes a timestamped bundle — bundle.md, per-control JSON, and a
sha256 manifest — you hand to the auditor as-is. Per-framework walkthroughs live
in docs/evidence/.
6. Staying compliant
Regulation and provider changes ship as tagged releases with compliance patch notes. Renewals follow your audit cycle: subscriptions are annual, and access includes every release published while subscribed.
Try before you buy
- Three open-source modules — the same hardening style, minus the compliance layer. The trial is the code, not a timer.
- gate-demo — watch the PR gate block a real change with clause-cited comments.
- Security & trust — how the platform behind this product applies the same controls to itself.