Toc Builder

gasserane/personal-skills/skills/toc-builder

作者 gasseranea22368a1505356d9815ee7aa7ffd65f0afeb5bad无许可证收录于 2026年10月9日更新于 2026年10月9日

Build a rigorous Theory of Change for MEL/SRHR programmes following Vogel (2012) DFID criteria and van Eerdewijk et al. (2017) KIT feminist ToC model. Use when Ane asks for a "theory of change", "ToC", "programme logic", "change pathway", "pathway analysis", or similar. Produces articulated outcomes, preconditions, assumptions (tested vs untested), contribution questions, and an evidence plan. Flags missing feminist political economy analysis.

AI 生成的概览

为MEL与SRHR项目构建结构化的变革理论,包含假设、贡献问题与证据计划。

功能
引导用户以逆向映射方式构建变革理论:愿景、按时间范围划分的前提条件、因果主张与假设、女性主义政治经济学分析、威胁、贡献问题以及证据计划。产出包含十个部分的变革理论文档,其中有文本形式的路径呈现和可选的Mermaid源码,并标注数据缺口与未经检验的机制。引用指定框架,不生成指标。
适用场景
适用于项目设计、变革理论修订、路径分析、项目逻辑审查、资助方要求的变革理论提交或变革理论评审。不适用于常规成果框架、逻辑框架或指标清单,这些属于变革理论的下游产物。
运行要求
无脚本,仅为说明性内容。起草前需要用户提供长期成果、目标人群与背景、项目范围和时间框架;既有分析和女性主义政治经济学分析为可选项,但在SRHR工作中应提供。引用外部写作风格文件和编辑保留协议文档。

Theory of Change Builder

A ToC is not a logic model with arrows. It is an argument about how change happens, with the assumptions made visible and testable. This skill enforces that standard.

When to use

Trigger for theory-of-change work: new programme design, ToC revision, pathway analysis, programme logic review, funder-required ToC submissions, or ToC critique.

Do not trigger for routine results frameworks, logframes, or indicator lists — those are downstream of the ToC.

Required inputs

Ask in one batch. Do not start drafting without the first four.

  1. Long-term outcome or vision: the change Ane wants the programme to contribute to, stated in language the target population would recognise (required)
  2. Target population and context: who, where, what constraints shape their lives (required)
  3. Programme scope: what interventions the programme can actually deliver (required)
  4. Timeframe: short (12 mo), medium (3 yr), long (5-10 yr) markers (required)
  5. Existing analysis: prior ToC, needs assessment, or evaluation findings (optional)
  6. Feminist political economy analysis: who holds power in this system, how gender and other axes shape access (optional but required for SRHR; will prompt if missing)

Method

Work backward from the long-term outcome. Never forward from activities.

Step 1 — articulate the vision

Write the long-term outcome as one sentence. Must be specific enough to be falsifiable. "Improved SRHR outcomes" fails. "Adolescent girls in [region] access quality contraception within 30 minutes' travel, without third-party consent" passes.

Step 2 — identify preconditions

What must be true for the long-term outcome to hold? List preconditions at medium-term and short-term horizons. Each precondition is itself a change state, not an activity.

Step 3 — surface the causal links

For every link between preconditions, name:

  • Causal claim: why does A lead to B in this context?
  • Assumption: what must be true, outside the programme's control, for A to actually lead to B?
  • Evidence status: tested (cite the source), plausible (cite the framework), or untested (flag for evidence gap)

Step 4 — apply the feminist political economy lens

Do not skip this, even if the programme is not labelled SRHR. For each node:

  • Whose interests does this change serve? Whose interests does it threaten?
  • What power relations must shift for this change to stick?
  • Which voices defined this outcome? Who was consulted? Who co-designed?

If these questions cannot be answered, mark the precondition with ⚠️ Feminist political economy analysis missing.

Step 5 — identify threats to the ToC

From Mayne (2019): what alternative explanations would account for the expected change if the programme were not running? What other contributions are likely? Name them.

Step 6 — define the contribution question

State the evaluative question the ToC must eventually answer. Follow Mayne (2019) phrasing: "To what extent and in what ways did the programme contribute to [outcome], given other contributions and context?"

Step 7 — plan the evidence

For each assumption, name:

  • What would confirm it?
  • What would disconfirm it?
  • What data source could provide that evidence?
  • When will the ToC be revisited in light of the evidence?

Output structure

Produce a ToC document with these sections under these H2s:

  1. Vision — one sentence, as described in Step 1
  2. Context and population — two paragraphs max
  3. Pathway diagram — text representation: each precondition as a node, each link described in one sentence. If the user needs a visual, produce Mermaid source.
  4. Preconditions by horizon — three columns (short / medium / long), each precondition one line
  5. Causal claims and assumptions — table: From → To, Causal claim, Assumption, Evidence status
  6. Feminist political economy analysis — per-node power and participation notes
  7. Threats to the ToC — rival explanations and other contributions
  8. Contribution question — one sentence
  9. Evidence plan — table: Assumption, Confirming evidence, Disconfirming evidence, Data source, Revisit date
  10. Data gaps — ⚠️ Data gap: entries for anything missing

Citation requirements

Every framework claim cites author and year. Mandatory versions:

  • Vogel (2012) "Review of the Use of 'Theory of Change' in International Development" (DFID)
  • van Eerdewijk et al. (2017) "White Paper: A Conceptual Model of Women and Girls' Empowerment" (KIT)
  • Mayne (2019) "Revisiting the Contribution Question" Evaluation 25(3)
  • Cornwall & Rivas (2015) for feminist framing when relevant

Writing rules

Follow CLAUDE.md house style. No hedging in causal claims — if the claim is uncertain, state that the evidence is untested. No logical leaps — if Step 3 cannot name the causal mechanism, mark the link as ⚠️ Untested mechanism.

Limitations

This skill does not generate indicators. Route to indicator-designer after the ToC is stable. It does not replace stakeholder consultation — it structures the analysis Ane brings from that consultation.

Edit-preservation protocol

If Ane references an existing output by path and asks to improve, iterate, or expand it, the protocol activates. Read the file first, edit scope-bounded via the Edit tool, preserve out-of-scope content byte-identical, and return the EDIT-PRESERVATION DELIVERY summary.

Apply mel_wiki/wiki/concepts/edit-preservation-protocol.md when target file exists.

来源与署名

来源:gasserane/personal-skills位于skills/toc-builder提交a22368a

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架