Skip to content

Commit 27c5c2d

Browse files
committed
Enrich cross-domain method coverage
1 parent 4c4eb41 commit 27c5c2d

12 files changed

Lines changed: 164 additions & 2 deletions

‎README.md‎

Lines changed: 2 additions & 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 36 domain and cross-domain catalogs, from strategy, software, evidence, statistics, and AI to finance, law, sustainability, supply chains, health, assets, geospatial analysis, and construction.
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.
88

99
## Why it exists
1010

@@ -42,6 +42,7 @@ The skill can also trigger implicitly for methodology discovery, comparison, com
4242
- [Taxonomy and selection protocol](skills/select-methodologies/references/00-taxonomy-selection.md)
4343
- [Method engineering and composition patterns](skills/select-methodologies/references/10-composition-patterns.md)
4444
- [Probability, statistics, and inference](skills/select-methodologies/references/37-probability-statistics-inference.md)
45+
- [Urban, territorial, and regional planning](skills/select-methodologies/references/38-urban-territorial-planning.md)
4546
- [Primary source and status registry](skills/select-methodologies/references/11-source-registry.md)
4647
- [Repository architecture](docs/architecture.md)
4748
- [Contribution guide](CONTRIBUTING.md)
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# ADR 0004: Add an urban and territorial planning catalog
2+
3+
- **Date:** 2026-08-16
4+
- **Status:** accepted
5+
6+
## Context
7+
8+
The repository already covered geospatial analysis, construction/BIM, participation, climate, project governance, and public policy. It did not have a canonical owner for the planning decisions that connect those fragments: territorial diagnosis, land-use strategy, urban form, mobility integration, public-space choices, implementation rules, and place-based monitoring.
9+
10+
## Decision
11+
12+
Add `38-urban-territorial-planning.md` as the canonical catalog for urban, territorial, and regional plan-making. Keep geospatial computation in `33`, construction delivery in `36`, participation methods in `24`, and climate-risk methods in `15`/`21`/`32`. The urban catalog composes those fragments around a place-based planning decision and its implementation boundary.
13+
14+
## Consequences
15+
16+
- **Positive:** planning has a discoverable home without duplicating spatial, construction, or participation methods.
17+
- **Positive:** land rights, local authority, infrastructure capacity, displacement, and climate resilience become explicit validity boundaries.
18+
- **Cost:** contributors must distinguish a spatial model, participation process, project, and plan.

‎skills/select-methodologies/SKILL.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,7 @@ Read only the files needed:
104104
| Asset management, criticality, maintenance strategy, RCM, RBI, condition monitoring, spares, obsolescence, or lifecycle renewal | `references/34-asset-maintenance-reliability.md` |
105105
| Human factors, ergonomics, human-systems integration, workload, medical devices, clinical evidence, usability engineering, or medical QMS | `references/35-human-factors-health-medical-devices.md` |
106106
| Construction, infrastructure, BIM, ISO 19650, constructability, Last Planner, commissioning, or built-asset handover | `references/36-construction-infrastructure-bim.md` |
107+
| Urban, territorial, regional, land-use, mobility, public-space, or place-based planning | `references/38-urban-territorial-planning.md` |
107108

108109
For a cross-domain problem, begin with the primary decision catalog and at most two adjacent domain catalogs. Add another only when a selected fragment is canonically owned there or a material hard gate remains uncovered. Route by decision and missing capability, not by every noun in the prompt. `references/10-composition-patterns.md` and `references/11-source-registry.md` do not count as domain catalogs. Do not load all references by default.
109110

