Answer your agent’s questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.
Your agent has questions for you. Instead of asking them one at a time in a chat prompt, it writes them into its plan or document, and Plannotator shows each one as a card. You answer them all in one place, on your own time, and send them back together.A modern model has no reason to sit blocked on a prompt. Terminal agents and desktop agent apps both lack a good interface for answering questions. Plannotator works with both.The post An interactive UI for the grill-me skill, written before question blocks existed, shows the same idea through /plannotator-last (a tool for annotating your agent’s last message, useful for CLI agents).
How to use
With the skill. The Plannotator installer adds a plannotator skill for Claude Code, Codex, and other agents that read ~/.agents/skills. It teaches the agent the question syntax. Nothing to set up. Ask your agent to use it:
Use the plannotator skill. Write your questions for me as question blocks in a Markdown file, then open it with plannotator annotate.
Without the skill. Copy this prompt into your agent’s AGENTS.md, CLAUDE.md, or a skill of your own:
## Asking the reviewer questionsWhen a decision needs the reviewer (a trade-off you cannot settle from the code or the conversation), write it as a question block. The reviewer answers in place, and the answers come back to you in an "Answers to your questions" section at the top of their feedback, with the questions they left open listed under "Unanswered".```markdown:::questionWhere should losing conflict versions be kept?Last-write-wins silently drops the loser unless we keep it somewhere.- [ ] Local only, purged after 30 days — cheap, no server change- [ ] Server-side per user — survives reinstall, needs a retention policy- [ ] Nowhere — accept silent loss for v1Recommended: Local only, purged after 30 days:::```- `:::question` picks one choice, `:::question-multi` picks any number, `:::question-text` asks for free text (a block with no choices is free text too).- The first line is the question. Other prose lines are context. Most reviewers answer faster with a sentence or two of it: what the choice affects and what you already know. Context can include an image (``), which helps when the question is about something visual, such as a screen.- Choices are task-list items: `- [ ] label`, optionally `- [ ] label — why`. The reviewer can always answer "Other", add a note, or skip.- `Recommended: <label>` marks your recommendation. Text that matches no choice is offered as a suggested answer.- `- [x]` means the choice is already settled. Use it when you resubmit: keep an answered question with the chosen choice checked, or remove the block and write the decision into the prose.- Leave blank lines between the parts so the block also reads well on GitHub.- Ask only what you cannot decide alone, and keep a round short (about 8 questions at most). Do not ask rhetorical questions or questions the codebase answers.- Each answer comes back under its question (`### Q2. <question> (line N)`) as `Answer: <choice>`, marked `(your recommendation)` when the reviewer took yours, or as `Other: …`, free text in a quote, or `Skipped`, plus any `Note:`. A question you marked `- [x]` is settled and only comes back if the reviewer changed it or added a note.
Then:
Your agent writes its questions into its plan or a Markdown file. Plannotator opens it.
You answer the cards.
You click Send answers. The agent gets every answer in one message.
Questions work in plan review, in plannotator annotate on a Markdown file or folder, and in plannotator last. They do not work on HTML pages, live apps, diagram files, or in code review.From Plannotator 0.28.0, the Pi integration keeps working during plan review while you answer. So does Claude Code 2.1.287 or later, through the Plannotator mod, in plan review, /plannotator-annotate, and /plannotator-last. The agent does not wait. Your answers arrive as a message when you send them.
The three kinds of question
Block
You answer with
:::question
One choice.
:::question-multi
Any number of choices.
:::question-text
Free text. A block with no choices is also free text.
What the agent writes
A question block starts with :::question and ends with :::.
:::questionWhere should losing conflict versions be kept?Last-write-wins silently drops the loser unless we keep it somewhere.- [ ] Local only, purged after 30 days - cheap, no server change- [ ] Server-side per user - survives reinstall, needs a retention policy- [ ] Nowhere - accept silent loss for v1Recommended: Local only, purged after 30 days:::
The first line is the question. Lines before the choices are context. Context can include an image. See Show an image in a question.
Each choice is - [ ] label. A reason can follow the label after -.
Recommended: names the agent’s pick. If it matches no choice, Plannotator shows it as a suggested answer.
- [x] marks a choice as already settled.
Show an image in a question
A question can show an image, such as a mockup or a screenshot. Put a Markdown image on its own line in the question, before the choices. The card shows it under the question text.
:::questionKeep a Merge button on the home's "Needs you" list?It would appear only on branches that are ready to merge.- [ ] Keep it, on ready branches only- [ ] Remove it; merge only from the branch pageRecommended: Keep it, on ready branches only:::
The path is relative to the Markdown file, as for any other image in the document. A URL works too.
The agent prompt above tells the agent that a question can include an image. You can also ask for one, for example: “Show the mockup in the question.”The optional Plannotator Flavored Markdown reminder includes a short paragraph and an example of question blocks. Turn it on with "pfmReminder": true in ~/.plannotator/config.json. See Configuration.
How you answer
Each card shows “Question N of M” and a status: Open, Answered, Skipped, or Settled.
Pick a choice, or type your own answer in Other….
Add note adds a comment to your answer.
Skip tells the agent you chose not to answer.
Accept recommended fills in the agent’s pick. It shows only on an open question that has one.
You can also select and comment on the question text like any other text. See Annotations and feedback.Click the answered count in the header to jump to the next open question.
The annotations panel lists every question in a Questions section above your comments. Answers are saved in your draft, so they survive a reload, and Mod+Z undoes them.
What the agent gets back
Answers come first in the feedback. This is what an agent received after Send answers on a four-question plan:
## Answers to your questions4 of 4 questions answered.### Q1. Where should the limit be enforced? (line 25)Answer: In the Node middleware after auth (your recommendation)### Q2. Which algorithm should the counter use? (line 41)Answer: Token bucket### Q3. Which endpoints should get their own, stricter budget? (line 61)Answer:- `POST /v2/orders`- `GET /v2/reports/export`- `POST /v2/webhooks/test`### Q4. What should the 429 response body tell the customer? (line 74)Answer:> You've hit the rate limit for this API key (600 requests/minute on the Team plan). Retry after the number of seconds in the Retry-After header. Need more headroom? Contact support with your key ID.
“(your recommendation)” means you accepted the agent’s pick. A note comes back as Note:, a skipped question as Skipped, and questions you did not answer are listed under “Unanswered”.In Claude Code, the whole message looks like this:
Send answers in plan review
When your only feedback on a plan is answers, the main button reads Send answers. The agent is told you answered its questions and is asked to revise the plan and resubmit. It does not get the “your plan was not approved” message.If you also comment or edit the plan, the button reads Send feedback, and the answers go at the top of the normal feedback.To change the message the agent receives after Send answers, set the answered key in prompts.plan. See Customize Feedback.
In Claude Code, Approve does not send answers or notes to the agent. Plannotator warns you first. To send answers, use Send answers.
Resubmitting with - [x]
On resubmit, the agent does one of two things with each answered question:
It removes the block and writes the decision into the plan.
It keeps the block and marks the chosen choice - [x].
A settled choice shows as selected with a “Settled” tag. You can still change it. A settled question comes back to the agent only if you changed it or added a note.
Limits
Share links carry an answer as a comment on the question, not as a filled-in card.
A browser agent using Plannotator’s WebMCP tools can read questions and answers but cannot answer.
If the agent rewords a question, your earlier answer is no longer attached to it. The answer shows in the Questions section as unanchored and is still sent.
Last verified on October 3, 2026, using Plannotator release v0.27.25, product commit c9c8cbbb. Screenshots and the clip were captured from v0.27.23. The agent prompt and “Where it works” were updated for v0.28.0 on October 4, 2026. Maintained by the Plannotator project.
Last modified on October 5, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Plannotator","description":"Plannotator product and open-source documentation, planning templates, framework profiles, comparisons, and guides to AI-assisted development.","colors":{"primary":"#6D5BD0","light":"#8A7BE0","dark":"#8A7BE0"},"logo":{"light":"https://mintcdn.com/plannotator/vqDpSTQONLoR6rqS/images/totman_transparent.webp?fit=max\u0026auto=format\u0026n=vqDpSTQONLoR6rqS\u0026q=85\u0026s=979a51a8f7a0fc863c02150b818d7df0","dark":"https://mintcdn.com/plannotator/vqDpSTQONLoR6rqS/images/totman_transparent.webp?fit=max\u0026auto=format\u0026n=vqDpSTQONLoR6rqS\u0026q=85\u0026s=979a51a8f7a0fc863c02150b818d7df0"},"favicon":"https://mintcdn.com/plannotator/R7DK-7odgGi8zHBh/favicon.png?fit=max\u0026auto=format\u0026n=R7DK-7odgGi8zHBh\u0026q=85\u0026s=3ab0d16d5c5acbc3b715b15b24274415","navbar":{"links":[{"href":"https://help.plannotator.ai/workspaces/","label":"Workspaces Help"},{"href":"https://github.com/backnotprop/plannotator","label":"GitHub"},{"href":"https://plannotator.ai","label":"Plannotator.ai"}],"primary":{"type":"button","label":"Open source","href":"/open-source/"}},"footer":{"socials":{}},"search":{"prompt":"Search Plannotator docs and guides…"},"seo":{"metatags":{"canonical":"https://docs.plannotator.ai","og:image":"https://plannotator.ai/assets/plannotator-generic-og-v1.jpg","twitter:image":"https://plannotator.ai/assets/plannotator-generic-og-v1.jpg","twitter:card":"summary_large_image"}},"errors":{"404":{"redirect":false,"title":"Page not found","description":"Use the product switcher, navigation, or search to find a page."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"plannotator","hasAudioNarration":false,"actualSubdomain":"plannotator","customDomains":["docs.plannotator.ai"],"gitSource":{"type":"github","owner":"plannotator","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"}},"buildId":"6aebe80b859848b3a5e3dcb5","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Open Source","count":53},{"language":"default","tag":"Learn","count":31},{"language":"default","tag":"Planning Library","count":24},{"language":"default","tag":"Code review","count":12},{"language":"default","tag":"Start","count":12},{"language":"default","tag":"Agents","count":10},{"language":"default","tag":"Reference","count":10},{"language":"default","tag":"Templates","count":10},{"language":"default","tag":"Frameworks","count":9},{"language":"default","tag":"AI development workflows","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"open-source/workflows/questions","slug":"/open-source/workflows/questions","pageMetadata":{"title":"Answer Your Agent's Questions Asynchronously","sidebarTitle":"Questions","description":"Answer your agent's questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.","keywords":["async agent questions","Plannotator questions","question block",":::question","agent asks reviewer","answer agent questions","plan review questions","AGENTS.md question syntax"],"og:type":"article","href":"/open-source/workflows/questions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Answer your agent’s questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Frame,{children:[_jsx(`video`,{className:`mint-block dark:mint-hidden mint-w-full`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-flow.mp4?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=f1d6321e68a408cdeb735b809643e403`,autoPlay:true,muted:true,loop:true,playsInline:true,controls:true,\"data-path\":`images/questions-flow.mp4`}),_jsx(`video`,{className:`mint-hidden dark:mint-block mint-w-full`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-flow-dark.mp4?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=a23ff8e29b831e171f41027fba1a0b4c`,autoPlay:true,muted:true,loop:true,playsInline:true,controls:true,\"data-path\":`images/questions-flow-dark.mp4`})]}),`\n`,_jsx(_components.p,{children:`Your agent has questions for you. Instead of asking them one at a time in a chat prompt, it writes them into its plan or document, and Plannotator shows each one as a card. You answer them all in one place, on your own time, and send them back together.`}),`\n`,_jsx(_components.p,{children:`A modern model has no reason to sit blocked on a prompt. Terminal agents and desktop agent apps both lack a good interface for answering questions. Plannotator works with both.`}),`\n`,_jsxs(_components.p,{children:[`The post `,_jsx(_components.a,{href:`https://plannotator.ai/blog/an-interactive-ui-for-the-grill-me-skill`,children:`An interactive UI for the grill-me skill`}),`, written before question blocks existed, shows the same idea through `,_jsx(_components.code,{children:`/plannotator-last`}),` (a tool for annotating your agent’s last message, useful for CLI agents).`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-to-use`,children:`How to use`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`With the skill.`}),` The Plannotator installer adds a `,_jsx(_components.code,{children:`plannotator`}),` skill for Claude Code, Codex, and other agents that read `,_jsx(_components.code,{children:`~/.agents/skills`}),`. It teaches the agent the question syntax. Nothing to set up. Ask your agent to use it:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use the plannotator skill. Write your questions for me as question blocks in a Markdown file, then open it with plannotator annotate.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Without the skill.`}),` Copy this prompt into your agent’s `,_jsx(_components.code,{children:`AGENTS.md`}),`, `,_jsx(_components.code,{children:`CLAUDE.md`}),`, or a skill of your own:`]}),`\n`,_jsx(CodeBlock,{filename:``,expandable:`true`,numberOfLines:`26`,language:`markdown`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`markdown`,children:_jsxs(_components.code,{language:`markdown`,numberOfLines:`26`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## Asking the reviewer questions`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`When a decision needs the reviewer (a trade-off you cannot settle from the code or the conversation), write it as a question block. The reviewer answers in place, and the answers come back to you in an \"Answers to your questions\" section at the top of their feedback, with the questions they left open listed under \"Unanswered\".`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:\"```markdown\"})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:::question`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Where should losing conflict versions be kept?`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Last-write-wins silently drops the loser unless we keep it somewhere.`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Local only, purged after 30 days — cheap, no server change`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Server-side per user — survives reinstall, needs a retention policy`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Nowhere — accept silent loss for v1`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Recommended: Local only, purged after 30 days`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:::`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:\"```\"})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\" `:::question`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` picks one choice, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`:::question-multi`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` picks any number, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`:::question-text`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` asks for free text (a block with no choices is free text too).`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` The first line is the question. Other prose lines are context. Most reviewers answer faster with a sentence or two of it: what the choice affects and what you already know. Context can include an image (`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"``\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`), which helps when the question is about something visual, such as a screen.`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Choices are task-list items: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`- [ ] label`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, optionally `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`- [ ] label — why`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`. The reviewer can always answer \"Other\", add a note, or skip.`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\" `Recommended: \u003clabel>`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` marks your recommendation. Text that matches no choice is offered as a suggested answer.`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\" `- [x]`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` means the choice is already settled. Use it when you resubmit: keep an answered question with the chosen choice checked, or remove the block and write the decision into the prose.`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Leave blank lines between the parts so the block also reads well on GitHub.`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Ask only what you cannot decide alone, and keep a round short (about 8 questions at most). Do not ask rhetorical questions or questions the codebase answers.`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Each answer comes back under its question (`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`### Q2. \u003cquestion> (line N)`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) as `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`Answer: \u003cchoice>`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, marked `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`(your recommendation)`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` when the reviewer took yours, or as `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`Other: …`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, free text in a quote, or `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`Skipped`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, plus any `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`Note:`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`. A question you marked `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\"`- [x]`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` is settled and only comes back if the reviewer changed it or added a note.`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Then:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Your agent writes its questions into its plan or a Markdown file. Plannotator opens it.`}),`\n`,_jsx(_components.li,{children:`You answer the cards.`}),`\n`,_jsxs(_components.li,{children:[`You click `,_jsx(_components.strong,{children:`Send answers`}),`. The agent gets every answer in one message.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/open-source/start/skills`,children:`Agent Skills`}),` for what the installer sets up.`]}),`\n`,_jsx(Heading,{level:`2`,id:`where-it-works`,children:`Where it works`}),`\n`,_jsxs(_components.p,{children:[`Questions work in plan review, in `,_jsx(_components.code,{children:`plannotator annotate`}),` on a Markdown file or folder, and in `,_jsx(_components.code,{children:`plannotator last`}),`. They do not work on HTML pages, live apps, diagram files, or in code review.`]}),`\n`,_jsxs(_components.p,{children:[`From Plannotator 0.28.0, the Pi integration keeps working during plan review while you answer. So does Claude Code 2.1.287 or later, through the `,_jsx(_components.a,{href:`/open-source/agents/claude-code#the-plannotator-mod`,children:`Plannotator mod`}),`, in plan review, `,_jsx(_components.code,{children:`/plannotator-annotate`}),`, and `,_jsx(_components.code,{children:`/plannotator-last`}),`. The agent does not wait. Your answers arrive as a message when you send them.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-three-kinds-of-question`,children:`The three kinds of question`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Block`}),_jsx(_components.th,{children:`You answer with`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`:::question`})}),_jsx(_components.td,{children:`One choice.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`:::question-multi`})}),_jsx(_components.td,{children:`Any number of choices.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`:::question-text`})}),_jsx(_components.td,{children:`Free text. A block with no choices is also free text.`})]})]})]}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=7cc93b7affeb70473c481f07c1c1fae8`,alt:`A multi-choice question card asking which endpoints get a stricter budget, with three endpoints checked.`,\"data-og-width\":`1468`,width:`1468`,\"data-og-height\":`596`,height:`596`,\"data-path\":`images/questions-card-multi-choice.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=f126a7292afe68f5b5b3d117efcb974c 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=b3f8b1c1da4428e19d08d59eb99c2582 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=27c9990f8050c5147453ae569a8f1682 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=d38c1373354d20389c804c6dad457fc4 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=92ad5f4ad93b8eec331abe4a4e68b13c 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=2d5e3ad2dc66d46ef953e498f32cd175 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice-dark.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=5e4b7a283bf81fc73b246c3860b86b81`,alt:`A multi-choice question card asking which endpoints get a stricter budget, with three endpoints checked.`,\"data-og-width\":`1468`,width:`1468`,\"data-og-height\":`596`,height:`596`,\"data-path\":`images/questions-card-multi-choice-dark.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice-dark.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=82e6350a7f4bc4c32e22fbe5a584d663 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice-dark.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=1a3c7634f92ac33c136d1b455d61e1d5 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice-dark.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=4907d1c544f0c6c61070773459e759c2 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice-dark.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=f3b6e7bb15d797539dc28e53b6b144db 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice-dark.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=ae8d8f76088d5b252e94a180b09e3abd 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-multi-choice-dark.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=404c179b9a42d67525d3b2bed40a44d3 2500w`})]}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=677c25596447376c3194c41032bfc843`,alt:`A free-text question card asking what the 429 response body should tell the customer, with a typed answer.`,\"data-og-width\":`1468`,width:`1468`,\"data-og-height\":`442`,height:`442`,\"data-path\":`images/questions-card-free-text.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=32e541c8dc2f2a26a8189f01a7245310 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=99e547f4654711f4c8e29dacc2d07380 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=0b1fda8acb44a387fc86f9c61b5016d8 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=da0471ca12c476361c0048cb44dd8e5f 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=51a412d537222b1c627467d336b1b127 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=4cd8010354aa449ae0208fecbb9320ee 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text-dark.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=73c40018a5a92ae07fd6f9fb4fe3c016`,alt:`A free-text question card asking what the 429 response body should tell the customer, with a typed answer.`,\"data-og-width\":`1468`,width:`1468`,\"data-og-height\":`442`,height:`442`,\"data-path\":`images/questions-card-free-text-dark.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text-dark.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=dbf2ebe37928154ac22bbf70e70718d1 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text-dark.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=9348b993a26034405adfe001c2c0091d 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text-dark.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=41bf0f6e9a6f9d0bb5e31220da130b77 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text-dark.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=ff5669034e81e6e271cc1bb7de20977a 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text-dark.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=e718744899e28361f1c46dca231fad62 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-free-text-dark.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=2656a367c5f3fe7178bef1a904ae3d9c 2500w`})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-agent-writes`,children:`What the agent writes`}),`\n`,_jsxs(_components.p,{children:[`A question block starts with `,_jsx(_components.code,{children:`:::question`}),` and ends with `,_jsx(_components.code,{children:`:::`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`markdown`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`markdown`,children:_jsxs(_components.code,{language:`markdown`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:::question`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Where should losing conflict versions be kept?`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Last-write-wins silently drops the loser unless we keep it somewhere.`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Local only, purged after 30 days - cheap, no server change`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Server-side per user - survives reinstall, needs a retention policy`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Nowhere - accept silent loss for v1`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Recommended: Local only, purged after 30 days`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:::`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The first line is the question. Lines before the choices are context. Context can include an image. See `,_jsx(_components.a,{href:`#show-an-image-in-a-question`,children:`Show an image in a question`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Each choice is `,_jsx(_components.code,{children:`- [ ] label`}),`. A reason can follow the label after `,_jsx(_components.code,{children:`-`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`Recommended:`}),` names the agent’s pick. If it matches no choice, Plannotator shows it as a suggested answer.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`- [x]`}),` marks a choice as already settled.`]}),`\n`]}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=1a981d20b6f5cad0580934b56c495e32`,alt:`An open single-choice question card, Question 1 of 4, with three choices, a Recommended tag on one, an Other option, and Add note, Skip, and Accept recommended buttons.`,\"data-og-width\":`1468`,width:`1468`,\"data-og-height\":`696`,height:`696`,\"data-path\":`images/questions-card-single-choice.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=273e5df928ebb55665a1c9b3db3cc958 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=0485f60d6c28097026873e583a2e6f79 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=0f15b029e301f64f28ceeb8b3eecb373 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=4d01eccfdfc361880b02c5f13e628806 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=202482bd6226104f7eb6b5bc8997e596 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=bba9b563a1f465757eaf82f0139d13e2 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice-dark.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=2694206bac7e4e3f41da5ee2f40924eb`,alt:`An open single-choice question card, Question 1 of 4, with three choices, a Recommended tag on one, an Other option, and Add note, Skip, and Accept recommended buttons.`,\"data-og-width\":`1468`,width:`1468`,\"data-og-height\":`696`,height:`696`,\"data-path\":`images/questions-card-single-choice-dark.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice-dark.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=dee0001c7a8386b7166136e0632f6f37 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice-dark.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=2412881af081be58f7e45488f28a36ed 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice-dark.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=0c46a5b4d617ebcf79abdab9fa1983a4 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice-dark.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=b1134138b53b826b2cd67ccb679090c0 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice-dark.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=78ca6f227ebceecb58e2cee1e1e4e545 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-card-single-choice-dark.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=b0a28e3dd0e8f388c0788f819255be70 2500w`})]}),`\n`,_jsx(Heading,{level:`3`,id:`show-an-image-in-a-question`,children:`Show an image in a question`}),`\n`,_jsx(_components.p,{children:`A question can show an image, such as a mockup or a screenshot. Put a Markdown image on its own line in the question, before the choices. The card shows it under the question text.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`markdown`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`markdown`,children:_jsxs(_components.code,{language:`markdown`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:::question`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Keep a Merge button on the home's \"Needs you\" list?`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`It would appear only on branches that are ready to merge.`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-light-text-decoration\":`underline`,\"--shiki-dark\":`#D4D4D4`,\"--shiki-dark-text-decoration\":`underline`},children:`mockups/home-needs-you.png`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Keep it, on ready branches only`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [ ] Remove it; merge only from the branch page`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Recommended: Keep it, on ready branches only`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:::`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The path is relative to the Markdown file, as for any other image in the document. A URL works too.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/plannotator/BFZaDI_B4NpaJ2j9/images/questions-card-with-image-dark.webp?fit=max\u0026auto=format\u0026n=BFZaDI_B4NpaJ2j9\u0026q=85\u0026s=9244933d0ddcb83874b781a720ccbdd9`,alt:`A question card, Question 4 of 10, asking whether to keep a Merge button. A mockup of the page is shown under the question, above two choices, one marked Recommended.`,\"data-og-width\":`1806`,width:`1806`,\"data-og-height\":`1610`,height:`1610`,\"data-path\":`images/questions-card-with-image-dark.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/BFZaDI_B4NpaJ2j9/images/questions-card-with-image-dark.webp?w=280\u0026fit=max\u0026auto=format\u0026n=BFZaDI_B4NpaJ2j9\u0026q=85\u0026s=a0071962d5bfedf9257055582dec417a 280w, https://mintcdn.com/plannotator/BFZaDI_B4NpaJ2j9/images/questions-card-with-image-dark.webp?w=560\u0026fit=max\u0026auto=format\u0026n=BFZaDI_B4NpaJ2j9\u0026q=85\u0026s=10465ad2f02fa50cbfc722bc19fb2c0b 560w, https://mintcdn.com/plannotator/BFZaDI_B4NpaJ2j9/images/questions-card-with-image-dark.webp?w=840\u0026fit=max\u0026auto=format\u0026n=BFZaDI_B4NpaJ2j9\u0026q=85\u0026s=e77b701da0766d111e957601c88e9f72 840w, https://mintcdn.com/plannotator/BFZaDI_B4NpaJ2j9/images/questions-card-with-image-dark.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=BFZaDI_B4NpaJ2j9\u0026q=85\u0026s=de5b24b1cee743b8eaab31a41b303add 1100w, https://mintcdn.com/plannotator/BFZaDI_B4NpaJ2j9/images/questions-card-with-image-dark.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=BFZaDI_B4NpaJ2j9\u0026q=85\u0026s=c4e1eeffcba43da04eb59767a49ad643 1650w, https://mintcdn.com/plannotator/BFZaDI_B4NpaJ2j9/images/questions-card-with-image-dark.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=BFZaDI_B4NpaJ2j9\u0026q=85\u0026s=85c0de89e9903b94b80cc34e48cd9c27 2500w`})}),`\n`,_jsx(_components.p,{children:`The agent prompt above tells the agent that a question can include an image. You can also ask for one, for example: “Show the mockup in the question.”`}),`\n`,_jsxs(_components.p,{children:[`The optional Plannotator Flavored Markdown reminder includes a short paragraph and an example of question blocks. Turn it on with `,_jsx(_components.code,{children:`\"pfmReminder\": true`}),` in `,_jsx(_components.code,{children:`~/.plannotator/config.json`}),`. See `,_jsx(_components.a,{href:`/open-source/reference/configuration`,children:`Configuration`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-you-answer`,children:`How you answer`}),`\n`,_jsx(_components.p,{children:`Each card shows “Question N of M” and a status: Open, Answered, Skipped, or Settled.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Pick a choice, or type your own answer in `,_jsx(_components.strong,{children:`Other…`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Add note`}),` adds a comment to your answer.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Skip`}),` tells the agent you chose not to answer.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Accept recommended`}),` fills in the agent’s pick. It shows only on an open question that has one.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`You can also select and comment on the question text like any other text. See `,_jsx(_components.a,{href:`/open-source/workflows/annotations-and-feedback`,children:`Annotations and feedback`}),`.`]}),`\n`,_jsx(_components.p,{children:`Click the answered count in the header to jump to the next open question.`}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=8c5eaf1fc918d6da06ee8be65b91c3e8`,width:`391`,alt:`The plan review header showing 4/4 answered, a Send answers button, and Approve.`,\"data-og-width\":`782`,\"data-og-height\":`120`,\"data-path\":`images/questions-header-send-answers.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=d7f678fae4883ea45e814cac00aa9ac0 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=548796eb72be032873372f7e09608b02 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=4b939f022d277b5741fb2d6a81b3b252 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=067b56fb0c9f57a2011be1efae1ae2d2 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=555387f95f24592503cd00ab98fe53e2 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=4208ccb0404ee5e37ed3aa3079d6f94e 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers-dark.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=a171a8981ea7cc09f9fc189a34b3f511`,width:`391`,alt:`The plan review header showing 4/4 answered, a Send answers button, and Approve.`,\"data-og-width\":`782`,\"data-og-height\":`120`,\"data-path\":`images/questions-header-send-answers-dark.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers-dark.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=ebeaecca49d03f272936e23864fb4c9e 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers-dark.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=5beda7579d357ad3d73410ab476f7837 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers-dark.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=4adb45e630d42ea10d2dcc2adb20e973 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers-dark.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=efe0161826a3e1e733530a33161bfebd 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers-dark.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=38c833cb83a8df927634271594c3b69c 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-header-send-answers-dark.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=a480cf4d0e1379d21e3e007a4c0df7df 2500w`})]}),`\n`,_jsxs(_components.p,{children:[`The annotations panel lists every question in a `,_jsx(_components.strong,{children:`Questions`}),` section above your comments. Answers are saved in your draft, so they survive a reload, and `,_jsx(_components.code,{children:`Mod+Z`}),` undoes them.`]}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=b7786ef4a0fdaaa656f795dc3bea188a`,width:`288`,alt:`The annotations panel with a Questions section at 4/4, each question listed with its answer, above an empty Comments section.`,\"data-og-width\":`576`,\"data-og-height\":`1174`,\"data-path\":`images/questions-panel-answered.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=07668340ed9a6b5ab25ef7ac777a0359 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=ac014167c0831941d584a14134254ba5 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=62bd6a5df337868882be6304fdf9ded7 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=109e417eeb4521a01ef40fad318f505c 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=a0c3b88ff0955fcf475a277a694c5283 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=8127c4bf65ce24509bd5661d6c5a7ea6 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered-dark.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=f03004e246a1b2012bd826055dd09738`,width:`288`,alt:`The annotations panel with a Questions section at 4/4, each question listed with its answer, above an empty Comments section.`,\"data-og-width\":`576`,\"data-og-height\":`1174`,\"data-path\":`images/questions-panel-answered-dark.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered-dark.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=f1106d04e7d17714a393b2dc422e2ddb 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered-dark.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=36f62bbe54a0527a934516a3244c6394 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered-dark.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=9166bbc1918b08e3d79c14b2dd676d4a 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered-dark.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=cabc8d41cabfda37b7b0acac3b7d39f8 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered-dark.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=1e2b93231901f8123cb031c0c41b03ee 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-panel-answered-dark.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=271f364b036d672942e9a87d4afcadd1 2500w`})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-agent-gets-back`,children:`What the agent gets back`}),`\n`,_jsxs(_components.p,{children:[`Answers come first in the feedback. This is what an agent received after `,_jsx(_components.strong,{children:`Send answers`}),` on a four-question plan:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`markdown`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`markdown`,children:_jsxs(_components.code,{language:`markdown`,numberOfLines:`19`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`## Answers to your questions`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`4 of 4 questions answered.`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`### Q1. Where should the limit be enforced? (line 25)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Answer: In the Node middleware after auth (your recommendation)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`### Q2. Which algorithm should the counter use? (line 41)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Answer: Token bucket`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`### Q3. Which endpoints should get their own, stricter budget? (line 61)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Answer:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\" `POST /v2/orders`\"})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\" `GET /v2/reports/export`\"})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#6796E6`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#CE9178`},children:\" `POST /v2/webhooks/test`\"})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-light-font-weight\":`bold`,\"--shiki-dark\":`#569CD6`,\"--shiki-dark-font-weight\":`bold`},children:`### Q4. What should the 429 response body tell the customer? (line 74)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Answer:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#6A9955`},children:`>`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#D4D4D4`},children:` You've hit the rate limit for this API key (600 requests/minute on the Team plan). Retry after the number of seconds in the Retry-After header. Need more headroom? Contact support with your key ID.`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`“(your recommendation)” means you accepted the agent’s pick. A note comes back as `,_jsx(_components.code,{children:`Note:`}),`, a skipped question as `,_jsx(_components.code,{children:`Skipped`}),`, and questions you did not answer are listed under “Unanswered”.`]}),`\n`,_jsx(_components.p,{children:`In Claude Code, the whole message looks like this:`}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=7d2ce458c1032b125e8c3f9fc670a09b`,alt:`A Claude Code terminal showing the Plannotator feedback after Send answers: instructions to revise the plan, then Answers to your questions with four answered questions.`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`1301`,height:`1301`,\"data-path\":`images/questions-agent-feedback-terminal.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=d64f34e386ebbccad4b6b1bdaf06a844 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=74604a4736afdee9333d247ad577ff4b 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=f12a6954dcd95c81b87af23c17d206aa 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=1993e660fe452b92d299bd35f5ccf459 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=db3de6509932418d93ff6efc24e89228 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=a4754e6991cd3571d2adcb9a9cf66b73 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal-dark.webp?fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=3ca2bbc0ef456919261acc4300611a08`,alt:`A Claude Code terminal showing the Plannotator feedback after Send answers: instructions to revise the plan, then Answers to your questions with four answered questions.`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`1301`,height:`1301`,\"data-path\":`images/questions-agent-feedback-terminal-dark.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal-dark.webp?w=280\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=d91c99e067945445482e1dddf9c7033c 280w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal-dark.webp?w=560\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=f8a3cd4c839b746cfe3a5aae21c7e090 560w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal-dark.webp?w=840\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=d6b406fcd915c3adc59a35659d3b5016 840w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal-dark.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=1bf19aa240a9e87d1220035dbb56e210 1100w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal-dark.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=a0120266d35e193a30e5842ec6ad9f97 1650w, https://mintcdn.com/plannotator/P_Mwm6tav4UNIqRn/images/questions-agent-feedback-terminal-dark.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=P_Mwm6tav4UNIqRn\u0026q=85\u0026s=0b81c4a770c792be7c366d8bf3fe4220 2500w`})]}),`\n`,_jsx(Heading,{level:`2`,id:`send-answers-in-plan-review`,children:`Send answers in plan review`}),`\n`,_jsxs(_components.p,{children:[`When your only feedback on a plan is answers, the main button reads `,_jsx(_components.strong,{children:`Send answers`}),`. The agent is told you answered its questions and is asked to revise the plan and resubmit. It does not get the “your plan was not approved” message.`]}),`\n`,_jsxs(_components.p,{children:[`If you also comment or edit the plan, the button reads `,_jsx(_components.strong,{children:`Send feedback`}),`, and the answers go at the top of the normal feedback.`]}),`\n`,_jsxs(_components.p,{children:[`To change the message the agent receives after `,_jsx(_components.strong,{children:`Send answers`}),`, set the `,_jsx(_components.code,{children:`answered`}),` key in `,_jsx(_components.code,{children:`prompts.plan`}),`. See `,_jsx(_components.a,{href:`/open-source/reference/custom-feedback#plan-and-document-feedback`,children:`Customize Feedback`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`In Claude Code, `,_jsx(_components.strong,{children:`Approve`}),` does not send answers or notes to the agent. Plannotator warns you first. To send answers, use `,_jsx(_components.strong,{children:`Send answers`}),`.`]})}),`\n`,_jsxs(Heading,{level:`2`,id:`resubmitting-with-x`,children:[`Resubmitting with `,_jsx(_components.code,{children:`- [x]`})]}),`\n`,_jsx(_components.p,{children:`On resubmit, the agent does one of two things with each answered question:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`It removes the block and writes the decision into the plan.`}),`\n`,_jsxs(_components.li,{children:[`It keeps the block and marks the chosen choice `,_jsx(_components.code,{children:`- [x]`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`A settled choice shows as selected with a “Settled” tag. You can still change it. A settled question comes back to the agent only if you changed it or added a note.`}),`\n`,_jsx(Heading,{level:`2`,id:`limits`,children:`Limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Share links carry an answer as a comment on the question, not as a filled-in card.`}),`\n`,_jsx(_components.li,{children:`A browser agent using Plannotator’s WebMCP tools can read questions and answers but cannot answer.`}),`\n`,_jsx(_components.li,{children:`If the agent rewords a question, your earlier answer is no longer attached to it. The answer shows in the Questions section as unanchored and is still sent.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Last verified on October 3, 2026, using Plannotator release v0.27.25, product commit `,_jsx(_components.code,{children:`c9c8cbbb`}),`. Screenshots and the clip were captured from v0.27.23. The agent prompt and “Where it works” were updated for v0.28.0 on October 4, 2026. Maintained by the Plannotator project.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Answer Your Agent's Questions Asynchronously","sidebarTitle":"Questions","description":"Answer your agent's questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.","keywords":["async agent questions","Plannotator questions","question block",":::question","agent asks reviewer","answer agent questions","plan review questions","AGENTS.md question syntax"],"og:type":"article","href":"/open-source/workflows/questions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How to use","slug":"how-to-use","depth":2,"children":[]},{"title":"Where it works","slug":"where-it-works","depth":2,"children":[]},{"title":"The three kinds of question","slug":"the-three-kinds-of-question","depth":2,"children":[]},{"title":"What the agent writes","slug":"what-the-agent-writes","depth":2,"children":[{"title":"Show an image in a question","slug":"show-an-image-in-a-question","depth":3,"children":[]}]},{"title":"How you answer","slug":"how-you-answer","depth":2,"children":[]},{"title":"What the agent gets back","slug":"what-the-agent-gets-back","depth":2,"children":[]},{"title":"Send answers in plan review","slug":"send-answers-in-plan-review","depth":2,"children":[]},{"title":"Resubmitting with - [x]","slug":"resubmitting-with-x","depth":2,"children":[]},{"title":"Limits","slug":"limits","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.mint-w-full {\n width: 100%\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"plannotator","siteName":"Plannotator","title":"Answer Your Agent's Questions Asynchronously - Plannotator","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T02:08:04.315Z","gitLastModified":"2026-10-05T00:53:37.000Z","originalFileLocation":"open-source/workflows/questions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Answer your agent\u0026#x27;s questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Plannotator\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Answer Your Agent\u0026#x27;s Questions Asynchronously - Plannotator\">\u003cmeta data-mint-head property=\"og:description\" content=\"Answer your agent\u0026#x27;s questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Plannotator\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.plannotator.ai/open-source/workflows/questions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://plannotator.ai/assets/plannotator-generic-og-v1.jpg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Answer Your Agent\u0026#x27;s Questions Asynchronously - Plannotator\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Answer your agent\u0026#x27;s questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://plannotator.ai/assets/plannotator-generic-og-v1.jpg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/plannotator/hZJJbeM0ENum3mVc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Plannotator\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6D5BD0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.plannotator.ai/open-source/workflows/questions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/open-source/workflows/questions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.plannotator.ai/#organization\",\"name\":\"Plannotator\",\"url\":\"https://docs.plannotator.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/plannotator/vqDpSTQONLoR6rqS/images/totman_transparent.webp?fit=max\u0026auto=format\u0026n=vqDpSTQONLoR6rqS\u0026q=85\u0026s=979a51a8f7a0fc863c02150b818d7df0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.plannotator.ai#website\",\"name\":\"Plannotator\",\"url\":\"https://docs.plannotator.ai\",\"publisher\":{\"@id\":\"https://docs.plannotator.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.plannotator.ai/open-source/workflows/questions#webpage\",\"url\":\"https://docs.plannotator.ai/open-source/workflows/questions\",\"name\":\"Answer Your Agent's Questions Asynchronously\",\"description\":\"Answer your agent's questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.\",\"dateModified\":\"2026-10-05T00:53:37.000Z\",\"isPartOf\":{\"@id\":\"https://docs.plannotator.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.plannotator.ai/open-source/workflows/questions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.plannotator.ai/open-source/workflows/questions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Plans and documents\",\"item\":\"https://docs.plannotator.ai/open-source/workflows/plan-review\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Answer Your Agent's Questions Asynchronously\",\"item\":\"https://docs.plannotator.ai/open-source/workflows/questions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.plannotator.ai/open-source/workflows/questions#article\",\"headline\":\"Answer Your Agent's Questions Asynchronously\",\"name\":\"Answer Your Agent's Questions Asynchronously\",\"description\":\"Answer your agent's questions asynchronously in Plannotator: question cards you fill in on your own time, a quality interface for terminal and desktop agents alike.\",\"url\":\"https://docs.plannotator.ai/open-source/workflows/questions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.plannotator.ai/open-source/workflows/questions#webpage\"},\"image\":\"https://plannotator.ai/assets/plannotator-generic-og-v1.jpg\",\"dateModified\":\"2026-10-05T00:53:37.000Z\",\"keywords\":\"async agent questions, Plannotator questions, question block, :::question, agent asks reviewer, answer agent questions, plan review questions, AGENTS.md question syntax\",\"publisher\":{\"@id\":\"https://docs.plannotator.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.plannotator.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Plannotator\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Plannotator\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/open-source/workflows/questions.md","siteName":"Plannotator","nav":{"global":null,"products":[{"product":"Plannotator","icon":"house","pages":[{"title":"Plannotator","href":""}]},{"product":"Open Source","icon":"code-branch","groups":[{"group":"Start","pages":[{"title":"Plannotator OSS Documentation","sidebarTitle":"Overview","href":"/open-source"},{"title":"Install Plannotator","sidebarTitle":"Installation","href":"/open-source/start/installation"},{"title":"Plannotator Open Source Security","sidebarTitle":"Security","href":"/open-source/security"},{"title":"Self-Host Plannotator's Deprecated Share Services","sidebarTitle":"Self-hosting","href":"/open-source/self-hosting"},{"title":"Set Up the Plannotator Inbox for Your Coding Agents","sidebarTitle":"Inbox","href":"/open-source/inbox"},{"title":"Review Plannotator Sessions over Tailscale","sidebarTitle":"Tailscale remote reviews","href":"/open-source/tailscale"},{"title":"Open Plannotator on Another Device","sidebarTitle":"Remote access","href":"/open-source/remote-access"},{"title":"Install and Manage Plannotator Skills","sidebarTitle":"Skills","href":"/open-source/start/skills"},{"title":"Annotate Your First Plan","sidebarTitle":"Quickstart: Planning","href":"/open-source/start/quickstart"},{"title":"Review Your First Code Change","sidebarTitle":"Quickstart: Code Review","href":"/open-source/start/code-review-quickstart"},{"title":"Open Plannotator","sidebarTitle":"Open Plannotator","href":"/open-source/start/open-plannotator"},{"title":"Turn Plannotator Feedback into Agent Skills","sidebarTitle":"Compound value","href":"/open-source/start/compound-value"}]},{"group":"Plans and documents","pages":[{"title":"Review an AI Coding Plan with Plannotator","sidebarTitle":"Plan review","href":"/open-source/workflows/plan-review"},{"title":"Open and Annotate Markdown, Documents, URLs, and Folders","sidebarTitle":"Documents","href":"/open-source/workflows/documents"},{"title":"Annotate a Folder with Plannotator","sidebarTitle":"Folders","href":"/open-source/workflows/folders"},{"title":"Annotate HTML in Plannotator","sidebarTitle":"HTML","href":"/open-source/workflows/html"},{"title":"Add Annotations and Send Feedback","sidebarTitle":"Annotations and feedback","description":"Comment on exact text, add a global comment, draw on image attachments, and choose whether to request changes, approve, or dismiss a review.","href":"/open-source/workflows/annotations-and-feedback"},{"title":"Answer Your Agent's Questions Asynchronously","sidebarTitle":"Questions","href":"/open-source/workflows/questions"},{"title":"Use Local Version History and Plan Diffs","sidebarTitle":"Version history","description":"Compare plan and document revisions in Plannotator and control the local history copies stored on your machine.","href":"/open-source/workflows/version-history"},{"title":"Share a Plannotator Session","sidebarTitle":"Sharing","href":"/open-source/workflows/sharing"}]},{"group":"Code review","pages":[{"title":"Code Review with Plannotator","sidebarTitle":"Code review overview","href":"/code-review/index"},{"title":"Review local code changes","sidebarTitle":"Local changes","href":"/open-source/workflows/local-changes"},{"title":"Review GitButler Workspaces, Stacks, and Branches","sidebarTitle":"GitButler","href":"/open-source/workflows/gitbutler"},{"title":"Review pull requests and merge requests","sidebarTitle":"Pull requests and merge requests","href":"/open-source/workflows/pull-requests"},{"title":"Ask AI during a review","sidebarTitle":"Ask AI","href":"/open-source/workflows/ask-ai"},{"title":"Ask This Session: Ask AI Answered by Your Agent","sidebarTitle":"Ask this session","href":"/open-source/workflows/ask-this-session"},{"title":"Run Agent Reviews, Code Tours, and Guided Reviews","sidebarTitle":"Agent and guided reviews","href":"/open-source/workflows/agent-reviews"}]},{"group":"Reference","pages":[{"title":"Automate and Customize Plannotator","sidebarTitle":"Reference overview","href":"/open-source/reference/index"},{"title":"Plannotator CLI reference","sidebarTitle":"CLI","href":"/open-source/reference/cli"},{"title":"Configure Plannotator","sidebarTitle":"Configuration","href":"/open-source/reference/configuration"},{"title":"Plannotator environment variables","sidebarTitle":"Environment variables","href":"/open-source/reference/environment-variables"},{"title":"Plannotator OSS Privacy and Data Flow","sidebarTitle":"Privacy and data flow","href":"/open-source/reference/privacy-and-data-flow"},{"title":"Customize Feedback","sidebarTitle":"Custom feedback","href":"/open-source/reference/custom-feedback"},{"title":"Plannotator keyboard shortcuts","sidebarTitle":"Keyboard shortcuts","href":"/open-source/reference/keyboard-shortcuts"},{"title":"Use Plannotator Approval Gates and Automation Hooks","sidebarTitle":"Gates and hooks","href":"/open-source/reference/hooks"},{"title":"Plannotator Local Server and API","sidebarTitle":"Local server and API","href":"/open-source/reference/local-api"},{"title":"Add external annotations to Plannotator","sidebarTitle":"External annotations","href":"/open-source/reference/external-annotations"}]},{"group":"Agents","pages":[{"title":"Choose Your Agent","sidebarTitle":"Agents","href":"/open-source/agents/index"},{"title":"Use Plannotator with Claude Code","sidebarTitle":"Claude Code","href":"/open-source/agents/claude-code"},{"title":"Use Plannotator with Codex","sidebarTitle":"Codex","href":"/open-source/agents/codex"},{"title":"Use Plannotator with OpenCode","sidebarTitle":"OpenCode","href":"/open-source/agents/opencode"},{"title":"Use Plannotator with Copilot CLI","sidebarTitle":"Copilot CLI","href":"/open-source/agents/copilot-cli"},{"title":"Use Plannotator with Gemini CLI","sidebarTitle":"Gemini CLI","href":"/open-source/agents/gemini-cli"},{"title":"Use Plannotator with Pi","sidebarTitle":"Pi","href":"/open-source/agents/pi"},{"title":"Use Plannotator with Amp","sidebarTitle":"Amp","href":"/open-source/agents/amp"},{"title":"Use Plannotator with Droid","sidebarTitle":"Droid","href":"/open-source/agents/droid"},{"title":"Use Plannotator with Kiro CLI","sidebarTitle":"Kiro CLI","href":"/open-source/agents/kiro-cli"}]},{"group":"Editors and notes","pages":[{"title":"Open Plannotator in VS Code","sidebarTitle":"VS Code","href":"/open-source/agents/vscode"},{"title":"Open review files in Zed","sidebarTitle":"Zed","href":"/open-source/agents/zed"},{"title":"Save Plannotator Plans to Obsidian or Bear","sidebarTitle":"Obsidian and Bear","href":"/open-source/agents/notes"},{"title":"Save Plannotator Plans to Octarine","sidebarTitle":"Octarine","href":"/open-source/agents/octarine"}]},{"group":"Troubleshooting","pages":[{"title":"Troubleshoot Plannotator","sidebarTitle":"Troubleshooting","href":"/open-source/troubleshooting"}]},{"group":"Related project","pages":[{"title":"Artifact Server: A Local Workspace for AI Agent Artifacts","sidebarTitle":"Artifact Server","href":"/open-source/artifact-server"}]}]},{"product":"Planning Library","icon":"books","pages":[{"title":"Planning Library","href":"/templates"}]},{"product":"Learn","icon":"graduation-cap","pages":[{"title":"Learn","href":"/learn"}]}]},"basePath":"","title":"Answer Your Agent's Questions Asynchronously - Plannotator","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DevImLcx.js","DynamicMarkdown-BGHukeRM.js","zoom-image-lightbox-DQG3o8Eu.js","lightbox-handle-r17bVUz3.js"]}