{"site":{"name":"Koji","description":"AI-native customer research platform that helps teams conduct, analyze, and synthesize customer interviews at scale.","url":"https://www.koji.so","contentTypes":["blog","documentation"],"lastUpdated":"2026-09-12T19:08:39.166Z"},"content":[{"type":"documentation","id":"df9cc751-1dbd-4045-a8a5-0fd6eb26005a","slug":"editing-the-brief-manually","title":"Editing the Brief Manually","url":"https://www.koji.so/docs/editing-the-brief-manually","summary":"Koji's structured brief editor lets you directly modify every part of your study design across four tabs: Problem, Participant, Approach, and Questions. This guide covers the structured question editor, drag-and-drop reordering, probing configuration, and a review checklist before publishing.","content":"While the [AI Consultant](/docs/working-with-the-ai-consultant) is excellent at drafting and iterating on your research brief through conversation, sometimes you know exactly what change you want to make and you'd rather just do it yourself. Koji's brief editor lets you directly modify every part of your study design through a structured interface.\n\n## When to Edit Manually vs. Chat\n\nBoth approaches update the same research brief, so choose whichever feels faster for the change you're making:\n\n| Change Type | Recommended Approach |\n|---|---|\n| Reword a single question | Manual edit |\n| Restructure the entire interview plan | Chat with AI Consultant |\n| Fix a typo or adjust phrasing | Manual edit |\n| Change the methodology | Chat with AI Consultant |\n| Add or remove a specific probe | Manual edit |\n| Rethink the target participant entirely | Chat with AI Consultant |\n| Reorder questions | Manual edit (drag and drop) |\n| Explore whether a question is biased | Chat with AI Consultant |\n| Change a question type (e.g., open-ended to scale) | Manual edit |\n| Add scale labels or choice options | Manual edit |\n\nThe general rule: if you know the exact words you want, edit manually. If you want to think through implications or get suggestions, chat with the Consultant.\n\n## Accessing the Brief Editor\n\nThe research brief is displayed in the artifact panel alongside your conversation with the AI Consultant. The editor is organized into four tabs:\n\n- **Problem** — edit the problem statement, decision to inform, hypothesis, success criteria, and problem cost\n- **Participant** — define required experience, behavior of interest, relationship to problem, and screening question\n- **Approach** — select from available methodologies and configure the interview mode (structured, exploratory, or hybrid)\n- **Questions** — add, edit, configure, and reorder your interview questions using the structured question editor\n\nTo edit any section, click the corresponding tab and modify the fields directly. Your changes are saved automatically.\n\n## Editing the Problem Context\n\nThe Problem tab contains the fields that anchor your entire study. Changes here can have cascading effects.\n\n**Tips for editing the problem context:**\n- Keep the problem statement to one to three sentences\n- Focus on what you want to learn, not what you plan to build\n- Use the hypothesis field to state what you currently believe — the study will test it\n- The decision to inform field should name a specific business or product decision\n- After editing, scan the rest of the brief to make sure everything still aligns\n\nIf you significantly change the problem statement, consider asking the AI Consultant to review the rest of the brief for consistency. You can say something like: \"I updated the problem statement — does the rest of the brief still make sense?\"\n\n## Changing the Methodology\n\nYou can switch the methodology from the Approach tab. Select from the available methodologies — each is described in detail in our [methodology guide](/docs/choosing-a-methodology).\n\n**Important:** Changing the methodology affects how the AI interviewer conducts conversations. Different methodologies use different questioning styles, follow-up strategies, and conversational approaches. If you switch methodologies, review your interview questions to make sure they still fit the new framework.\n\nFor significant methodology changes, chatting with the AI Consultant is often more efficient, since it can regenerate appropriate questions for the new approach.\n\n## Working with the Structured Question Editor\n\nThe Questions tab is where most manual editing happens. Unlike a plain text editor, the question editor provides a structured interface for each question:\n\n### Adding Questions\n\nClick the \"Add Question\" button to create a new question. You'll set:\n\n1. **Question text** — the actual question the AI will ask\n2. **Question type** — select from the dropdown: open-ended, scale, single choice, multiple choice, ranking, or yes/no\n3. **Type-specific configuration** — depending on the type you chose:\n   - **Scale:** set min/max values and endpoint labels (e.g., \"Very Unlikely\" to \"Very Likely\")\n   - **Single/Multiple Choice:** add your option list, optionally enable \"Allow Other\" for free-text responses\n   - **Ranking:** add items participants will order by preference\n4. **Probing configuration** — set the maximum follow-up depth (0–3) and add specific probing instructions\n\nFor a full guide to question types and their configurations, see [Structured Questions in AI Interviews](/docs/structured-questions-guide).\n\n### Editing Existing Questions\n\nClick on any question to expand its editing panel. You can modify the text, change the type, adjust configuration, or update probing settings. Changing a question's type will reset its type-specific configuration, so set the type first before configuring options.\n\n### Rewording Questions\n\nSmall wording changes can make a big difference in how participants respond.\n\n**Before:** \"What challenges do you face with the product?\"\n**After:** \"Walk me through a recent situation where you ran into difficulty while using the product.\"\n\nThe second version is more specific, grounded in real experience, and harder to answer with a vague generalization.\n\n### Reordering Questions\n\nDrag and drop questions into the sequence that makes sense for the conversation flow. A well-ordered interview:\n\n1. **Starts with easy, broad questions** that get the participant talking comfortably\n2. **Moves into the core topic** once rapport is established\n3. **Goes deeper** with specific, potentially sensitive questions in the middle\n4. **Places structured questions** (scales, choices) after open-ended discovery, once the participant has context\n5. **Ends with reflective or forward-looking questions** that leave the participant feeling valued\n\nAfter reordering, read through the whole plan to check that transitions between questions still feel natural.\n\n### Configuring Probing\n\nEach question has a probing configuration that controls how the AI follows up:\n\n- **Max follow-ups (0–3)** — how many probing questions the AI can ask after the initial answer. Set to 0 for no probing, or up to 3 for deep exploration.\n- **Probing instructions** — specific guidance for the AI, like \"If the participant gives a low score, ask what would need to change.\"\n- **Anchor probing (scale questions only)** — after a rating, the AI asks something like \"You said 7 — what would need to change to make it a 9?\" This is powerful for understanding the gap between current and ideal experience.\n\n### Adding or Removing Questions\n\n**Things to consider when adding questions:**\n- Will there be enough time to cover this in the interview?\n- Does it contribute directly to answering your research question?\n- Is it distinct from other questions, or does it overlap?\n- Would a structured type (scale, choice) or open-ended approach work better here?\n\n**Things to consider when removing questions:**\n- Is the question truly unnecessary, or is it just phrased poorly? Sometimes rewording is better than removing.\n- Does removing it leave a gap in the conversation flow?\n\n## Adjusting the Target Participant\n\nThe Participant tab describes who your study is designed for. When editing this section:\n\n- Focus on behavioral criteria — what participants have experienced or done — rather than demographic categories\n- **Required Experience** should describe specific past actions (e.g., \"has evaluated at least two CRM tools in the past year\")\n- **Behavior of Interest** should name the specific behavior you're studying\n- **Screening Question** helps verify participant fit at the start of the interview\n- Consider whether your participant description is specific enough to recruit against\n\n## After Editing: A Quick Review Checklist\n\nAfter any manual edits, run through this checklist before [publishing your study](/docs/publishing-your-study):\n\n- [ ] Does the problem statement still match the rest of the brief?\n- [ ] Are all questions open-ended and non-leading (unless intentionally structured)?\n- [ ] Do questions flow naturally from one to the next?\n- [ ] Is the total number of questions realistic for your target interview length?\n- [ ] Do probes add depth rather than just asking for \"more\"?\n- [ ] Are structured questions configured correctly (scales have labels, choices have options)?\n- [ ] Is the target participant specific enough to recruit?\n- [ ] Does the methodology match the conversational style of your questions?\n\n## Switching Between Manual Editing and Chat\n\nRemember, you can freely switch between editing manually and chatting with the AI Consultant. They operate on the same document. A common workflow is:\n\n1. Use the AI Consultant for the initial draft and major structural decisions\n2. Switch to manual editing for precise wording adjustments and question configuration\n3. Return to the Consultant if you're unsure about a change and want a second opinion\n\nFor a full walkthrough of what each section contains, see [Understanding the Research Brief](/docs/understanding-the-research-brief).\n\n## Related Articles\n\n- [Understanding the Research Brief](/docs/understanding-the-research-brief) — what each section of the brief contains\n- [Structured Questions in AI Interviews](/docs/structured-questions-guide) — the full guide to question types, configuration, and probing\n- [Working with the AI Consultant](/docs/working-with-the-ai-consultant) — collaborating with the AI on study design\n- [Publishing Your Study](/docs/publishing-your-study) — going live with your study\n- [Choosing a Methodology](/docs/choosing-a-methodology) — understanding available research frameworks\n\n## Further reading on the blog\n\n- [Customer Interview Questions: 50+ Templates for Discovery, Churn, and Win/Loss (2026)](/blog/customer-interview-questions-templates) — The template is not the bottleneck — conducting the interview at scale is. Here are 50+ customer interview questions organized by use case, \n- [How to Run AI-Powered Customer Interviews at Scale](/blog/how-to-run-ai-powered-customer-interviews-at-scale) — Learn how to conduct effective customer interviews at scale using AI. This comprehensive guide covers everything from planning and question \n- [The Mom Test for Customer Interviews: How to Ask Questions That Get Real Answers (2026)](/blog/mom-test-customer-interviews-2026) — The Mom Test is the founder's guide to customer interviews that actually work. This complete guide covers Rob Fitzpatrick's three rules, rea\n\n<!-- further-reading:blog -->\n","category":"Study Design","lastModified":"2026-05-13T03:20:03.689176+00:00","metaTitle":"Editing the Brief Manually — Koji Docs","metaDescription":"Learn how to directly edit your Koji research brief to fine-tune questions, methodology, audience, and interview flow.","keywords":["edit brief","interview questions","research brief","study design","manual editing","probes"],"aiSummary":"Koji's structured brief editor lets you directly modify every part of your study design across four tabs: Problem, Participant, Approach, and Questions. This guide covers the structured question editor, drag-and-drop reordering, probing configuration, and a review checklist before publishing.","aiPrerequisites":["understanding-the-research-brief"],"aiLearningOutcomes":["Edit any section of the research brief directly","Fine-tune interview questions, probes, and ordering","Know when to edit manually versus chatting with the AI Consultant","Review edits using a pre-publish checklist"],"aiDifficulty":"beginner","aiEstimatedTime":"7 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}