‎skills/select-methodologies/references/00-taxonomy-selection.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,7 @@ When the same family appears in multiple catalogs, retrieve its generic definiti
127127
| Asset management, maintenance, inspection, condition monitoring, spares, and renewal | `34-asset-maintenance-reliability.md` | manufacturing equipment in `14`; built-asset handover in `36` |
128128
| Human factors, ergonomics, medical devices, and clinical-device evidence | `35-human-factors-health-medical-devices.md` | UX in `20`; product realization in `14`; health regulation in `13` |
129129
| Construction, infrastructure, BIM, constructability, and commissioning | `36-construction-infrastructure-bim.md` | project controls in `30`; asset operations in `34`; physical engineering in `14` |
130+
| Urban, territorial, regional, land-use, mobility, public-space, and place-based planning | `38-urban-territorial-planning.md` | geospatial data/models in `33`; construction/BIM in `36`; participation in `24`; climate resilience in `15`/`21`/`32` |
130131
| LCA, environmental claims, TEA, industrial processes | `15-sustainability-circular-energy.md` | agricultural sustainability in `17` |
131132
| Supply chains, inventory, logistics, reverse networks, and traceability | `16-supply-chain-logistics.md` | circular feedstock/recovery in `15`; spatial network design in `33` |
132133
| Geospatial data, spatial analysis/econometrics, remote sensing, and location decisions | `33-geospatial-location-analysis.md` | route/facility operations in `16`; causal inference in `08`; investigations in `31` |

‎skills/select-methodologies/references/11-source-registry.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,7 @@ Use this registry to begin research. Open the owner page and verify current stab
4848
| DMN | `omg.org/spec/DMN` | 1.5 formal; later beta material must not be called formal |
4949
| APQC PCF | `apqc.org/process-frameworks` | live cross-industry/industry collection; check current edition |
5050
| Quality management | `iso.org/standard/62085.html` | ISO 9001:2015 plus amendments remained current; 2026 revision status must be checked |
51+
| Quality improvement | IHI Model for Improvement; Langley et al., *The Improvement Guide* | improvement framework with PDSA testing; separate learning cycles from causal impact evaluation |
5152
| Risk management | `iso.org/standard/65694.html` | ISO 31000:2018 |
5253
| Knowledge management | `iso.org/standard/68683.html` | ISO 30401:2018 with amendments; revision under development at check date |
5354
| Human-centred design | ISO 9241-210 owner page | verify current edition/status |
@@ -101,6 +102,8 @@ Use this registry to begin research. Open the owner page and verify current stab
101102
| MCDA | UK Government Analysis Function / Green Book guidance | authoritative public analytical guidance; choose technique contextually |
102103
| Causal evaluation | World Bank *Impact Evaluation in Practice*; PyWhy/DoWhy; primary econometrics literature | software workflow does not prove identification assumptions |
103104
| General statistics and probability | `itl.nist.gov/div898/handbook/`; ASA Ethical Guidelines; relevant primary design and measurement literature | generic statistical methods; verify domain, sampling, estimand, measurement, and jurisdictional requirements before use |
105+
| Program monitoring and evaluation | USAID Logframe guidance; IDRC Outcome Mapping; OECD DAC criteria | planning and learning methods; do not treat a logic model, behavioral outcome, or story as causal proof |
106+
| Urban and territorial planning | UN-Habitat International Guidelines on Urban and Territorial Planning; Citywide Strategic Planning; Our City Plans | planning principles and process anchors; local planning law, authority, land rights, and infrastructure capacity govern applicability |
104107

105108
## Finance, markets, audit, and procurement
106109

@@ -121,6 +124,7 @@ Use this registry to begin research. Open the owner page and verify current stab
121124
| Compliance management | `iso.org/standard/75080.html` and ISO 37302 owner page | ISO 37301:2021 plus Amendment 1:2024; ISO 37302:2025 effectiveness guidance |
122125
| Regulatory impact assessment | OECD Regulatory Impact Assessment principles; controlling jurisdictional procedure | cross-jurisdiction analytical anchor; local authority and law govern applicability |
123126
| Human rights and responsible business | UN Guiding Principles on Business and Human Rights; OECD Guidelines for Multinational Enterprises | authoritative general anchors; apply current binding jurisdictional duties separately |
127+
| Health technology assessment and clinical guidance | WHO HTA resources; AGREE II instrument; GRADE ecosystem | multidisciplinary adoption/evidence appraisal; jurisdictional clinical, regulatory, and ethics requirements remain controlling |
124128
| Management-system auditing | ISO 19011 owner page | ISO 19011:2026 current; verify sector-specific competence and audit criteria |
125129
| Business continuity | `iso.org/standard/75106.html` | ISO 22301:2019 plus Amendment 1:2024 current; later draft is not a replacement |
126130
| Crisis and incident management | ISO 22361:2022; ISO 22320:2018; NIST SP 800-61 Rev. 3 | distinguish strategic crisis leadership, cross-agency incident management, and cyber response |
@@ -147,6 +151,7 @@ Use this registry to begin research. Open the owner page and verify current stab
147151
| Family | Canonical research anchor | Status note at check date |
148152
| --- | --- | --- |
149153
| Environmental management | `iso.org/standard/14001` | ISO 14001:2026 published and current; ISO 14001:2015 withdrawn |
154+
| Climate risk and adaptation | IPCC AR6 Synthesis Report and relevant Working Group reports | assessment anchor; local hazard, exposure, vulnerability, authority, and adaptation feasibility require context-specific evidence |
150155
| Life-cycle assessment | ISO 14040 and ISO 14044 owner pages | 2006 base editions with applicable amendments; functional unit, system boundary, allocation, and review determine validity |
151156
| Circular economy | ISO 59004, ISO 59010, and ISO 59020 owner pages | 2024 principles, transition, and measurement standards; circularity is not environmental proof |
152157
| GHG accounting | GHG Protocol standards and guidance; ISO 14064-1 and ISO 14067 | distinguish organization, scope, product, project, and avoided-emissions claims |

