alterlab-ssci-reflexivity-gate

$npx mdskill add AlterLab-IEU/AlterLab-Academic-Skills/alterlab-ssci-reflexivity-gate

Gates trustworthiness before qualitative interpretivist claims are written.

  • Ensures qualitative studies meet Lincoln & Guba trustworthiness criteria.
  • Reads/writes YAML Design Passport; optional checklist linter runs locally.
  • Checks positionality, credibility, transferability, dependability, confirmability, and reflexivity.
  • Refuses interpretivist claims lacking warrant; passes control to alterlab-qualitative-analysis.

SKILL.md

.github/skills/alterlab-ssci-reflexivity-gateView on GitHub ↗
---
name: alterlab-ssci-reflexivity-gate
description: "Gates trustworthiness before qualitative or interpretivist claims are written — the qualitative analog of the measurement gate. Checks that researcher positionality and role are stated, that the four Lincoln & Guba trustworthiness criteria are addressed (credibility via triangulation / member-checking / prolonged engagement, transferability via thick description, dependability via an audit trail, confirmability via reflexive bracketing), and that reflexivity is evidenced rather than asserted. Fail-closed: interpretivist generalizing or causal language is refused without the corresponding warrant. Use when a study is qualitative / ethnographic / interpretivist, when reviewing trustworthiness or reflexivity, or before writing up thematic or grounded-theory findings. For quantitative measurement validity prefer alterlab-ssci-measurement-gate; for running the coding prefer alterlab-qualitative-analysis; for the final claim audit prefer alterlab-ssci-inference-gate. Part of the AlterLab Academic Skills suite."
license: MIT
allowed-tools: Read Bash(python:*)
compatibility: "No API key required. A discipline-enforcing gate; coding execution is handed to alterlab-qualitative-analysis. Reads/writes the YAML Design Passport like the other ssci gates; the optional checklist linter runs locally via `uv run python` (standard library only)."
metadata:
    skill-author: AlterLab
    version: "1.0.0"
    depends_on: "alterlab-ssci-orchestrator (pipeline), alterlab-qualitative-analysis (coding), alterlab-qualitative-methods (methodology); audited by alterlab-ssci-inference-gate"
---

# Reflexivity Gate — Trustworthiness Before the Interpretivist Claim

**Skill type: DISCIPLINE-ENFORCING.** This is the qualitative analog of the measurement gate in
the social-science methods spine. Where the measurement gate asks "is this number a valid,
reliable measure?", the reflexivity gate asks "is this interpretation *trustworthy* — and is the
researcher's hand in it made visible?" It runs no coding itself; it requires the warrant and
routes execution to `alterlab-qualitative-analysis`.

## The Core Rule

```
IN INTERPRETIVE WORK THE RESEARCHER IS THE INSTRUMENT. STATE POSITIONALITY AND EARN TRUSTWORTHINESS
BEFORE MAKING A CLAIM — DON'T ASSERT RIGOR, EVIDENCE IT.
```

Positivist validity does not transfer to interpretivist work. The field's analog is Lincoln &
Guba's **trustworthiness**: credibility, transferability, dependability, confirmability. A
qualitative claim is only as strong as the warrant behind each — and the researcher's positionality
shapes the finding, so it must be declared, not hidden behind a passive voice.

## When to Use This Skill

- "Review the trustworthiness / rigor of my qualitative study."
- "I'm writing up my thematic / grounded-theory / ethnographic findings — am I ready?"
- "How do I address reflexivity and positionality in my methods section?"
- "Can I say my interpretivist findings generalize to other settings?" (← transferability warrant)

### Does NOT Trigger

| The request is really about… | Route to | Why not this skill |
|---|---|---|
| Quantitative scale reliability / validity (omega, CFA, invariance) | `alterlab-ssci-measurement-gate` | This gate is the *qualitative* validity analog. |
| Actually coding the data / computing intercoder reliability | `alterlab-qualitative-analysis` | This gate requires trustworthiness; that skill does the coding. |
| Choosing the qualitative design / method (grounded theory, phenomenology) | `alterlab-qualitative-methods` | Method selection, upstream. |
| Auditing the final written claim against design + evidence | `alterlab-ssci-inference-gate` | Terminal claim audit. |
| Picking the study design in the first place | `alterlab-ssci-design-gate` | Design routing. |

## The four trustworthiness criteria (Lincoln & Guba)

