The source documents
This site is written from a commissioning pack, and the pack is published in full — 13 documents, 9,783 words — because a site that argues from a document should let you read the document.
The raw file is the source of truth. Each markdown reader page renders its document
from the raw file in briefs/ at load time; if that fails, the page falls back
to a link to the raw file. teams__roster.json and the source manifest CSV have
no reader page — they are already the format an agent wants, and rendering them would be a
worse copy.
Every file is fetchable at a stable constructed URL: /briefs/<filename>.
That is a promise, not an accident.
Read them
00 — The Brief: teams.sgit.ai
The commission itself: the thesis, the measured inventory, the honest constraints and the build order this site follows.
Read it →01 — The ROLE.md Format: measured, and one recommendation
All 39 ROLE.md files parsed for section headers and Identity fields. The falsifiable-claim recommendation and the format drift, quantified.
Read it →02 — The Roster: nineteen roles
The nineteen roles grouped by function, where each exists across the four team instantiations, the portable six-role core, and the growth timeline.
Read it →03 — The Three Topologies: Pioneers, Settlers, Town Planners, staffed
Explorer, Villager and Town Planner as Wardley's PST implemented as agent configurations — the handback rule, and why it solves a real problem.
Read it →04 — The Comms Protocol: how roles hand work to each other
Inbox/outbox addressing inside role files, the eight-step session-start ritual, and why files beat a message bus for inter-agent comms.
Read it →05 — Evolution and Learnings: what the roles learned, as diffs
Git archaeology over team/roles/*/ROLE.md — the timeline, and three learnings recovered from the diffs rather than the files.
Read it →06 — Site Architecture: teams.sgit.ai
The URL scheme, the machine-readable roster, the deconfliction table against sibling sites, and what this site deliberately does not do.
Read it →07 — Boundaries and Licensing
What is being published, the pre-publication scrub for vault keys and internal identifiers, third-party attribution, and the honesty rule that outranks the licence.
Read it →08 — Gaps and Open Questions
Seven gaps and seven open questions for the founder, published unresolved rather than smoothed over.
Read it →Brief pack README
The commissioning pack's own index: what each document contains, the two things to know before building, and the licence.
Read it →Licence
CC BY 4.0 for the pack and the site it commissions; what CC BY does not cover (Pioneers–Settlers–Town Planners is Simon Wardley's); the rules that outrank the licence.
Read it →All 13, with their raw files
What was scrubbed before publication
07__ of the pack sets the rule: vault keys, share tokens, access tokens and API keys are
never published, and the grep for them is a CI build step, not a review step —
the leak tripwire scans every file in this tree on every
release, the same check that runs on every sibling site. Internal hostnames, bucket names,
account IDs and ARNs become placeholders where they would otherwise appear. This pack's
own source material — role definitions from a live product team — carries none of that, so
nothing in briefs/ has been redacted; the tripwire runs anyway, because the check
that only runs when you expect a problem is the check that is not running when you have one.
Licence
Every document in the pack, and every page of this site, is released under CC BY 4.0. Attribution: Dinis Cruz, with AI co-authorship (Claude, Anthropic).
Pioneers–Settlers–Town Planners is not. It is Simon Wardley's model, published by him under CC BY-SA — named and credited here, linked to wardley-maps.sgit.ai and to his own material, never reproduced. This site's contribution is the staffing of PST as three agent teams, which is original; the model is not.