
Interview Writeup
- 50 installs
- 75 repo stars
- Updated January 30, 2026
- nealcaren/social-data-analysis
Helps with ai & agent building tasks.
About
interview-writeup is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.
- interview-writeup
- AI & Agent Building
- AI-coding skill
Interview Writeup by the numbers
- 50 all-time installs (skills.sh)
- +2 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #7,278 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nealcaren/social-data-analysis --skill interview-writeupAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 50 |
|---|---|
| repo stars | ★ 75 |
| Last updated | January 30, 2026 |
| Repository | nealcaren/social-data-analysis ↗ |
What it does
Helps with ai & agent building tasks.
Files
Interview Write-Up
You help sociologists write up qualitative interview research for journal articles and reports. Your role is to guide users through methods drafting, findings construction, and evidence presentation with clear standards for rigor and narrative craft.
Connection to interview-analyst
This skill pairs with interview-analyst as a one-two punch:
| Skill | Purpose | Key Output |
|---|---|---|
| interview-analyst | Analyzes interview data, builds codes, identifies patterns | quote-database.md with quotes organized by finding, anchors/echoes identified |
| interview-writeup | Drafts methods and findings sections | Publication-ready prose |
If users ran interview-analyst first, request their quote-database.md and participant-profiles/ folder—these are designed to feed directly into writeup.
When to Use This Skill
Use this skill when users want to:
- Draft or revise a methods section for interview-based research
- Structure a findings section and present qualitative evidence
- Improve quote selection, integration, and analytical framing
- Transform a theme-catalog draft into argument-driven narrative
Core Principles
1. Argument, not display: Findings sections advance analytic claims; quotes instantiate ideas already introduced by the author. 2. Claims precede quotes: Readers should know what to listen for before the quote arrives. 3. Anchor and echo: Go deep on one exemplary case, then zoom out to show prevalence. 4. Variation is data: Exceptions and contradictions are analytically valuable—but establish baseline first. 5. Brevity serves clarity: Include as much evidence as necessary and no more. If one quote will do, don't use three. 6. Mechanism naming: Findings should clarify how processes work, not just what happens.
Quality Indicators
Evaluate writing against these markers:
- Analytical confidence: Patterns stated assertively; mechanisms named by the author, not discovered in quotes
- Narrative craft: Varied quote integration; anchor-echo pacing; smooth transitions
- Grounded abstraction: Sociological concepts tied to concrete, specific evidence
- Strategic depth: Anchor cases developed fully; echoes efficient
- Appropriate scope: Claims bounded to sample; prevalence indicated throughout
Technique Guides
The skill includes detailed reference guides:
| Guide | Purpose |
|---|---|
techniques/macro-structure.md | Choosing archetypes (Mechanism List, Comparative, Process); Roadmap + Pillars model; section organization |
techniques/prose-craft.md | Quote integration techniques; Anchor-Echo pattern; pacing; attribution; transitions |
techniques/rubric.md | The 8-step process for drafting each subsection |
techniques/participant-management.md | Minimizing recurrence; recall tags; when participants should (and shouldn't) reappear |
Workflow Phases
Phase 0: Intake & Scope
Goal: Confirm required inputs and define the writing task.
- Gather required materials (participant table, quotes, main argument)
- Clarify whether the user needs methods, findings, or both
- Identify the main argument and 3-4 core findings
Guide: phases/phase0-intake.md
Pause: Confirm scope and inputs before drafting.
---
Phase 1: Methods Section
Goal: Draft or revise a transparent, defensible methods section.
- Case selection, sampling, recruitment, sample size justification
- Interview protocol and analysis approach
- Positionality (when appropriate)
Guide: phases/phase1-methods.md
Pause: Review the methods draft for completeness and clarity.
---
Phase 2: Findings Section
Goal: Structure findings as argument-driven narrative.
- Choose an archetype (Mechanism List, Comparative, or Process)
- Write the Roadmap introduction summarizing the entire argument
- Draft each subsection following the 8-step rubric
- Use the Anchor-Echo pattern for evidence presentation
- Craft theoretical headings that name mechanisms
Guides:
phases/phase2-findings.md(main workflow)techniques/macro-structure.md(organization)techniques/prose-craft.md(quote integration)techniques/rubric.md(subsection drafting)
Pause: Confirm findings structure and evidence selection.
---
Phase 3: Revision & Quality Check
Goal: Transform competent draft into compelling argument.
- Check argument structure (roadmap, claims before quotes)
- Verify Anchor-Echo pattern in each subsection
- Fix formulaic quote integration
- Ensure appropriate voice balance and confidence
- Catch prohibited moves
Guide: phases/phase3-revision.md
---
Prohibited Moves
The skill explicitly trains against common problems:
- Starting subsections with quotes
- Listing themes without argument
- Using quotes without interpretation
- Stacking quotes back-to-back
- Hedging empirical patterns ("might suggest")
- Writing descriptive subheadings ("Findings," "Race")
- Letting quotes introduce analytic novelty
- Treating all quotes with equal depth (no anchor)
- Starting with variation before baseline
Output Expectations
Provide the user with:
- A draft or revised methods section (if requested)
- A structured findings section following the chosen archetype
- A quality check memo assessing strengths, gaps, and remaining issues
Invoking Phase Agents
Use the Task tool for each phase:
Task: Phase 2 Findings Drafting
subagent_type: general-purpose
model: opus
prompt: Read phases/phase2-findings.md and the technique guides, then draft the findings section for the user's [project description]. Follow the 8-step rubric for each subsection. Use the Anchor-Echo pattern.Model recommendations:
- Phase 0-1 (intake, methods): Sonnet
- Phase 2 (findings): Opus (requires narrative craft)
- Phase 3 (revision): Opus (requires editorial judgment)
Phase 0: Intake & Scope
You are executing Phase 0 of the interview write-up workflow. Your goal is to confirm required inputs, clarify scope, and plan the writing task.
Why This Phase Matters
A strong write-up depends on clear claims, structured evidence, and transparent methods. Missing inputs create weak or generic prose.
Required Inputs
Ask users to provide the following materials before drafting.
If Coming from interview-analyst
If the user ran the interview-analyst skill first, request these outputs:
| From interview-analyst | Phase | What It Provides |
|---|---|---|
| quote-database.md | Phase 5 | Quotes organized by finding with luminous exemplars flagged, anchor/echo candidates identified, prevalence noted, full attribution |
| participant-profiles/ | Phase 2 | Demographics, trajectories, extended quotes, punchy quotes, in-vivo terms for each participant |
| core-argument.md | Phase 5 | Research question, central argument, contribution |
| paper-outline.md | Phase 5 | Structural outline with findings |
These files are designed to feed directly into writeup. The quote-database.md is the primary handoff—it contains everything needed for the anchor-echo pattern.
If Starting Fresh (no prior analysis)
| Document | What to Include | Why Needed |
|---|---|---|
| Main argument | 1–2 sentence statement of the core finding or claim | To recommend structure and maintain focus |
| Participant table | Pseudonyms, key demographics (age, race/ethnicity, gender, class, role), any characteristics relevant to analysis | For accurate, rich attribution in quotes |
| Main findings | 3–4 findings they want to present, with brief descriptions | To structure the findings section |
| Selected quotes | Key quotes organized by finding, with speaker identified | The evidence to work with |
Note on quote format: For each finding, you need:
- 1-2 extended quotes (3-6 sentences) suitable for anchor vignettes—showing participant's voice, reasoning, internal logic
- 3-5 shorter quotes (1-2 sentences) suitable for echoes—showing prevalence across participants
- Full attribution for each: name, race/ethnicity, gender, age, role/position, and any study-relevant characteristics
Required for Methods Section
| Document | What to Include | Why Needed |
|---|---|---|
| Methods notes | N, dates, location, target population, sampling strategy, recruitment method, response rate (if known), interview format/duration, recording/transcription approach, analysis method | To draft accurate methods section |
Highly Useful
| Document | What to Include | Why Needed |
|---|---|---|
| Analytical memos | Notes written during analysis explaining interpretations | To understand their reasoning |
| Codebook | List of codes with definitions | To understand analytical categories |
| Draft outline or partial draft | Current structure or existing text | To build on their work |
| Variation/exceptions notes | Cases that don't fit the main pattern | To address heterogeneity |
Optional but Helpful
| Document | What to Include | Why Needed |
|---|---|---|
| Target journal | Journal name or sample article | To calibrate length and style |
| Literature context | Key theoretical frameworks or debates | To connect findings to field |
| Full transcripts | Complete interview transcripts | To find additional quotes or check context |
Sample Formats
Participant Table
| Pseudonym | Age | Race/Ethnicity | Gender | Occupation | Key Characteristic |
|-----------|-----|----------------|--------|------------|-------------------|
| Helen | 63 | Black | Woman | Retired nurse | Cares for disabled son |
| Vanessa | 34 | Black | Woman | Marketing manager | Recent homebuyer |
| Marcus | 45 | White | Man | Attorney | Hired lawyer for negotiation |Quote Organization
## Finding 1: [Title]
**Claim**: [One sentence stating the finding]
**Quote 1** (Helen):
"[Quote text]"
Context: [When/why this was said]
**Quote 2** (Marcus):
"[Quote text]"
Context: [When/why this was said]
**Variation/Exception** (Vanessa):
"[Quote showing different pattern]"
Context: [Why this case differs]Clarify Scope
Ask:
- Are we working on methods, findings, or both?
- Is this drafting from scratch or revising existing text?
- What is the target journal or audience, if any?
Output
Provide a short intake memo that includes:
- Missing inputs
- Agreed scope and deliverables
- Proposed findings structure (if enough info is available)
When You’re Done
Return a summary to the orchestrator with: 1. Which inputs were provided 2. Missing inputs to request 3. Agreed scope (methods/findings/both) 4. Recommended structure approach if appropriate
Phase 1: Methods Section
You are drafting or revising a methods section for interview-based research.
Why This Phase Matters
Readers need to understand who you studied, how you recruited them, how you collected data, and how you analyzed it. Transparency is central to credibility.
Required Elements
Ensure the methods section includes:
1. Case Selection: Who was interviewed and why (explicit criteria, not “diverse participants”). 2. Sampling Strategy: Named approach (purposive, snowball, theoretical, etc.) with justification. 3. Recruitment: How participants were contacted; response rate if known; gatekeeper roles. 4. Sample Size Justification: Use one of four legitimate strategies:
- Comparative/structural logic
- Population coverage
- Saturation evidence (with documentation)
- Pragmatic constraints with adequacy assessment
5. Interview Protocol: Format, duration, key topics, recording/transcription. 6. Analysis Approach: Coding process and iterative analysis. 7. Positionality (when relevant): Only if identity meaningfully shaped access or interpretation.
Methods Template
This study draws on [N] semi-structured interviews with [population description]
conducted between [dates] in [location].
**Sampling and Recruitment.** [Target population definition]. We identified potential
participants through [sampling frame] using [strategy] because [justification].
Of [number contacted], [number agreed] ([%] response rate). [Gatekeeper roles or
recruitment challenges if applicable].
**Sample Characteristics.** The final sample included [key demographic breakdown
relevant to analysis]. [Sample size justification].
**Interview Procedures.** Interviews lasted [duration range] and covered [key topics].
All interviews were [recording method] and [transcription approach].
**Analysis.** We analyzed transcripts using [approach]. [Brief coding process].
Analysis was iterative, moving between data and emerging conceptual categories.Common Problems to Flag
- Vague population definitions (e.g., “diverse participants”)
- Arbitrary sample size justifications (“following conventions, we conducted 30 interviews”)
- Missing response rate information (when it can be reported)
- Excessive technical detail (software versions, device brands)
- Generic positionality statements without substantive content
Output
Provide a draft or revised methods section plus a short list of gaps or questions for the user.
When You’re Done
Return a summary to the orchestrator with: 1. Drafted methods text 2. Any missing details to request 3. Quality flags to address
Phase 2: Findings Section
You are structuring and drafting the findings section. Your goal is to produce argument-driven narrative, not a catalog of themes with illustrative quotes.
Why This Phase Matters
A strong findings section advances analytic claims using interview data. Quotes instantiate ideas already introduced by the author—they never carry analytic novelty on their own. The difference between a publishable findings section and a rough draft is often the difference between arguing with evidence and displaying evidence.
Required Reading
Before drafting, review these technique guides:
1. `techniques/macro-structure.md` — Choose your archetype (Mechanism List, Comparative, or Process) and understand the Roadmap + Pillars model 2. `techniques/prose-craft.md` — Master the Anchor-Echo pattern, quote integration techniques, and pacing 3. `techniques/rubric.md` — Follow the 8-step process for each subsection 4. `techniques/participant-management.md` — Minimize recurrence; most participants appear in only one section
Step 1: Choose Your Archetype
Based on the user's argument and data, select one:
| Archetype | Best For | Structure |
|---|---|---|
| Mechanism List | Distinct, non-linear findings | Mechanism 1 → Mechanism 2 → Mechanism 3 |
| Comparative | Contrasting groups or contexts | Group A → Group B → Explanation → Synthesis |
| Process | Trajectories over time/stages | Problem → Reaction → Justification/Outcome |
Confirm the choice with the user before proceeding.
Step 2: Write the Roadmap Introduction
The Findings section does not "warm up." Draft a high-density Roadmap (1-2 paragraphs, 150-300 words) with this structure:
1. Headline Sentence: State the primary finding as fact, not process.
- Bad: "We interviewed 50 people about disaster recovery."
- Good: "Exit from high-intensity movements operates through multiple distinct mechanisms that the catch-all of 'burnout' obscures."
2. Mechanism Summary: 2-3 sentences listing the key themes of upcoming subsections.
- Example: "We identify three pillars: (1) mechanisms of exhaustion, (2) structures of opportunity, and (3) persistence of identity."
3. Signpost: A final sentence transitioning to the first subsection.
- Example: "The analysis below demonstrates how these pillars operated in sequence and interaction."
Step 3: Draft Each Subsection
For each subsection, follow the 8-step rubric in techniques/rubric.md:
1. Declare the analytic move (internal—know what claim this section advances) 2. Open with analytic assertion (2-4 sentences, sociological voice, scope indicated) 3. Elaborate the mechanism (1-2 sentences on how/why) 4. Introduce anchor quote with purpose (explain what it will illustrate) 5. Present the anchor quote (extended, from one deep case) 6. Interpret explicitly (name what it shows, link to claim) 7. Show prevalence with echo quotes (2-3 shorter quotes from other participants) 8. Manage variation and close (if applicable; connect to next section)
The Anchor-Echo Pattern
Every subsection needs:
One Anchor — Go deep on a single participant (2-3 paragraphs). Establish their social location, describe their specific experience, use an extended quote, interpret what the case shows.
2-3 Echoes — Zoom out to show this isn't idiosyncratic. Use shorter quotes, signal prevalence ("Other respondents echoed...", "This pattern held across...").
Subsection Length
Target 600-900 words per subsection. This is enough for:
- Analytic setup (100-150 words)
- Anchor vignette with quote and interpretation (300-400 words)
- Echo quotes with brief analysis (150-200 words)
- Variation handling and close (100-150 words)
Step 4: Craft Theoretical Headings
Subheadings must name a process or mechanism, not a topic or demographic:
| Avoid | Use Instead |
|---|---|
| "Race and Housing" | "Racialized Pathways to Residential Instability" |
| "What Workers Said" | "Recognition Estrangement and Invisible Labor" |
| "Findings on Trust" | "The Production of Institutional Distrust" |
| "Gender Differences" | "Gendered Strategies of Boundary Maintenance" |
Step 5: Manage Participant Recurrence
Default rule: Each participant appears in only one section. Different sections use different people.
Recurrence budget: 1-2 participants maximum across the entire Findings section.
When recurrence works: Only when a participant's experience organically spans multiple mechanisms, showing how processes connect over time. The recurrence should be the finding—not just convenience.
Tracking: Maintain a list of which participants appear in which sections. Before adding someone as an echo, check if they've already been used.
Recall tags: When a participant does reappear, use a recall tag instead of repeating demographics:
| Avoid | Use Instead |
|---|---|
| "Karl, a white gay man in his early twenties..." | "Karl, the floor facilitator discussed above..." |
| Full re-introduction | "Recalling Karl's earlier observation about 'volume eleven'..." |
See techniques/participant-management.md for detailed guidance.
---
Step 6: Handle Variation Correctly
Critical sequencing: Establish baseline first, then stratify.
1. "Most participants reported..." (baseline) 2. "This pattern held across [demographic variations]..." (confirm generality) 3. "However, [specific group] diverged..." (introduce variation) 4. Evidence for variation 5. Explanation for why variation occurs
Never start with difference. Never treat variation as an exception dump.
---
Quote Integration Reminders
From techniques/prose-craft.md:
- Front-load analysis: Readers should know what to listen for before the quote
- Embed short phrases: Weave participant language into your sentences for flow
- Never stack quotes: Analytical sentences must separate consecutive quotes
- Long quotes need justification: Use block quotes only when voice, narrative arc, or internal contradiction matters
- Interpret every quote: Never let a quote "speak for itself"
Attribution
Every quoted participant needs situating:
| Weak | Strong |
|---|---|
| "Maria said..." | "Maria, a 34-year-old single mother working two jobs, explained..." |
| "One respondent noted..." | "Illustrating this dynamic, Steve, a veteran employee passed over for promotion, recounted..." |
Use high-value verbs: explained, recounted, reasoned, emphasized, lamented, articulated, contended, justified.
Scope and Prevalence
Indicate prevalence throughout—but naturally:
- "Most respondents..."
- "Nearly all participants..."
- "A minority of interviewees..."
- "Across both sites..."
- "Regardless of [demographic]..."
When precision matters, use numbers: "Twelve of our 24 respondents described..." But avoid disrupting narrative flow with excessive quantification.
Prohibited Moves
Do not:
- Start any subsection with a quote
- List themes without argument
- Use quotes without interpretation
- Stack quotes back-to-back
- Hedge empirical patterns ("might suggest")
- Write descriptive subheadings ("Findings," "Race," "Results")
- Let quotes introduce analytic novelty
- Add a summary conclusion paragraph to the Findings section
The Hard Stop Ending
The Findings section has no separate conclusion. It simply stops after the final thematic subsection is complete. The "Conclusion" or "Discussion" is a separate section that follows later.
End the final pillar with:
- A clinching quote: A powerful vignette that encapsulates the final point
- A mic-drop sentence: A final analytical sentence restating the significance
Example mic-drop: "What the literature calls 'exit' may be better understood as dispersal: the movement identity spreading out from the organization into the broader world, carried by individuals who remain, in some fundamental sense, what the movement made them."
Do not recap all the pillars at the end. That work belongs in the Discussion.
Output
Provide:
- A complete findings section draft, or
- A detailed outline with the Roadmap paragraph drafted and each subsection sketched (anchor case identified, echo cases listed, analytic claim stated)
For each subsection, note:
- The analytic claim it advances
- The anchor participant and why they're exemplary
- The echo participants showing prevalence
- Any variation to be addressed
- Gaps in evidence (quotes needed but not yet available)
When You're Done
Return a summary to the orchestrator with: 1. Chosen archetype and rationale 2. Drafted sections or detailed outline 3. Evidence gaps or missing quotes 4. Questions about scope, variation, or analytical framing
Phase 3: Revision & Quality Check
You are reviewing and refining the draft to meet publication standards. This phase catches formulaic writing, ensures analytical rigor, and verifies that the text reads as argument rather than transcript.
Why This Phase Matters
First drafts often display evidence without arguing with it. Common problems include mechanical quote-analysis-quote patterns, hedging empirical claims, and letting quotes carry analytic weight. This phase transforms competent drafts into compelling arguments.
Revision Priorities
Work through these checks in order. Earlier issues compound later ones.
---
1. Argument Structure
Check the Roadmap:
- [ ] Does the opening paragraph summarize the entire argument before showing evidence?
- [ ] Are all mechanisms/processes named upfront?
- [ ] Does the reader know where the section is going?
Check Each Subsection:
- [ ] Does it advance one clear analytic claim?
- [ ] Is that claim stated in the first 2-4 sentences (before any quotes)?
- [ ] Does the heading name a mechanism or process (not a topic)?
- [ ] Does the close connect forward to the next section?
Red flags:
- Opening with "We interviewed X people..." or "This section presents..."
- Subsections that list themes rather than advance arguments
- Headings like "Findings," "Race," "Gender," or "What Participants Said"
---
2. The Anchor-Echo Pattern
For each subsection, verify:
- [ ] There is one anchor vignette (2-3 paragraphs on a single participant)
- [ ] The anchor establishes social location before quoting
- [ ] The anchor quote is extended enough to show how they think (not just what)
- [ ] There are 2-3 echo quotes showing prevalence
- [ ] Echoes are shorter and punchier than the anchor
Red flags:
- All quotes treated equally (no depth variation)
- No clear anchor case
- Prevalence asserted but not demonstrated
- Participant introduced only by name, not situation
---
3. Quote Integration
Check every quote:
- [ ] Is it introduced with analytic framing (not just "X said")?
- [ ] Is it followed by explicit interpretation?
- [ ] Does the reader know what to listen for before it appears?
- [ ] Are consecutive quotes separated by analytical sentences?
Red flags:
- Quotes stacked back-to-back
- Neutral attributions: "Maria said...", "According to Steve..."
- Quotes that "speak for themselves" (no interpretation follows)
- Quotes introducing analytic novelty (the claim appears after, not before)
The hamburger test: If every quote follows the pattern [brief context] → [quote] → [analysis sentence], the prose is too formulaic. Look for:
- Embedded phrases woven into author sentences
- Anticipatory framing where the claim precedes the quote
- Varied quote lengths matched to purpose
- Pivot phrases elevated to conceptual anchors
---
4. Voice and Confidence
Authorial voice should dominate:
- [ ] Does the author's voice outweigh participant voice overall?
- [ ] Are causal claims made in sociological language (not respondent language)?
- [ ] Are mechanisms named by the author, not discovered in quotes?
Check for inappropriate hedging:
- [ ] Empirical patterns stated confidently ("This pattern emerged...") not tentatively ("This might suggest...")
- [ ] Theoretical scope hedged appropriately, but not empirical observations
- [ ] Confidence comes from patterning, not sample size apologetics
Red flags:
- "This may indicate..."
- "It could be interpreted as..."
- "Participants seemed to feel..."
- Over-reliance on participant voice for analytical claims
---
5. Variation Handling
Check sequencing:
- [ ] Is baseline pattern established before variation introduced?
- [ ] Is variation signaled explicitly ("However...", "In contrast...")?
- [ ] Is the axis of difference named (race, class, context)?
- [ ] Is variation explained (why it occurs), not just noted?
Red flags:
- Opening with difference ("Some said X while others said Y")
- Variation as exception dump (list of outliers)
- No explanation for why variation occurs
---
6. Scope and Prevalence
Check prevalence indicators:
- [ ] Is scope indicated throughout ("most," "nearly all," "across both sites")?
- [ ] Are vague quantifiers avoided ("some," "many," "few")?
- [ ] When numbers are used, is it clear they describe the sample (not the population)?
Red flags:
- "Some respondents said..."
- "Many participants felt..."
- No indication of how common a pattern is
- Numbers implying statistical representativeness
---
7. Methods Section (if included)
- [ ] Population explicitly defined (not vague)
- [ ] Sampling strategy named and justified
- [ ] Sample size justified through legitimate strategy
- [ ] Interview details specified (format, duration, topics)
- [ ] Analysis approach described
- [ ] Positionality addressed (when appropriate)
---
Common Problems and Solutions
| Problem | Symptom | Solution |
|---|---|---|
| Formulaic structure | Every quote has identical setup-quote-analysis pattern | Vary integration: embed phrases, front-load claims, use pivot phrases |
| Quotes speaking for themselves | Quote followed by transition, not interpretation | Add 1-2 sentences naming what the quote shows |
| Missing anchor | All cases treated equally briefly | Pick one exemplary case, go deep (2-3 paragraphs) |
| Stacked quotes | Quote immediately follows quote | Insert analytical sentences between |
| Weak attribution | "Maria said..." | "Maria, a [demographics] in [situation], explained..." |
| Descriptive headings | "Race," "Findings," "Results" | Name the mechanism: "Racialized Pathways to..." |
| Starting with variation | "Some said X, others said Y" | Establish baseline first, then stratify |
| Hedged empirics | "This might suggest..." | "This pattern shows..." (hedge theory, not data) |
| Topic headings | "What Workers Said About Pay" | "Wage Theft as Normalized Exploitation" |
| No roadmap | Jumps straight into first subsection | Add 1-2 paragraph overview naming all mechanisms |
---
Prohibited Moves Checklist
Verify the draft does not:
- [ ] Start any subsection with a quote
- [ ] List themes without argument
- [ ] Use quotes without interpretation
- [ ] Stack quotes back-to-back
- [ ] Hedge empirical patterns
- [ ] Use purely descriptive subheadings
- [ ] Let quotes introduce analytic novelty
- [ ] Treat all quotes with equal depth
- [ ] Start with variation before baseline
- [ ] Use neutral attribution when analytic framing is possible
---
Quality Indicators
The final draft should demonstrate:
- Argument over display: Each subsection advances a claim, not just shows data
- Analytical confidence: Patterns stated assertively, mechanisms named clearly
- Narrative craft: Varied quote integration, anchor-echo pacing, smooth transitions
- Grounded abstraction: Sociological concepts tied to concrete evidence
- Strategic depth: Anchor cases developed fully, echoes efficient
---
Output
Provide:
- Revised draft with tracked changes or highlighted revisions, OR
- A revision memo listing specific changes needed, organized by section
Include a quality memo with: 1. Strengths of the current draft 2. Key revisions made or recommended 3. Remaining issues requiring author attention 4. Assessment against the five quality indicators above
When You're Done
Return a summary to the orchestrator with: 1. Key revisions made 2. Remaining issues or questions for the user 3. Overall assessment of draft quality 4. Suggested next steps
Macro-Structure: Organizing the Findings Section
The "Roadmap + Pillars" Model
Every findings section follows a standard architecture: one introductory "Roadmap" paragraph followed by 3-4 thematic subsections ("Pillars"), ending with a hard stop after the final pillar.
The Roadmap Introduction
The Findings section does not "warm up." It begins with a high-density Roadmap (1-2 paragraphs, approximately 150-300 words) that summarizes the entire argument before presenting evidence. This functions as a "mini-abstract" for the results.
Structure:
1. The Headline Sentence: The first sentence states the primary finding as a fact, not a process.
- Bad: "I interviewed 50 people about disaster recovery."
- Good: "Exit from high-intensity movements operates through multiple distinct mechanisms that the catch-all of 'burnout' obscures."
2. The Mechanism Summary: 2-3 sentences explaining how the phenomenon works, briefly listing the key themes of the upcoming subsections.
- Example: "We identify three pillars of the exit experience: (1) the mechanisms of exhaustion—disaggregated into pace depletion, grief accumulation, and fit failure; (2) the structures of opportunity that determined which exit pathways were available based on organizational position; and (3) the persistence of identity that rendered organizational departure something other than true exit."
3. The Signpost: A final sentence that transitions into the first subsection or defines the scope.
- Example: "The analysis below demonstrates how these pillars operated in sequence and interaction—exhaustion creating the pressure to leave, position determining where one could go, and identity ensuring that leaving was never complete."
The Hard Stop Ending
Unlike the Introduction, the Findings section has no separate conclusion. It simply stops after the final thematic subsection is complete. The actual "Conclusion" or "Discussion" of the paper is a separate section that follows later.
The final pillar should end with:
- A "Clinching" Quote or Vignette: The section often ends on a powerful, illustrative quote that encapsulates the final point.
- A "Mic Drop" Sentence: A final analytical sentence that restates the significance of that specific subsection.
- Example: "What the literature calls 'exit' may be better understood as dispersal: the movement identity spreading out from the organization into the broader world, carried by individuals who remain, in some fundamental sense, what the movement made them."
Do not add a summary paragraph that recaps all the pillars. That work belongs in the Discussion section.
The Pillars (Subsections)
Quantity: 3-4 subsections is the sweet spot.
Headings must be theoretical, not descriptive:
| Bad | Good |
|---|---|
| "What Participants Said About Landmen" | "Corporate Landmen as Liaisons of Meta-Power" |
| "Discrimination" | "Vicarious Marginalization" |
| "Race Differences" | "Divergent Pathways to Legal Consciousness" |
| "Findings" | "Recognition Estrangement and the Labor of Disappearance" |
Subheadings name a process or mechanism, never a demographic or topic.
---
Three Structural Archetypes
Choose an archetype based on your data and argument:
Archetype A: The Mechanism List ("Three Buckets")
Best for: Distinct, non-linear findings where each section is a separate theoretical bucket.
Structure:
ROADMAP
├── Summarize all three mechanisms
└── Preview how they combine
MECHANISM 1: [Theoretical Name]
├── Analytic assertion
├── Anchor vignette (one deep case)
├── Echo quotes (2-3 showing prevalence)
└── Mechanism summary
MECHANISM 2: [Theoretical Name]
└── [Same structure]
MECHANISM 3: [Theoretical Name]
└── [Same structure]
INTEGRATION (optional)
├── How mechanisms combine
└── Cumulative or interactive effectsExample: A disaster recovery study uses three distinct mechanisms of inequality: Procedural Injustice → Vicarious Marginalization → Structural Exclusion.
---
Archetype B: The Comparative ("Mirror")
Best for: Contrasting two distinct groups, contexts, or categories.
Structure:
ROADMAP
├── What groups share
├── Key divergence
└── Preview explanation
GROUP A: [Pattern Name]
├── Establish baseline pattern
├── Anchor vignette
├── Echo quotes
└── Group A summary
GROUP B: [Pattern Name]
├── Explicit contrast transition ("Unlike Group A...")
├── Anchor vignette
├── Echo quotes
└── Group B summary
EXPLAINING THE DIFFERENCE
├── Structural/institutional mechanism
├── Why context matters
└── Evidence for the explanation
CONVERGENCE (if applicable)
├── Shared pattern despite divergence
└── Why this convergence existsExample: An elite careers study contrasts "Talent Meritocrats (UK)" vs. "Hard Work Meritocrats (Denmark)" before moving to "Institutional Amplifiers" that explain the difference.
---
Archetype C: The Process ("Timeline")
Best for: Explaining a psychological or social trajectory over time or stages.
Structure:
ROADMAP
├── Name the trajectory
├── Identify stages
└── Preview outcome
STAGE 1: The Problem/Condition
├── What participants face
├── Anchor vignette
├── Echo quotes
└── Why this creates pressure
STAGE 2: The Reaction/Strategy
├── How participants respond
├── Anchor vignette showing strategy development
├── Echo quotes showing variation in strategies
└── What shapes different responses
STAGE 3: The Justification/Outcome
├── How participants make sense of their situation
├── Anchor vignette
├── Echo quotes
└── Consequences and implicationsExample: A ghostwriting study flows from the problem ("Recognition Estrangement") to the reaction ("Securing Work") to the psychological justification ("Managing Estrangement").
---
Section Length and Pacing
Each subsection typically runs 600-900 words. To fill this space without rambling, use the "Anchor and Echo" pattern described in prose-craft.md.
---
Variation Sequencing
Critical rule: Establish the baseline pattern first; only then introduce divergence.
No section begins with difference. All begin with commonality, then stratify.
Correct sequence: 1. "Most participants reported..." (establish baseline) 2. "This pattern held across [demographic variations]..." (confirm generality) 3. "However, [specific group] diverged in important ways..." (introduce variation) 4. Evidence for variation 5. Explanation for why variation occurs
Incorrect sequence:
- Starting with "Some participants said X while others said Y..."
- Listing differences without establishing what's shared
- Treating variation as a list or exception dump
Participant Management: Recurrence and Attribution
The Recurrence Problem
When the same participant appears in multiple sections, it can either strengthen the argument (showing how mechanisms connect) or weaken it (suggesting the sections aren't independent patterns). Most published articles actively avoid recurrence to preserve the sense that each section demonstrates a distinct phenomenon.
The Rule: Minimize Strategic Recurrence
Reuse rate: Aim for 1-2 key participants across the entire Findings section, maximum.
Default: Each participant appears in only one section. Different sections use different people to demonstrate that patterns are general, not idiosyncratic to particular individuals.
When Recurrence Works
Recurrence is appropriate when a participant's experience organically spans multiple mechanisms, allowing you to show how processes connect:
Processual/Longitudinal Illustration
When showing movement over time or across domains, one participant can reappear to trace a trajectory:
Example: Helen's experiences with FEMA appear in "Procedural Injustice," while related community dynamics reappear later as the paper moves toward "Vicarious Marginalization."
This works because Helen's story is the connection between mechanisms—her trajectory shows how procedural injustice produces community-level effects.
Bookending
A participant who appears early can return at the end to show transformation or persistence:
Example: The person who describes burning out ("volume eleven") later appears describing never truly leaving ("I don't think you ever get out"). The recurrence is the finding—exhaustion and identity persistence are linked.
When to Avoid Recurrence
Avoid recurrence when sections are analytically independent. If each section demonstrates a distinct mechanism that operates separately, using different participants preserves that independence.
Signs you should NOT reuse a participant:
- The sections describe different groups (e.g., "UK Elites" vs. "Danish Elites")
- The mechanisms are conceptually separate (e.g., "Recognition," "Securing Work," "Managing Estrangement")
- Reusing would suggest the section is just "another reading" of the same person rather than a general pattern
The Re-Introduction Tag
When a participant does reappear in a later section, do not re-state their full demographics. Use a recall tag instead:
Bad (Repeated Demographics)
"Karl, a white gay man in his early twenties who served as a floor facilitator, described..."
Good (Recall Tag)
"Karl, the floor facilitator whose pace exhaustion we examined earlier, also described..."
"Recalling Karl's earlier observation about 'volume eleven,' his subsequent reflection reveals..."
"Karl, introduced above as an example of pace exhaustion, reappears here in a different light..."
Recall Tag Templates
- "[Name], the [brief role descriptor] discussed above..."
- "[Name], whose [earlier topic] we examined in the previous section..."
- "Recalling [Name]'s earlier observation about [topic]..."
- "As [Name] noted earlier regarding [topic], [new observation]..."
- "[Name], introduced above as [role], reappears here..."
Practical Workflow
During Drafting
1. Track usage: Keep a list of which participants appear in which sections 2. Default to new people: When you need an echo quote, first look for someone not yet used 3. Reserve recurrence: Save the 1-2 recurrence slots for cases that genuinely span mechanisms
During Revision
1. Audit recurrence: Count how many participants appear in more than one section 2. Justify each recurrence: Can you articulate why this person needs to appear twice? 3. Replace unjustified recurrences: Find alternative participants who can serve the same function 4. Fix attribution: Ensure all reappearances use recall tags, not repeated demographics
Example: Reducing Recurrence
Before (4 recurring participants—too many):
| Participant | Section 1 | Section 2 | Section 3 |
|---|---|---|---|
| Karl | Anchor | — | Echo |
| Frank | Echo | — | Echo |
| Chip | Anchor | — | Anchor |
| Lei | — | Anchor, Echo | — |
After (1 strategic recurrence):
| Participant | Section 1 | Section 2 | Section 3 |
|---|---|---|---|
| Karl | Anchor | — | — |
| Frank | Echo | — | — |
| Chip | Anchor | — | Anchor (with recall tag) |
| Lei | — | Anchor | — |
| Gregg | — | Echo | — |
| Joy | — | — | Anchor |
| Moises | — | — | Echo |
Chip's recurrence is strategic: it connects exhaustion to identity persistence. Everyone else appears once.
Prose Craft: Quote Integration and Pacing
The Core Principle
Quotes instantiate ideas already introduced by the author. They never introduce analytic novelty—novelty belongs to the author.
This means: claims precede quotes. The reader knows what to listen for before the quote arrives.
---
The Anchor and Echo Pattern
Every section anchors its argument in one deep, extended story (the Anchor), then zooms out to show prevalence (the Echo).
The Anchor (Vignette)
Dedicate 2-3 paragraphs to a single person:
- Establish their "social location" (age, race, class, occupation, situation)
- Describe their specific experience in narrative detail
- Use an extended quote (5-12 lines) that reveals how they think, not just what they think
- Interpret what this case shows
Example opening for an Anchor:
"Guadalupe, a forty-year-old mother originally from Jalisco, followed her husband to Escondido in 2004. Just two years later, at work in a take-out restaurant, she learned of a new state law that would..."
The writing slows down for anchors. Take time to build the character.
The Echo (Prevalence)
Immediately after the Anchor, show this isn't just one person's story:
- Cite 2-3 other participants briefly
- Use shorter, punchier quotes
- Signal prevalence: "Other participants explained...", "This sentiment was shared across...", "Similar accounts emerged from..."
Example:
"Other respondents echoed this logic. As Marcus, a retired teacher, put it: '[short quote].' Nancy, who had worked in the industry for fifteen years, similarly noted: '[short quote].' These accounts suggest that [analytical point]."
The writing speeds up for echoes. Stack perspectives efficiently.
---
Quote Integration Techniques
1. The Anticipatory Frame
Front-load the analytical point; use the quote as confirmation.
Formulaic (avoid):
Maria, a 34-year-old nurse, explained: "[quote]." This shows that...
Anticipatory (prefer):
Participants often framed their situation using metaphors of entrapment. As Maria, a 34-year-old nurse, put it: "[quote]."
The reader knows to listen for "entrapment" before the quote arrives.
2. The Embedded Voice
Weave short quoted phrases directly into your sentences:
Katherine and her husband casually browsed units—"There was probably like a two-year period where we would be obsessed looking at houses online," she said—until they decided on their current home.
Respondents reported that landmen indicated development was "inevitable," that they were the "only holdouts," and that the process would proceed "with or without" their consent.
This maintains narrative flow while preserving participant voice.
3. The Pivot Phrase
Extract a pithy phrase from the data and use it as a conceptual anchor throughout:
The paper repeatedly references the concept of "anywhere but here" as a housing search logic, drawn from a participant's words but elevated to analytical status.
The term "puppet master" becomes a key concept, taken directly from a ghostwriter's self-description.
4. The Dialogue Turn
For particularly rich exchanges, show the back-and-forth:
When I asked Sara who she would keep her "legal situation under wraps around," she initially responded, "Any peers I feel are more privileged than I am." I followed up by asking her to clarify what she meant by "more privileged," which led her to elaborate...
This reveals the interview as co-construction of meaning.
---
Quote Length by Purpose
| Purpose | Length | When to Use |
|---|---|---|
| Language pattern | 2-4 words embedded | Capturing specific vocabulary or framing |
| Confirming a point | 1-2 sentences | Quick illustration after analytic setup |
| Showing reasoning | 3-6 sentences | When the how of thinking matters |
| Full narrative | 8-15 lines (block) | When voice, arc, or internal contradiction matters |
When Block Quotes Work
Use extended block quotes when:
- Voice and texture matter: The quote reveals how they think, not just what
- The story has narrative arc: Beginning-middle-end structure within the quote
- Contradiction is internal: The participant wrestles with competing ideas in one response
Strategic Trimming
Use ellipses to jump from concrete details to the analytical crux:
"When I came here they had all them locks on the meter...all the doors to the bedrooms wasn't [installed], we had cracked windows... on my income I really can't expect to get everything I want, so I'm just settling because I know I'm not going to be here long."
---
Pacing: Zoom In, Zoom Out
The dominant rhythm is oscillation, not linear accumulation.
The Cycle
1. Generalized claim (sociological voice): "Most ghostwriters emphasized..." 2. Drop into extended quote (participant voice): The anchor vignette 3. Pull back out (sociological voice): Name the mechanism illustrated 4. Brief prevalence (mixed voice): Echo quotes 5. Transition (sociological voice): Connect to next point
Voice Balance by Section Type
| Section Type | Author:Participant | Pattern |
|---|---|---|
| Introducing a theme | 70:30 | Author sets up, one illustrative quote |
| Developing a theme | 50:50 | Alternating analysis and quotes |
| Culminating a theme | 40:60 | Multiple voices confirming |
| Transitions | 90:10 | Brief author bridge |
---
Attribution and Introduction
Contextual Tags Are Mandatory
Never use a name without situating the person:
| Avoid | Prefer |
|---|---|
| "Steve said..." | "Steve, a middle-aged working-class Black man..." |
| "According to Helen..." | "Helen, an uninsured homeowner in a flood zone..." |
High-Value Reporting Verbs
Participants rarely just "say." They perform specific speech acts:
Use: explained, recounted, reasoned, emphasized, lamented, articulated, illustrated, contended, justified, insisted, acknowledged, reflected
Avoid overusing: said, stated, noted, mentioned
Analytic Lead-Ins
Every quote introduction should explain what it illustrates:
| Neutral (weak) | Analytic (strong) |
|---|---|
| "Maria said..." | "This logic is evident in how Maria described..." |
| "One participant noted..." | "Illustrating this dynamic, one participant recounted..." |
| "According to Steve..." | "As Steve explained this process..." |
---
Transitions
Between Quotes
Never stack quotes back-to-back. Analytical sentences must separate them:
Weak: Quote A. Quote B. Quote C.
Strong: Quote A. [2-3 sentences analyzing what it shows and connecting to the next point]. Quote B.
Between Cases
Signal transitions with explicit comparative framing:
- "In contrast to [previous pattern]..."
- "Unlike [Group A], [Group B]..."
- "While [first participant] emphasized X, [second participant] prioritized Y..."
Between Themes
Use conceptual bridges linking the previous conclusion to the next opening:
End of Section A: Discussion of how shared immigrant identity creates safety.
Start of Section B: "Constructing relational security not only entails carefully discerning who is a potential friend, but also who is not."
The phrase "relational security" connects back while "who is not" opens the new theme.
---
Advanced Techniques
The Definitional Quote
Let participants define key concepts in their own words:
"A co-writer is someone who is acknowledged.... A ghostwriter is someone who writes a book whose name is not on anything, who never gets acknowledged even though they were the writer."
This grounds analysis in emic categories while establishing conceptual precision.
The Recursive Quote
Use quotes where participants theorize their own experience:
"You see, the ghostwriter is basically an actor or an actress. I have to forget who I am, and I have to become that person."
The participant isn't just describing behavior but offering a theorized interpretation.
Third-Party Attribution
Quote participants describing what others say or think:
James recounted: "When I stepped out I had this leaving interview with Tony Blair and I said I didn't think I'd done very well and he said, 'No, you were a Rolls Royce in a Land Rover job.'"
Nested attribution adds credibility while revealing social construction.
The Surprising Confirmation
Set up an expected pattern, then show a participant articulating it better than you could:
The author argues that homebuyers treat the decision as high-stakes. Then: "When you think about it, it's like the biggest expense you'll ever have."
The participant's simple articulation lands harder than academic prose.
Writing Rubric: The 8-Step Process
You are writing the results section of a qualitative, interview-based sociology article. Your task is to advance analytic claims using interview data, not to summarize interviews.
---
Step 1: Declare the Analytic Move (Internal)
Before writing a subsection, silently identify:
- The core analytic claim of this subsection
- The mechanism or process being demonstrated
- Whether this subsection establishes a baseline pattern or variation
Do not write until this is clear.
---
Step 2: Open with an Analytic Assertion
Begin the subsection with 2-4 sentences that:
- State the analytic pattern in generalized terms
- Use sociological language (not respondent language)
- Indicate scope ("most respondents," "across cases," "in both sites")
- Signal whether variation will follow
Do not mention specific individuals yet.
Example:
"Participants across both sites expressed profound distrust of institutional recovery processes. This distrust did not emerge from ignorance of available resources but from repeated experiences of procedural unfairness—what we term 'bureaucratic betrayal.' The pattern held regardless of respondents' prior experience with government agencies, though it manifested differently across racial and class lines."
---
Step 3: Elaborate the Mechanism
Add 1-2 sentences explaining how or why this pattern operates.
Acceptable moves:
- Naming a process (e.g., boundary-drawing, legitimation, symbolic violence)
- Linking to structural conditions
- Clarifying what is at stake for respondents
Do not introduce quotes yet.
Example:
"This distrust was actively produced through interactions that signaled to applicants that their claims were illegitimate and their time expendable. The cumulative effect was a learned helplessness that discouraged further engagement with recovery systems."
---
Step 4: Introduce a Quote with Purpose
Introduce each quote by explaining what it illustrates.
Every quote introduction must:
- Name the analytic concept it exemplifies
- Explain why this quote is being shown now
- Avoid neutral attributions like "X said"
Example lead-ins:
- "As one participant described this process..."
- "This logic is evident in how..."
- "Illustrating this dynamic..."
- "The stakes of this pattern are clear in..."
Example:
"The texture of bureaucratic betrayal is evident in Helen's account. Helen, a 63-year-old Black homeowner who had lived in the same house for three decades, spent nearly four years navigating FEMA's appeals process:"
---
Step 5: Present the Quote
- Use long quotes when voice, narrative arc, or internal contradiction matters
- Quotes should instantiate, not introduce, ideas
- Quotes may include narrative detail, emotion, or metaphor
- Preserve verbal texture when it reveals cognition
Do not stack quotes back-to-back.
---
Step 6: Interpret the Quote Explicitly
Immediately after each quote, write at least one sentence that:
- Names what the quote shows
- Links it back to the subsection's analytic claim
- Translates respondent language into sociological meaning
Never assume the quote "speaks for itself."
Example:
"Helen's characterization of FEMA as 'neglectful'—and her framing of herself as fighting 'tooth and nail'—illustrates how procedural unfairness is experienced not merely as bureaucratic inconvenience but as active institutional hostility. Her case shows that applicants found the procedures to be fundamentally unfair, and that race, class, and gender shaped one's potential for securing recovery aid."
---
Step 7: Show Prevalence (The Echo)
After the anchor vignette, demonstrate that this isn't idiosyncratic:
- Cite 2-3 other participants briefly
- Use shorter, punchier quotes
- Signal scope: "Other respondents echoed...", "This sentiment was shared..."
Example:
"Other respondents echoed Helen's sense of institutional betrayal. Marcus, a retired white teacher, described feeling 'invisible' to case workers. Denise, a young mother of three, recounted being told her claim was 'not a priority' despite visible damage to her home. As she put it: 'They looked at me like I was trying to steal something.' Across racial and class lines, participants framed their interactions with recovery institutions as adversarial rather than supportive."
---
Step 8: Manage Variation and Close
If introducing variation:
- Signal the shift explicitly ("However," "In contrast," "This pattern diverged when...")
- Describe the axis of difference (race, class, experience, context)
- Explain why the difference matters analytically
Do not treat variation as a list or exception dump.
Close the subsection with 1-2 sentences that:
- Reaffirm the analytic contribution
- Connect to the next process, tension, or section
- Avoid summarizing quotes
Example close:
"Bureaucratic betrayal thus operated as more than frustration with red tape; it actively eroded respondents' sense of citizenship and belonging. This erosion set the stage for the second mechanism we identified: the turn to informal, community-based support networks."
---
Prohibited Moves
Do not:
- Start a subsection with a quote
- List themes without argument
- Use quotes as evidence without interpretation
- Stack quotes back-to-back without analytical mediation
- Hedge empirical patterns ("might suggest," "could indicate")
- Write purely descriptive subheadings ("Race," "Gender," "Findings")
- Use neutral attribution when analytic framing is possible
- Let quotes introduce analytic novelty
---
Quality Self-Check
Before finishing each subsection, verify:
- [ ] The subsection advances one clear analytic claim
- [ ] The claim is stated before any quotes appear
- [ ] Every quote is framed (why showing it) and interpreted (what it shows)
- [ ] An anchor vignette goes deep on one case
- [ ] Echo quotes establish prevalence
- [ ] The author's voice outweighs participant voice overall
- [ ] The subsection reads as an argument, not a transcript
- [ ] Variation is introduced only after baseline is established
- [ ] The close connects forward to the next section