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.
HTML agent-marketplacechatgpt-pluginchatgpt-skillsclaude-codeclaude-code-pluginclaude-pluginclaude-skillsmcporganization
Add a source catalog so skills can cite live authorities
Claude0e7cd01aa93e
diff --git a/.claude/agents/sources.md b/.claude/agents/sources.mdnew file mode 100644index 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.ymlnew file mode 100644index 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 --onlinediff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 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 cheGive it a chief before any specialists — the department's remit should exist before things are addedto 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 verticalA vertical is the core made specific to one industry. `scripts/build-vertical.py` emits a standalonediff --git a/docs/AGENT-SURFACES.md b/docs/AGENT-SURFACES.mdindex 439c3b1..2315d09 100644--- a/docs/AGENT-SURFACES.md+++ b/docs/AGENT-SURFACES.md@@ -54,6 +54,7 @@ security builder installed autonomousit-operations builder installed autonomouspmo builder installed autonomousverticals builder installed proposes+sources builder installed autonomousrepo-meta builder installed proposeslegal-risk-review reviewer installed autonomoussecurity-review reviewer installed autonomous@@ -147,6 +148,10 @@ plugins/security/**verticals/**```+```surface:sources+sources/**+```+```surface:repo-metaLICENSE.gitignorediff --git a/docs/DECISION-LOG.md b/docs/DECISION-LOG.mdindex 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, anis 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 aredifferent 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.mdindex 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, custometransition, and a stalled integration that leaves two of everything indefinitely. Each isforeseeable 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.mdnew file mode 100644index 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.mdindex 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 questioKnow where a number came from and what feeds it. Without lineage, you cannot answer the twoquestions 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.mdnew file mode 100644index 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.mdindex 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 asnothing.+## 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.+## ToolingPlanning: Anaplan, Pigment, Workday Adaptive Planning, Vena, Cube, and similar. Adiff --git a/plugins/finance/skills/budgeting-and-forecasting/references/sources.md b/plugins/finance/skills/budgeting-and-forecasting/references/sources.mdnew file mode 100644index 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.mdindex 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 rathernobody looks back, forecasts drift optimistic because optimism is rewarded at approval and nevertested 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.mdnew file mode 100644index 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.mdindex 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 rightEscalate 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.+## ToolingThe stack a CFO is accountable for, by layer: the ledger (QuickBooks or Xero at smalldiff --git a/plugins/finance/skills/chief-financial-officer/references/sources.md b/plugins/finance/skills/chief-financial-officer/references/sources.mdnew file mode 100644index 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.mdindex 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 whNever present a model without stating what it is most sensitive to — the recipient will assumerobustness 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 adiff --git a/plugins/finance/skills/financial-modeling/references/sources.md b/plugins/finance/skills/financial-modeling/references/sources.mdnew file mode 100644index 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.mdindex 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 differentbusiness 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.+## ToolingLedger, by scale: QuickBooks, Xero, or FreshBooks for a single entity; NetSuite, Sagediff --git a/plugins/finance/skills/financial-reporting-and-close/references/sources.md b/plugins/finance/skills/financial-reporting-and-close/references/sources.mdnew file mode 100644index 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.mdindex 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 deteriorlike a demand problem is a margin or working capital problem, and the two call for differentresponses.+## 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.mdnew file mode 100644index 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.mdindex 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 financialreporting.+## 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.mdnew file mode 100644index 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.mdindex 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 oblianswer what it is composed of and when it releases. A balance nobody can decompose is one thatsurprises 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.+## ToolingSubledgers that carry recognition schedules: NetSuite Advanced Revenue Management, Zuoradiff --git a/plugins/finance/skills/revenue-recognition/references/sources.md b/plugins/finance/skills/revenue-recognition/references/sources.mdnew file mode 100644index 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.mdindex 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 itselfsomething 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.mdnew file mode 100644index 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.mdindex 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 cliquidity risk, and treasury losses of this kind are always described afterwards as conservativeinvestments.+## 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.+## ToolingCash visibility and forecasting: Kyriba, Trovata, Tesorio, and similar. Bank portals plusdiff --git a/plugins/finance/skills/treasury-and-liquidity/references/sources.md b/plugins/finance/skills/treasury-and-liquidity/references/sources.mdnew file mode 100644index 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.mdindex 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 signaturediff --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.mdnew file mode 100644index 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.mdindex 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 rescalation path. Review every contract personally and you become the bottleneck the process wasmeant 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.+## ToolingContract lifecycle management: Ironclad, Icertis, Agiloft, DocuSign CLM, LinkSquares, anddiff --git a/plugins/legal-risk/skills/contract-review/references/sources.md b/plugins/legal-risk/skills/contract-review/references/sources.mdnew file mode 100644index 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.mdindex 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 iwhat needs a decision. Not the whole register. A risk report that requires reading forty rows tofind 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.+## ToolingA risk register is a table, and for most organizations a spreadsheet or a database indiff --git a/plugins/legal-risk/skills/enterprise-risk/references/sources.md b/plugins/legal-risk/skills/enterprise-risk/references/sources.mdnew file mode 100644index 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.mdindex 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 pra 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.mdnew file mode 100644index 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.mdindex 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 partFor breaches, know your notification clock before you need it — several regimes measure it in hoursfrom 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.mdnew file mode 100644index 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.mdindex 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 ona 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.+## ToolingCompliance automation — Vanta, Drata, Secureframe, Keel GRC, and similar — collectsdiff --git a/plugins/legal-risk/skills/regulatory-compliance/references/sources.md b/plugins/legal-risk/skills/regulatory-compliance/references/sources.mdnew file mode 100644index 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.mdindex 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 tsystem you have just lost. Map dependencies to the point where they stop being yours, and checkwhether 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.+## ToolingContinuity 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.mdnew file mode 100644index 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.mdindex 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 rightEscalate 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 itdiff --git a/plugins/people/skills/chief-human-resources-officer/references/sources.md b/plugins/people/skills/chief-human-resources-officer/references/sources.mdnew file mode 100644index 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.mdindex 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.+## ToolingBenchmark data is the purchase that matters, and it is where the scale tier is real: free anddiff --git a/plugins/people/skills/compensation-and-leveling/references/sources.md b/plugins/people/skills/compensation-and-leveling/references/sources.mdnew file mode 100644index 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.mdindex 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 successfulThe people who remain draw conclusions from how leavers are treated, and those conclusions aredurable.+## 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.mdnew file mode 100644index 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.mdindex 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 checSet retention by the longest applicable requirement, and suspend disposal entirely when litigationor 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.mdnew file mode 100644index 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.mdindex 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 alonger 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.+## ToolingApplicant tracking, roughly by scale: Workable, JazzHR or the hiring module of an all-in-one HRISdiff --git a/plugins/people/skills/hiring-and-interviewing/references/sources.md b/plugins/people/skills/hiring-and-interviewing/references/sources.mdnew file mode 100644index 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.mdindex 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 filieach cycle takes minutes; reconciling a year of unreconciled cycles at year-end takes weeks andfinds 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.mdnew file mode 100644index 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.mdindex 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 canadministrative access, accounts whose owner has left, service credentials with no owner, and systemsoutside 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.+## ToolingIdentity 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.mdnew file mode 100644index 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.mdindex 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 fexposure the business is carrying. To Legal & Risk on anything with regulatory or contractualconsequence — 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.mdnew file mode 100644index 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.mdindex 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 tabrealistic scenario finds the gaps — who has authority out of hours, where the credentials are, whocalls 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.mdnew file mode 100644index 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.mdindex 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 thatimplements 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 thediff --git a/plugins/security/skills/security-architecture-review/references/sources.md b/plugins/security/skills/security-architecture-review/references/sources.mdnew file mode 100644index 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.mdindex 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-longexercise 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.mdnew file mode 100644index 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.mdindex 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 oneLeadership needs: what is exposed and unfixed past SLA, the trend, and what needs a decision. Notthe 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.+## ToolingInfrastructure scanning: Tenable, Qualys, Rapid7 InsightVM, and similar. Code anddiff --git a/plugins/security/skills/vulnerability-management/references/sources.md b/plugins/security/skills/vulnerability-management/references/sources.mdnew file mode 100644index 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.mdindex 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 developmentdataset 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.+## ToolingPipelines: 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.mdnew file mode 100644index 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.pynew file mode 100755index 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.shindex 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.pyrun "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 --checkrun "Verticals emit and pass their own checks" \python3 scripts/build-vertical.py --all --verifyrun "Manifests parse" \diff --git a/scripts/check-provenance.py b/scripts/check-provenance.pyindex 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 expectedOWN_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):continuetext = 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_PATTERNSfor pattern in PATTERNS:- if pattern == waived:+ if pattern in waived:continueif re.search(pattern, text):problems.append(f"{path}: matches {pattern!r}")diff --git a/scripts/check-sources.py b/scripts/check-sources.pynew file mode 100755index 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.mdnew file mode 100644index 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.tomlnew file mode 100644index 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.tomlnew file mode 100644index 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.tomlnew file mode 100644index 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"