qualitative-research-pro 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +108 -0
- package/CLAUDE.md +171 -0
- package/LICENSE +21 -0
- package/README.md +166 -0
- package/agents/analysis-orchestrator.md +162 -0
- package/agents/audit-trail-builder.md +127 -0
- package/agents/category-developer.md +179 -0
- package/agents/citation-manager.md +83 -0
- package/agents/constant-comparator.md +135 -0
- package/agents/data-manager.md +104 -0
- package/agents/discussion-writer.md +128 -0
- package/agents/document-analyst.md +114 -0
- package/agents/ethics-reviewer.md +119 -0
- package/agents/field-note-analyst.md +124 -0
- package/agents/fit-assessor.md +192 -0
- package/agents/grounded-theorist.md +210 -0
- package/agents/literature-integrator.md +169 -0
- package/agents/literature-reviewer.md +112 -0
- package/agents/memo-writer.md +234 -0
- package/agents/methodology-critic.md +166 -0
- package/agents/methods-writer.md +109 -0
- package/agents/open-coder.md +187 -0
- package/agents/pattern-analyst.md +166 -0
- package/agents/peer-reviewer.md +129 -0
- package/agents/planner.md +122 -0
- package/agents/proposal-writer.md +108 -0
- package/agents/reflexivity-auditor.md +128 -0
- package/agents/research-designer.md +164 -0
- package/agents/research-writer.md +100 -0
- package/agents/saturation-assessor.md +159 -0
- package/agents/selective-coder.md +167 -0
- package/agents/theoretical-coder.md +260 -0
- package/agents/theoretical-sampler.md +165 -0
- package/agents/transcript-analyst.md +123 -0
- package/bin/cli.mjs +236 -0
- package/hooks/dist/agent-memory-loader.mjs +94 -0
- package/hooks/dist/agent-memory-saver.mjs +113 -0
- package/hooks/dist/bash-audit-log.mjs +71 -0
- package/hooks/dist/credential-deny.mjs +165 -0
- package/hooks/dist/forge-compile-check.mjs +92 -0
- package/hooks/dist/gas-snapshot-diff.mjs +71 -0
- package/hooks/dist/memory-awareness.mjs +276 -0
- package/hooks/dist/natspec-enforcer.mjs +67 -0
- package/hooks/dist/passive-learner.mjs +220 -0
- package/hooks/dist/pre-compact-continuity.mjs +467 -0
- package/hooks/dist/sast-on-edit.mjs +230 -0
- package/hooks/dist/session-analytics.mjs +84 -0
- package/hooks/dist/session-end-cleanup.mjs +121 -0
- package/hooks/dist/session-outcome.mjs +84 -0
- package/hooks/dist/session-register.mjs +307 -0
- package/hooks/dist/session-start-continuity.mjs +405 -0
- package/hooks/dist/slither-on-save.mjs +87 -0
- package/hooks/dist/storage-layout-check.mjs +89 -0
- package/hooks/dist/transcript-parser.mjs +214 -0
- package/install.sh +194 -0
- package/package.json +46 -0
- package/plugin.json +19 -0
- package/rules/academic-writing-style.md +42 -0
- package/rules/citation-standards.md +47 -0
- package/rules/current-methodological-state.md +40 -0
- package/rules/data-handling.md +44 -0
- package/rules/finding-output-format.md +47 -0
- package/rules/gt-coding-standards.md +40 -0
- package/rules/methodological-rigor.md +56 -0
- package/rules/quality-criteria.md +41 -0
- package/rules/reflexivity-requirements.md +40 -0
- package/rules/research-ethics-standards.md +44 -0
- package/skills/.gitkeep +2 -0
- package/skills/academic-writing/SKILL.md +73 -0
- package/skills/action-research/SKILL.md +96 -0
- package/skills/apa-formatting/SKILL.md +85 -0
- package/skills/case-study-methods/SKILL.md +96 -0
- package/skills/category-development/SKILL.md +80 -0
- package/skills/chicago-formatting/SKILL.md +81 -0
- package/skills/coding-pipeline/SKILL.md +81 -0
- package/skills/conceptual-frameworks/SKILL.md +70 -0
- package/skills/constant-comparison/SKILL.md +188 -0
- package/skills/constructivist-gt/SKILL.md +91 -0
- package/skills/data-management-protocols/SKILL.md +67 -0
- package/skills/document-analysis/SKILL.md +66 -0
- package/skills/ethnographic-methods/SKILL.md +82 -0
- package/skills/focus-group-methods/SKILL.md +66 -0
- package/skills/formal-theory/SKILL.md +159 -0
- package/skills/glaserian-grounded-theory/SKILL.md +212 -0
- package/skills/interview-design/SKILL.md +67 -0
- package/skills/literature-synthesis/SKILL.md +71 -0
- package/skills/member-checking/SKILL.md +66 -0
- package/skills/memo-writing/SKILL.md +158 -0
- package/skills/mixed-methods-design/SKILL.md +69 -0
- package/skills/narrative-inquiry/SKILL.md +101 -0
- package/skills/observation-methods/SKILL.md +67 -0
- package/skills/open-coding/SKILL.md +176 -0
- package/skills/paradigmatic-positioning/SKILL.md +72 -0
- package/skills/peer-debriefing/SKILL.md +72 -0
- package/skills/phenomenological-methods/SKILL.md +91 -0
- package/skills/qualitative-rigor/SKILL.md +78 -0
- package/skills/reflexive-practice/SKILL.md +64 -0
- package/skills/research-ethics/SKILL.md +64 -0
- package/skills/research-proposal-writing/SKILL.md +81 -0
- package/skills/research-questions/SKILL.md +66 -0
- package/skills/sampling-strategies/SKILL.md +61 -0
- package/skills/selective-coding/SKILL.md +183 -0
- package/skills/situational-analysis/SKILL.md +93 -0
- package/skills/substantive-theory/SKILL.md +169 -0
- package/skills/thematic-analysis/SKILL.md +80 -0
- package/skills/theoretical-coding/SKILL.md +213 -0
- package/skills/theoretical-sampling/SKILL.md +152 -0
- package/skills/theoretical-saturation/SKILL.md +179 -0
- package/skills/theoretical-sensitivity/SKILL.md +175 -0
- package/skills/theory-integration/SKILL.md +85 -0
- package/skills/thick-description/SKILL.md +69 -0
- package/skills/triangulation/SKILL.md +65 -0
- package/skills/visual-modeling/SKILL.md +66 -0
- package/skills/vulnerable-populations/SKILL.md +69 -0
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: research-proposal-writing
|
|
3
|
+
description: Use when writing research proposals or grant applications for qualitative or grounded theory studies.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Research Proposal Writing (Qualitative & Grounded Theory)
|
|
7
|
+
|
|
8
|
+
A strong proposal convinces reviewers that the study is **important, feasible, ethical, and methodologically coherent**—even when outcomes are emergent rather than hypothesized.
|
|
9
|
+
|
|
10
|
+
## Proposal structure (typical)
|
|
11
|
+
|
|
12
|
+
- Summary/abstract.
|
|
13
|
+
- Specific aims or objectives.
|
|
14
|
+
- Significance/innovation.
|
|
15
|
+
- Background (tailored—see GT paradox below).
|
|
16
|
+
- Methods: design, setting, participants/sampling, data collection, analysis, rigor, ethics, timeline, team roles.
|
|
17
|
+
- Dissemination; broader impacts (funder-dependent).
|
|
18
|
+
- Budget and justification; facilities/resources.
|
|
19
|
+
|
|
20
|
+
## The grounded theory proposal paradox
|
|
21
|
+
|
|
22
|
+
GT proposals must demonstrate preparedness without **predetermining findings**. Frame the topic as an **area of interest** and justify why emergent theory is needed. Describe **analytic procedures** (constant comparison, memoing, theoretical sampling) rather than a finalized conceptual framework.
|
|
23
|
+
|
|
24
|
+
## Writing for non-qualitative reviewers
|
|
25
|
+
|
|
26
|
+
Translate:
|
|
27
|
+
|
|
28
|
+
- “Saturation” → explain as **stopping criterion based on category development**, not magic N.
|
|
29
|
+
- “Emergence” → clarify disciplined procedures that prevent cherry-picking.
|
|
30
|
+
- “Rigor” → name concrete techniques (audit trail, triangulation, debriefing) appropriate to your paradigm.
|
|
31
|
+
|
|
32
|
+
Avoid jargon walls; include a concise **why qualitative** paragraph.
|
|
33
|
+
|
|
34
|
+
## Significance section
|
|
35
|
+
|
|
36
|
+
Connect to gaps: what is unknown, costly, unjust, or theoretically weak. Specify **who benefits** and how knowledge will be used—without overpromising causal claims qualitative designs cannot support.
|
|
37
|
+
|
|
38
|
+
## Methodology justification
|
|
39
|
+
|
|
40
|
+
Defend **why GT** (or other approach) fits the phenomenon. Describe **initial sampling** and how **theoretical sampling** will evolve. Name software if used, but emphasize **analytic discipline**, not button clicks.
|
|
41
|
+
|
|
42
|
+
## Timeline
|
|
43
|
+
|
|
44
|
+
Use phased milestones: IRB, pilot, initial interviews, iterative coding cycles, selective/theoretical coding, write-up. Build time for **transcription** and **team reconciliation**.
|
|
45
|
+
|
|
46
|
+
## Budget
|
|
47
|
+
|
|
48
|
+
Include transcription, participant incentives, travel/site costs, software licenses, translation/back-translation if needed, and conference dissemination if allowed.
|
|
49
|
+
|
|
50
|
+
## Broader impacts (NSF-style framing)
|
|
51
|
+
|
|
52
|
+
Education/training products, public engagement, tools/templates (de-identified), community partnerships—aligned with funder values.
|
|
53
|
+
|
|
54
|
+
## NIH-specific considerations (qualitative)
|
|
55
|
+
|
|
56
|
+
Qualitative work may appear in mixed-methods aims; justify **integration**. Human subjects sections must be meticulous. Check relevant FOAs for qualitative-friendly language and review panels.
|
|
57
|
+
|
|
58
|
+
## NSF-specific considerations
|
|
59
|
+
|
|
60
|
+
Broader impacts and data management plans must be realistic for qualitative constraints; describe **metadata and sharing limits** ethically.
|
|
61
|
+
|
|
62
|
+
## Red flags reviewers notice
|
|
63
|
+
|
|
64
|
+
- “We will prove hypothesis X” in classic GT proposals.
|
|
65
|
+
- Vague analysis (“themes will be identified”) with no procedural depth.
|
|
66
|
+
- Sampling that cannot possibly support claims.
|
|
67
|
+
- Ethics underspecified for sensitive topics.
|
|
68
|
+
|
|
69
|
+
## Checklist
|
|
70
|
+
|
|
71
|
+
- [ ] Paradox of emergence handled with procedural specificity.
|
|
72
|
+
- [ ] Rigor strategies named and matched to paradigm.
|
|
73
|
+
- [ ] Timeline includes iterative analysis realities.
|
|
74
|
+
- [ ] Budget covers hidden qualitative costs.
|
|
75
|
+
- [ ] Data management/sharing ethically truthful.
|
|
76
|
+
|
|
77
|
+
## References (starting points)
|
|
78
|
+
|
|
79
|
+
- Stern, P. N. (Ed.). *Grounded theory in applied practice* — proposal and project realities.
|
|
80
|
+
- O’Cathain, A., Murphy, E., & Nicholl, J. (2008). Multidisciplinary, interdisciplinary, or dysfunctional? *Journal of Mixed Methods Research*.
|
|
81
|
+
- Funder solicitation texts and sample funded proposals (when accessible).
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: research-questions
|
|
3
|
+
description: Use when formulating qualitative research questions — open-ended, exploratory, process-oriented questions appropriate for the chosen methodology.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Qualitative Research Questions
|
|
7
|
+
|
|
8
|
+
Qualitative research questions invite **meaning, process, and context**. They should be **open-ended**, non-leading, and aligned with what your methodology can actually deliver.
|
|
9
|
+
|
|
10
|
+
## What makes a good qualitative RQ
|
|
11
|
+
|
|
12
|
+
- Explores **how/why/what** in a situated way (wording depends on tradition).
|
|
13
|
+
- Avoids pre-judging mechanisms or imposing variables.
|
|
14
|
+
- Matches **data access** and ethics (what you can actually observe/ask).
|
|
15
|
+
- Is **focused** enough to bound the study yet **flexible** enough to learn.
|
|
16
|
+
|
|
17
|
+
## Grounded theory: area of interest vs forced questions
|
|
18
|
+
|
|
19
|
+
Classic GT often begins with a broad **area of interest** rather than a tight hypothesis. Questions should not telegraph expected categories. As theory emerges, questions in later interviews become **theoretically sampled** to fill analytic gaps.
|
|
20
|
+
|
|
21
|
+
## Phenomenology
|
|
22
|
+
|
|
23
|
+
Central question form often resembles: **“What is the lived experience of X?”** Follow with probes about essence, embodiment, time, and relationality—aligned with your phenomenological variant (descriptive, interpretive, hermeneutic).
|
|
24
|
+
|
|
25
|
+
## Ethnography
|
|
26
|
+
|
|
27
|
+
Ask **cultural/process** questions: What meanings, practices, and norms constitute membership? How is everyday life organized in this setting? How do insiders explain their actions?
|
|
28
|
+
|
|
29
|
+
## Case study
|
|
30
|
+
|
|
31
|
+
Yin-style case studies often ask **how/why** about a bounded system. Questions should clarify **case boundaries** (unit of analysis) and the theoretical proposition the case illuminates—without smuggling quantitative causality claims.
|
|
32
|
+
|
|
33
|
+
## Avoiding quantitative framing
|
|
34
|
+
|
|
35
|
+
Steer away from “How much?”, “How many?”, or “Does X cause Y?” unless you truly have measurement designs. If magnitudes matter, consider mixed methods rather than forcing a qualitative core question into a survey frame.
|
|
36
|
+
|
|
37
|
+
## Evolving RQs in GT
|
|
38
|
+
|
|
39
|
+
It is legitimate to **revise** the research question as the core category emerges. Document the evolution in your audit trail (“initial focus → refined focus after selective coding”). Proposals can present **staging**: initial orienting question + plan to refine.
|
|
40
|
+
|
|
41
|
+
## From RQ to interview guide
|
|
42
|
+
|
|
43
|
+
Translate the RQ into **topic areas** and **open prompts**, not a litany of micro-questions that exhaust participants.
|
|
44
|
+
|
|
45
|
+
## Evaluation rubric (quick)
|
|
46
|
+
|
|
47
|
+
- Open?
|
|
48
|
+
- Non-leading?
|
|
49
|
+
- Feasible?
|
|
50
|
+
- Ethical?
|
|
51
|
+
- Method-aligned?
|
|
52
|
+
- Single-bounded phenomenon (not ten dissertations in one)?
|
|
53
|
+
|
|
54
|
+
## Checklist
|
|
55
|
+
|
|
56
|
+
- [ ] RQ matches methodology (GT/phenomenology/ethnography/case).
|
|
57
|
+
- [ ] Process/meaning central; quantification not smuggled in.
|
|
58
|
+
- [ ] GT: openness preserved; theoretical sampling plan noted.
|
|
59
|
+
- [ ] Case/ethnography: boundaries defined.
|
|
60
|
+
- [ ] Evolution pathway documented where emergent designs apply.
|
|
61
|
+
|
|
62
|
+
## References (starting points)
|
|
63
|
+
|
|
64
|
+
- Maxwell, J. A. *Qualitative research design: An interactive approach* (3rd ed.).
|
|
65
|
+
- Creswell, J. W., & Poth, C. N. *Qualitative inquiry and research design: Choosing among five approaches* (4th ed.).
|
|
66
|
+
- Glaser, B. G. *Doing Grounded Theory* — emergent question evolution.
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: sampling-strategies
|
|
3
|
+
description: Use when selecting sampling strategies for qualitative research — purposeful, theoretical, snowball, criterion, maximum variation.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Sampling Strategies in Qualitative Research
|
|
7
|
+
|
|
8
|
+
Qualitative sampling prioritizes **information-rich cases** and **analytic progression** over statistical representativeness. Your sampling chapter should explain logic, not pretend to randomize for generalization in a positivist sense.
|
|
9
|
+
|
|
10
|
+
## Purposeful sampling (Patton)
|
|
11
|
+
|
|
12
|
+
Purposeful sampling selects cases that illuminate the phenomenon intensely. Common variants:
|
|
13
|
+
|
|
14
|
+
- **Maximum variation:** Deliberately include diverse contexts to surface core patterns and boundaries.
|
|
15
|
+
- **Homogeneous:** Deepen understanding within a similar subset when noise reduction helps early theory.
|
|
16
|
+
- **Typical case:** Clarify the “usual” pattern when stakeholders misunderstand extremes.
|
|
17
|
+
- **Critical case:** A instance that can falsify or strongly test an emerging claim.
|
|
18
|
+
- **Criterion:** All participants meet explicit inclusion criteria tied to the research question.
|
|
19
|
+
- **Snowball/chain:** Referrals lead to new participants; efficient for hidden populations.
|
|
20
|
+
|
|
21
|
+
## Theoretical sampling (Glaser)
|
|
22
|
+
|
|
23
|
+
After initial coding, **theoretical sampling** seeks data to elaborate **properties, dimensions, conditions, and consequences** of emerging categories. You sample for **analytic gaps**, not demographic quotas (unless demographics are theoretically relevant). The question is: “What data do I need next to develop this category?”
|
|
24
|
+
|
|
25
|
+
## Snowball and chain referral sampling
|
|
26
|
+
|
|
27
|
+
Use when populations are hard to reach or trust is network-based. Mitigate bias from seed participants by using **multiple entry points** and monitoring whose voices dominate. Document referral chains in audit materials.
|
|
28
|
+
|
|
29
|
+
## Maximum variation vs typical case
|
|
30
|
+
|
|
31
|
+
Maximum variation guards against **provincial theory**; typical case helps communicate **mundane patterning**. In GT, these are tools in service of emergent categories—choose based on what the evolving theory demands.
|
|
32
|
+
|
|
33
|
+
## Convenience sampling (with caveats)
|
|
34
|
+
|
|
35
|
+
Convenience sampling is acceptable only when limitations are **transparent** and you take compensatory steps (prolonged engagement, triangulation, negative case search). Never dress convenience up as theoretical sampling without analytic justification.
|
|
36
|
+
|
|
37
|
+
## Sample size in qualitative research
|
|
38
|
+
|
|
39
|
+
“How many?” depends on **study scope, data richness, and saturation**. A focused GT project may achieve workable saturation with fewer cases if incidents are dense; a comparative multi-site study may need many more. Report **saturation reasoning** and **disconfirming efforts**, not a fake power analysis.
|
|
40
|
+
|
|
41
|
+
## Saturation-based sampling
|
|
42
|
+
|
|
43
|
+
Saturation means **no new properties/dimensions** are emerging for a category (in the Glaserian sense), not mere repetition of wordings. Track saturation **by category**, not only globally—some categories saturate early while others remain thin.
|
|
44
|
+
|
|
45
|
+
## Integration tip
|
|
46
|
+
|
|
47
|
+
In proposals, distinguish **initial purposeful sampling** (who can get you started) from **later theoretical sampling** (who/what you need next as categories form). This shows methodological maturity in GT.
|
|
48
|
+
|
|
49
|
+
## Checklist
|
|
50
|
+
|
|
51
|
+
- [ ] Sampling logic matches methodology (purposeful vs theoretical).
|
|
52
|
+
- [ ] Inclusion/exclusion criteria explicit and ethically justified.
|
|
53
|
+
- [ ] Referral/snowball bias considered and mitigated where possible.
|
|
54
|
+
- [ ] Saturation tracked with documented negative case searches.
|
|
55
|
+
- [ ] Limitations of non-probability sampling frankly acknowledged.
|
|
56
|
+
|
|
57
|
+
## References (starting points)
|
|
58
|
+
|
|
59
|
+
- Patton, M. Q. *Qualitative research and evaluation methods* — purposeful sampling typology.
|
|
60
|
+
- Glaser, B. G., & Strauss, A. L. *The Discovery of Grounded Theory* — theoretical sampling origins.
|
|
61
|
+
- Emmel, N. *Sampling and choosing cases in qualitative research*.
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: selective-coding
|
|
3
|
+
description: "Use when the core category has emerged and you need to delimit the theory by coding selectively around the core."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Selective Coding (Classic Grounded Theory)
|
|
7
|
+
|
|
8
|
+
Selective coding begins when a **core category** has **emerged** and **earned** its place as the center of the developing theory. You shift from coding **everything** to coding **only** what develops the **story** that integrates the core category with major related categories (conditions, strategies, consequences, etc.).
|
|
9
|
+
|
|
10
|
+
Use this skill when your open coding and constant comparison suggest a **central pattern**, and you need to **delimit** scope while increasing **theoretical density** and **integration**.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## What selective coding is (and is not)
|
|
15
|
+
|
|
16
|
+
**It is**:
|
|
17
|
+
|
|
18
|
+
- **Focused** coding around the **core** and its multivariate relations.
|
|
19
|
+
- A disciplined way to **stop sprawl** while deepening **explanatory** power.
|
|
20
|
+
- A bridge from **many codes** to a **coherent theoretical outline**.
|
|
21
|
+
|
|
22
|
+
**It is not**:
|
|
23
|
+
|
|
24
|
+
- Cherry-picking quotes to fit a pet theory.
|
|
25
|
+
- Ignoring contradictory data (negative cases remain essential).
|
|
26
|
+
- Replacing comparison with a **single storyline** that ignores variation.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Identifying the core category
|
|
31
|
+
|
|
32
|
+
Glaser describes the core as the category that:
|
|
33
|
+
|
|
34
|
+
- **Recurs** frequently in varied forms.
|
|
35
|
+
- **Relates meaningfully** to many other categories.
|
|
36
|
+
- Helps **explain** variation (why some incidents differ).
|
|
37
|
+
- Often connects to participants’ **main concern** and how they **continually resolve** it.
|
|
38
|
+
|
|
39
|
+
### Practical tests for a core candidate
|
|
40
|
+
|
|
41
|
+
Ask:
|
|
42
|
+
|
|
43
|
+
1. **Coverage test**: If I remove this category, does the theory **fall apart**?
|
|
44
|
+
2. **Connection test**: Does it **link** multiple other categories (not just sit beside them)?
|
|
45
|
+
3. **Process test** (when relevant): Does it read as a **basic social process** (BSP) or central social-psychological process?
|
|
46
|
+
4. **Variation test**: Does it help explain **differences** across incidents and cases?
|
|
47
|
+
|
|
48
|
+
If a candidate fails these tests, keep comparing—**do not promote** a core by fiat.
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## Basic social process (BSP)
|
|
53
|
+
|
|
54
|
+
In many Glaserian studies, the core is a **process**: something participants **do** or **work through** over time (e.g., *status passage*, *becoming*, *managing uncertainty*).
|
|
55
|
+
|
|
56
|
+
**Indicators you may be dealing with a BSP core**:
|
|
57
|
+
|
|
58
|
+
- Temporal language (*then*, *after*, *at first*, *eventually*).
|
|
59
|
+
- Stages/phases that **vary** by condition but retain a **family resemblance**.
|
|
60
|
+
- Strategies that appear as **recurrent tactics** tied to conditions/consequences.
|
|
61
|
+
|
|
62
|
+
Not every core must be a BSP, but if your data are strongly processual, **gerund formulations** often help.
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Delimiting the theory
|
|
67
|
+
|
|
68
|
+
**Delimiting** means you intentionally **stop** trying to code all possible interesting topics. Instead, you ask of each new incident:
|
|
69
|
+
|
|
70
|
+
> “What does this contribute to **the core** and its **integrated** relationships?”
|
|
71
|
+
|
|
72
|
+
### Delimiting rules of thumb
|
|
73
|
+
|
|
74
|
+
- **Retain** data that clarifies **properties/dimensions** of core-related categories.
|
|
75
|
+
- **Retain** negative cases that define **boundaries** and **conditions**.
|
|
76
|
+
- **Deprioritize** tangents that do not change your **theoretical statements** even if they are “interesting.”
|
|
77
|
+
|
|
78
|
+
Document delimiting decisions in **memos** to preserve transparency.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Focused coding procedure
|
|
83
|
+
|
|
84
|
+
1. **State the core category** in a memo in **one sentence** (provisional).
|
|
85
|
+
2. List **major related categories** already suggested by comparison (conditions, context features, strategies, outcomes).
|
|
86
|
+
3. For each new data segment, ask:
|
|
87
|
+
- “How does this **develop** the core story?”
|
|
88
|
+
- “Does it add **properties**, **dimensions**, **conditions**, or **consequences**?”
|
|
89
|
+
4. **Compare** new incidents to **theoretical statements** you are beginning to trust—then revise statements if mismatch appears.
|
|
90
|
+
5. **Sort memos** into an emerging **outline** structured around the core.
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## Transitioning from open to selective coding
|
|
95
|
+
|
|
96
|
+
### Signals you may be ready
|
|
97
|
+
|
|
98
|
+
- Repeated **redundancy** in open coding relative to the same conceptual points.
|
|
99
|
+
- Memo outlines keep returning to the **same center of gravity**.
|
|
100
|
+
- You can **summarize** the study’s main pattern without relying on dozens of disconnected themes.
|
|
101
|
+
|
|
102
|
+
### A safe transition practice
|
|
103
|
+
|
|
104
|
+
Run a **two-track week**:
|
|
105
|
+
|
|
106
|
+
- Track A: continue open coding on **one** new transcript.
|
|
107
|
+
- Track B: selective-code **only** for core development on the same transcript.
|
|
108
|
+
Compare results: does selective coding **lose** essential variation? If yes, you’re not ready or your core is wrong.
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## Relationship to theoretical coding
|
|
113
|
+
|
|
114
|
+
Selective coding clarifies **what** must be integrated. **Theoretical coding** (coding families) clarifies **how** categories relate (e.g., conditional, causal, strategy).
|
|
115
|
+
|
|
116
|
+
Sequence (typical in classic GT):
|
|
117
|
+
|
|
118
|
+
1. Substantive coding matures (open → selective).
|
|
119
|
+
2. Theoretical codes help **write** integrated hypotheses as the outline stabilizes.
|
|
120
|
+
|
|
121
|
+
Avoid bolting on theoretical codes **before** substantive relationships are comparatively earned.
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Output format (recommended)
|
|
126
|
+
|
|
127
|
+
### Core statement template
|
|
128
|
+
|
|
129
|
+
```text
|
|
130
|
+
Provisional core category:
|
|
131
|
+
One-sentence core claim (hypothesis):
|
|
132
|
+
Main concern (if identifiable):
|
|
133
|
+
Primary related categories (list):
|
|
134
|
+
Negative cases queued for comparison:
|
|
135
|
+
What would falsify this core claim in upcoming data?
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### Selective coding excerpt log
|
|
139
|
+
|
|
140
|
+
```text
|
|
141
|
+
Source ID / location:
|
|
142
|
+
Why this excerpt matters to the core:
|
|
143
|
+
New properties/dimensions discovered (if any):
|
|
144
|
+
Revised relationship statements (if any):
|
|
145
|
+
Next sampling impulse (theoretical sampling note):
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## Common mistakes
|
|
151
|
+
|
|
152
|
+
- **Premature selective coding** after one interview.
|
|
153
|
+
- **Renaming** without comparative justification (cosmetic “core”).
|
|
154
|
+
- **Suppressing outliers** that define scope conditions.
|
|
155
|
+
- **Theme rebranding**: calling a theme a “core” without **explanatory** work.
|
|
156
|
+
- **Mixing units**: confusing participant goals with analytic categories—keep analytic language in memos and theory.
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Quality criteria checkpoint
|
|
161
|
+
|
|
162
|
+
Revisit **fit, work, relevance, modifiability**:
|
|
163
|
+
|
|
164
|
+
- **Fit**: Does the core fit **all** major data contexts you’ve compared (including deviant cases)?
|
|
165
|
+
- **Work**: Does it **explain** why strategies differ and outcomes differ?
|
|
166
|
+
- **Relevance**: Does it address what participants **continually work on**?
|
|
167
|
+
- **Modifiability**: Can you refine the core if tomorrow’s data demands it?
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## Key references
|
|
172
|
+
|
|
173
|
+
- Glaser, B. G. (1992). *Basics of grounded theory analysis*. Sociology Press.
|
|
174
|
+
- Glaser, B. G. (1978). *Theoretical sensitivity*. Sociology Press.
|
|
175
|
+
- Glaser, B. G. (1998). *Doing grounded theory*. Sociology Press.
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## Companion skills
|
|
180
|
+
|
|
181
|
+
- `open-coding`, `constant-comparison`, `memo-writing`
|
|
182
|
+
- `theoretical-coding`, `theoretical-sampling`, `theoretical-saturation`
|
|
183
|
+
- `substantive-theory` (write-up structure)
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: situational-analysis
|
|
3
|
+
description: "Use when conducting Clarke's situational analysis — mapping the situation of inquiry using situational, social worlds/arenas, and positional maps."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Situational Analysis (Clarke)
|
|
7
|
+
|
|
8
|
+
**Situational analysis (SA)** extends grounded theory–inflected inquiry into **complex, heterogeneous, postmodern** situations where **multiple actors, discourses, technologies, nonhumans, and silences** matter. Adele E. Clarke (2005, 2018) developed SA to **map** the **situation** of inquiry beyond a single core storyline.
|
|
9
|
+
|
|
10
|
+
## Intellectual location
|
|
11
|
+
|
|
12
|
+
SA grows from **Straussian** grounded theory and **Anselm Strauss’s social worlds/arenas** framework, while embracing **situational complexity**. It resists forcing messy realities into **single axial** stories when **multiplicity** is theoretically important.
|
|
13
|
+
|
|
14
|
+
## Three families of maps
|
|
15
|
+
|
|
16
|
+
Maps are **analytic devices** and **heuristic visuals**, not mere illustrations. They should be **iterated** as analysis deepens.
|
|
17
|
+
|
|
18
|
+
### 1. Situational map (messy and ordered)
|
|
19
|
+
|
|
20
|
+
**Messy situational map** — Brainstorm **all** elements in the situation: **human actors**, **nonhuman actants**, **institutions**, **discourses**, **technologies**, **spatial/temporal elements**, **key controversies**, and **silences**.
|
|
21
|
+
|
|
22
|
+
**Ordered situational map** — Organize messy elements into **categories** (e.g., individual actors, collectives, discursive constructions, implicated/silent actors, political/economic elements, related discourses). The ordered map prompts **relational questions**: Who and what matters? What is missing?
|
|
23
|
+
|
|
24
|
+
### 2. Social worlds / arenas maps
|
|
25
|
+
|
|
26
|
+
Drawn from **Strauss’s** work:
|
|
27
|
+
|
|
28
|
+
- **Social worlds** — Groups with **shared commitments** to action in a domain (e.g., clinicians, advocates, regulators).
|
|
29
|
+
- **Arenas** — **Sites of debate and negotiation** where worlds intersect around issues (e.g., policy arenas, clinical settings).
|
|
30
|
+
|
|
31
|
+
Map **which worlds** participate, **how** they align or conflict, and **what arenas** structure contention. Useful for **multi-agency**, **interprofessional**, or **contested** fields.
|
|
32
|
+
|
|
33
|
+
### 3. Positional maps
|
|
34
|
+
|
|
35
|
+
Capture **positions taken and not taken** on **key axes of controversy and concern** in the situation.
|
|
36
|
+
|
|
37
|
+
- **Axes** — Construct dimensions that organize discourses (e.g., autonomy vs safety, market vs public good).
|
|
38
|
+
- **Plots** — Place **discursive positions** (not only individuals) relative to axes.
|
|
39
|
+
- **Silences** — Explicitly note **unspoken** or **marginalized** positions.
|
|
40
|
+
|
|
41
|
+
Positional maps surface **normative tensions** and **absences** that interviews alone may underrepresent.
|
|
42
|
+
|
|
43
|
+
## How to construct each map (workflow)
|
|
44
|
+
|
|
45
|
+
1. **Initial coding** — Use GT-style coding to anchor yourself in data (interviews, documents, media, field notes).
|
|
46
|
+
2. **Messy map** — Freelist elements; chase **what else** belongs; include **nonhumans** and **institutions**.
|
|
47
|
+
3. **Ordered map** — Sort, label gaps, and **rewrite** categories as needed.
|
|
48
|
+
4. **Relational analyses** — Ask how elements **implicate** one another; memo **relations**.
|
|
49
|
+
5. **Social worlds/arenas** — Identify **commitments** and **sites of negotiation**; revise after new data.
|
|
50
|
+
6. **Positional maps** — Select **salient controversies**; define axes; plot discourses; mark **silences**.
|
|
51
|
+
7. **Integration** — Return to **writing**; let maps discipline **claims** and **discussion**.
|
|
52
|
+
|
|
53
|
+
## Relationship to Strauss’s social worlds theory
|
|
54
|
+
|
|
55
|
+
SA **inherits** the **social worlds/arenas** lens and **extends** it with:
|
|
56
|
+
|
|
57
|
+
- Stronger emphasis on **discursive constructions** and **power/knowledge** (Foucauldian inflection).
|
|
58
|
+
- Explicit mapping of **nonhuman** and **institutional** elements.
|
|
59
|
+
- **Positional** mapping of **discursive fields**.
|
|
60
|
+
|
|
61
|
+
## When situational analysis adds value beyond traditional GT
|
|
62
|
+
|
|
63
|
+
Use SA when:
|
|
64
|
+
|
|
65
|
+
- **No single core category** should dominate because **multiplicity** is substantive.
|
|
66
|
+
- **Boundary objects**, **technologies**, **policy discourses**, and **nonhuman actors** are as important as individuals.
|
|
67
|
+
- **Controversies** and **conflicting logics** structure the field.
|
|
68
|
+
- You want **visual-analytic** discipline for **complex cases** (science & technology studies, health policy, organizational ecologies).
|
|
69
|
+
|
|
70
|
+
Traditional **Glaserian GT** may be preferable when the aim is a **parsimonious substantive theory** of a **core social process** with **theoretical sampling** tightly focused on that process.
|
|
71
|
+
|
|
72
|
+
## Differences from Glaserian GT (concise)
|
|
73
|
+
|
|
74
|
+
| Aspect | Glaserian GT | Situational analysis |
|
|
75
|
+
|--------|----------------|----------------------|
|
|
76
|
+
| Goal | Substantive theory, core category | Situational mapping, complex cartographies |
|
|
77
|
+
| Emphasis | Emergence, coding families | Worlds/arenas, discourses, actants |
|
|
78
|
+
| Visuals | Optional diagrams | Maps as **central method** |
|
|
79
|
+
| Nonhumans | May appear as data | Often **mapped as actants** |
|
|
80
|
+
| Epistemology | Classic GT (emergence discipline) | Postmodern-inflected **multiplicity** |
|
|
81
|
+
|
|
82
|
+
SA can **complement** GT: use coding to **enter** data, use maps to **hold complexity** accountable in **findings**.
|
|
83
|
+
|
|
84
|
+
## Reporting
|
|
85
|
+
|
|
86
|
+
Present **maps as figures** with **legends**; explain **how** maps changed over time. Connect maps to **narrative analysis**—maps should **advance argument**, not decorate.
|
|
87
|
+
|
|
88
|
+
## Key references
|
|
89
|
+
|
|
90
|
+
- Clarke, A. E. (2005). *Situational Analysis: Grounded Theory After the Postmodern Turn*.
|
|
91
|
+
- Clarke, A. E., Friese, C., & Washburn, R. (Eds.). (2018). *The Situational Analysis Toolkit*.
|
|
92
|
+
|
|
93
|
+
Use this skill for messy multi-actor projects, STS-inflected qualitative work, or explicit mapping alongside grounded coding.
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: substantive-theory
|
|
3
|
+
description: "Use when building a substantive grounded theory — a theory grounded in data from a specific substantive area."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Substantive Grounded Theory
|
|
7
|
+
|
|
8
|
+
A **substantive grounded theory** is a conceptual theory **grounded in data** about a **specific substantive area** (e.g., a particular occupation, illness experience, organizational setting, community practice). It explains **patterns of behavior/process** relevant to people in that area, using **categories** and **hypothetical relationships** earned through **constant comparison**.
|
|
9
|
+
|
|
10
|
+
Use this skill when moving from **memo outlines** to **draft manuscripts**, dissertations, or journal articles framed in classic GT.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Substantive theory vs formal theory
|
|
15
|
+
|
|
16
|
+
| Feature | Substantive theory | Formal theory |
|
|
17
|
+
|--------|---------------------|---------------|
|
|
18
|
+
| Scope | A specific empirical domain | Cross-substantive, abstracted |
|
|
19
|
+
| Empirical anchor | Deep in one area | Built by comparing substantive theories |
|
|
20
|
+
| Typical reader payoff | Explains a real-world arena | Explains a generic social process |
|
|
21
|
+
|
|
22
|
+
Substantive theory is the **default** GT product. Formal theory is a **later**, more abstract step (see `formal-theory`).
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Components of a substantive theory
|
|
27
|
+
|
|
28
|
+
### Core category
|
|
29
|
+
|
|
30
|
+
The **central** conceptual pattern that **integrates** the theory. It should:
|
|
31
|
+
|
|
32
|
+
- recur and carry **explanatory** weight
|
|
33
|
+
- connect to many other categories
|
|
34
|
+
- often align with a **main concern** and its recurrent **resolution**
|
|
35
|
+
|
|
36
|
+
### Related categories (major satellites)
|
|
37
|
+
|
|
38
|
+
Commonly include (when supported by data):
|
|
39
|
+
|
|
40
|
+
- **Conditions** (what makes X more/less likely)
|
|
41
|
+
- **Contextual embedments** (where/when/for whom)
|
|
42
|
+
- **Strategies / tactics** (how people handle problems)
|
|
43
|
+
- **Interactional processes** (how meanings/roles co-develop)
|
|
44
|
+
- **Consequences** (outcomes, side effects, feedback loops)
|
|
45
|
+
|
|
46
|
+
Avoid treating satellites as a **checklist**—include only what **comparison** supports.
|
|
47
|
+
|
|
48
|
+
### Theoretical propositions (hypotheses)
|
|
49
|
+
|
|
50
|
+
Substantive GT writes **hypotheses as statements**:
|
|
51
|
+
|
|
52
|
+
> Under conditions {C}, people tend to deploy strategy {S}, which produces {O}, unless {B}—where {B} is a **boundary** condition supported by negative cases.
|
|
53
|
+
|
|
54
|
+
These are **grounded hypotheses**, not statistical predictions—though later work might operationalize them.
|
|
55
|
+
|
|
56
|
+
### Properties and dimensions
|
|
57
|
+
|
|
58
|
+
A mature theory specifies **how** categories vary:
|
|
59
|
+
|
|
60
|
+
- **Properties**: characteristics of a category
|
|
61
|
+
- **Dimensions**: ranges along which properties vary (e.g., high/low visibility)
|
|
62
|
+
|
|
63
|
+
This is how GT handles **variation** without collapsing into single-story anecdotes.
|
|
64
|
+
|
|
65
|
+
### Basic social process (optional but common)
|
|
66
|
+
|
|
67
|
+
If data are strongly processual, present **phases** or **sequences**—always conditioned and variable, never rigid “stages” for everyone.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Writing the theory (structure that matches classic GT)
|
|
72
|
+
|
|
73
|
+
### Opening moves
|
|
74
|
+
|
|
75
|
+
- **Substantive area** and **why it matters** (brief).
|
|
76
|
+
- **Main concern** (what participants continually work on/resolve), if identifiable.
|
|
77
|
+
- **Method note** (GT procedures summarized; transparency).
|
|
78
|
+
|
|
79
|
+
### Middle moves (conceptual heart)
|
|
80
|
+
|
|
81
|
+
- Introduce **core category** with **conceptual definition**.
|
|
82
|
+
- Develop **related categories** and **hypotheses** linking them.
|
|
83
|
+
- Show **variation** via properties/dimensions and **boundary conditions**.
|
|
84
|
+
|
|
85
|
+
### Evidence moves (illustrative, not exhaustive)
|
|
86
|
+
|
|
87
|
+
- Use **short excerpts** as **indicators** of categories—**not** long narrative blocks.
|
|
88
|
+
- Prefer **compare-and-contrast** illustrations (typical vs deviant).
|
|
89
|
+
|
|
90
|
+
### Closing moves
|
|
91
|
+
|
|
92
|
+
- **Implications** (careful claims—substantive scope).
|
|
93
|
+
- **Limitations** and **modifiability** (what would change the theory).
|
|
94
|
+
- **Next sampling** suggestions if saturation was uneven across categories.
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## Evaluating substantive theory: fit, work, relevance, modifiability
|
|
99
|
+
|
|
100
|
+
### Fit
|
|
101
|
+
|
|
102
|
+
Do categories **fit** the incidents that generated them? Do **negative cases** fit refined boundary statements?
|
|
103
|
+
|
|
104
|
+
### Work
|
|
105
|
+
|
|
106
|
+
Does the theory **explain** variation and the **central pattern**? Does it **integrate** rather than list?
|
|
107
|
+
|
|
108
|
+
### Relevance
|
|
109
|
+
|
|
110
|
+
Does it address what participants **actually treat as problematic** or continually handle?
|
|
111
|
+
|
|
112
|
+
### Modifiability
|
|
113
|
+
|
|
114
|
+
Could a researcher refine categories with more data without collapsing the entire structure? Modifiability rewards **clear** conditional statements and **honest** limits.
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Common writing mistakes
|
|
119
|
+
|
|
120
|
+
- **Theme dump**: headings are topics, not an integrated model.
|
|
121
|
+
- **Quote pile**: evidence without conceptual scaffolding.
|
|
122
|
+
- **Borrowed constructs** presented as discovered.
|
|
123
|
+
- **Overclaiming** to formal theory while only one site/role is studied.
|
|
124
|
+
- **Method slippage**: claiming GT while actually doing **thematic analysis** or **hypothesis testing**.
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Output formats (templates)
|
|
129
|
+
|
|
130
|
+
### One-page integrative summary
|
|
131
|
+
|
|
132
|
+
```text
|
|
133
|
+
Substantive area:
|
|
134
|
+
Main concern:
|
|
135
|
+
Core category (definition):
|
|
136
|
+
3–5 key hypotheses (If/Then/Unless):
|
|
137
|
+
Major dimensions of variation:
|
|
138
|
+
Boundary conditions:
|
|
139
|
+
What data this theory does NOT explain (honest):
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### Paragraph template for a hypothesis
|
|
143
|
+
|
|
144
|
+
```text
|
|
145
|
+
Claim:
|
|
146
|
+
Conditions:
|
|
147
|
+
Mechanism (process language):
|
|
148
|
+
Expected outcomes:
|
|
149
|
+
Negative case pattern (if any):
|
|
150
|
+
Implications for practice/research (bounded):
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## Key references
|
|
156
|
+
|
|
157
|
+
- Glaser, B. G., & Strauss, A. L. (1967). *The discovery of grounded theory*. Aldine.
|
|
158
|
+
- Glaser, B. G. (1978). *Theoretical sensitivity*. Sociology Press.
|
|
159
|
+
- Glaser, B. G. (1992). *Basics of grounded theory analysis*. Sociology Press.
|
|
160
|
+
- Glaser, B. G. (1998). *Doing grounded theory*. Sociology Press.
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Companion skills
|
|
165
|
+
|
|
166
|
+
- `selective-coding`, `theoretical-coding`, `memo-writing`
|
|
167
|
+
- `theoretical-saturation`, `theoretical-sampling`
|
|
168
|
+
- `formal-theory` (next abstraction step)
|
|
169
|
+
- `glaserian-grounded-theory`
|