neqsim-task-workflow

NeqSim Task Workflow

This is the detailed procedure behind @solve-task. The agent file holds the mandatory first action, the purpose, and the operating principles (section 0); sections 1-10 below are loaded on demand for Standard and Comprehensive work. Section numbers are kept so cross-references from the agent and from docs/development/TASK_SOLVING_GUIDE.md stay valid.

---

0.5 ── ALWAYS-ON OBLIGATIONS (moved from the agent)

Keep user_input.md up to date through the whole conversation

user_input.md is the reproducibility log — anyone re-running this task should be able to recover the exact starting input from it.

Whenever the user provides new information during the task, append it to user_input.md immediately and verbatim:

• Answers to your clarifying questions → append to section 2 (Q&A)
• Mid-task corrections, scope changes, or new constraints → append to section 3 (Follow-up)
• Any value you assume because the user did not specify it → record it in section 4 (Inferred Assumptions) with justification

Do NOT paraphrase, summarise, or "clean up" the user's wording. Paste it as given. Never delete previous entries — only append.

All downloaded documents go INSIDE the task folder

All documents retrieved during a task — STID drawings, PI historian exports, vendor datasheets, P&IDs, literature PDFs, downloaded standards — MUST be saved to step1_scope_and_research/references/ within the task folder.

NEVER download or save task-related files to workspace-level directories like output/, figures/, or any path outside task_solve/YYYY-MM-DD_slug/.

For STID/document retrieval scripts: Always pass the task's references/ path as the output directory:

# CORRECT — saves inside the task folder:
out_dir = os.path.join(TASK_DIR, "step1_scope_and_research", "references")

# WRONG — saves outside the task folder:
out_dir = os.path.join(os.path.dirname(__file__), "..", "figures", "stid_docs")  # NEVER DO THIS