‎skills/select-methodologies/references/12-finance-market-audit-procurement.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,10 @@ Use this catalog when capital allocation, commercial evidence, financial control
3030
| Venture / scenario valuation | financing heuristic family | highly uncertain staged ventures require dilution, failure, follow-on, and exit scenarios | one success multiple is presented as intrinsic value or expected value hides financing path and survival risk |
3131
| Earned Value Management — EVM | delivery-control method | stable baselines and objective progress rules integrate scope, schedule, and cost | use as investment valuation, benefits evidence, or percent-complete theater in discovery work |
3232
| Benefits realization / ex post evaluation | governance and evaluation method | delivered outputs must trace to owner, adoption, operating outcomes, and the original counterfactual | close the case at project delivery or attribute every observed improvement to the investment |
33+
| Cost-Benefit Analysis (CBA) | economic appraisal method; discounted social costs, benefits, risks, and net value | options have monetizable or explicitly valued social consequences and a common appraisal horizon | force incomparable rights, ecological thresholds, or distributional harms into one price without a stated constraint |
34+
| Social Return on Investment (SROI) | social-value accounting/appraisal method | people affected, material outcomes, deadweight, attribution, displacement, and valuation need an explicit impact account | present a ratio as causal proof, monetize every outcome, or hide negative/distributed effects |
35+
| Distributional analysis | equity-aware appraisal method | costs, benefits, risks, and access differ materially by group, income, geography, or vulnerability | report one aggregate NPV while decision legitimacy depends on who gains and loses |
36+
| Place-based analysis | spatial appraisal specialization | impacts, constraints, services, and opportunity costs vary by place and local system | treat a national average as valid for every locality or double-count spatial benefits |
3337

3438
Core rules: use incremental after-tax cash flows in a consistent nominal/real currency basis; report NPV as primary for value creation; treat IRR/payback as complements; separate unlevered project economics from financing and equity returns; reconcile model totals to source evidence; expose working capital, replacement CAPEX, ramp-up, downtime, salvage, taxes, incentives, and exit.
3539

