docs: split LLM project workflow into task-specific modes #336

2026-07-07T02:40:22-05:00

jcwalker3 commented

2026-07-07 02:40:22 -05:00

Closes #333

Summary

Refactors skills/llm-project-workflow/SKILL.md into a short router and extracts all four canonical task workflows with final-report schemas.

Workflow files

workflows/review-merge-pr.md — full PR review/merge gates (canonical prompt)
workflows/reconcile-landed-pr.md — already-landed open PR reconciliation
workflows/create-issue.md — issue creation gates (canonical prompt)
workflows/work-issue.md — author/coder implementation gates (canonical prompt)

Schemas

schemas/review-merge-final-report.md
schemas/reconcile-landed-final-report.md
schemas/create-issue-final-report.md
schemas/work-issue-final-report.md

Validation

pytest tests/test_llm_workflow_split.py \
  tests/test_review_proofs.py::TestControllerHandoff::test_skill_doc_declares_handoff_requirement \
  tests/test_shell_spawn_hard_stop_docs.py::test_skill_doc_declares_shell_spawn_hard_stop_rule -q
→ 15 passed

Worktree / branch

Branch: feat/issue-333-work-issue-workflow-extract
Worktree: branches/feat-issue-333-work-issue-workflow-extract
Commit: 6200e6b

Risk

Low — documentation/skill routing only; no runtime MCP behavior changes.

Known limitations

gates/*.md shared rule files still planned (#333 follow-up)
PR #335 (#334) overlaps review-merge extraction; prefer merging #336 for consolidated #333 delivery
reconcile-landed-pr.md built from project reconciliation issues (#301–#303) and operator spec; expand when full verbatim reconciler prompt is published

LLM Handoff Metadata:

LLM-Role: implementer
Authenticated-Gitea-User: jcwalker3
MCP-Profile: prgs-author
Self-review allowed: no

Closes #333 ## Summary Refactors `skills/llm-project-workflow/SKILL.md` into a short router and extracts all four canonical task workflows with final-report schemas. ## Workflow files - `workflows/review-merge-pr.md` — full PR review/merge gates (canonical prompt) - `workflows/reconcile-landed-pr.md` — already-landed open PR reconciliation - `workflows/create-issue.md` — issue creation gates (canonical prompt) - `workflows/work-issue.md` — author/coder implementation gates (canonical prompt) ## Schemas - `schemas/review-merge-final-report.md` - `schemas/reconcile-landed-final-report.md` - `schemas/create-issue-final-report.md` - `schemas/work-issue-final-report.md` ## Validation ``` pytest tests/test_llm_workflow_split.py \ tests/test_review_proofs.py::TestControllerHandoff::test_skill_doc_declares_handoff_requirement \ tests/test_shell_spawn_hard_stop_docs.py::test_skill_doc_declares_shell_spawn_hard_stop_rule -q → 15 passed ``` ## Worktree / branch - Branch: `feat/issue-333-work-issue-workflow-extract` - Worktree: `branches/feat-issue-333-work-issue-workflow-extract` - Commit: `6200e6b` ## Risk Low — documentation/skill routing only; no runtime MCP behavior changes. ## Known limitations - `gates/*.md` shared rule files still planned (#333 follow-up) - PR #335 (#334) overlaps review-merge extraction; prefer merging #336 for consolidated #333 delivery - `reconcile-landed-pr.md` built from project reconciliation issues (#301–#303) and operator spec; expand when full verbatim reconciler prompt is published LLM Handoff Metadata: - LLM-Role: implementer - Authenticated-Gitea-User: jcwalker3 - MCP-Profile: prgs-author - Self-review allowed: no

jcwalker3 added 1 commit 2026-07-07 02:40:22 -05:00

feat: extract canonical work-issue workflow from monolithic skill (Closes #333 ) 8d7203d701

Add workflows/work-issue.md with full author/coder gates (§0–§30),
work-issue final-report schema, task-mode router entry, start-issue template
link, and doc-contract tests.

Part of #333 workflow split (#334 review-merge extraction remains in PR #335).

jcwalker3 referenced this pull request

2026-07-07 02:41:21 -05:00

Extract create-issue workflow from monolithic LLM project skill #337

jcwalker3 added 1 commit 2026-07-07 02:44:28 -05:00

docs: split LLM project workflow into task-specific modes (Closes #333 ) 6200e6bbec

Consolidate all four canonical workflow files and router SKILL.md:
- review-merge-pr.md (from #334 canonical prompt)
- reconcile-landed-pr.md (reconciliation gates + handoff schema)
- create-issue.md (canonical issue-creation prompt)
- work-issue.md (canonical author/coder prompt)

SKILL.md is now a short router with mode isolation and universal rules.
Adds final-report schemas for all modes and 13 doc-contract tests.

Supersedes partial split work in PR #335; full #333 acceptance in one PR.

jcwalker3 changed title from ~~feat: extract canonical work-issue workflow from monolithic skill~~ to docs: split LLM project workflow into task-specific modes

2026-07-07 02:44:34 -05:00

sysadmin approved these changes 2026-07-07 02:46:48 -05:00

sysadmin left a comment

PR #336 successfully splits the monolithic LLM project workflow into task-specific modules. All targeted tests and validation checks passed.

sysadmin merged commit f7621b155e into master

2026-07-07 02:47:04 -05:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Scaled-Tech-Consulting/Gitea-Tools#336