sgit newsroom v0.1.29 · snapshot 2026-09-24

Reading room · nfrs.sgit.ai · llms-full

On this page

Reading room / nfrs.sgit.ai / llms-full.txt · section 5 of 12

00 — The Brief: nfrs.sgit.ai

Version v0.33.62 · 24 August 2026 From Dinis Cruz, via the SG/Send Librarian To the agent commissioned to build nfrs.sgit.ai Licence CC BY 4.0


1. The commission

"the home for lots of the NFR related topics we have covered in quite detail — for example CI pipelines, security, scalability, resilience, explainability, serverless, architecture, testing, documentation, budgets/finance, project management…"

And the framing that matters more than the topic list:

"the idea of these sites is to provide good briefs for agents to learn about how we work and think — these sites are a more evolved and focused version of what is usually called LLM memory."

That second sentence is the clearest statement of the whole *.sgit.ai network's purpose made anywhere in this project, and it should not stay buried in a chat message. 02__ develops it into a page — and recommends it also land on the sgit.ai hub, because it explains all fourteen sites at once.


2. The name — verdict: yes, nfrs.sgit.ai

Three reasons it is right:

  1. It is your own operative term, already defined in the corpus. The villagers brief: "what I call the non-functional requirements, which fundamentally is the whole version control, reliability, resilience, security, backups, consistency, explainability, and documentation." That sentence is this site's table of contents, written a month before the site was conceived.
  2. It fits the network's naming pattern — plural subject nouns: risks. graphs. skills. twins. standards. nfrs. reads as one of the family.
  3. The jargon objection does not apply here. "NFR" is opaque to a general reader — but the stated audience is agents and technical readers, for whom it is precise and unambiguous. The alternatives are worse: quality. is vague, engineering. overclaims, operations. misses half the list.

Two conditions: expand the acronym in the first sentence of the front page, and note that the corpus itself writes it both ways ("non-functional requirements" in prose, NFR in speech) — the site should use NFRs as the name and the full phrase on first use per page.


3. The shape: this is a hub site

Unlike twins. (a primitive) or sg-compute. (a platform), this site is a hub over topics that mostly already have owners in the network. The measured densities and the split:

TopicFilesThis site's role
Testing279OWNS — no-mocks-no-patches, deploy-via-pytest, the structural-guard pattern, 4,785-tests-in-81s
CI pipelines273OWNS — digest-first multi-arch, AMI bake-and-verify, auto-increment versioning
Documentation651OWNS — the reality-document system, briefs-are-aspirations, the markdown twin, day-indexes
IFD (the methodology)guidesOWNS — Iterative Flow Development, versioned guides written explicitly "for LLMs"
Budgets / finance410OWNS the discipline — pre-approve-the-ladder, profitability-first, budget-on-the-step
Project management31OWNS — the PM-is-where-the-register-becomes-work brief, the brief/debrief system itself
Resilience100OWNS the patterns — the watchdog, health poller, teardown paths (artefacts live in sg-compute.)
Explainability65LINKS — the grounding ladder is risks./standards.; this site owns "computed, not claimed" as an engineering habit
Serverless / scalability347 / 104LINKS — sg-compute. owns the platform; this site owns the requirement framing
Security—LINKS — pki. nhi. sg-sentinel. own domains; this site owns the NFR posture (audit-before-the-key, key-leak CI gates)
Architecture—LINKS — coding. owns conventions; this site owns responsibility-boundaries as a requirement class

The rule: this site owns the disciplines that have no other home, and the topic map that shows an agent where everything else lives. 01__ is that map.


4. The spine: the villagers sentence, from the inside

The network already tells the NFR story from the market side — open-source.sgit.ai owns "somebody has to be the villagers" as an economic argument. This site is the same sentence from the inside: how we actually do the NFRs the villagers sell.

That gives the site an unusual honesty obligation, because this session has already measured the estate against its own NFR list:

NFR (his list)The estate, measured
Version control✅ 2,777 commits/100 days, auto-increment tags, the version file convention
Reliability / resilience✅ watchdog, poller, bake-and-verify — and a dead workflow (sg-play ×16) nobody noticed
Security✅ key discipline, allowlists — and one disclosed key-in-history incident, handled well
Backups⚠️ thinnest topic in the corpus — 151 mentions, no doctrine
Consistency🟡 100% banner compliance beside 39% import alignment; four stale sources of truth
Explainability✅ reality docs, provenance — and no evals anywhere
Documentation✅ 1.27M words with a governing rule — and a README describing a repo that does not exist

Publish that table. A site teaching NFRs from a corpus that visibly practises and visibly lapses is credible in a way no clean-room guide can be — and every lapse is already documented in a sibling pack with the evidence.


5. The numbers

Densitiesdocumentation 651 · budget 410 · observability 393 · serverless 347 · unit test 279 · CI 273 · backup 151 · scalability 104 · resilience 100 · reliability 74 · explainability 65 · PM 31 · "non-functional" 26
The definitionone sentence in the villagers brief, listing eight NFRs verbatim
Owned disciplinestesting · CI · documentation/reality · IFD · budgets · PM · resilience patterns
The methodologyIFD — versioned guides (v1.2.1), written "for LLMs assisting with IFD-based development"
This pack7 documents · manifest of 26 rows · every path verified

6. Build order

  1. /map/ — the topic map (01__). The hub's reason to exist: one page an agent reads to know where everything lives.
  2. /memory/ — the sites-as-agent-memory thesis (02__). The page that explains the network.
  3. /testing/ and /ci/ — the two strongest owned disciplines, with the measured numbers.
  4. /documentation/ — the reality-document system: "if the reality document doesn't list it, it does not exist… briefs are aspirations, not facts."
  5. /budgets/ and /pm/ — pre-approve-the-ladder, profitability-first, the brief/debrief system.
  6. /scorecard/ — §4's table, unsoftened, linked to the sibling packs' evidence.
  7. /shipped/ — what this site asserts vs what the estate demonstrably does.

This document is released under the Creative Commons Attribution 4.0 International licence (CC BY 4.0).


== briefs/v0.33.62__nfrs-brief-pack__01__the-topic-map.md