Skip to content

An agent organization structured as a company — 15+ departments, 125+ skills, each independently installable, citing the standards and regulators that settle the question. Runs in Claude Code and ChatGPT.

Add a source catalog so skills can cite live authorities

Claude0e7cd01aa93e
diff --git a/.claude/agents/sources.md b/.claude/agents/sources.md
new file mode 100644
index 0000000..5c8763f
--- /dev/null
+++ b/.claude/agents/sources.md
@@ -0,0 +1,53 @@
+---
+name: sources
+description: Source catalog. Owns sources/** and nothing else — the authoritative external references each skill should check against, with the license class that says what may be done with each. Delegate adding, correcting or re-verifying a source here.
+---
+
+# Source catalog
+
+## Why this agent exists
+
+The single owner of `sources/**`. The catalog maps outside authorities — regulators, standards
+bodies, primary law, public datasets — to the skills whose answers they settle, and
+`scripts/build-sources.py` emits each skill's list into its own `references/sources.md`.
+
+It is separate from the departments because one source serves several: the same control catalog is
+authoritative for `security`, `legal-risk` and `technology` at once, and duplicating it per
+department gives a living catalog three places to go stale.
+
+## Standard
+
+**References, never copies.** The catalog holds a URL and a judgment about it. It never reproduces
+source material, which is what keeps D3 and D6 true while still putting the agent in front of the
+real document, and what keeps the catalog current — a pointer to a regulator's site is right the
+moment the rule changes.
+
+**The license class is the load-bearing field.** Most of what a professional must cite is not open:
+ISO standards are sold, SANS papers are copyrighted, the FASB Codification needs an account. An
+entry classed wrongly as open invites an agent to reproduce text it was only allowed to read. When
+uncertain between two classes, take the more restrictive one.
+
+**Prefer the publisher to the aggregator.** `ecfr.gov` over a site that reprints it. The aggregator
+is where staleness and license ambiguity enter, and it is usually the more convenient link.
+
+**Record what a source is authoritative *for*, not what it is about.** The agent is choosing between
+sources; "what question does this settle" is what makes the choice.
+
+`sources/README.md` holds the format and the full license vocabulary.
+
+## Surface
+
+Writes: `sources/**`.
+Reads: anything. Commits: nothing; the orchestrator is the sole committer.
+
+Note that the emitted `plugins/*/skills/*/references/sources.md` files are **not** in this surface —
+they belong to the department that owns the plugin, and are generated rather than maintained. A
+change to them is made here, in the catalog, and regenerated.
+
+## Verification this surface implies
+
+- `python3 scripts/check-sources.py` passes — structure, license vocabulary, every `department:skill`
+ resolves, and every skill with sources carries the `## Sources` pointer that sends an agent to them.
+- `python3 scripts/build-sources.py --check` passes — no emitted file has drifted from the catalog.
+- `python3 scripts/check-sources.py --online` before claiming a `checked` date. CI does not fetch
+ URLs on every push; a publisher being briefly down is not a reason to fail somebody's pull request.
diff --git a/.github/workflows/sources.yml b/.github/workflows/sources.yml
new file mode 100644
index 0000000..68b1c1a
--- /dev/null
+++ b/.github/workflows/sources.yml
@@ -0,0 +1,23 @@
+name: source links
+
+# The catalog points at outside publishers, so it rots without anything in this repository
+# changing. That makes it the one check worth running on a clock rather than on a diff.
+#
+# Deliberately not part of `checks.yml`: a publisher being briefly down, or rate-limiting a
+# runner, is not a reason to fail somebody's pull request. A dead link is real and worth a
+# notification; it is not worth blocking a merge that has nothing to do with it.
+on:
+ schedule:
+ - cron: "17 7 * * 1"
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ links:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v7
+ - name: Fetch every cataloged source
+ run: python3 scripts/check-sources.py --online
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e411729..48bad41 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -61,6 +61,8 @@ Every check CI runs, in one script — the workflow calls this same file, so the
| Skill references | Every `department:skill` mentioned in the docs or in a skill body resolves |
| US English spelling | No British spellings, by exact word form |
| `## Never` blocks | Bullets inside one block agree on terminal punctuation |
+| Source catalog | Structure, license vocabulary, and every skill it names resolves |
+| Skill source files | Each skill's `references/sources.md` matches the catalog |
| Verticals | Every vertical emits, and the emitted repository passes its own checks |
| Manifests | The marketplace file and every `plugin.json` parse |
@@ -114,6 +116,25 @@ department cannot end up missing from the README and the org chart while the che
Give it a chief before any specialists — the department's remit should exist before things are added
to it.
+## Adding a source
+
+`sources/*.toml` maps outside authorities — regulators, standards bodies, primary law, public
+datasets — to the skills whose answers they settle. `scripts/build-sources.py` emits each skill's
+list into its own `references/sources.md`, which is what an agent reads while it is answering.
+
+**References, never copies.** The catalog holds a URL and a judgment about it, never source
+material. That keeps D3 and D6 true and keeps the catalog live — a pointer to a regulator's site is
+right the moment the rule changes, and a copy is wrong the moment it does.
+
+**The `license` field is the load-bearing one.** Most of what a professional must cite is not open:
+ISO standards are sold, SANS papers are copyrighted, the FASB Codification needs an account. An
+entry classed wrongly as open invites an agent to reproduce text it was only allowed to read. When
+torn between two classes, take the more restrictive one. `sources/README.md` has the vocabulary.
+
+Link reachability is checked weekly by its own workflow rather than on every push, because a
+publisher being briefly down is not a reason to fail an unrelated pull request. Run
+`python3 scripts/check-sources.py --online` before you claim a `checked` date.
+
## Adding to a vertical
A vertical is the core made specific to one industry. `scripts/build-vertical.py` emits a standalone
diff --git a/docs/AGENT-SURFACES.md b/docs/AGENT-SURFACES.md
index 439c3b1..2315d09 100644
--- a/docs/AGENT-SURFACES.md
+++ b/docs/AGENT-SURFACES.md
@@ -54,6 +54,7 @@ security builder installed autonomous
it-operations builder installed autonomous
pmo builder installed autonomous
verticals builder installed proposes
+sources builder installed autonomous
repo-meta builder installed proposes
legal-risk-review reviewer installed autonomous
security-review reviewer installed autonomous
@@ -147,6 +148,10 @@ plugins/security/**
verticals/**
```
+```surface:sources
+sources/**
+```
+
```surface:repo-meta
LICENSE
.gitignore
diff --git a/docs/DECISION-LOG.md b/docs/DECISION-LOG.md
index 78c1b4c..84c554a 100644
--- a/docs/DECISION-LOG.md
+++ b/docs/DECISION-LOG.md
@@ -48,6 +48,7 @@ recorded rather than being deleted.
| D34 | Two skills claim social graphics | ✅ Resolved |
| D35 | Whether description shape is a checkable convention | ✅ Resolved |
| D36 | Where emitted vertical repositories live | ✅ Resolved |
+| D37 | Authoritative sources as a catalog of references | ✅ Resolved |
---
@@ -1249,3 +1250,61 @@ is emitted into a distributable repository carrying industry-specific advice, an
is one-way, nothing downstream can correct it locally. The generator itself stays with `repo-meta`
alongside the other scripts — writing industry advice and maintaining the tool that ships it are
different jobs.
+
+---
+
+## D37. Authoritative sources as a catalog of references — ✅ Resolved
+
+A skill states what a competent practitioner knows. It does not state what the regulator published
+last month, and it cannot: the catalog is written once and the obligation moves. The ask was for
+each skill to carry the outside authorities an agent should check in real time — tax guidance,
+employment law by jurisdiction, security control catalogs, standards bodies, public datasets.
+
+The framing offered was "open source or MIT/Apache licensed sources." Investigating that turned out
+to be the decision, because **most of what a professional must cite is not open**, and the examples
+named make the point: ISO standards are sold, SANS papers are copyrighted, the FASB Codification is
+free only behind an account. What *is* freely usable is narrower and more valuable than it looks —
+US federal works are public domain by statute, statutes and regulations are uncopyrightable as
+government edicts, and EU legal texts are reusable with attribution.
+
+So the catalog cannot be a list of things we may copy. It has to be a list of things an agent may
+*read*, each carrying what it may then do with what it read.
+
+- **(a) A catalog of references, with a closed license vocabulary, emitted per skill.** ← **chosen**
+- (b) Vendor the material that permits it — US public-domain control catalogs, CISA KEV — so a
+ skill works offline. Reverses D3 and D6, needs a carve-out in the provenance check, and
+ reintroduces the staleness the catalog exists to remove: a snapshot of a live feed is wrong the
+ day after it is taken.
+- (c) Put the URLs inline in each skill body. No new machinery, and no way to check that a link
+ still resolves, no way to record what may be done with it, and one source serving three
+ departments becomes three copies to update.
+
+**Resolution: (a).** `sources/*.toml` maps a source to the skills whose answers it settles.
+`scripts/build-sources.py` emits each skill's list into its own `references/sources.md`, which is
+where Claude Code and ChatGPT both load a skill's supporting files from on demand — so the agent
+gets its own sources and not the other 171 skills'.
+
+**The license class is the load-bearing field**, and it is a closed vocabulary the checker enforces.
+Three of its ten values — `free-to-read`, `registration-required`, `paywalled` — exist specifically
+to mark the sources most often assumed open and not. An entry classed wrongly as open invites an
+agent to reproduce text it was only ever allowed to cite. The emitted file states the consequence in
+the imperative next to each source rather than leaving it to a table elsewhere.
+
+**Three things were built to keep it honest rather than merely present.**
+
+A skill with sources must carry a `## Sources` section, and a skill carrying one must have sources.
+Without that pairing the feature rots in both directions at once — a file nobody is told about, or a
+pointer to a file no longer emitted. The check enforces it both ways.
+
+Reachability is checked weekly on its own schedule, not on every push. A publisher being briefly
+down is not a reason to fail an unrelated pull request, and a check that fails for reasons outside
+the diff is a check people learn to ignore. All 37 initial URLs were verified reachable before the
+`checked` dates were claimed, and three were wrong at first writing.
+
+The provenance check gained a narrow waiver, because a file whose job is to classify licenses must
+be able to name license families. It waives the *names* only; actual license text is still caught by
+its body, which the waiver was tested against by pasting some in and watching it fail.
+
+**Coverage is `security`, `legal-risk` and `finance` first** — the three departments where citing
+the authority changes the answer rather than decorating it. Extending it is adding entries, not
+changing the mechanism.
diff --git a/plugins/corporate-strategy/skills/mergers-and-acquisitions/SKILL.md b/plugins/corporate-strategy/skills/mergers-and-acquisitions/SKILL.md
index b27f8a6..511e1a8 100644
--- a/plugins/corporate-strategy/skills/mergers-and-acquisitions/SKILL.md
+++ b/plugins/corporate-strategy/skills/mergers-and-acquisitions/SKILL.md
@@ -65,6 +65,13 @@ The predictable value destroyers are attrition of the people you bought, custome
transition, and a stalled integration that leaves two of everything indefinitely. Each is
foreseeable and each is planned around, or it is not.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Proceed with a thesis that changed to fit the target.
diff --git a/plugins/corporate-strategy/skills/mergers-and-acquisitions/references/sources.md b/plugins/corporate-strategy/skills/mergers-and-acquisitions/references/sources.md
new file mode 100644
index 0000000..20e29ea
--- /dev/null
+++ b/plugins/corporate-strategy/skills/mergers-and-acquisitions/references/sources.md
@@ -0,0 +1,19 @@
+# Sources — `corporate-strategy:mergers-and-acquisitions`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## EDGAR full-text search and submissions API
+
+US Securities and Exchange Commission · US · public domain (US government) — quote freely
+
+<https://www.sec.gov/edgar/search-and-access>
+
+Machine-readable: <https://www.sec.gov/search-filings/edgar-application-programming-interfaces>
+
+**Authoritative for:** What public companies actually reported, in their own filings — the primary source for a competitor's economics, a comparable's margin structure, or how a peer disclosed an accounting policy.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/data-analytics/skills/data-governance/SKILL.md b/plugins/data-analytics/skills/data-governance/SKILL.md
index 0a49124..50c9668 100644
--- a/plugins/data-analytics/skills/data-governance/SKILL.md
+++ b/plugins/data-analytics/skills/data-governance/SKILL.md
@@ -58,6 +58,13 @@ periodically, with Legal & Risk involved on anything with a lawful-basis questio
Know where a number came from and what feeds it. Without lineage, you cannot answer the two
questions that matter during an incident: what broke upstream, and what downstream is now wrong.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Let two systems each claim to be the source of truth for the same fact.
diff --git a/plugins/data-analytics/skills/data-governance/references/sources.md b/plugins/data-analytics/skills/data-governance/references/sources.md
new file mode 100644
index 0000000..83f9e8d
--- /dev/null
+++ b/plugins/data-analytics/skills/data-governance/references/sources.md
@@ -0,0 +1,33 @@
+# Sources — `data-analytics:data-governance`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## California Consumer Privacy Act — Attorney General
+
+California Office of the Attorney General · US-CA · public domain — quote freely
+
+<https://oag.ca.gov/privacy/ccpa>
+
+**Authoritative for:** The largest US state privacy regime, and the template several other states followed. Start here before generalizing about 'US state privacy law', which is not one thing.
+
+## European Data Protection Board guidelines and recommendations
+
+EDPB · EU · free to use with attribution — credit the publisher
+
+<https://www.edpb.europa.eu/our-work-tools/general-guidance/guidelines-recommendations-best-practices_en>
+
+**Authoritative for:** How supervisory authorities actually read the GDPR — lawful basis, transfers, legitimate interest balancing — which is where a plain reading of the regulation stops being enough.
+
+## Regulation (EU) 2016/679 — GDPR
+
+Publications Office of the European Union · EU · free to use with attribution — credit the publisher
+
+<https://eur-lex.europa.eu/eli/reg/2016/679/oj>
+
+**Authoritative for:** The operative text of the GDPR. EU legal texts are reusable with attribution under the Commission's reuse decision, so this is quotable where a national summary is not.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/budgeting-and-forecasting/SKILL.md b/plugins/finance/skills/budgeting-and-forecasting/SKILL.md
index 3ebabeb..a4ea9ba 100644
--- a/plugins/finance/skills/budgeting-and-forecasting/SKILL.md
+++ b/plugins/finance/skills/budgeting-and-forecasting/SKILL.md
@@ -44,6 +44,13 @@ recurring costs compound and are constantly under-reacted to.
Explain the top few by value, not every line. A variance report covering everything gets read as
nothing.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Planning: Anaplan, Pigment, Workday Adaptive Planning, Vena, Cube, and similar. A
diff --git a/plugins/finance/skills/budgeting-and-forecasting/references/sources.md b/plugins/finance/skills/budgeting-and-forecasting/references/sources.md
new file mode 100644
index 0000000..996a124
--- /dev/null
+++ b/plugins/finance/skills/budgeting-and-forecasting/references/sources.md
@@ -0,0 +1,19 @@
+# Sources — `finance:budgeting-and-forecasting`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## FRED — Federal Reserve Economic Data
+
+Federal Reserve Bank of St. Louis · US · open data — check the terms before redistributing
+
+<https://fred.stlouisfed.org/>
+
+Machine-readable: <https://fred.stlouisfed.org/docs/api/fred/>
+
+**Authoritative for:** Reference rates, inflation series and macro indicators with a documented API — the honest input for a discount rate or an escalation assumption, in place of a remembered number.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/capital-allocation/SKILL.md b/plugins/finance/skills/capital-allocation/SKILL.md
index 2d46ea3..6aac09f 100644
--- a/plugins/finance/skills/capital-allocation/SKILL.md
+++ b/plugins/finance/skills/capital-allocation/SKILL.md
@@ -52,6 +52,13 @@ Compare realized outcomes against the approved case, and make it routine rather
nobody looks back, forecasts drift optimistic because optimism is rewarded at approval and never
tested afterwards.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Include sunk cost in a forward case.
diff --git a/plugins/finance/skills/capital-allocation/references/sources.md b/plugins/finance/skills/capital-allocation/references/sources.md
new file mode 100644
index 0000000..98c91d7
--- /dev/null
+++ b/plugins/finance/skills/capital-allocation/references/sources.md
@@ -0,0 +1,17 @@
+# Sources — `finance:capital-allocation`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Daily Treasury Par Yield Curve Rates
+
+US Department of the Treasury · US · public domain (US government) — quote freely
+
+<https://home.treasury.gov/interest-rates-data-csv-archive>
+
+**Authoritative for:** The risk-free rate by maturity, as published — the input a discount rate is built from, rather than asserted.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/chief-financial-officer/SKILL.md b/plugins/finance/skills/chief-financial-officer/SKILL.md
index 80cfe4d..bb43db3 100644
--- a/plugins/finance/skills/chief-financial-officer/SKILL.md
+++ b/plugins/finance/skills/chief-financial-officer/SKILL.md
@@ -91,6 +91,13 @@ These are the artifacts of record. Where two of them disagree, this one is right
Escalate to Chief Executive when the plan is not fundable as written; to Legal & Risk on anything touching financial reporting obligations.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
The stack a CFO is accountable for, by layer: the ledger (QuickBooks or Xero at small
diff --git a/plugins/finance/skills/chief-financial-officer/references/sources.md b/plugins/finance/skills/chief-financial-officer/references/sources.md
new file mode 100644
index 0000000..5501da3
--- /dev/null
+++ b/plugins/finance/skills/chief-financial-officer/references/sources.md
@@ -0,0 +1,25 @@
+# Sources — `finance:chief-financial-officer`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## FASB Accounting Standards Codification
+
+Financial Accounting Standards Board · US · **account required — cite it; the user fetches it**
+
+<https://asc.fasb.org/>
+
+**Authoritative for:** US GAAP as it actually reads — revenue recognition, leases, impairment. The Basic View is free with an account and the text is copyrighted: cite the ASC number, do not reproduce the wording.
+
+## Internal Revenue Bulletin
+
+US Internal Revenue Service · US · public domain (US government) — quote freely
+
+<https://www.irs.gov/irb>
+
+**Authoritative for:** The IRS's own authoritative announcements — revenue rulings, revenue procedures, notices. Where a position has to be supported rather than described, this is what supports it.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/financial-modeling/SKILL.md b/plugins/finance/skills/financial-modeling/SKILL.md
index a9c4fe1..3da13e7 100644
--- a/plugins/finance/skills/financial-modeling/SKILL.md
+++ b/plugins/finance/skills/financial-modeling/SKILL.md
@@ -69,6 +69,13 @@ Lead with the answer, then the two assumptions it rests on most heavily, then wh
Never present a model without stating what it is most sensitive to — the recipient will assume
robustness you did not claim.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Report a number to more precision than the assumptions support. Five significant figures from a
diff --git a/plugins/finance/skills/financial-modeling/references/sources.md b/plugins/finance/skills/financial-modeling/references/sources.md
new file mode 100644
index 0000000..06728bf
--- /dev/null
+++ b/plugins/finance/skills/financial-modeling/references/sources.md
@@ -0,0 +1,27 @@
+# Sources — `finance:financial-modeling`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Daily Treasury Par Yield Curve Rates
+
+US Department of the Treasury · US · public domain (US government) — quote freely
+
+<https://home.treasury.gov/interest-rates-data-csv-archive>
+
+**Authoritative for:** The risk-free rate by maturity, as published — the input a discount rate is built from, rather than asserted.
+
+## FRED — Federal Reserve Economic Data
+
+Federal Reserve Bank of St. Louis · US · open data — check the terms before redistributing
+
+<https://fred.stlouisfed.org/>
+
+Machine-readable: <https://fred.stlouisfed.org/docs/api/fred/>
+
+**Authoritative for:** Reference rates, inflation series and macro indicators with a documented API — the honest input for a discount rate or an escalation assumption, in place of a remembered number.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/financial-reporting-and-close/SKILL.md b/plugins/finance/skills/financial-reporting-and-close/SKILL.md
index 25aaef8..91c46fe 100644
--- a/plugins/finance/skills/financial-reporting-and-close/SKILL.md
+++ b/plugins/finance/skills/financial-reporting-and-close/SKILL.md
@@ -50,6 +50,13 @@ during a crisis.
Separate **timing** from **run-rate**. A miss caused by something slipping a week is a different
business fact from a miss caused by demand falling, and conflating them produces the wrong reaction.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Ledger, by scale: QuickBooks, Xero, or FreshBooks for a single entity; NetSuite, Sage
diff --git a/plugins/finance/skills/financial-reporting-and-close/references/sources.md b/plugins/finance/skills/financial-reporting-and-close/references/sources.md
new file mode 100644
index 0000000..373bb3f
--- /dev/null
+++ b/plugins/finance/skills/financial-reporting-and-close/references/sources.md
@@ -0,0 +1,35 @@
+# Sources — `finance:financial-reporting-and-close`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## EDGAR full-text search and submissions API
+
+US Securities and Exchange Commission · US · public domain (US government) — quote freely
+
+<https://www.sec.gov/edgar/search-and-access>
+
+Machine-readable: <https://www.sec.gov/search-filings/edgar-application-programming-interfaces>
+
+**Authoritative for:** What public companies actually reported, in their own filings — the primary source for a competitor's economics, a comparable's margin structure, or how a peer disclosed an accounting policy.
+
+## FASB Accounting Standards Codification
+
+Financial Accounting Standards Board · US · **account required — cite it; the user fetches it**
+
+<https://asc.fasb.org/>
+
+**Authoritative for:** US GAAP as it actually reads — revenue recognition, leases, impairment. The Basic View is free with an account and the text is copyrighted: cite the ASC number, do not reproduce the wording.
+
+## IFRS Accounting Standards
+
+IFRS Foundation · global · **account required — cite it; the user fetches it**
+
+<https://www.ifrs.org/issued-standards/list-of-standards/>
+
+**Authoritative for:** The standards outside US GAAP, and where the two diverge on a given transaction. Free access requires an account; the text is copyrighted.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/financial-statement-analysis/SKILL.md b/plugins/finance/skills/financial-statement-analysis/SKILL.md
index 080d1c9..e857193 100644
--- a/plugins/finance/skills/financial-statement-analysis/SKILL.md
+++ b/plugins/finance/skills/financial-statement-analysis/SKILL.md
@@ -72,6 +72,13 @@ then operating expense, then working capital, then financing cost. Most deterior
like a demand problem is a margin or working capital problem, and the two call for different
responses.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Present a ratio with no trend and no comparison. A number standing alone is decoration.
diff --git a/plugins/finance/skills/financial-statement-analysis/references/sources.md b/plugins/finance/skills/financial-statement-analysis/references/sources.md
new file mode 100644
index 0000000..50b35da
--- /dev/null
+++ b/plugins/finance/skills/financial-statement-analysis/references/sources.md
@@ -0,0 +1,19 @@
+# Sources — `finance:financial-statement-analysis`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## EDGAR full-text search and submissions API
+
+US Securities and Exchange Commission · US · public domain (US government) — quote freely
+
+<https://www.sec.gov/edgar/search-and-access>
+
+Machine-readable: <https://www.sec.gov/search-filings/edgar-application-programming-interfaces>
+
+**Authoritative for:** What public companies actually reported, in their own filings — the primary source for a competitor's economics, a comparable's margin structure, or how a peer disclosed an accounting policy.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/internal-controls-and-audit/SKILL.md b/plugins/finance/skills/internal-controls-and-audit/SKILL.md
index 7c0c4e9..29f2615 100644
--- a/plugins/finance/skills/internal-controls-and-audit/SKILL.md
+++ b/plugins/finance/skills/internal-controls-and-audit/SKILL.md
@@ -79,6 +79,13 @@ Related but distinct: `legal-risk:corporate-governance` owns board and entity go
`legal-risk:enterprise-risk` owns the risk framework. This skill owns controls over financial
reporting.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Sign a control matrix that describes separation the team does not actually have.
diff --git a/plugins/finance/skills/internal-controls-and-audit/references/sources.md b/plugins/finance/skills/internal-controls-and-audit/references/sources.md
new file mode 100644
index 0000000..cb16ee6
--- /dev/null
+++ b/plugins/finance/skills/internal-controls-and-audit/references/sources.md
@@ -0,0 +1,25 @@
+# Sources — `finance:internal-controls-and-audit`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## COSO Internal Control — Integrated Framework
+
+Committee of Sponsoring Organizations of the Treadway Commission · global · **sold — cite the identifier only, never the text**
+
+<https://www.coso.org/guidance-on-ic>
+
+**Authoritative for:** The internal-control framework a SOX program is organized around and an auditor expects to be named. The framework document is sold — cite the component, not the text.
+
+## PCAOB auditing standards
+
+Public Company Accounting Oversight Board · US · **read and cite only — copyrighted, do not reproduce**
+
+<https://pcaobus.org/oversight/standards/auditing-standards>
+
+**Authoritative for:** What an auditor of a public company is required to do — useful in reverse, as the definition of the evidence an internal controls program has to be able to produce.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/revenue-recognition/SKILL.md b/plugins/finance/skills/revenue-recognition/SKILL.md
index eb10da5..7af8ba8 100644
--- a/plugins/finance/skills/revenue-recognition/SKILL.md
+++ b/plugins/finance/skills/revenue-recognition/SKILL.md
@@ -54,6 +54,13 @@ The deferred balance is work owed, not money banked. Track it by cohort and obli
answer what it is composed of and when it releases. A balance nobody can decompose is one that
surprises you.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Subledgers that carry recognition schedules: NetSuite Advanced Revenue Management, Zuora
diff --git a/plugins/finance/skills/revenue-recognition/references/sources.md b/plugins/finance/skills/revenue-recognition/references/sources.md
new file mode 100644
index 0000000..2ce2fb4
--- /dev/null
+++ b/plugins/finance/skills/revenue-recognition/references/sources.md
@@ -0,0 +1,25 @@
+# Sources — `finance:revenue-recognition`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## FASB Accounting Standards Codification
+
+Financial Accounting Standards Board · US · **account required — cite it; the user fetches it**
+
+<https://asc.fasb.org/>
+
+**Authoritative for:** US GAAP as it actually reads — revenue recognition, leases, impairment. The Basic View is free with an account and the text is copyrighted: cite the ASC number, do not reproduce the wording.
+
+## IFRS Accounting Standards
+
+IFRS Foundation · global · **account required — cite it; the user fetches it**
+
+<https://www.ifrs.org/issued-standards/list-of-standards/>
+
+**Authoritative for:** The standards outside US GAAP, and where the two diverge on a given transaction. Free access requires an account; the text is copyrighted.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/tax/SKILL.md b/plugins/finance/skills/tax/SKILL.md
index af08b30..e58b2e4 100644
--- a/plugins/finance/skills/tax/SKILL.md
+++ b/plugins/finance/skills/tax/SKILL.md
@@ -55,6 +55,13 @@ owner, and treat it as part of `finance:financial-reporting-and-close`.
- `finance:revenue-recognition` — book and tax treatment diverge, and the difference is itself
something to track
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Assume no obligation because there is no office in a jurisdiction.
diff --git a/plugins/finance/skills/tax/references/sources.md b/plugins/finance/skills/tax/references/sources.md
new file mode 100644
index 0000000..2e40e1a
--- /dev/null
+++ b/plugins/finance/skills/tax/references/sources.md
@@ -0,0 +1,41 @@
+# Sources — `finance:tax`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Applicable Federal Rates
+
+US Internal Revenue Service · US · public domain (US government) — quote freely
+
+<https://www.irs.gov/applicable-federal-rates>
+
+**Authoritative for:** The minimum interest rate an intercompany or related-party loan must carry to avoid imputed interest, published monthly.
+
+## IRS forms, instructions and publications
+
+US Internal Revenue Service · US · public domain (US government) — quote freely
+
+<https://www.irs.gov/forms-instructions>
+
+**Authoritative for:** Current-year thresholds, rates, limits and filing mechanics. Instructions carry the numbers that change annually and that a model built last year has wrong.
+
+## Internal Revenue Bulletin
+
+US Internal Revenue Service · US · public domain (US government) — quote freely
+
+<https://www.irs.gov/irb>
+
+**Authoritative for:** The IRS's own authoritative announcements — revenue rulings, revenue procedures, notices. Where a position has to be supported rather than described, this is what supports it.
+
+## State tax agency directory
+
+Federation of Tax Administrators · US · **read and cite only — copyrighted, do not reproduce**
+
+<https://taxadmin.org/state-tax-agencies/>
+
+**Authoritative for:** Which state revenue department to ask, and its site. State tax guidance has no single open source and no consistent format — this is the index that routes the question to the body that can answer it.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/finance/skills/treasury-and-liquidity/SKILL.md b/plugins/finance/skills/treasury-and-liquidity/SKILL.md
index 2ef79e4..fe92469 100644
--- a/plugins/finance/skills/treasury-and-liquidity/SKILL.md
+++ b/plugins/finance/skills/treasury-and-liquidity/SKILL.md
@@ -52,6 +52,13 @@ Do not reach for yield with money you have a date for. The return on operating c
liquidity risk, and treasury losses of this kind are always described afterwards as conservative
investments.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Cash visibility and forecasting: Kyriba, Trovata, Tesorio, and similar. Bank portals plus
diff --git a/plugins/finance/skills/treasury-and-liquidity/references/sources.md b/plugins/finance/skills/treasury-and-liquidity/references/sources.md
new file mode 100644
index 0000000..3573f64
--- /dev/null
+++ b/plugins/finance/skills/treasury-and-liquidity/references/sources.md
@@ -0,0 +1,35 @@
+# Sources — `finance:treasury-and-liquidity`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Applicable Federal Rates
+
+US Internal Revenue Service · US · public domain (US government) — quote freely
+
+<https://www.irs.gov/applicable-federal-rates>
+
+**Authoritative for:** The minimum interest rate an intercompany or related-party loan must carry to avoid imputed interest, published monthly.
+
+## Daily Treasury Par Yield Curve Rates
+
+US Department of the Treasury · US · public domain (US government) — quote freely
+
+<https://home.treasury.gov/interest-rates-data-csv-archive>
+
+**Authoritative for:** The risk-free rate by maturity, as published — the input a discount rate is built from, rather than asserted.
+
+## FRED — Federal Reserve Economic Data
+
+Federal Reserve Bank of St. Louis · US · open data — check the terms before redistributing
+
+<https://fred.stlouisfed.org/>
+
+Machine-readable: <https://fred.stlouisfed.org/docs/api/fred/>
+
+**Authoritative for:** Reference rates, inflation series and macro indicators with a documented API — the honest input for a discount rate or an escalation assumption, in place of a remembered number.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/legal-risk/skills/chief-legal-and-risk-officer/SKILL.md b/plugins/legal-risk/skills/chief-legal-and-risk-officer/SKILL.md
index eb64846..3bc1886 100644
--- a/plugins/legal-risk/skills/chief-legal-and-risk-officer/SKILL.md
+++ b/plugins/legal-risk/skills/chief-legal-and-risk-officer/SKILL.md
@@ -94,6 +94,13 @@ broadly is exactly the instinct that destroys the protection.
Escalate to Chief Executive when a risk can only be accepted at the top; risk acceptance is never implicit.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Never let an unreviewed obligation reach signature
diff --git a/plugins/legal-risk/skills/chief-legal-and-risk-officer/references/sources.md b/plugins/legal-risk/skills/chief-legal-and-risk-officer/references/sources.md
new file mode 100644
index 0000000..a542c32
--- /dev/null
+++ b/plugins/legal-risk/skills/chief-legal-and-risk-officer/references/sources.md
@@ -0,0 +1,35 @@
+# Sources — `legal-risk:chief-legal-and-risk-officer`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Electronic Code of Federal Regulations
+
+US Government Publishing Office / NARA · US · public domain (US government) — quote freely
+
+<https://www.ecfr.gov/>
+
+Machine-readable: <https://www.ecfr.gov/developers/documentation/api/v1>
+
+**Authoritative for:** The current text of US federal regulation, updated daily. This is the citation of record — an agency web page summarizing its own rule is not.
+
+## Legal Information Institute
+
+Cornell Law School · US · **read and cite only — copyrighted, do not reproduce**
+
+<https://www.law.cornell.edu/>
+
+**Authoritative for:** Finding the right provision fast, with plain-language context around it. The underlying law is public domain; LII's annotations and commentary are not — follow through to the primary source before citing.
+
+## United States Code
+
+Office of the Law Revision Counsel, US House of Representatives · US · public domain (US government) — quote freely
+
+<https://uscode.house.gov/>
+
+**Authoritative for:** The consolidated text of US federal statute, where a regulation's authority is traced back to the law that permits it.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/legal-risk/skills/contract-review/SKILL.md b/plugins/legal-risk/skills/contract-review/SKILL.md
index 6ee8394..0970d0d 100644
--- a/plugins/legal-risk/skills/contract-review/SKILL.md
+++ b/plugins/legal-risk/skills/contract-review/SKILL.md
@@ -44,6 +44,13 @@ with pre-approved fallbacks, thresholds below which the business signs without r
escalation path. Review every contract personally and you become the bottleneck the process was
meant to prevent.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Contract lifecycle management: Ironclad, Icertis, Agiloft, DocuSign CLM, LinkSquares, and
diff --git a/plugins/legal-risk/skills/contract-review/references/sources.md b/plugins/legal-risk/skills/contract-review/references/sources.md
new file mode 100644
index 0000000..144dce8
--- /dev/null
+++ b/plugins/legal-risk/skills/contract-review/references/sources.md
@@ -0,0 +1,17 @@
+# Sources — `legal-risk:contract-review`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Legal Information Institute
+
+Cornell Law School · US · **read and cite only — copyrighted, do not reproduce**
+
+<https://www.law.cornell.edu/>
+
+**Authoritative for:** Finding the right provision fast, with plain-language context around it. The underlying law is public domain; LII's annotations and commentary are not — follow through to the primary source before citing.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/legal-risk/skills/enterprise-risk/SKILL.md b/plugins/legal-risk/skills/enterprise-risk/SKILL.md
index 1d673c5..67cfd24 100644
--- a/plugins/legal-risk/skills/enterprise-risk/SKILL.md
+++ b/plugins/legal-risk/skills/enterprise-risk/SKILL.md
@@ -54,6 +54,13 @@ Leadership needs the few risks whose residual exposure is above appetite, what i
what needs a decision. Not the whole register. A risk report that requires reading forty rows to
find the three that matter will not be read.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
A risk register is a table, and for most organizations a spreadsheet or a database in
diff --git a/plugins/legal-risk/skills/enterprise-risk/references/sources.md b/plugins/legal-risk/skills/enterprise-risk/references/sources.md
new file mode 100644
index 0000000..daebc4e
--- /dev/null
+++ b/plugins/legal-risk/skills/enterprise-risk/references/sources.md
@@ -0,0 +1,17 @@
+# Sources — `legal-risk:enterprise-risk`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## COSO Internal Control — Integrated Framework
+
+Committee of Sponsoring Organizations of the Treadway Commission · global · **sold — cite the identifier only, never the text**
+
+<https://www.coso.org/guidance-on-ic>
+
+**Authoritative for:** The internal-control framework a SOX program is organized around and an auditor expects to be named. The framework document is sold — cite the component, not the text.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/legal-risk/skills/intellectual-property/SKILL.md b/plugins/legal-risk/skills/intellectual-property/SKILL.md
index 7afdebe..2a0d005 100644
--- a/plugins/legal-risk/skills/intellectual-property/SKILL.md
+++ b/plugins/legal-risk/skills/intellectual-property/SKILL.md
@@ -76,6 +76,13 @@ Do not reply substantively before counsel sees it, do not admit anything, and pr
a claim letter triggers a preservation obligation immediately. Check whether insurance responds,
and check the indemnity you may hold from a supplier whose component is the actual subject.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Adopt a name on the strength of domain availability.
diff --git a/plugins/legal-risk/skills/intellectual-property/references/sources.md b/plugins/legal-risk/skills/intellectual-property/references/sources.md
new file mode 100644
index 0000000..3d7bf4a
--- /dev/null
+++ b/plugins/legal-risk/skills/intellectual-property/references/sources.md
@@ -0,0 +1,29 @@
+# Sources — `legal-risk:intellectual-property`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## SPDX License List
+
+The Linux Foundation · global · CC BY — quote with attribution
+
+<https://spdx.org/licenses/>
+
+Machine-readable: <https://github.com/spdx/license-list-data>
+
+**Authoritative for:** The canonical identifier and full text of every common open-source license — the reference for an inbound license review, and for what a share-alike obligation actually says.
+
+## USPTO search and guidance
+
+US Patent and Trademark Office · US · public domain (US government) — quote freely
+
+<https://www.uspto.gov/>
+
+Machine-readable: <https://developer.uspto.gov/>
+
+**Authoritative for:** Whether a mark or an invention is already claimed, and the examination standards a filing will be judged against.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/legal-risk/skills/privacy-and-data-protection/SKILL.md b/plugins/legal-risk/skills/privacy-and-data-protection/SKILL.md
index 45e9551..f47c0ad 100644
--- a/plugins/legal-risk/skills/privacy-and-data-protection/SKILL.md
+++ b/plugins/legal-risk/skills/privacy-and-data-protection/SKILL.md
@@ -56,6 +56,13 @@ data is located across systems, and the deadline. Locating the data is the part
For breaches, know your notification clock before you need it — several regimes measure it in hours
from awareness. Decide in advance who determines that awareness has occurred.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Collect data because it may be useful later. Purpose first, then collection.
diff --git a/plugins/legal-risk/skills/privacy-and-data-protection/references/sources.md b/plugins/legal-risk/skills/privacy-and-data-protection/references/sources.md
new file mode 100644
index 0000000..0595ea4
--- /dev/null
+++ b/plugins/legal-risk/skills/privacy-and-data-protection/references/sources.md
@@ -0,0 +1,33 @@
+# Sources — `legal-risk:privacy-and-data-protection`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## California Consumer Privacy Act — Attorney General
+
+California Office of the Attorney General · US-CA · public domain — quote freely
+
+<https://oag.ca.gov/privacy/ccpa>
+
+**Authoritative for:** The largest US state privacy regime, and the template several other states followed. Start here before generalizing about 'US state privacy law', which is not one thing.
+
+## European Data Protection Board guidelines and recommendations
+
+EDPB · EU · free to use with attribution — credit the publisher
+
+<https://www.edpb.europa.eu/our-work-tools/general-guidance/guidelines-recommendations-best-practices_en>
+
+**Authoritative for:** How supervisory authorities actually read the GDPR — lawful basis, transfers, legitimate interest balancing — which is where a plain reading of the regulation stops being enough.
+
+## Regulation (EU) 2016/679 — GDPR
+
+Publications Office of the European Union · EU · free to use with attribution — credit the publisher
+
+<https://eur-lex.europa.eu/eli/reg/2016/679/oj>
+
+**Authoritative for:** The operative text of the GDPR. EU legal texts are reusable with attribution under the Commission's reuse decision, so this is quotable where a national summary is not.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/legal-risk/skills/regulatory-compliance/SKILL.md b/plugins/legal-risk/skills/regulatory-compliance/SKILL.md
index 9332645..f500cc6 100644
--- a/plugins/legal-risk/skills/regulatory-compliance/SKILL.md
+++ b/plugins/legal-risk/skills/regulatory-compliance/SKILL.md
@@ -58,6 +58,13 @@ conversation become an undocumented commitment.
Findings get root-caused like any other failure. A remediation that consists of retraining people on
a process that made the failure easy will produce the same finding next cycle.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Compliance automation — Vanta, Drata, Secureframe, Keel GRC, and similar — collects
diff --git a/plugins/legal-risk/skills/regulatory-compliance/references/sources.md b/plugins/legal-risk/skills/regulatory-compliance/references/sources.md
new file mode 100644
index 0000000..278b3e2
--- /dev/null
+++ b/plugins/legal-risk/skills/regulatory-compliance/references/sources.md
@@ -0,0 +1,87 @@
+# Sources — `legal-risk:regulatory-compliance`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Electronic Code of Federal Regulations
+
+US Government Publishing Office / NARA · US · public domain (US government) — quote freely
+
+<https://www.ecfr.gov/>
+
+Machine-readable: <https://www.ecfr.gov/developers/documentation/api/v1>
+
+**Authoritative for:** The current text of US federal regulation, updated daily. This is the citation of record — an agency web page summarizing its own rule is not.
+
+## FedRAMP baselines and automation content
+
+GSA · US · public domain (US government) — quote freely
+
+<https://www.fedramp.gov/rev5/documents-templates/>
+
+Machine-readable: <https://github.com/GSA/fedramp-automation>
+
+**Authoritative for:** Which SP 800-53 controls apply at low, moderate and high impact for a cloud service selling to the US federal government, and the evidence each requires.
+
+## ISO/IEC 27001 — Information security management systems
+
+ISO · global · **sold — cite the identifier only, never the text**
+
+<https://www.iso.org/standard/27001>
+
+**Authoritative for:** The certifiable ISMS standard enterprise buyers ask for by name. The text is sold, not published — cite the clause number, never the wording.
+
+## Legal Information Institute
+
+Cornell Law School · US · **read and cite only — copyrighted, do not reproduce**
+
+<https://www.law.cornell.edu/>
+
+**Authoritative for:** Finding the right provision fast, with plain-language context around it. The underlying law is public domain; LII's annotations and commentary are not — follow through to the primary source before citing.
+
+## OSHA law and regulations
+
+US Occupational Safety and Health Administration · US · public domain (US government) — quote freely
+
+<https://www.osha.gov/laws-regs>
+
+**Authoritative for:** Workplace safety obligation, recordkeeping requirements and the reporting windows for a fatality or serious injury.
+
+## Regulation (EU) 2016/679 — GDPR
+
+Publications Office of the European Union · EU · free to use with attribution — credit the publisher
+
+<https://eur-lex.europa.eu/eli/reg/2016/679/oj>
+
+**Authoritative for:** The operative text of the GDPR. EU legal texts are reusable with attribution under the Commission's reuse decision, so this is quotable where a national summary is not.
+
+## SANS Information Security Policy Templates
+
+SANS Institute · global · **read and cite only — copyrighted, do not reproduce**
+
+<https://www.sans.org/information-security-policy/>
+
+**Authoritative for:** Starting-point policy language for the policies an auditor expects to exist. Read and adapt; the templates are copyrighted and are not open-licensed.
+
+## United States Code
+
+Office of the Law Revision Counsel, US House of Representatives · US · public domain (US government) — quote freely
+
+<https://uscode.house.gov/>
+
+**Authoritative for:** The consolidated text of US federal statute, where a regulation's authority is traced back to the law that permits it.
+
+## govinfo
+
+US Government Publishing Office · US · public domain (US government) — quote freely
+
+<https://www.govinfo.gov/>
+
+Machine-readable: <https://api.govinfo.gov/docs/>
+
+**Authoritative for:** Authenticated federal documents — the Federal Register, bills, the Congressional Record — when the question is what was actually published and when.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/operations/skills/business-continuity-and-resilience/SKILL.md b/plugins/operations/skills/business-continuity-and-resilience/SKILL.md
index 6723f2d..d649ed3 100644
--- a/plugins/operations/skills/business-continuity-and-resilience/SKILL.md
+++ b/plugins/operations/skills/business-continuity-and-resilience/SKILL.md
@@ -53,6 +53,13 @@ region, redundant network paths in the same physical duct, a manual workaround t
system you have just lost. Map dependencies to the point where they stop being yours, and check
whether the redundancy is real or just contractual.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Continuity and crisis management platforms: Fusion Framework, Castellan, Riskonnect, and similar.
diff --git a/plugins/operations/skills/business-continuity-and-resilience/references/sources.md b/plugins/operations/skills/business-continuity-and-resilience/references/sources.md
new file mode 100644
index 0000000..298cda6
--- /dev/null
+++ b/plugins/operations/skills/business-continuity-and-resilience/references/sources.md
@@ -0,0 +1,17 @@
+# Sources — `operations:business-continuity-and-resilience`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## OSHA law and regulations
+
+US Occupational Safety and Health Administration · US · public domain (US government) — quote freely
+
+<https://www.osha.gov/laws-regs>
+
+**Authoritative for:** Workplace safety obligation, recordkeeping requirements and the reporting windows for a fatality or serious injury.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/people/skills/chief-human-resources-officer/SKILL.md b/plugins/people/skills/chief-human-resources-officer/SKILL.md
index e889a16..eb85ec8 100644
--- a/plugins/people/skills/chief-human-resources-officer/SKILL.md
+++ b/plugins/people/skills/chief-human-resources-officer/SKILL.md
@@ -95,6 +95,13 @@ These are the artifacts of record. Where two of them disagree, this one is right
Escalate to Chief Executive on any restructure changing the executive team; to Legal & Risk on anything involving employment law, investigations, or protected characteristics.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Never resolve an employee-relations matter without documenting it
diff --git a/plugins/people/skills/chief-human-resources-officer/references/sources.md b/plugins/people/skills/chief-human-resources-officer/references/sources.md
new file mode 100644
index 0000000..c4cfc51
--- /dev/null
+++ b/plugins/people/skills/chief-human-resources-officer/references/sources.md
@@ -0,0 +1,17 @@
+# Sources — `people:chief-human-resources-officer`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Wage and Hour Division
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd>
+
+**Authoritative for:** Federal wage and hour obligation — overtime, the regular rate, exemption tests, child labor, family and medical leave — including the fact sheets and opinion letters the agency itself enforces against.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/people/skills/compensation-and-leveling/SKILL.md b/plugins/people/skills/compensation-and-leveling/SKILL.md
index ca87c49..8921c1d 100644
--- a/plugins/people/skills/compensation-and-leveling/SKILL.md
+++ b/plugins/people/skills/compensation-and-leveling/SKILL.md
@@ -54,6 +54,13 @@ cycle. Findings here need qualified review before action.
counteroffer is right, it should reflect a correction you should have already made.
- Every exception is a precedent. Document the reasoning, because you will be asked to repeat it.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Benchmark data is the purchase that matters, and it is where the scale tier is real: free and
diff --git a/plugins/people/skills/compensation-and-leveling/references/sources.md b/plugins/people/skills/compensation-and-leveling/references/sources.md
new file mode 100644
index 0000000..e93273f
--- /dev/null
+++ b/plugins/people/skills/compensation-and-leveling/references/sources.md
@@ -0,0 +1,17 @@
+# Sources — `people:compensation-and-leveling`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Consolidated State Minimum Wage and Overtime tables
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd/state/minimum-wage/history>
+
+**Authoritative for:** State-by-state minimum wage and state overtime rules in one maintained table, where the binding figure is whichever of state or federal is higher.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/people/skills/employee-relations/SKILL.md b/plugins/people/skills/employee-relations/SKILL.md
index 5579e1c..fcb85e6 100644
--- a/plugins/people/skills/employee-relations/SKILL.md
+++ b/plugins/people/skills/employee-relations/SKILL.md
@@ -57,6 +57,13 @@ have been treated. Inconsistency is the single most common source of successful
The people who remain draw conclusions from how leavers are treated, and those conclusions are
durable.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Promise confidentiality you cannot keep.
diff --git a/plugins/people/skills/employee-relations/references/sources.md b/plugins/people/skills/employee-relations/references/sources.md
new file mode 100644
index 0000000..7c6e888
--- /dev/null
+++ b/plugins/people/skills/employee-relations/references/sources.md
@@ -0,0 +1,25 @@
+# Sources — `people:employee-relations`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## EEOC Laws, Regulations, Guidance and MOUs
+
+US Equal Employment Opportunity Commission · US · public domain (US government) — quote freely
+
+<https://www.eeoc.gov/laws-guidance>
+
+**Authoritative for:** Federal anti-discrimination obligation as the agency that enforces it reads it — including guidance on selection procedures, accommodation, and automated decision tools in hiring.
+
+## National Labor Relations Board — decisions and guidance
+
+NLRB · US · public domain (US government) — quote freely
+
+<https://www.nlrb.gov/cases-decisions>
+
+**Authoritative for:** What counts as protected concerted activity and as an unfair labor practice, for represented and unrepresented workforces alike.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/people/skills/employment-compliance/SKILL.md b/plugins/people/skills/employment-compliance/SKILL.md
index 3371cb8..cbc2be9 100644
--- a/plugins/people/skills/employment-compliance/SKILL.md
+++ b/plugins/people/skills/employment-compliance/SKILL.md
@@ -66,6 +66,13 @@ them are checked first in a dispute, because they are the cheapest thing to chec
Set retention by the longest applicable requirement, and suspend disposal entirely when litigation
or an investigation is reasonably anticipated.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Classify a role by title, by what the person prefers, or by what the last company did.
diff --git a/plugins/people/skills/employment-compliance/references/sources.md b/plugins/people/skills/employment-compliance/references/sources.md
new file mode 100644
index 0000000..d065625
--- /dev/null
+++ b/plugins/people/skills/employment-compliance/references/sources.md
@@ -0,0 +1,49 @@
+# Sources — `people:employment-compliance`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Consolidated State Minimum Wage and Overtime tables
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd/state/minimum-wage/history>
+
+**Authoritative for:** State-by-state minimum wage and state overtime rules in one maintained table, where the binding figure is whichever of state or federal is higher.
+
+## EEOC Laws, Regulations, Guidance and MOUs
+
+US Equal Employment Opportunity Commission · US · public domain (US government) — quote freely
+
+<https://www.eeoc.gov/laws-guidance>
+
+**Authoritative for:** Federal anti-discrimination obligation as the agency that enforces it reads it — including guidance on selection procedures, accommodation, and automated decision tools in hiring.
+
+## National Labor Relations Board — decisions and guidance
+
+NLRB · US · public domain (US government) — quote freely
+
+<https://www.nlrb.gov/cases-decisions>
+
+**Authoritative for:** What counts as protected concerted activity and as an unfair labor practice, for represented and unrepresented workforces alike.
+
+## State Labor Offices directory
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd/state/contacts>
+
+**Authoritative for:** Which state agency to ask, and its site, when an employment question turns on state rather than federal law. There is no single open source for fifty states — this is the index that gets you to the right one.
+
+## Wage and Hour Division
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd>
+
+**Authoritative for:** Federal wage and hour obligation — overtime, the regular rate, exemption tests, child labor, family and medical leave — including the fact sheets and opinion letters the agency itself enforces against.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/people/skills/hiring-and-interviewing/SKILL.md b/plugins/people/skills/hiring-and-interviewing/SKILL.md
index e47d804..ec9f838 100644
--- a/plugins/people/skills/hiring-and-interviewing/SKILL.md
+++ b/plugins/people/skills/hiring-and-interviewing/SKILL.md
@@ -50,6 +50,13 @@ is missing, get it — an extra conversation is cheap compared to a mis-hire.
Ambiguity means no. The cost of a bad hire is far larger and lasts far longer than the cost of a
longer search, and it is borne by the team, not the hiring manager.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Applicant tracking, roughly by scale: Workable, JazzHR or the hiring module of an all-in-one HRIS
diff --git a/plugins/people/skills/hiring-and-interviewing/references/sources.md b/plugins/people/skills/hiring-and-interviewing/references/sources.md
new file mode 100644
index 0000000..3a83ff5
--- /dev/null
+++ b/plugins/people/skills/hiring-and-interviewing/references/sources.md
@@ -0,0 +1,17 @@
+# Sources — `people:hiring-and-interviewing`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## EEOC Laws, Regulations, Guidance and MOUs
+
+US Equal Employment Opportunity Commission · US · public domain (US government) — quote freely
+
+<https://www.eeoc.gov/laws-guidance>
+
+**Authoritative for:** Federal anti-discrimination obligation as the agency that enforces it reads it — including guidance on selection procedures, accommodation, and automated decision tools in hiring.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/people/skills/payroll-operations/SKILL.md b/plugins/people/skills/payroll-operations/SKILL.md
index 7fc8e0f..2323085 100644
--- a/plugins/people/skills/payroll-operations/SKILL.md
+++ b/plugins/people/skills/payroll-operations/SKILL.md
@@ -67,6 +67,13 @@ Payroll register to general ledger, and the sum of the cycles to the annual fili
each cycle takes minutes; reconciling a year of unreconciled cycles at year-end takes weeks and
finds errors too late to correct cleanly.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Pay from a spreadsheet that has not been reconciled to the system of record.
diff --git a/plugins/people/skills/payroll-operations/references/sources.md b/plugins/people/skills/payroll-operations/references/sources.md
new file mode 100644
index 0000000..a055d71
--- /dev/null
+++ b/plugins/people/skills/payroll-operations/references/sources.md
@@ -0,0 +1,41 @@
+# Sources — `people:payroll-operations`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## Consolidated State Minimum Wage and Overtime tables
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd/state/minimum-wage/history>
+
+**Authoritative for:** State-by-state minimum wage and state overtime rules in one maintained table, where the binding figure is whichever of state or federal is higher.
+
+## IRS forms, instructions and publications
+
+US Internal Revenue Service · US · public domain (US government) — quote freely
+
+<https://www.irs.gov/forms-instructions>
+
+**Authoritative for:** Current-year thresholds, rates, limits and filing mechanics. Instructions carry the numbers that change annually and that a model built last year has wrong.
+
+## State Labor Offices directory
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd/state/contacts>
+
+**Authoritative for:** Which state agency to ask, and its site, when an employment question turns on state rather than federal law. There is no single open source for fifty states — this is the index that gets you to the right one.
+
+## Wage and Hour Division
+
+US Department of Labor · US · public domain (US government) — quote freely
+
+<https://www.dol.gov/agencies/whd>
+
+**Authoritative for:** Federal wage and hour obligation — overtime, the regular rate, exemption tests, child labor, family and medical leave — including the fact sheets and opinion letters the agency itself enforces against.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/security/skills/access-and-identity/SKILL.md b/plugins/security/skills/access-and-identity/SKILL.md
index 52e6ac6..84b8082 100644
--- a/plugins/security/skills/access-and-identity/SKILL.md
+++ b/plugins/security/skills/access-and-identity/SKILL.md
@@ -65,6 +65,13 @@ Look for: permissions granted to individuals rather than roles, roles nobody can
administrative access, accounts whose owner has left, service credentials with no owner, and systems
outside SSO. Each is a specific fix, and the list is nearly always the same list.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Identity providers: Okta, Microsoft Entra ID, Google Workspace, JumpCloud, and similar.
diff --git a/plugins/security/skills/access-and-identity/references/sources.md b/plugins/security/skills/access-and-identity/references/sources.md
new file mode 100644
index 0000000..dc9f4ba
--- /dev/null
+++ b/plugins/security/skills/access-and-identity/references/sources.md
@@ -0,0 +1,19 @@
+# Sources — `security:access-and-identity`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## NIST SP 800-53 Rev. 5 — Security and Privacy Controls for Information Systems
+
+NIST · US · public domain (US government) — quote freely
+
+<https://csrc.nist.gov/pubs/sp/800/53/r5/upd1/final>
+
+Machine-readable: <https://github.com/usnistgov/oscal-content>
+
+**Authoritative for:** The control catalog US federal systems are assessed against, and the control vocabulary FedRAMP and many private frameworks inherit.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/security/skills/chief-information-security-officer/SKILL.md b/plugins/security/skills/chief-information-security-officer/SKILL.md
index da6b0bf..cfe242f 100644
--- a/plugins/security/skills/chief-information-security-officer/SKILL.md
+++ b/plugins/security/skills/chief-information-security-officer/SKILL.md
@@ -109,6 +109,13 @@ accepting a finding this role has blocked, or when the security program is not f
exposure the business is carrying. To Legal & Risk on anything with regulatory or contractual
consequence — breach notification in particular runs on statutory clocks measured in hours.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Approve an exception without an expiry date and a named owner.
diff --git a/plugins/security/skills/chief-information-security-officer/references/sources.md b/plugins/security/skills/chief-information-security-officer/references/sources.md
new file mode 100644
index 0000000..22dcc42
--- /dev/null
+++ b/plugins/security/skills/chief-information-security-officer/references/sources.md
@@ -0,0 +1,61 @@
+# Sources — `security:chief-information-security-officer`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## CIS Critical Security Controls
+
+Center for Internet Security · global · **account required — cite it; the user fetches it**
+
+<https://www.cisecurity.org/controls>
+
+**Authoritative for:** A prioritized implementation order for a security program that has to start somewhere, with implementation groups sized to organizational maturity.
+
+## FedRAMP baselines and automation content
+
+GSA · US · public domain (US government) — quote freely
+
+<https://www.fedramp.gov/rev5/documents-templates/>
+
+Machine-readable: <https://github.com/GSA/fedramp-automation>
+
+**Authoritative for:** Which SP 800-53 controls apply at low, moderate and high impact for a cloud service selling to the US federal government, and the evidence each requires.
+
+## ISO/IEC 27001 — Information security management systems
+
+ISO · global · **sold — cite the identifier only, never the text**
+
+<https://www.iso.org/standard/27001>
+
+**Authoritative for:** The certifiable ISMS standard enterprise buyers ask for by name. The text is sold, not published — cite the clause number, never the wording.
+
+## NIST Cybersecurity Framework 2.0
+
+NIST · US · public domain (US government) — quote freely
+
+<https://www.nist.gov/cyberframework>
+
+**Authoritative for:** The outcome-based vocabulary — govern, identify, protect, detect, respond, recover — that boards and customers most often ask a security program to map to.
+
+## NIST SP 800-53 Rev. 5 — Security and Privacy Controls for Information Systems
+
+NIST · US · public domain (US government) — quote freely
+
+<https://csrc.nist.gov/pubs/sp/800/53/r5/upd1/final>
+
+Machine-readable: <https://github.com/usnistgov/oscal-content>
+
+**Authoritative for:** The control catalog US federal systems are assessed against, and the control vocabulary FedRAMP and many private frameworks inherit.
+
+## SANS Information Security Policy Templates
+
+SANS Institute · global · **read and cite only — copyrighted, do not reproduce**
+
+<https://www.sans.org/information-security-policy/>
+
+**Authoritative for:** Starting-point policy language for the policies an auditor expects to exist. Read and adapt; the templates are copyrighted and are not open-licensed.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/security/skills/incident-response/SKILL.md b/plugins/security/skills/incident-response/SKILL.md
index 4c223e9..db66804 100644
--- a/plugins/security/skills/incident-response/SKILL.md
+++ b/plugins/security/skills/incident-response/SKILL.md
@@ -66,6 +66,13 @@ The plan matters less than having run it. Exercise once a year at minimum: a tab
realistic scenario finds the gaps — who has authority out of hours, where the credentials are, who
calls counsel — at a time when finding them is free.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Rebuild or wipe a compromised host before evidence is captured.
diff --git a/plugins/security/skills/incident-response/references/sources.md b/plugins/security/skills/incident-response/references/sources.md
new file mode 100644
index 0000000..ee0811c
--- /dev/null
+++ b/plugins/security/skills/incident-response/references/sources.md
@@ -0,0 +1,29 @@
+# Sources — `security:incident-response`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## CISA Known Exploited Vulnerabilities Catalog
+
+CISA · US · public domain (US government) — quote freely
+
+<https://www.cisa.gov/known-exploited-vulnerabilities-catalog>
+
+Machine-readable: <https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json>
+
+**Authoritative for:** Which vulnerabilities are being exploited in the wild right now — the only list that reliably separates patch-this-week from patch-this-quarter.
+
+## MITRE ATT&CK
+
+The MITRE Corporation · global · free to use with attribution — credit the publisher
+
+<https://attack.mitre.org/>
+
+Machine-readable: <https://github.com/mitre-attack/attack-stix-data>
+
+**Authoritative for:** The shared vocabulary for adversary tactics and techniques — what to name a behavior so a detection, a threat model and an incident report refer to the same thing.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/security/skills/security-architecture-review/SKILL.md b/plugins/security/skills/security-architecture-review/SKILL.md
index eebc24b..709050f 100644
--- a/plugins/security/skills/security-architecture-review/SKILL.md
+++ b/plugins/security/skills/security-architecture-review/SKILL.md
@@ -45,6 +45,13 @@ role can do. Everything else is usually lower yield.
**Never write your own cryptography.** Use the vetted primitives, and be suspicious of any diff that
implements a comparison, a token, or a signature by hand.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
- **SAST** catches classes of bug cheaply and produces false positives at volume. Tune it or the
diff --git a/plugins/security/skills/security-architecture-review/references/sources.md b/plugins/security/skills/security-architecture-review/references/sources.md
new file mode 100644
index 0000000..2a68516
--- /dev/null
+++ b/plugins/security/skills/security-architecture-review/references/sources.md
@@ -0,0 +1,63 @@
+# Sources — `security:security-architecture-review`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## FedRAMP baselines and automation content
+
+GSA · US · public domain (US government) — quote freely
+
+<https://www.fedramp.gov/rev5/documents-templates/>
+
+Machine-readable: <https://github.com/GSA/fedramp-automation>
+
+**Authoritative for:** Which SP 800-53 controls apply at low, moderate and high impact for a cloud service selling to the US federal government, and the evidence each requires.
+
+## MITRE ATT&CK
+
+The MITRE Corporation · global · free to use with attribution — credit the publisher
+
+<https://attack.mitre.org/>
+
+Machine-readable: <https://github.com/mitre-attack/attack-stix-data>
+
+**Authoritative for:** The shared vocabulary for adversary tactics and techniques — what to name a behavior so a detection, a threat model and an incident report refer to the same thing.
+
+## NIST Cybersecurity Framework 2.0
+
+NIST · US · public domain (US government) — quote freely
+
+<https://www.nist.gov/cyberframework>
+
+**Authoritative for:** The outcome-based vocabulary — govern, identify, protect, detect, respond, recover — that boards and customers most often ask a security program to map to.
+
+## NIST SP 800-53 Rev. 5 — Security and Privacy Controls for Information Systems
+
+NIST · US · public domain (US government) — quote freely
+
+<https://csrc.nist.gov/pubs/sp/800/53/r5/upd1/final>
+
+Machine-readable: <https://github.com/usnistgov/oscal-content>
+
+**Authoritative for:** The control catalog US federal systems are assessed against, and the control vocabulary FedRAMP and many private frameworks inherit.
+
+## OWASP Application Security Verification Standard
+
+OWASP Foundation · global · CC BY-SA — quote with attribution; share-alike, so do not fold into this repository
+
+<https://owasp.org/ASVS/>
+
+**Authoritative for:** Testable application security requirements at three assurance levels — the thing to write into a spec when 'make it secure' needs to become acceptance criteria.
+
+## OWASP Top 10
+
+OWASP Foundation · global · CC BY-SA — quote with attribution; share-alike, so do not fold into this repository
+
+<https://owasp.org/www-project-top-ten/>
+
+**Authoritative for:** The application-security risk categories a customer questionnaire or a pen-test report will be organized around.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/security/skills/threat-modeling/SKILL.md b/plugins/security/skills/threat-modeling/SKILL.md
index 44bf0d3..5503fd9 100644
--- a/plugins/security/skills/threat-modeling/SKILL.md
+++ b/plugins/security/skills/threat-modeling/SKILL.md
@@ -49,6 +49,13 @@ vague to act on.
Timebox it. An hour on a specific feature with the engineers who will build it beats a week-long
exercise producing a document nobody reads.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Never
- Model the system as designed rather than as built. Ask what actually got shipped.
diff --git a/plugins/security/skills/threat-modeling/references/sources.md b/plugins/security/skills/threat-modeling/references/sources.md
new file mode 100644
index 0000000..5199c5f
--- /dev/null
+++ b/plugins/security/skills/threat-modeling/references/sources.md
@@ -0,0 +1,27 @@
+# Sources — `security:threat-modeling`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## MITRE ATT&CK
+
+The MITRE Corporation · global · free to use with attribution — credit the publisher
+
+<https://attack.mitre.org/>
+
+Machine-readable: <https://github.com/mitre-attack/attack-stix-data>
+
+**Authoritative for:** The shared vocabulary for adversary tactics and techniques — what to name a behavior so a detection, a threat model and an incident report refer to the same thing.
+
+## OWASP Top 10
+
+OWASP Foundation · global · CC BY-SA — quote with attribution; share-alike, so do not fold into this repository
+
+<https://owasp.org/www-project-top-ten/>
+
+**Authoritative for:** The application-security risk categories a customer questionnaire or a pen-test report will be organized around.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/security/skills/vulnerability-management/SKILL.md b/plugins/security/skills/vulnerability-management/SKILL.md
index 7666c9c..72d7be7 100644
--- a/plugins/security/skills/vulnerability-management/SKILL.md
+++ b/plugins/security/skills/vulnerability-management/SKILL.md
@@ -67,6 +67,13 @@ good-faith reporter as an adversary is how a private report becomes a public one
Leadership needs: what is exposed and unfixed past SLA, the trend, and what needs a decision. Not
the count of findings, which mostly measures how much you scanned.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Infrastructure scanning: Tenable, Qualys, Rapid7 InsightVM, and similar. Code and
diff --git a/plugins/security/skills/vulnerability-management/references/sources.md b/plugins/security/skills/vulnerability-management/references/sources.md
new file mode 100644
index 0000000..816ced6
--- /dev/null
+++ b/plugins/security/skills/vulnerability-management/references/sources.md
@@ -0,0 +1,29 @@
+# Sources — `security:vulnerability-management`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## CISA Known Exploited Vulnerabilities Catalog
+
+CISA · US · public domain (US government) — quote freely
+
+<https://www.cisa.gov/known-exploited-vulnerabilities-catalog>
+
+Machine-readable: <https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json>
+
+**Authoritative for:** Which vulnerabilities are being exploited in the wild right now — the only list that reliably separates patch-this-week from patch-this-quarter.
+
+## National Vulnerability Database
+
+NIST · US · public domain (US government) — quote freely
+
+<https://nvd.nist.gov/>
+
+Machine-readable: <https://nvd.nist.gov/developers/vulnerabilities>
+
+**Authoritative for:** CVE records with severity scoring and affected-version data, and the API a vulnerability program queries rather than reads.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/plugins/technology/skills/release-and-deployment/SKILL.md b/plugins/technology/skills/release-and-deployment/SKILL.md
index de25454..afe61fb 100644
--- a/plugins/technology/skills/release-and-deployment/SKILL.md
+++ b/plugins/technology/skills/release-and-deployment/SKILL.md
@@ -50,6 +50,13 @@ of both shapes throughout.
Test the migration against production-scale data. A migration that is instant on a development
dataset can lock a large table for a length of time nobody modeled.
+## Sources
+
+`references/sources.md` in this skill lists the outside authorities that settle the questions
+here — what each one is authoritative for, and what you may do with it. Check them before
+answering on anything they cover, and cite what you used. Most are free to read and not free
+to reproduce; the use note on each is binding.
+
## Tooling
Pipelines: GitHub Actions, GitLab CI, CircleCI, Buildkite, Jenkins, and similar.
diff --git a/plugins/technology/skills/release-and-deployment/references/sources.md b/plugins/technology/skills/release-and-deployment/references/sources.md
new file mode 100644
index 0000000..cf19726
--- /dev/null
+++ b/plugins/technology/skills/release-and-deployment/references/sources.md
@@ -0,0 +1,19 @@
+# Sources — `technology:release-and-deployment`
+
+<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
+
+Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
+
+## SPDX License List
+
+The Linux Foundation · global · CC BY — quote with attribution
+
+<https://spdx.org/licenses/>
+
+Machine-readable: <https://github.com/spdx/license-list-data>
+
+**Authoritative for:** The canonical identifier and full text of every common open-source license — the reference for an inbound license review, and for what a share-alike obligation actually says.
+
+---
+
+Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
diff --git a/scripts/build-sources.py b/scripts/build-sources.py
new file mode 100755
index 0000000..c2bf3d2
--- /dev/null
+++ b/scripts/build-sources.py
@@ -0,0 +1,128 @@
+#!/usr/bin/env python3
+"""Emit each skill's sources into its own `references/sources.md`.
+
+A catalog nothing reads is a bibliography. Claude Code and ChatGPT both load a skill's
+`references/` files on demand, so putting each skill's sources there is what turns the catalog into
+something an agent consults at the moment it is answering — without spending context on sources for
+the other 171 skills.
+
+Generated, never hand-edited: `--check` fails the build when a file drifts from the catalog.
+"""
+import argparse
+import collections
+import glob
+import os
+import sys
+
+BANNER = "<!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->"
+
+# What an agent is allowed to do with each class, stated where it will be read rather than only in
+# sources/README.md. The wording is deliberately blunt: the failure this prevents is an agent
+# reproducing a standard it was only ever allowed to cite.
+USE = {
+ "public-domain-usgov": "public domain (US government) — quote freely",
+ "public-domain": "public domain — quote freely",
+ "cc0": "CC0 — quote freely",
+ "cc-by": "CC BY — quote with attribution",
+ "cc-by-sa": "CC BY-SA — quote with attribution; share-alike, so do not fold into this repository",
+ "attribution-required": "free to use with attribution — credit the publisher",
+ "open-data": "open data — check the terms before redistributing",
+ "free-to-read": "**read and cite only — copyrighted, do not reproduce**",
+ "registration-required": "**account required — cite it; the user fetches it**",
+ "paywalled": "**sold — cite the identifier only, never the text**",
+}
+
+
+def load_catalog():
+ """Reuse the checker's loader so the two cannot read the catalog differently."""
+ import importlib.util
+ path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "check-sources.py")
+ spec = importlib.util.spec_from_file_location("check_sources", path)
+ module = importlib.util.module_from_spec(spec)
+ spec.loader.exec_module(module)
+ return module.load()
+
+
+def render(skill_ref, entries):
+ department, skill = skill_ref.split(":")
+ lines = [
+ f"# Sources — `{skill_ref}`",
+ "",
+ BANNER,
+ "",
+ "Check these before answering on anything they cover, and cite what you used. The use note "
+ "on each one is binding: most of what a professional cites is free to read and not free to "
+ "reproduce.",
+ "",
+ ]
+ for entry in sorted(entries, key=lambda e: e["title"]):
+ lines += [
+ f"## {entry['title']}",
+ "",
+ f"{entry['publisher']} · {entry['jurisdiction']} · {USE[entry['license']]}",
+ "",
+ f"<{entry['url']}>",
+ ]
+ if entry.get("data"):
+ lines += ["", f"Machine-readable: <{entry['data']}>"]
+ lines += ["", f"**Authoritative for:** {entry['authoritative_for']}", ""]
+ lines += [
+ "---",
+ "",
+ "Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or "
+ "missing, fix it there — this file is regenerated and an edit to it is lost.",
+ "",
+ ]
+ return "\n".join(lines)
+
+
+def targets():
+ """The file each skill's sources belong in, and what goes in it."""
+ by_skill = collections.defaultdict(list)
+ for _, entry in load_catalog():
+ for ref in entry.get("skills", []):
+ by_skill[ref].append(entry)
+ out = {}
+ for ref, entries in by_skill.items():
+ department, skill = ref.split(":")
+ out[f"plugins/{department}/skills/{skill}/references/sources.md"] = render(ref, entries)
+ return out
+
+
+def main():
+ parser = argparse.ArgumentParser(description=__doc__)
+ parser.add_argument("--check", action="store_true", help="report drift instead of writing")
+ args = parser.parse_args()
+
+ wanted = targets()
+ # A skill that loses its last source must lose the file too, or the catalog and the tree
+ # disagree in the one direction a content comparison cannot see.
+ existing = {p for p in glob.glob("plugins/*/skills/*/references/sources.md")}
+ stale = sorted(existing - set(wanted))
+
+ if args.check:
+ drifted = [p for p, text in sorted(wanted.items())
+ if not os.path.exists(p) or open(p, encoding="utf-8").read() != text]
+ for path in drifted:
+ print(f" stale or missing: {path}")
+ for path in stale:
+ print(f" no longer in the catalog: {path}")
+ problems = len(drifted) + len(stale)
+ if problems:
+ print(" run: python3 scripts/build-sources.py")
+ print(f"skill source files: {len(wanted)} expected, {problems} out of date")
+ return 1 if problems else 0
+
+ for path, text in sorted(wanted.items()):
+ os.makedirs(os.path.dirname(path), exist_ok=True)
+ with open(path, "w", encoding="utf-8") as handle:
+ handle.write(text)
+ for path in stale:
+ os.remove(path)
+ print(f"sources: {len(wanted)} skill reference file(s) written"
+ + (f", {len(stale)} removed" if stale else ""))
+ return 0
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/scripts/check-all.sh b/scripts/check-all.sh
index 7c3db2d..329526c 100755
--- a/scripts/check-all.sh
+++ b/scripts/check-all.sh
@@ -35,6 +35,10 @@ run "US English spelling" \
python3 scripts/check-us-english.py
run "Never blocks are internally consistent" \
python3 scripts/check-never-blocks.py
+run "Source catalog is valid" \
+ python3 scripts/check-sources.py
+run "Skill source files are current" \
+ python3 scripts/build-sources.py --check
run "Verticals emit and pass their own checks" \
python3 scripts/build-vertical.py --all --verify
run "Manifests parse" \
diff --git a/scripts/check-provenance.py b/scripts/check-provenance.py
index 81bb25a..32ffe8c 100755
--- a/scripts/check-provenance.py
+++ b/scripts/check-provenance.py
@@ -41,6 +41,20 @@ OWN_LICENSE = "LICENSE" # ours, and the only one expected
OWN_LICENSE_MENTION = {"CONTRIBUTING.md", "README.md", "docs/DECISION-LOG.md"}
OWN_LICENSE_PATTERN = r"\bMIT License\b"
+# The source catalog classifies outside material by its license, so naming license families is its
+# job rather than evidence of carrying any. The waiver is for the family *names* only, in the files
+# that document the vocabulary and the agent that maintains it — every other pattern still applies,
+# so actual license text remains caught by its body ("Permission is hereby granted", "Copyright
+# (c)", "Redistribution and use..."), which no real license lacks. This is the same reasoning as the
+# MIT waiver above: a name is a reference, a body is a copy.
+#
+# The catalog itself holds no license names to waive — entries carry a short slug (`cc-by-sa`) and
+# never the family's prose name — so the waiver deliberately does not extend to `sources/*.toml`.
+LICENSE_FAMILY_MENTION = {"sources/README.md", ".claude/agents/sources.md"}
+LICENSE_FAMILY_PATTERNS = {r"\bCreative Commons Attribution\b", r"\bMIT License\b",
+ r"\bApache License\b", r"\bBSD \d-Clause\b",
+ r"\bMozilla Public License\b"}
+
# Generated output and build byproducts are not this repository's content. `dist/` in particular
# is a copy of the tree already being checked, so scanning it doubles every finding.
SKIP_DIRS = (".git/", "dist/", "__pycache__/")
@@ -82,9 +96,11 @@ for path in glob.glob("**/*", recursive=True):
if not is_probably_text(path):
continue
text = open(path, encoding="utf-8", errors="replace").read()
- waived = OWN_LICENSE_PATTERN if path in OWN_LICENSE_MENTION else None
+ waived = {OWN_LICENSE_PATTERN} if path in OWN_LICENSE_MENTION else set()
+ if path in LICENSE_FAMILY_MENTION:
+ waived |= LICENSE_FAMILY_PATTERNS
for pattern in PATTERNS:
- if pattern == waived:
+ if pattern in waived:
continue
if re.search(pattern, text):
problems.append(f"{path}: matches {pattern!r}")
diff --git a/scripts/check-sources.py b/scripts/check-sources.py
new file mode 100755
index 0000000..6723b39
--- /dev/null
+++ b/scripts/check-sources.py
@@ -0,0 +1,152 @@
+#!/usr/bin/env python3
+"""Validate the source catalog: structure, license vocabulary, and that every skill named exists.
+
+The catalog points agents at outside authorities. Two things make a pointer worse than none — a
+reference to a skill that no longer exists, so nothing surfaces it, and a license class that is
+wrong, so an agent reproduces text it was only allowed to read. Both are checkable here.
+
+Reachability is not checked by default. A publisher being briefly down is not a reason to fail
+somebody's pull request, so `--online` runs that separately and a scheduled workflow calls it.
+"""
+import argparse
+import datetime
+import glob
+import os
+import re
+import sys
+import tomllib
+
+# Closed vocabulary. The three at the end are the ones most often assumed open and are not, which
+# is the single most useful thing this catalog records — see sources/README.md.
+LICENSES = {
+ "public-domain-usgov", "public-domain", "cc0", "cc-by", "cc-by-sa",
+ "attribution-required", "open-data",
+ "free-to-read", "registration-required", "paywalled",
+}
+REQUIRED = ("id", "title", "publisher", "url", "license", "jurisdiction",
+ "authoritative_for", "skills", "checked")
+ID = re.compile(r"^[a-z0-9]+(-[a-z0-9]+)*$")
+SKILL_REF = re.compile(r"^([a-z][a-z0-9-]*):([a-z][a-z0-9-]*)$")
+
+
+def load():
+ """Every source in the catalog, with the file it came from."""
+ entries = []
+ for path in sorted(glob.glob("sources/*.toml")):
+ with open(path, "rb") as handle:
+ data = tomllib.load(handle)
+ for entry in data.get("source", []):
+ entries.append((path, entry))
+ return entries
+
+
+def validate(entries):
+ problems, seen = [], {}
+ for path, entry in entries:
+ where = f"{path}: {entry.get('id', '<no id>')}"
+ for field in REQUIRED:
+ if not entry.get(field):
+ problems.append(f"{where}: missing {field}")
+ if not entry.get("id"):
+ continue
+ if not ID.fullmatch(entry["id"]):
+ problems.append(f"{where}: id is not lowercase-hyphenated")
+ if entry["id"] in seen:
+ problems.append(f"{where}: duplicate id, also in {seen[entry['id']]}")
+ seen[entry["id"]] = path
+
+ if entry.get("license") and entry["license"] not in LICENSES:
+ problems.append(f"{where}: license {entry['license']!r} is not in the vocabulary — "
+ f"one of {', '.join(sorted(LICENSES))}")
+ for field in ("url", "data"):
+ value = entry.get(field)
+ if value and not value.startswith("https://"):
+ problems.append(f"{where}: {field} is not https")
+ if entry.get("checked"):
+ try:
+ datetime.date.fromisoformat(str(entry["checked"]))
+ except ValueError:
+ problems.append(f"{where}: checked is not an ISO date")
+ for ref in entry.get("skills", []):
+ match = SKILL_REF.fullmatch(ref)
+ if not match:
+ problems.append(f"{where}: {ref!r} is not a department:skill reference")
+ continue
+ if not os.path.exists(f"plugins/{match[1]}/skills/{match[2]}/SKILL.md"):
+ problems.append(f"{where}: `{ref}` does not exist")
+ return problems
+
+
+def reachable(entries):
+ """Fetch every URL. Separate from validation because the network is not a property of the diff."""
+ import urllib.error
+ import urllib.request
+ problems = []
+ for path, entry in entries:
+ for field in ("url", "data"):
+ url = entry.get(field)
+ if not url:
+ continue
+ request = urllib.request.Request(url, method="GET", headers={
+ "User-Agent": "headcount-source-catalog/1.0 (+https://github.com/cbrock84/headcount)"
+ })
+ try:
+ with urllib.request.urlopen(request, timeout=30) as response:
+ if response.status >= 400:
+ problems.append(f"{entry['id']}: {field} returned {response.status}")
+ except urllib.error.HTTPError as error:
+ # 403 is routinely a bot filter rather than a dead link; report it as a warning.
+ label = "warning" if error.code in (403, 429) else "problem"
+ line = f"{entry['id']}: {field} returned {error.code} ({url})"
+ print(f" {label}: {line}")
+ if label == "problem":
+ problems.append(line)
+ except Exception as error: # noqa: BLE001 — any transport failure is the same finding
+ problems.append(f"{entry['id']}: {field} unreachable — {type(error).__name__} ({url})")
+ return problems
+
+
+def pointers(entries):
+ """A skill with sources must say so, and a skill that says so must have them.
+
+ The generated `references/sources.md` is only useful if the skill body sends the agent to it.
+ Without this check the pairing rots in both directions at once: a skill gains sources and never
+ mentions them, or loses its last source and keeps pointing at a file that is no longer emitted.
+ """
+ problems = []
+ with_sources = {ref for _, e in entries for ref in e.get("skills", [])}
+ for path in sorted(glob.glob("plugins/*/skills/*/SKILL.md")):
+ parts = path.split(os.sep)
+ ref = f"{parts[1]}:{parts[3]}"
+ mentions = "\n## Sources\n" in open(path, encoding="utf-8").read()
+ if ref in with_sources and not mentions:
+ problems.append(f"{path}: has catalog sources but no `## Sources` section — "
+ f"the agent is never told the file exists")
+ if mentions and ref not in with_sources:
+ problems.append(f"{path}: has a `## Sources` section but nothing in the catalog "
+ f"lists `{ref}`")
+ return problems
+
+
+def main():
+ parser = argparse.ArgumentParser(description=__doc__)
+ parser.add_argument("--online", action="store_true",
+ help="also fetch every URL; not run in the per-push build")
+ args = parser.parse_args()
+
+ entries = load()
+ problems = validate(entries)
+ if not problems:
+ problems += pointers(entries)
+ if args.online and not problems:
+ problems += reachable(entries)
+
+ for problem in problems:
+ print(f" {problem}")
+ skills = {ref for _, e in entries for ref in e.get("skills", [])}
+ print(f"sources: {len(entries)} checked across {len(skills)} skill(s), {len(problems)} problems")
+ return 1 if problems else 0
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/sources/README.md b/sources/README.md
new file mode 100644
index 0000000..6328efb
--- /dev/null
+++ b/sources/README.md
@@ -0,0 +1,66 @@
+# Source catalog
+
+Authoritative external sources, mapped to the skills they apply to. `scripts/build-sources.py` emits
+a `references/sources.md` into each skill that has any, so an agent working inside a skill can find
+what it should be checking against before it answers.
+
+**References, never copies.** Nothing in this catalog reproduces source material. The catalog holds
+a URL, who publishes it, what it is authoritative for, and what you are allowed to do with it. D3
+and D6 settled that this repository carries no third-party licensed content, and a catalog of
+pointers keeps that true while still putting the agent in front of the real document. It also keeps
+the catalog live: a pointer to `ecfr.gov` is current the moment the regulation changes, and a copy
+is wrong the moment it does.
+
+## The license field is the point
+
+Most of what a professional needs to cite is **not** open source. That is the single most important
+thing this catalog records, because an agent that treats a free-to-read standard as reusable text
+will reproduce it. The vocabulary is closed and `scripts/check-sources.py` enforces it:
+
+| `license` | What it means | What an agent may do |
+|---|---|---|
+| `public-domain-usgov` | A work of the US federal government, 17 U.S.C. §105 | Quote, summarize, reuse freely |
+| `public-domain` | Public domain for another reason, including government edicts | Quote, summarize, reuse freely |
+| `cc0` | Dedicated to the public domain by its author | Quote, summarize, reuse freely |
+| `cc-by` | Creative Commons Attribution | Quote and reuse with attribution |
+| `cc-by-sa` | Attribution, **share-alike** | Quote with attribution; do not fold into this repository, the license is viral |
+| `attribution-required` | Free to use under bespoke terms requiring credit | Quote with the publisher's required credit |
+| `open-data` | Published as data under permissive bespoke terms | Use the data; read the terms before redistributing |
+| `free-to-read` | Readable at no cost, all rights reserved | **Read and cite. Never reproduce.** |
+| `registration-required` | Free but behind an account | Read and cite; the user must fetch it themselves |
+| `paywalled` | Must be purchased | Cite the identifier only. Do not seek a copy |
+
+`free-to-read`, `registration-required` and `paywalled` cover the sources most likely to be assumed
+open and are not: ISO standards are sold, SANS white papers are copyrighted, and the FASB
+Codification requires an account. A skill may name them as the authority and must not quote them.
+
+## Format
+
+One file per subject area. Each entry:
+
+```toml
+[[source]]
+id = "nist-sp-800-53" # unique across the catalog, lowercase-hyphenated
+title = "NIST SP 800-53 Rev. 5 — Security and Privacy Controls"
+publisher = "NIST"
+url = "https://csrc.nist.gov/pubs/sp/800/53/r5/upd1/final"
+license = "public-domain-usgov" # from the table above
+jurisdiction = "US" # or "EU", "global", a US state code, etc.
+authoritative_for = "One sentence on what question this settles."
+skills = ["security:security-architecture-review"]
+data = "https://github.com/usnistgov/oscal-content" # optional machine-readable form
+checked = "2026-09-16" # last time the URL was verified reachable
+```
+
+Every `skills` entry must resolve to a real skill, every URL must be `https`, and every `license`
+must be in the vocabulary. `python3 scripts/check-sources.py` enforces all three on every push;
+`--online` additionally fetches each URL and is run on a schedule rather than per-push, because a
+publisher being briefly down is not a reason to fail somebody's pull request.
+
+## Adding a source
+
+Prefer the publisher over an aggregator — `ecfr.gov` rather than a site that reprints it — because
+the aggregator is where staleness and license ambiguity enter. Prefer a stable landing page over a
+deep link to one revision, unless the revision is the point. Record what it is authoritative *for*
+rather than what it is about; the agent is choosing between sources, and "what question does this
+settle" is what makes that choice.
diff --git a/sources/finance-and-tax.toml b/sources/finance-and-tax.toml
new file mode 100644
index 0000000..f178e71
--- /dev/null
+++ b/sources/finance-and-tax.toml
@@ -0,0 +1,128 @@
+# Tax, accounting standards, filings and reference rates.
+#
+# The pattern to notice: US tax authority is public domain and directly quotable, while the
+# accounting standards it interacts with are copyrighted and sold. A skill may cite ASC 606 by
+# number and must not reproduce its text.
+
+[[source]]
+id = "irs-irb"
+title = "Internal Revenue Bulletin"
+publisher = "US Internal Revenue Service"
+url = "https://www.irs.gov/irb"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "The IRS's own authoritative announcements — revenue rulings, revenue procedures, notices. Where a position has to be supported rather than described, this is what supports it."
+skills = ["finance:tax", "finance:chief-financial-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "irs-forms-pubs"
+title = "IRS forms, instructions and publications"
+publisher = "US Internal Revenue Service"
+url = "https://www.irs.gov/forms-instructions"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Current-year thresholds, rates, limits and filing mechanics. Instructions carry the numbers that change annually and that a model built last year has wrong."
+skills = ["finance:tax", "people:payroll-operations"]
+checked = "2026-09-16"
+
+[[source]]
+id = "irs-applicable-federal-rates"
+title = "Applicable Federal Rates"
+publisher = "US Internal Revenue Service"
+url = "https://www.irs.gov/applicable-federal-rates"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "The minimum interest rate an intercompany or related-party loan must carry to avoid imputed interest, published monthly."
+skills = ["finance:tax", "finance:treasury-and-liquidity"]
+checked = "2026-09-16"
+
+[[source]]
+id = "fta-state-tax-agencies"
+title = "State tax agency directory"
+publisher = "Federation of Tax Administrators"
+url = "https://taxadmin.org/state-tax-agencies/"
+license = "free-to-read"
+jurisdiction = "US"
+authoritative_for = "Which state revenue department to ask, and its site. State tax guidance has no single open source and no consistent format — this is the index that routes the question to the body that can answer it."
+skills = ["finance:tax"]
+checked = "2026-09-16"
+
+[[source]]
+id = "sec-edgar"
+title = "EDGAR full-text search and submissions API"
+publisher = "US Securities and Exchange Commission"
+url = "https://www.sec.gov/edgar/search-and-access"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "What public companies actually reported, in their own filings — the primary source for a competitor's economics, a comparable's margin structure, or how a peer disclosed an accounting policy."
+data = "https://www.sec.gov/search-filings/edgar-application-programming-interfaces"
+skills = ["finance:financial-statement-analysis", "finance:financial-reporting-and-close", "corporate-strategy:mergers-and-acquisitions"]
+checked = "2026-09-16"
+
+[[source]]
+id = "fred"
+title = "FRED — Federal Reserve Economic Data"
+publisher = "Federal Reserve Bank of St. Louis"
+url = "https://fred.stlouisfed.org/"
+license = "open-data"
+jurisdiction = "US"
+authoritative_for = "Reference rates, inflation series and macro indicators with a documented API — the honest input for a discount rate or an escalation assumption, in place of a remembered number."
+data = "https://fred.stlouisfed.org/docs/api/fred/"
+skills = ["finance:financial-modeling", "finance:treasury-and-liquidity", "finance:budgeting-and-forecasting"]
+checked = "2026-09-16"
+
+[[source]]
+id = "treasury-yield-curve"
+title = "Daily Treasury Par Yield Curve Rates"
+publisher = "US Department of the Treasury"
+url = "https://home.treasury.gov/interest-rates-data-csv-archive"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "The risk-free rate by maturity, as published — the input a discount rate is built from, rather than asserted."
+skills = ["finance:financial-modeling", "finance:capital-allocation", "finance:treasury-and-liquidity"]
+checked = "2026-09-16"
+
+[[source]]
+id = "fasb-codification"
+title = "FASB Accounting Standards Codification"
+publisher = "Financial Accounting Standards Board"
+url = "https://asc.fasb.org/"
+license = "registration-required"
+jurisdiction = "US"
+authoritative_for = "US GAAP as it actually reads — revenue recognition, leases, impairment. The Basic View is free with an account and the text is copyrighted: cite the ASC number, do not reproduce the wording."
+skills = ["finance:revenue-recognition", "finance:financial-reporting-and-close", "finance:chief-financial-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "pcaob-standards"
+title = "PCAOB auditing standards"
+publisher = "Public Company Accounting Oversight Board"
+url = "https://pcaobus.org/oversight/standards/auditing-standards"
+license = "free-to-read"
+jurisdiction = "US"
+authoritative_for = "What an auditor of a public company is required to do — useful in reverse, as the definition of the evidence an internal controls program has to be able to produce."
+skills = ["finance:internal-controls-and-audit"]
+checked = "2026-09-16"
+
+[[source]]
+id = "coso-framework"
+title = "COSO Internal Control — Integrated Framework"
+publisher = "Committee of Sponsoring Organizations of the Treadway Commission"
+url = "https://www.coso.org/guidance-on-ic"
+license = "paywalled"
+jurisdiction = "global"
+authoritative_for = "The internal-control framework a SOX program is organized around and an auditor expects to be named. The framework document is sold — cite the component, not the text."
+skills = ["finance:internal-controls-and-audit", "legal-risk:enterprise-risk"]
+checked = "2026-09-16"
+
+[[source]]
+id = "ifrs-standards"
+title = "IFRS Accounting Standards"
+publisher = "IFRS Foundation"
+url = "https://www.ifrs.org/issued-standards/list-of-standards/"
+license = "registration-required"
+jurisdiction = "global"
+authoritative_for = "The standards outside US GAAP, and where the two diverge on a given transaction. Free access requires an account; the text is copyrighted."
+skills = ["finance:financial-reporting-and-close", "finance:revenue-recognition"]
+checked = "2026-09-16"
diff --git a/sources/legal-and-employment.toml b/sources/legal-and-employment.toml
new file mode 100644
index 0000000..f32cbbe
--- /dev/null
+++ b/sources/legal-and-employment.toml
@@ -0,0 +1,174 @@
+# Law, regulation and employment obligation. Primary sources, jurisdiction-tagged.
+#
+# US statutes and regulations are not copyrightable — the government edicts doctrine — so the
+# primary sources here are free to quote. The annotated and aggregated versions of the same law
+# often are not, which is why this file points at the publisher rather than the convenient site.
+
+[[source]]
+id = "ecfr"
+title = "Electronic Code of Federal Regulations"
+publisher = "US Government Publishing Office / NARA"
+url = "https://www.ecfr.gov/"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "The current text of US federal regulation, updated daily. This is the citation of record — an agency web page summarizing its own rule is not."
+data = "https://www.ecfr.gov/developers/documentation/api/v1"
+skills = ["legal-risk:regulatory-compliance", "legal-risk:chief-legal-and-risk-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "us-code"
+title = "United States Code"
+publisher = "Office of the Law Revision Counsel, US House of Representatives"
+url = "https://uscode.house.gov/"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "The consolidated text of US federal statute, where a regulation's authority is traced back to the law that permits it."
+skills = ["legal-risk:regulatory-compliance", "legal-risk:chief-legal-and-risk-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "govinfo"
+title = "govinfo"
+publisher = "US Government Publishing Office"
+url = "https://www.govinfo.gov/"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Authenticated federal documents — the Federal Register, bills, the Congressional Record — when the question is what was actually published and when."
+data = "https://api.govinfo.gov/docs/"
+skills = ["legal-risk:regulatory-compliance"]
+checked = "2026-09-16"
+
+[[source]]
+id = "dol-whd"
+title = "Wage and Hour Division"
+publisher = "US Department of Labor"
+url = "https://www.dol.gov/agencies/whd"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Federal wage and hour obligation — overtime, the regular rate, exemption tests, child labor, family and medical leave — including the fact sheets and opinion letters the agency itself enforces against."
+skills = ["people:employment-compliance", "people:payroll-operations", "people:chief-human-resources-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "dol-state-labor-offices"
+title = "State Labor Offices directory"
+publisher = "US Department of Labor"
+url = "https://www.dol.gov/agencies/whd/state/contacts"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Which state agency to ask, and its site, when an employment question turns on state rather than federal law. There is no single open source for fifty states — this is the index that gets you to the right one."
+skills = ["people:employment-compliance", "people:payroll-operations"]
+checked = "2026-09-16"
+
+[[source]]
+id = "dol-state-minimum-wage"
+title = "Consolidated State Minimum Wage and Overtime tables"
+publisher = "US Department of Labor"
+url = "https://www.dol.gov/agencies/whd/state/minimum-wage/history"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "State-by-state minimum wage and state overtime rules in one maintained table, where the binding figure is whichever of state or federal is higher."
+skills = ["people:employment-compliance", "people:payroll-operations", "people:compensation-and-leveling"]
+checked = "2026-09-16"
+
+[[source]]
+id = "eeoc-guidance"
+title = "EEOC Laws, Regulations, Guidance and MOUs"
+publisher = "US Equal Employment Opportunity Commission"
+url = "https://www.eeoc.gov/laws-guidance"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Federal anti-discrimination obligation as the agency that enforces it reads it — including guidance on selection procedures, accommodation, and automated decision tools in hiring."
+skills = ["people:employment-compliance", "people:hiring-and-interviewing", "people:employee-relations"]
+checked = "2026-09-16"
+
+[[source]]
+id = "nlrb-decisions"
+title = "National Labor Relations Board — decisions and guidance"
+publisher = "NLRB"
+url = "https://www.nlrb.gov/cases-decisions"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "What counts as protected concerted activity and as an unfair labor practice, for represented and unrepresented workforces alike."
+skills = ["people:employee-relations", "people:employment-compliance"]
+checked = "2026-09-16"
+
+[[source]]
+id = "osha-standards"
+title = "OSHA law and regulations"
+publisher = "US Occupational Safety and Health Administration"
+url = "https://www.osha.gov/laws-regs"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Workplace safety obligation, recordkeeping requirements and the reporting windows for a fatality or serious injury."
+skills = ["legal-risk:regulatory-compliance", "operations:business-continuity-and-resilience"]
+checked = "2026-09-16"
+
+[[source]]
+id = "eur-lex-gdpr"
+title = "Regulation (EU) 2016/679 — GDPR"
+publisher = "Publications Office of the European Union"
+url = "https://eur-lex.europa.eu/eli/reg/2016/679/oj"
+license = "attribution-required"
+jurisdiction = "EU"
+authoritative_for = "The operative text of the GDPR. EU legal texts are reusable with attribution under the Commission's reuse decision, so this is quotable where a national summary is not."
+skills = ["legal-risk:privacy-and-data-protection", "legal-risk:regulatory-compliance", "data-analytics:data-governance"]
+checked = "2026-09-16"
+
+[[source]]
+id = "edpb-guidelines"
+title = "European Data Protection Board guidelines and recommendations"
+publisher = "EDPB"
+url = "https://www.edpb.europa.eu/our-work-tools/general-guidance/guidelines-recommendations-best-practices_en"
+license = "attribution-required"
+jurisdiction = "EU"
+authoritative_for = "How supervisory authorities actually read the GDPR — lawful basis, transfers, legitimate interest balancing — which is where a plain reading of the regulation stops being enough."
+skills = ["legal-risk:privacy-and-data-protection", "data-analytics:data-governance"]
+checked = "2026-09-16"
+
+[[source]]
+id = "ca-oag-ccpa"
+title = "California Consumer Privacy Act — Attorney General"
+publisher = "California Office of the Attorney General"
+url = "https://oag.ca.gov/privacy/ccpa"
+license = "public-domain"
+jurisdiction = "US-CA"
+authoritative_for = "The largest US state privacy regime, and the template several other states followed. Start here before generalizing about 'US state privacy law', which is not one thing."
+skills = ["legal-risk:privacy-and-data-protection", "data-analytics:data-governance"]
+checked = "2026-09-16"
+
+[[source]]
+id = "cornell-lii"
+title = "Legal Information Institute"
+publisher = "Cornell Law School"
+url = "https://www.law.cornell.edu/"
+license = "free-to-read"
+jurisdiction = "US"
+authoritative_for = "Finding the right provision fast, with plain-language context around it. The underlying law is public domain; LII's annotations and commentary are not — follow through to the primary source before citing."
+skills = ["legal-risk:regulatory-compliance", "legal-risk:contract-review", "legal-risk:chief-legal-and-risk-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "uspto"
+title = "USPTO search and guidance"
+publisher = "US Patent and Trademark Office"
+url = "https://www.uspto.gov/"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Whether a mark or an invention is already claimed, and the examination standards a filing will be judged against."
+data = "https://developer.uspto.gov/"
+skills = ["legal-risk:intellectual-property"]
+checked = "2026-09-16"
+
+[[source]]
+id = "spdx-license-list"
+title = "SPDX License List"
+publisher = "The Linux Foundation"
+url = "https://spdx.org/licenses/"
+license = "cc-by"
+jurisdiction = "global"
+authoritative_for = "The canonical identifier and full text of every common open-source license — the reference for an inbound license review, and for what a share-alike obligation actually says."
+data = "https://github.com/spdx/license-list-data"
+skills = ["legal-risk:intellectual-property", "technology:release-and-deployment"]
+checked = "2026-09-16"
diff --git a/sources/security.toml b/sources/security.toml
new file mode 100644
index 0000000..7199f4b
--- /dev/null
+++ b/sources/security.toml
@@ -0,0 +1,127 @@
+# Security, controls frameworks and vulnerability data.
+
+[[source]]
+id = "nist-sp-800-53"
+title = "NIST SP 800-53 Rev. 5 — Security and Privacy Controls for Information Systems"
+publisher = "NIST"
+url = "https://csrc.nist.gov/pubs/sp/800/53/r5/upd1/final"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "The control catalog US federal systems are assessed against, and the control vocabulary FedRAMP and many private frameworks inherit."
+data = "https://github.com/usnistgov/oscal-content"
+skills = ["security:security-architecture-review", "security:access-and-identity", "security:chief-information-security-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "nist-csf"
+title = "NIST Cybersecurity Framework 2.0"
+publisher = "NIST"
+url = "https://www.nist.gov/cyberframework"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "The outcome-based vocabulary — govern, identify, protect, detect, respond, recover — that boards and customers most often ask a security program to map to."
+skills = ["security:chief-information-security-officer", "security:security-architecture-review"]
+checked = "2026-09-16"
+
+[[source]]
+id = "fedramp-automation"
+title = "FedRAMP baselines and automation content"
+publisher = "GSA"
+url = "https://www.fedramp.gov/rev5/documents-templates/"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Which SP 800-53 controls apply at low, moderate and high impact for a cloud service selling to the US federal government, and the evidence each requires."
+data = "https://github.com/GSA/fedramp-automation"
+skills = ["security:chief-information-security-officer", "security:security-architecture-review", "legal-risk:regulatory-compliance"]
+checked = "2026-09-16"
+
+[[source]]
+id = "cisa-kev"
+title = "CISA Known Exploited Vulnerabilities Catalog"
+publisher = "CISA"
+url = "https://www.cisa.gov/known-exploited-vulnerabilities-catalog"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "Which vulnerabilities are being exploited in the wild right now — the only list that reliably separates patch-this-week from patch-this-quarter."
+data = "https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json"
+skills = ["security:vulnerability-management", "security:incident-response"]
+checked = "2026-09-16"
+
+[[source]]
+id = "nvd"
+title = "National Vulnerability Database"
+publisher = "NIST"
+url = "https://nvd.nist.gov/"
+license = "public-domain-usgov"
+jurisdiction = "US"
+authoritative_for = "CVE records with severity scoring and affected-version data, and the API a vulnerability program queries rather than reads."
+data = "https://nvd.nist.gov/developers/vulnerabilities"
+skills = ["security:vulnerability-management"]
+checked = "2026-09-16"
+
+[[source]]
+id = "mitre-attack"
+title = "MITRE ATT&CK"
+publisher = "The MITRE Corporation"
+url = "https://attack.mitre.org/"
+license = "attribution-required"
+jurisdiction = "global"
+authoritative_for = "The shared vocabulary for adversary tactics and techniques — what to name a behavior so a detection, a threat model and an incident report refer to the same thing."
+data = "https://github.com/mitre-attack/attack-stix-data"
+skills = ["security:threat-modeling", "security:incident-response", "security:security-architecture-review"]
+checked = "2026-09-16"
+
+[[source]]
+id = "owasp-top-10"
+title = "OWASP Top 10"
+publisher = "OWASP Foundation"
+url = "https://owasp.org/www-project-top-ten/"
+license = "cc-by-sa"
+jurisdiction = "global"
+authoritative_for = "The application-security risk categories a customer questionnaire or a pen-test report will be organized around."
+skills = ["security:threat-modeling", "security:security-architecture-review"]
+checked = "2026-09-16"
+
+[[source]]
+id = "owasp-asvs"
+title = "OWASP Application Security Verification Standard"
+publisher = "OWASP Foundation"
+url = "https://owasp.org/ASVS/"
+license = "cc-by-sa"
+jurisdiction = "global"
+authoritative_for = "Testable application security requirements at three assurance levels — the thing to write into a spec when 'make it secure' needs to become acceptance criteria."
+skills = ["security:security-architecture-review"]
+checked = "2026-09-16"
+
+[[source]]
+id = "cis-controls"
+title = "CIS Critical Security Controls"
+publisher = "Center for Internet Security"
+url = "https://www.cisecurity.org/controls"
+license = "registration-required"
+jurisdiction = "global"
+authoritative_for = "A prioritized implementation order for a security program that has to start somewhere, with implementation groups sized to organizational maturity."
+skills = ["security:chief-information-security-officer"]
+checked = "2026-09-16"
+
+[[source]]
+id = "sans-policy-templates"
+title = "SANS Information Security Policy Templates"
+publisher = "SANS Institute"
+url = "https://www.sans.org/information-security-policy/"
+license = "free-to-read"
+jurisdiction = "global"
+authoritative_for = "Starting-point policy language for the policies an auditor expects to exist. Read and adapt; the templates are copyrighted and are not open-licensed."
+skills = ["security:chief-information-security-officer", "legal-risk:regulatory-compliance"]
+checked = "2026-09-16"
+
+[[source]]
+id = "iso-27001"
+title = "ISO/IEC 27001 — Information security management systems"
+publisher = "ISO"
+url = "https://www.iso.org/standard/27001"
+license = "paywalled"
+jurisdiction = "global"
+authoritative_for = "The certifiable ISMS standard enterprise buyers ask for by name. The text is sold, not published — cite the clause number, never the wording."
+skills = ["security:chief-information-security-officer", "legal-risk:regulatory-compliance"]
+checked = "2026-09-16"