@@ -116,6 +120,8 @@ Investigation outputs should distinguish `substantiated | not substantiated | in
116120
Status checked 2026-08-12. Financial, tax, accounting, audit, procurement, sanctions, and disclosure rules remain jurisdiction- and purpose-specific.
117121

118122
- [HM Treasury Green Book 2026](https://www.gov.uk/government/publications/the-green-book-appraisal-and-evaluation-in-central-government/the-green-book-2026) is the current UK public-appraisal edition; adapt outside its scope rather than claiming conformity.
123+
- The Green Book 2026 explicitly separates appraisal from evaluation and includes distributional and place-based analysis; use it as an anchor, not a jurisdiction-free rule.
124+
- [Social Value International standards and guidance](https://www.socialvalueint.org/standards-and-guidance) anchor SROI and social-value accounting; report materiality, deadweight, attribution, displacement, transparency, and verification rather than treating an SROI ratio as causal proof.
119125
- [GAO Cost Estimating and Assessment Guide](https://www.gao.gov/products/gao-20-195g) and live [AACE Recommended Practices](https://web.aacei.org/resources/recommended-practices) are cost-estimate and assurance anchors; estimate classes and ranges depend on sector/scope.
120126
- [ISO 21508:2026](https://www.iso.org/standard/87899.html) is the current EVM guidance; it controls delivery, not investment value.
121127
- [ISO 20252:2019](https://www.iso.org/standard/73671.html) remains the published market/opinion/social-research service standard while revision is underway; [ICC/ESOMAR Code 2025](https://standards.esomar.org/assets/documents/icc-esomar-code-2025.pdf) is self-regulatory ethics/transparency guidance.

‎skills/select-methodologies/references/13-legal-policy-ethics.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,12 @@ For every legal conclusion state: `jurisdiction | issue | law-as-of date | contr
5959
| Test and Learn / adaptive policy | adaptive implementation/evaluation approach | uncertainty is material, rollout can be staged safely, and feedback can change policy | experimentation exposes groups to unacceptable harm or operational changes destroy inference without documentation |
6060
| Analytical Quality Assurance — AQA | assurance framework | models and analyses materially influence public decisions and need proportional independent challenge | a review checklist substitutes for competent replication, data checks, and decision accountability |
6161

62+
| Logical Framework Approach / Logframe | program-design and monitoring method | inputs, activities, outputs, outcomes, assumptions, indicators, and responsibilities need one testable project logic | complete a matrix as paperwork, hide uncertainty in assumptions, or treat logical links as causal proof |
63+
| Results-Based Management | management and learning framework | resources, outputs, outcomes, indicators, risks, and adaptive decisions must connect across a program cycle | reduce complex change to target compliance or reward reporting volume over learning |
64+
| Outcome Mapping | participatory planning, monitoring, and evaluation method | change depends on behavior, relationships, and boundary partners beyond one agency's control | claim population impact from observed behavioral markers or ignore contribution and context |
65+
| Most Significant Change | qualitative outcome-learning technique | diverse stakeholders need to surface unexpected, valued, or contested changes and explain why they matter | use selected stories as prevalence estimates, suppress negative cases, or replace systematic monitoring |
66+
| Evidence-to-Decision framework | deliberative decision artifact/process | evidence, benefits, harms, values, equity, acceptability, feasibility, and implementation must be made explicit | treat a recommendation as a mechanical consequence of evidence certainty |
67+
6268
## Ethics, human rights, and responsible innovation
6369

6470
| Candidate | Type and output | Use when | Avoid when |
@@ -100,6 +106,8 @@ Escalate consequential interpretation, filings, strategy, rights, liability, or
100106
Status checked 2026-08-12. Always live-check jurisdictional sources and effective dates.
101107

102108
- [OECD Regulatory Impact Assessment principles](https://www.oecd.org/en/publications/regulatory-impact-assessment_7a9638cb-en.html) are the canonical cross-jurisdiction RIA anchor; local law and procedure control.
109+
- [USAID Logical Framework guide](https://www.usaid.gov/sites/default/files/2022-05/The-Logical-Framework-A-Managers-Guide.pdf) is a source anchor for the Logframe as a design-and-evaluation aid, not a guarantee of causality.
110+
- [IDRC Outcome Mapping](https://idrc-crdi.ca/en/books/outcome-mapping-building-learning-and-reflection-development-programs) anchors behavior/relationship-centered planning, monitoring, and contribution learning in complex development programs.
103111
- [ISO 37301:2021](https://www.iso.org/standard/75080.html) plus Amendment 1:2024 remains the compliance-management requirements standard; ISO 37302:2025 provides effectiveness guidance.
104112
- ISO 19011:2026 is the current management-system audit guidance; do not cite the superseded 2018 edition as current.
105113
- [UN Guiding Principles on Business and Human Rights](https://www.ohchr.org/sites/default/files/Documents/Publications/GuidingPrinciplesBusinessHR_EN.pdf) and the 2023 OECD Guidelines for Multinational Enterprises are authoritative general responsible-business anchors; apply current jurisdictional duties.

0 commit comments

Comments
 (0)