| Criterion | Positivist analog | Warrant the gate requires |
|-----------|-------------------|---------------------------|
| **Credibility** | internal validity | triangulation (data / investigator / method), member-checking, prolonged engagement, negative-case analysis, peer debriefing |
| **Transferability** | external validity | **thick description** of context so a reader can judge fit — NOT a claim of statistical generalization |
| **Dependability** | reliability | an **audit trail**: documented, traceable decisions from raw data to themes |
| **Confirmability** | objectivity | findings grounded in data, not researcher bias — reflexive bracketing, an audit of the chain of evidence |

## Positionality & reflexivity — evidenced, not asserted

Require a positionality statement: the researcher's role, relationship to participants/setting, and
the standpoint (disciplinary, social, personal) that shapes interpretation. "Reflexivity" written as
a one-line claim is not evidence — the gate wants *how* positionality was examined and how it
affected coding/interpretation (e.g. a reflexive journal, bracketing notes, team debriefs).

## Gate verdict semantics (matches the other ssci gates)

- **PASS** — positionality stated; all four trustworthiness criteria have a named, evidenced warrant.
- **WARN** — a criterion is addressed thinly (e.g. member-checking claimed but not described);
  advance with the caveat recorded in `gate_log`.
- **BLOCK (fail-closed)** — no positionality statement at all, OR an **interpretivist generalization /
  causal claim with no transferability (thick-description) warrant**. The claim must be scoped to the
  studied case, or the warrant supplied, before writing proceeds.

## The Design Passport (hand-off)

Append the qualitative-validity stanza the orchestrator threads downstream:

```yaml
positionality: <researcher role, relationship to setting, standpoint — or "MISSING" (BLOCK)>
trustworthiness:
  credibility: <triangulation / member-checking / prolonged engagement — evidence, or "none">
  transferability: <thick description present? scope of any transfer claim>
  dependability: <audit trail present?>
  confirmability: <reflexive bracketing / evidence chain>
reflexivity_evidence: <journal / bracketing / debriefs — how positionality was examined>
claim_scope: <case-bounded (transferable by thick description) | over-generalized (BLOCK)>
```

`alterlab-ssci-inference-gate` later audits the written claims against `claim_scope`.

## Self-Check Before Advancing

- Is positionality stated and its effect on interpretation examined (not just asserted)?
- Does each of the four criteria have a *named, evidenced* warrant, not a bare label?
- Is any generalization scoped by thick description to what the case supports (not statistical)?
- Is the reliability step method-appropriate — a coefficient only for codebook/content-analytic
  work, consensus-and-reflexivity for reflexive TA (routed to `alterlab-qualitative-analysis`)?

## References

- `references/trustworthiness.md` — the four criteria, their techniques, positionality guidance, and a write-up template.
- `scripts/trustworthiness_checklist.py` — stdlib linter flagging missing positionality / criteria / over-generalized claims against the Passport facts.

Part of the AlterLab Academic Skills suite.

More from AlterLab-IEU/AlterLab-Academic-Skills

