Feature/query orchestrator#123
Conversation
Brainstormed design for a multi-question research feature: /query slash command parses input into sub-questions, dispatches a query-researcher subagent per question in batches of 3 parallel, and assembles answers into a single output file per task. Spec covers script (build_docs_map.py), DOCS_MAP.md format, slash command, orchestrator skill (7-step procedure), subagent definition, install.sh / uninstall.sh changes, GitHub workflow integration, test plan, risks, and acceptance criteria. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
13-task plan with TDD where applicable. Each task is bite-sized with exact file paths, complete code, and concrete commands. Tasks 1-4: build_docs_map.py + tests + initial map + workflow Tasks 5-7: claude-files (command, agent, skill) Tasks 8-11: install.sh, uninstall.sh, README, CLAUDE.md updates Task 12: end-to-end manual validation Task 13: final review and push Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Add brace-depth JSX tracking to both strip_markdown() and extract_summary() to eliminate Mintlify-pattern export const blocks from polluting summaries and TF-IDF keywords in the 7 affected docs (amazon-bedrock, mcp, google-vertex-ai, etc.). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
User-generated /query outputs accumulate at $INSTALL_DIR/query. This directory should never be committed. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Final review noted two issues: - Batching table omitted N=6 (between N=5 and N=7); a literal reader would have no explicit guidance. Added the row plus a general ceil(N/3) formula as fallback. - "Independent parts joined by and/ve" used an unclear non-English token. Replaced with "a coordinating conjunction (e.g., and, or)". Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Upstream main added 5 new docs (agent-view, agents, claude-platform-on-aws, goal, worktrees) and updated many existing docs. Regenerated the map to reflect current docs/ contents — 126 → 131 entries. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Add /query multi-question research command Adds a new /query slash command that decomposes multi-part questions into independent sub-questions, dispatches a specialized subagent per question in batches of 3 in parallel, and assembles all answers into a single structured output file. The existing /docs command is unchanged. How it works /query Examples /query What is a hook? Each query produces a folder under ~/.claude-code-docs/query/ containing a structured answer file with citations. New pieces
Tests 13 pytest cases in scripts/test_build_docs_map.py covering title extraction, summary extraction (with frontmatter / code blocks / JSX stripping), TF-IDF keyword separation, and integration output. All pass. Notes for review
Closes: N/A (new feature) |
1 participant
No description provided.