annotations/.cursor/skills/research/references/usage-examples.md

Usage Examples — Reference

Example 1: Initial Research (Mode A)

User: Research this problem and find the best solution

Execution flow:

1. Context resolution: no explicit file -> project mode (INPUT_DIR=_docs/00_problem/, OUTPUT_DIR=_docs/01_solution/)
2. Guardrails: verify INPUT_DIR exists with required files
3. Mode detection: no solution_draft*.md -> Mode A
4. Phase 1: Assess acceptance criteria and restrictions, ask user about unclear parts
5. BLOCKING: present AC assessment, wait for user confirmation
6. Phase 2: Full 8-step research — competitors, components, state-of-the-art solutions
7. Output: OUTPUT_DIR/solution_draft01.md
8. (Optional) Phase 3: Tech stack consolidation -> tech_stack.md
9. (Optional) Phase 4: Security deep dive -> security_analysis.md

Example 2: Solution Assessment (Mode B)

User: Assess the current solution draft

Execution flow:

1. Context resolution: no explicit file -> project mode
2. Guardrails: verify INPUT_DIR exists
3. Mode detection: solution_draft03.md found in OUTPUT_DIR -> Mode B, read it as input
4. Full 8-step research — weak points, security, performance, solutions
5. Output: OUTPUT_DIR/solution_draft04.md with findings table + revised draft

Example 3: Standalone Research

User: /research @my_problem.md

Execution flow:

1. Context resolution: explicit file -> standalone mode (INPUT_FILE=my_problem.md, OUTPUT_DIR=_standalone/my_problem/01_solution/)
2. Guardrails: verify INPUT_FILE exists and is non-empty, warn about missing restrictions/AC
3. Mode detection + full research flow as in Example 1, scoped to standalone paths
4. Output: _standalone/my_problem/01_solution/solution_draft01.md
5. Move my_problem.md into _standalone/my_problem/

Example 4: Force Initial Research (Override)

User: Research from scratch, ignore existing drafts

Execution flow:

1. Context resolution: no explicit file -> project mode
2. Mode detection: drafts exist, but user explicitly requested initial research -> Mode A
3. Phase 1 + Phase 2 as in Example 1
4. Output: OUTPUT_DIR/solution_draft##.md (incremented from highest existing)