Skip to content

Add agentic research MVP docs and reusable research templates#105

Draft
PatrickSys wants to merge 1 commit intomainfrom
codex/distill-agentic-research-into-mvp-state-branch-wnloo9
Draft

Add agentic research MVP docs and reusable research templates#105
PatrickSys wants to merge 1 commit intomainfrom
codex/distill-agentic-research-into-mvp-state-branch-wnloo9

Conversation

@PatrickSys
Copy link
Copy Markdown
Owner

Motivation

  • Provide a lightweight, reproducible harness for web-enabled, decomposition-first agentic research so developers can run long-running research with an auditable scratchpad and clear verification gates.
  • Surface reusable templates that enforce prompt decomposition before search and standardize lane-based depth work to improve fidelity and handoff.
  • Integrate the MVP into the repo docs so the new research lane is discoverable from the main Workspine guidance.

Description

  • Added the MVP specification at docs/AGENTIC-RESEARCH-MVP.md describing architecture, artifacts, tradeoffs, and verification gates.
  • Added reusable templates at distilled/templates/research-agentic/prompt-decomposition.json and distilled/templates/research-agentic/scratchpad.md and updated documentation references in README.md and distilled/README.md to expose the new lane.
  • Intentionally avoided landing a new workflow source under distilled/workflows/ to preserve existing workflow-count invariants observed during tests.

Testing

  • Ran the repository test suite with npm test --silent and iterated until all automated tests passed, with the final run exiting successfully.
  • Verified repository state changes with git status and created a committed change including the new files.
  • Confirmed that generated init/update flows remain intact by observing the existing CI-style test output for gsdd init/gsdd update subtests during the test runs.

Codex Task

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces the 'Agentic Research MVP' workflow, which establishes a structured process for web-enabled research using prompt decomposition and a scratchpad protocol. Changes include updates to the main README, a new architectural overview in docs/AGENTIC-RESEARCH-MVP.md, and initial templates for research decomposition and progress tracking. Feedback highlights a discrepancy where several core artifacts mentioned in the documentation are missing from the template directory, which would prevent users from fully implementing the described workflow.

Comment on lines +33 to +42
## Core artifacts

- `.planning/research/scaffold.md`
- `.planning/research/query.md`
- `.planning/research/prompt-decomposition.json`
- `.planning/research/scratchpad.md`
- `.planning/research/source-ledger.md`
- `.planning/research/lane-*.md`
- `.planning/research/draft.md`
- `.planning/research/final.md`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The "Core artifacts" section lists several files (e.g., scaffold.md, query.md, source-ledger.md, lane-*.md, draft.md, final.md) that are not included in the distilled/templates/research-agentic/ directory added in this PR. Since the integration instructions on line 60 direct users to copy templates from that directory to establish the research harness, the absence of these files will prevent users from following the described workflow. Please either include the missing templates or update the documentation to reflect the current set of provided artifacts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant