Skip to content

PR 1: Convert research skills to deterministic YAML wrappers - #38

Merged
5uck1ess merged 3 commits into
mainfrom
feat/deterministic-pr1-research
Apr 9, 2026
Merged

PR 1: Convert research skills to deterministic YAML wrappers#38
5uck1ess merged 3 commits into
mainfrom
feat/deterministic-pr1-research

Conversation

@5uck1ess

@5uck1ess 5uck1ess commented Apr 9, 2026

Copy link
Copy Markdown
Owner

Summary

First PR of the deterministic workflow conversion project.

  • Skills (research, deep-research) converted from full step-by-step markdown (145/236 lines) to thin wrappers (37/45 lines) that delegate to YAML workflows via devkit workflow run
  • Command (deep-research.md) trimmed from 150 → 24 lines, pointing to the YAML workflow + skill fallback
  • YAML workflows (workflows/research.yml, workflows/deep-research.yml) untouched — they are already the source of truth with 9 and 13 deterministic steps respectively
  • Condensed fallbacks preserved in skills for environments without the Go engine

Net: -467 lines of duplicated logic removed. The Go engine now owns step sequencing; Claude handles thinking within each step.

Test plan

  • devkit workflow run research "test query" — engine executes full research pipeline
  • devkit workflow run deep-research "test query" — engine executes full ACH pipeline
  • Skill activation without engine falls back to condensed manual steps
  • /devkit:deep-research tab-completion still works via commands/deep-research.md

5uck1ess added 3 commits April 9, 2026 19:01
PR 1 of deterministic workflow conversion. Skills and commands
now delegate to workflows/research.yml and workflows/deep-research.yml
instead of containing full step-by-step logic. Condensed fallbacks
preserved for environments without the Go engine.

- skills/research/SKILL.md: 145 → 37 lines
- skills/deep-research/SKILL.md: 236 → 45 lines
- commands/deep-research.md: 150 → 24 lines
- Restore harness detection fallback in commands/deep-research.md
- Restore all 4 escalation triggers in research skill fallback
- Align pipeline summaries with actual YAML step IDs
- Merge sensitivity check into evidence-matrix step (matches YAML)
- Add budget mention (~200k) to research fallback
- Restore decompose-with-goals and confidence-calibration rules
@5uck1ess
5uck1ess merged commit b4b47bc into main Apr 9, 2026
3 checks passed
@5uck1ess
5uck1ess deleted the feat/deterministic-pr1-research branch April 9, 2026 23:20
5uck1ess added a commit that referenced this pull request Apr 10, 2026
Documents the full conversion project (PRs #38-#45): 24→8 commands,
~3,600 lines removed, expect field added, 3 new workflows, bug fixes.
5uck1ess added a commit that referenced this pull request Apr 10, 2026
)

Documents the full conversion project (PRs #38-#45): 24→8 commands,
~3,600 lines removed, expect field added, 3 new workflows, bug fixes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant