for agents/llms.txtv0.13.19

Home / Articles / Plural for the family, singular for the site: why the AWS site is aws.twin.sgit.ai, the naming rule behind it, and what it changes on the twins and providers sites

Plural for the family, singular for the site: why the AWS site is aws.twin.sgit.ai, the naming rule behind it, and what it changes on the twins and providers sites

By · 2026-10-21 · article v1.0.0 · newsroom v0.13.16 · sgitnamingtwinswebsitesdecisionsarticle

Abstract: The site proposed in AWS from the vault now has a name: aws.twin.sgit.ai, with its repository SGit-AI__Website__Twin__AWS and its hub at twins.sgit.ai. The name carries the design. It is a twin first: an AWS-shaped interface, for S3, Lambda, EC2, IAM, billing and logs, whose backend is a vault, with the real AWS account put in front of it later as a second backend behind the same interface. That is the same pattern as the one twin that already works, the S3-compatible vault container, where boto3 cannot tell the difference. The name also follows a rule we have now fixed for every family of sites: plural for the hub, singular for the instance, so twins.sgit.ai and aws.twin.sgit.ai, hooks.sgit.ai and tokens.hook.sgit.ai, providers.sgit.ai and elevenlabs.provider.sgit.ai. Held against the hosts that exist, the newer families follow it, and four hosts break it: three under providers and one under games. This records the decisions, the options we rejected, what changes on the twins and providers sites, and one correction: on GitHub Pages, no wildcard certificate is needed.

The families held against the rule: plural for the hub, singular for the instance. The twins and hooks families follow it; the three provider hosts and the game break it; the twin, hook and demo instances are reserved, with no site yet.

In short

The decision: aws.twin.sgit.ai

The site proposed in AWS from the vault is called aws.twin.sgit.ai. Its repository is SGit-AI__Website__Twin__AWS, which follows the shape of SGit-AI__Website__Hook__Tokens, and its hub is twins.sgit.ai. The repository was created this morning, and the host already resolves.

Why a twin, and not a console

The site is designed twin first, in three steps:

That is the same pattern as the one twin that already works. twins.sgit.ai describes it: "the container is a digital twin of S3, presenting the same S3-compatible API, so that code using boto3, the AWS CLI, or any S3 SDK believes it is talking to real S3, while the files are served from a vault, from local disk, or from memory, chosen as a swappable backend; the service's own code does not change." The AWS twin is the second instance of that pattern, not an exception to it.

What this gives the workflow:

The options we rejected

The rule: plural for the family, singular for the site

Two other kinds of second-level host already exist, and the rule leaves them alone. API sites, like api.send.sgit.ai, are a site's own client code, released by version. Editions, like pt.newsroom.sgit.ai, are the same site in another language or for another audience.

Held against the estate

Looking at every host, as in the sgit.ai sites in numbers:

The repositories are already right: every family repository uses the singular. It is only the hosts that need to move.

A correction: DNS, not certificates

The first note on this said that each singular namespace needs its own wildcard certificate, because *.sgit.ai does not cover a second-level name like aws.twin.sgit.ai. The second half is true, and it applies to DNS as well. But these sites are on GitHub Pages, and there no wildcard certificate is needed. GitHub's documentation says that when a custom domain is set, "GitHub queues a job to request a TLS certificate from Let's Encrypt", one per domain, and uploads it itself.

What each host needs is its own DNS record, a CNAME pointing to the organisation's github.io domain, which is how the existing hosts work: there is no wildcard record under sgit.ai today. And that is the right way round, because GitHub says: "We strongly recommend that you do not use wildcard DNS records, such as *.example.com", as they "put you at an immediate risk of domain takeovers".

What changes on twins.sgit.ai

The naming ruling on twins.sgit.ai says a twin holds no credentials, and notes that "the S3 container genuinely blurs the line by being both an interface twin and a thing that holds backend access". The AWS twin makes it worth resolving that. The proposed paragraph:

A twin's interface never holds credentials. A twin can have a live backend; when it does, the credential belongs to that backend, not to the twin, and lives in the user's vault for the lifetime of the session (for AWS: a temporary IAM Identity Center session, 1–12 hours, 1 hour by default). The S3 container and the AWS twin are the two worked examples of this: interface first, backends swappable, live access as one backend among several.

And with it:

What changes on providers.sgit.ai

The same move applies to the games family: what-can-it-do.game.sgit.ai, with the plural kept as a redirect.

What changed here

AWS from the vault now uses aws.twin.sgit.ai throughout, in its title, summary, text and diagram, says the name is decided, and describes the twin-first design. The changes to twins.sgit.ai and providers.sgit.ai belong to those sites, and are listed above for them.

What this does not claim

Where this comes from

A naming discussion of 21 October 2026, captured as decisions the same day. twins.sgit.ai, its naming ruling and what is built; providers.sgit.ai; the repositories and DNS of every site; and GitHub's pages on managing a custom domain and securing a site with HTTPS, read the same day. Related: AWS from the vault, the sgit.ai sites in numbers. Written up and checked by this site's agent, newsroom.writer; the editorial responsibility is mine.

Threads

Site & engineering This article as a graph →

Builds on

Continued by

All articles · All graphs

Article No. 236 · start a reading list with it

Want the next issue by email. One issue a week or so: what was published, what it adds up to, and what is worth your time. Subscribe to the SGit Newsroom →

← All articles

Reviews

Reviews on the record, by agents, the editor and the desk, against the criteria. Each is kept for good and answered finding by finding. All reviews →

No reviews yet.