SkillDescription
alterlab-abm-mesaBuilds agent-based models of social systems with Mesa 3 — the current AgentSet API (model.agents.shuffle_do('step'), auto-assigned unique_id, mandatory super().__init__(seed=...)), cell spaces (mesa.discrete_space OrthogonalMooreGrid / classic mesa.space grids), the DataCollector, batch_run parameter sweeps, and SolaraViz — for emergence, segregation, diffusion, opinion dynamics, and cooperation models. It uses the Mesa 3.x API (the old mesa.time schedulers like RandomActivation are removed) and treats the model as a generative theory to be validated, not just run. Use when the request mentions an agent-based model, Mesa, simulating interacting agents, or emergent macro behavior from micro rules. For discrete-event (queueing/process) simulation prefer alterlab-simpy; for reinforcement learning prefer alterlab-stable-baselines3. Part of the AlterLab Academic Skills suite.
alterlab-academic-careerPrepares academic career documents and professional-development materials for faculty and researchers. Use when drafting academic CVs, research statements, teaching philosophies, diversity statements, faculty-position cover letters, tenure dossiers, promotion narratives, academic portfolios, or mentorship statements, and when planning conference-networking strategy, building academic web presence, setting up ORCID profiles, or understanding impact metrics. Part of the AlterLab Academic Skills suite.
alterlab-accreditation-aolScaffolds program-level Assurance-of-Learning (AoL) documentation for AACSB (2020 Standard 5) and ABET (Criterion 3 Student Outcomes, Criterion 4 Continuous Improvement) accreditation — program learning outcomes / competency goals, curriculum-to-outcome mapping matrices, direct- and indirect-assessment plans, rubric design, and closing-the-loop continuous-improvement narratives — and validates the structure of an outcome-mapping matrix with scripts/aol_matrix.py. Use when the user needs AACSB or ABET assurance-of-learning material, a program-learning-outcomes set, a curriculum/outcome map or coverage matrix, a direct/indirect assessment plan, a closing-the-loop report, or accreditation self-study text. For single-course design or course rubrics prefer alterlab-teaching-design; for post-award grant reports prefer alterlab-grant-reporting. Part of the AlterLab Academic Skills suite.
alterlab-adaptyvSubmits and tracks protein-testing experiments on the Adaptyv Bio Foundry cloud lab (wet-lab validation), and optimizes protein sequences before submission with computational tools (NetSolP, SoluProt, SolubleMPNN, ESM). Use when designing proteins that need wet-lab validation - binding/affinity screening, expression testing, thermostability, or fluorescence assays - or when submitting experiments to the Foundry API, browsing the target catalog, tracking experiment status, retrieving results, or pre-screening sequences for solubility/expression. Triggers on "Adaptyv", "Foundry API", "cloud lab", "biolayer interferometry / BLI", "wet-lab validation". Part of the AlterLab Academic Skills suite.
alterlab-aeonRuns time series machine learning with the aeon library — classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search via scikit-learn compatible APIs. Use when working with temporal data, sequential patterns, or time-indexed observations (univariate or multivariate) that need specialized algorithms beyond standard ML approaches. Part of the AlterLab Academic Skills suite.
alterlab-akademik-tesvikComputes the annual Turkish academic-incentive (akademik teşvik) score for Devlet (state) university öğretim elemanı (academic staff) from a classified activity list, applying the verified Akademik Teşvik Ödeneği Yönetmeliği (2018/11834) Faaliyet Hesaplama Tablosu headline puanları (Proje 20, Araştırma 15, Yayın 30, Patent 30, Atıf 30, Tebliğ 20, Ödül 20) with the k (author-count), p (Q1 1/Q2 0.8/Q3 0.5/Q4 0.25), and r (project-role) coefficients via türü puanı = Σ(faaliyet oranları) × headline (MADDE 8/2), then enforcing the per-type headline ceilings, the 100 cap (MADDE 8/3), and the net-30 payment gate (MADDE 10/3) in a deterministic scripts/tesvik_score.py. Use when the user wants to calculate akademik teşvik puanı, check the en az 30 (net-30) threshold, apply TABLO 4 ceilings, or estimate teşvik eligibility; keeps its coefficients separate from doçentlik scoring. For doçentlik point eligibility prefer alterlab-docentlik-eligibility. Part of the AlterLab Academic Skills suite.
alterlab-alpha-vantageAccesses real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API (requires a free API key from alphavantage.co). Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Part of the AlterLab Academic Skills suite.
alterlab-alphafoldPredict protein 3D structures with AlphaFold2 via ColabFold — MMseqs2-accelerated MSAs, monomer and AlphaFold2-Multimer complex folding, and confidence-based validation (pLDDT, pTM/ipTM, PAE). Use when folding a protein sequence or complex from FASTA, generating a predicted structure with confidence metrics, ranking models, or checking self-consistency of a design. For co-folding a protein WITH a small-molecule ligand or predicting binding affinity prefer alterlab-boltz; for antibody–antigen or one-FASTA multi-entity complexes prefer alterlab-chai; to LOOK UP an already-computed structure prefer alterlab-alphafold-db; for ESM embeddings or inverse folding prefer alterlab-esm. Part of the AlterLab Academic Skills suite.
alterlab-alphafold-dbAccess the AlphaFold DB of 200M+ AI-PREDICTED protein structures — retrieve models by UniProt accession, download PDB/mmCIF files, and analyze prediction confidence metrics (pLDDT, PAE). Use when a UniProt ID needs a computationally predicted 3D structure or when no experimental structure exists, for homology modeling, protein engineering, or structure-based drug discovery; for EXPERIMENTALLY determined structures (X-ray, cryo-EM, NMR) prefer alterlab-pdb, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Skills suite.
alterlab-anndataBuild, slice, concatenate, read, and write AnnData annotated data matrices (obs, var, X, layers, obsm, uns) — the scverse data STRUCTURE, not an analysis pipeline. Use when creating or wrangling .h5ad/zarr files, managing cell and gene annotations, concatenating batches, or handling layers/obsm/backed-mode; for the QC, normalization, clustering, UMAP, and differential-expression analysis pipeline prefer alterlab-scanpy instead, and for RNA velocity from spliced/unspliced layers prefer alterlab-scvelo instead. Part of the AlterLab Academic Skills suite.