Load the smallest set of references that answers the task. Do not load README or research briefs by default.
| Mode | Max references | Default files |
|---|---|---|
quick |
1 | modules/indie-dev-faq.md or one task-specific module |
audit |
3 | runtime/input-contracts.md, plus up to two modules selected by issue |
design |
2 | runtime/pareto-cards.json, plus copy/layout/category module as needed |
calculator |
1 + script | modules/unit-economics-calculator.md, tools/ltv-calculator.py |
compliance |
2 | modules/decision-trees.md, docs/audit-checklist.md |
pattern |
1 | modules/teardowns.md or one pattern module |
implementation |
3 | runtime/input-contracts.md, billing/provider docs from target app, one domain module |
| Need | Load |
|---|---|
| One tactical benchmark answer | modules/indie-dev-faq.md |
| Common screenshot/design task | runtime/pareto-cards.json |
| Source-backed numeric claim | Run tools/source_lookup.py |
| Plan/pricing/category economics | modules/category-deep-dives.md |
| LTV/ROAS/breakeven | modules/unit-economics-calculator.md and script |
| App Store risk | modules/decision-trees.md, docs/audit-checklist.md |
| Toggle-paywall migration | docs/migrations/from-toggle-paywall.md |
| Copy variants | modules/copy-library.md |
| Layout/accessibility | modules/screen-anatomy.md |
| Localization/geo-pricing | modules/localization.md |
| Android parity | modules/android-parity.md |
| Acquisition/CAC | modules/cac-acquisition.md |
| Onboarding handoff | modules/onboarding-paywall-handoff.md |
| Notifications/lifecycle | modules/notifications-lifecycle.md |
| Refunds | modules/refund-management.md |
| Cohorts | modules/cohort-analysis.md |
| Academic mechanism | modules/pricing-psychology.md |
| Acronyms/definitions | modules/glossary.md |
Use lookup for numeric claims instead of loading benchmark tables.
python3 tools/source_lookup.py --query "trial paid global" --limit 3 --json
python3 tools/source_lookup.py --id trial-paid-global-25-6-27-8 --jsonRequired output fields for cited numeric claims:
claim, evidence_class, source, date, url, scope, id
Load outputs/2026-paywall-research-v2.md only when the user asks for methodology, provenance, or deep research. Prefer sources.json plus lookup for normal answers.