q-methods
Q-Methods
Draft methods sections in clear narrative style for broad scholarly audiences.
References
- references/methods_template.md — section template with placeholders
- ../references/appendix_template.md — shared appendix structure (methods and results)
- ../references/apa_style_guide.md — APA formatting, numbers, notation, formulas
Core Principles
- Narrative prose; no bullet points, em-dashes, or standalone introductory paragraphs
- Prefer 3-12 sentence paragraphs; merge pre-table intros into post-table narrative
- Conceptual language; avoid implementation jargon ("Interview responses were organized by dimension" not "We filtered the DataFrame")
- Organize by logical workflow stages: data collection, preprocessing, analysis, validation
- Wrap all formulas and operator-heavy expressions in inline code backticks, in both prose and table cells (see ../references/apa_style_guide.md, "Equations, Formulas, and Set Notation")
- Strict methods/results separation: describe what was done and how, not what was found
Section Structure
Data Collection and Preprocessing
Summarize sample size, date range, and breakdown by key variables. Describe preprocessing conceptually; reference appendix for technical parameters.
Data Analysis
Open with a pipeline overview. Justify method choices conceptually and reference appendix for technical details.
Validation
Describe human validation sampling and coding procedures. Leave placeholders for reliability metrics if pending.
Appendix Strategy
The main text presents the analytical logic at a level accessible to the target audience; appendices provide the detail needed for reproducibility.
General guidance (apply by default): If a parameter is needed to understand the analytical logic, include it in the main text (sample size, key thresholds, model names). If it is needed to replicate the analysis but not to follow the argument, place it in an appendix (full configuration tables, system prompts, coding rubrics, preprocessing specifications). Cross-reference appendices at the point of first relevance: "Detailed parameters are provided in Appendix A." Use placeholders for pending contributions.
Then ask the user to refine the standard-vs-detail boundary for their study, since it is context-dependent. A consistency threshold may be a standard parameter in one study but require appendix-level justification in another.
Scope
Include: Sample and corpus descriptive overview, preprocessing procedures, analytical methods, validation protocols.
Checklist
- Conceptual language throughout (no library names or code-level details in main text)
- Each workflow stage has appendix cross-references for technical parameters
- No analysis findings reported (reserved for results)
- Placeholders marked for pending contributions
- Appendix structure follows ../references/appendix_template.md
More from tyrealq/q-skills
q-educator
Develop course content for university teaching via interview-driven workflow. Use for course planning, lecture prep, assignment design, or student communication.
73q-infographics
Convert documents into business stories and infographics. Use for turning reports, documents, or text into visual summaries or infographics.
40q-scholar
Orchestrate end-to-end academic manuscript preparation following APA 7th edition. Use for writing papers, drafting sections, or academic writing support.
31q-topic-finetuning
Fine-tune and consolidate topic modeling outputs (BERTopic, LDA, etc.) into a theory-driven classification framework for academic manuscripts. Use when processing topic modeling results that need topic consolidation, theoretical classification, domain-specific preservation, multi-category handling, data verification, or Excel updates with final labels.
30q-presentations
Generate professional slide deck images from content with smart logo branding. Use when user asks to create slides, make a presentation, generate a deck, or PPT.
25q-results
Draft results sections for academic manuscripts with APA 7th tables and narrative flow. Use for writing results, presenting findings, formatting statistical tables, or reporting quantitative analysis.
14