Skip to content

Commit 2acb192

Browse files
committed
Align repository model documentation and governance
1 parent 5b9f480 commit 2acb192

6 files changed

Lines changed: 20 additions & 3 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,14 @@
22

33
All notable changes to Method Forge are documented here.
44

5+
## Unreleased
6+
7+
- Added probability, statistics, and inference coverage, including sampling, estimation, testing, regression, hierarchical models, time series, survival, Bayesian analysis, missing data, and reproducibility.
8+
- Added urban, territorial, and regional planning coverage.
9+
- Expanded process improvement, evaluation, finance and social value, climate, and health coverage.
10+
- Documented canonical ownership, secondary routing, and cross-domain composition rules through the taxonomy and architecture decisions.
11+
- Added catalog-routing regression evidence and strengthened repository validation guidance.
12+
513
## 0.1.0 — 2026-08-16
614

715
- Established the Method Forge public repository structure.

‎CONTRIBUTING.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ For every new or materially changed candidate:
1616
6. Separate definition/status evidence from effectiveness evidence.
1717
7. Record the date when volatile status, version, or jurisdiction was checked.
1818

19+
If a method is relevant to more than one catalog, keep one canonical definition and route the secondary use to it. Add a domain specialization only when the estimand, authority, measurement system, validation boundary, or other decision-relevant context changes. Record that ownership and routing decision in the taxonomy or composition patterns when it is not obvious.
20+
1921
Do not copy substantial third-party text. Summarize in original language and link to the source.
2022

2123
## Adding a domain
@@ -28,6 +30,7 @@ Laws, vendors, datasets, registries, rates, and platform features may constrain
2830

2931
- [ ] The change has one clear purpose.
3032
- [ ] Terminology is stable and does not duplicate an existing owner.
33+
- [ ] Any cross-catalog method has one canonical owner and an explicit secondary-routing decision.
3134
- [ ] Local links resolve.
3235
- [ ] Volatile claims include a check date.
3336
- [ ] Proprietary, emerging, contested, and draft material is labeled.

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
Method Forge helps people and AI agents turn underspecified problems into small, defensible method stacks. It distinguishes methodologies from frameworks, standards, techniques, representations, assurance mechanisms, artifacts, and metrics before comparing them.
66

7-
The repository currently covers 37 domain and cross-domain catalogs, from strategy, software, evidence, statistics, and AI to finance, law, sustainability, supply chains, health, assets, geospatial analysis, and urban planning.
7+
The repository currently contains 39 reference catalogs: 37 domain and cross-domain catalogs, plus two meta-reference catalogs for taxonomy and source discovery. Coverage ranges from strategy, software, evidence, statistics, and AI to finance, law, sustainability, supply chains, health, assets, geospatial analysis, and urban planning.
88

99
## Why it exists
1010

‎docs/architecture.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The root documentation explains purpose, governance, contribution, citation, and
1212

1313
## Validation boundary
1414

15-
The dependency-free repository validator checks package structure, frontmatter, local links, catalog headings, route integrity, placeholders, and duplicate ownership signals that can be detected mechanically. Human review remains responsible for methodological fit, evidence quality, proportionality, and jurisdiction.
15+
The dependency-free repository validator checks required package structure, frontmatter, local links, catalog headings, reference count, route integrity, and unresolved TODO markers. Canonical ownership and duplicate-method signals are reviewed through the taxonomy, composition patterns, architecture decisions, contribution checklist, and scenario contracts; the validator does not infer those judgments as facts. Human review also remains responsible for methodological fit, evidence quality, proportionality, and jurisdiction.
1616

1717
## Evolution
1818

‎docs/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,4 @@ Method Forge is both a curated methodological knowledge base and an installable
44

55
Start with the [repository README](../README.md) for purpose and usage. Read the [architecture](architecture.md) to understand ownership and validation. The operational selection workflow lives in the [`select-methodologies` skill](../skills/select-methodologies/SKILL.md).
66

7-
Structural decisions are preserved in [`docs/adr`](adr/0001-repository-architecture.md).
7+
Structural decisions are preserved in the [architecture decision records](adr/).

‎tests/scenarios/selection-invariants.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,3 +43,9 @@ These scenarios define behavioral expectations for future agent evaluations. The
4343
**Prompt:** Recommend a complete stack for an auditable public-source investigation.
4444

4545
**Expected invariants:** Every selected fragment must produce a distinct consumed output. The response should remove any element whose absence causes no material loss and preserve verified, rejected, and possible evidence states.
46+
47+
## Repository model organization
48+
49+
**Prompt:** Add or revise a method that could be relevant to more than one domain catalog.
50+
51+
**Expected invariants:** Keep one canonical method definition, route secondary uses to that owner, and add a specialization only when the decision-relevant context changes. Update the relevant taxonomy or composition guidance, preserve a rationale in an ADR when the ownership boundary changes, and keep the dependency-free validator passing.

0 commit comments

Comments
 (0)