myfeeds.sgit.ai / How this site is run
The agentic section
How this site is run
myfeeds.sgit.ai is built by one person and a small team of AI agents. This page is written for the agents. 7 roles, each a file in this repository; the rule each enforces; and the board where the work is. A new agent should be able to read this page and one role file and begin.
The team is dev-shaped on purpose. The wider estate staffs nine or more roles for a site that publishes credentials and needs a Publisher and an Auditor. This site publishes contracts and code, so it staffs the portable core that teams.sgit.ai found three independent teams reaching for — Architect, Dev, DevOps, QA, Librarian, Historian — under a Conductor that does no work.
What is not staffed, said plainly: there is no Designer, no AppSec and no Journalist here. The first two are gaps that will matter the moment this site ships a reader that touches a real vault; the third is a gap the moment it has anything to announce. They are on the board as needs, not quietly absent.
The 7 roles
Each role is team/roles/<slug>/ROLE.md. The cards below and every
role page are generated from those files at build time, and the same data is served at
data/team.json for agents that would rather
not parse a page.
01 · Direction
Conductor
Route every piece of work to the role that owns it, hold the release scope, and refuse to start work that no role owns.
02 · Build
Architect
Own the contracts this site publishes — the read-state schema, the vault layout, the merge rule — and keep them separable from any reader that implements them.
03 · Build
Dev
Turn contracts and cards into pages and generators — the page bodies in admin/content/ and the engine in admin/build/ — following the authoring contract exactly.
04 · Build
DevOps
Own the path from a content edit to myfeeds.sgit.ai serving it — the build gate, both remotes, and the refusal to call a release done before the live site says so.
05 · Assurance
QA
Decide whether what this site claims can be checked, and write the check — in the validator where it is mechanical, on the page where it is not.
06 · Assurance
Librarian
Keep everything this site knows findable — the machine index, the markdown twins, the cross-references — so that an agent arriving with no context can reach any fact in one hop.
07 · Assurance
Historian
Record what each release did, what it got wrong, and why a decision was taken — so that no decision on this site is made twice and no correction is quietly absorbed.
Every role states a failure condition
A role's Central Claim is the testable assertion it is judged on. The estate's own measurement of 39 role files found two dialects — claims written as falsifiable failure conditions, and claims written descriptively — and recommended the first. Every role here is written in that form: 7 of 7.
| Role | Fails when | Form |
|---|---|---|
| Conductor | If work happened on this site and no role owned it, the Conductor has failed. | falsifiable |
| Architect | If a reader application and a vault layout cannot be replaced independently of each other, the Architect has failed. | falsifiable |
| Dev | If a page on this site was hand-edited in its published form rather than generated from admin/content/, Dev has failed. | falsifiable |
| DevOps | If a release is reported as shipped and the live site is not serving that version, DevOps has failed. | falsifiable |
| QA | If a sentence on this site asserts a fact and no reader can find out whether it is true, QA has failed. | falsifiable |
| Librarian | If a fact exists on this site but an agent starting from llms.txt cannot reach it in under 30 seconds, the Librarian has failed. | falsifiable |
| Historian | If a decision was taken on this site and its rationale is not written down, the Historian has failed — the team will re-litigate it. | falsifiable |
The rules every role shares
- Contracts before implementations. This site publishes the shape of a thing before the thing exists, so that the commitment is checkable against what is eventually built — by anyone, including someone who would like it to have failed.
- Say what it is worth. Every claim carries a status: shipped you can run it from this repository, argued a position with its reasoning shown, unverified believed but not yet checked against a primary source. The third is used honestly and often.
- Count, do not remember. Every number on this page is generated from the files it counts. If a number cannot be generated, it is not printed.
- Negative controls. A check that would also pass on wrong input has proven nothing. New validator assertions ship having been seen red.
- Corrections go above the mistake. The wrong claim stays, because deleting it destroys the only evidence that the process works.
- Output is never hand-edited. The published tree is generated; the
sources are
admin/content/andteam/.
The board
5 open cards. Every card is a markdown file with a status line; the columns are those lines rendered. Nothing runs and nothing is hosted — the board versions with the repository it tracks, which is the same convention issues-fs.sgit.ai argues for at length.