Add agentic web research MVP harness to Workspine#103
Add agentic web research MVP harness to Workspine#103PatrickSys wants to merge 1 commit intomainfrom
Conversation
There was a problem hiding this comment.
Code Review
This pull request introduces an Agentic Research MVP for Workspine, establishing a structured, artifact-driven workflow for web-enabled research. It includes a new documentation file outlining the architecture and a template for the research harness. Review feedback focused on ensuring the template explicitly references the correct file paths and artifact names, such as 'scaffold.md', to align with the defined architectural specification.
| Use this when the task requires substantial web-enabled research and evidence-driven synthesis. | ||
|
|
||
| ## 0) Run metadata | ||
|
|
There was a problem hiding this comment.
The AGENTIC-RESEARCH-MVP.md documentation (line 28) specifies scaffold.md as the artifact for run metadata and configuration. This template should explicitly instruct the operator to write the metadata to that file to ensure the artifact is created as expected by the architecture.
| Write scaffold.md with: |
|
|
||
| ## 1) Decompose prompt | ||
|
|
||
| Write `prompt-decomposition.json` with: |
There was a problem hiding this comment.
|
|
||
| ## 2) Coverage matrix | ||
|
|
||
| Build `coverage-matrix.md` mapping each significant phrase in the query to decomposition items. |
There was a problem hiding this comment.
Explicitly defining the path for the coverage matrix ensures it is correctly located within the .planning/research/agentic/ directory as required by the core artifact specification.
| Build `coverage-matrix.md` mapping each significant phrase in the query to decomposition items. | |
| Build .planning/research/agentic/coverage-matrix.md mapping each significant phrase in the query to decomposition items. |
| - dissenting or contradictory evidence | ||
| - recent updates | ||
|
|
||
| Log results in `width-sweep.md`. |
|
|
||
| ## 4) Depth passes | ||
|
|
||
| Create one note file per major sub-question under `depth-notes/`. |
There was a problem hiding this comment.
The depth-notes/ directory should be prefixed with the research root path to prevent the operator from creating it in the repository root, which would violate the artifact organization defined in the MVP spec.
| Create one note file per major sub-question under `depth-notes/`. | |
| Create one note file per major sub-question under .planning/research/agentic/depth-notes/. |
|
|
||
| ## 9) Scratchpad discipline | ||
|
|
||
| Maintain `scratchpad.md` as append-only notes for long jobs: |
There was a problem hiding this comment.
Explicitly defining the path for scratchpad.md ensures it is correctly located within the .planning/research/agentic/ directory as required by the core artifact specification.
| Maintain `scratchpad.md` as append-only notes for long jobs: | |
| Maintain .planning/research/agentic/scratchpad.md as append-only notes for long jobs: |
Motivation
Description
docs/AGENTIC-RESEARCH-MVP.mddescribing the end-to-end decomposition-driven architecture, artifact contract, tradeoffs, and definition-of-done for the MVP.distilled/templates/research/agentic-harness.mdas a runnable template that defines the pipeline (decomposition → coverage matrix → width/depth passes → synthesis → critique → patch → verification) and an append-onlyscratchpad.mddiscipline.README.mdunder the proof/resources section for discoverability.distilled/SKILL.mdto follow the repo-native, spec-first workflow while authoring the changes.Testing
npm test -- --runInBand, which executed the test suites against the modified codebase and completed successfully.Codex Task