Split monolithic LLM project workflow into task-specific skill workflows #333

New Issue

2026-07-07T02:24:31-05:00

jcwalker3 commented

2026-07-07 02:24:31 -05:00

Problem

The current LLM workflow is becoming too large to paste and too broad to safely apply to every task. PR review/merge, issue creation, and issue implementation have different permissions, gates, reports, and stop conditions. Keeping all rules in one large prompt makes it easier for LLMs to mix modes, over-apply reviewer rules to issue creation, or accidentally perform reviewer mutations during unrelated work.

Required design

Make skills/llm-project-workflow/SKILL.md a small router and move task-specific rules into separate workflow files.

Proposed structure

skills/llm-project-workflow/SKILL.md
skills/llm-project-workflow/workflows/review-merge-pr.md
skills/llm-project-workflow/workflows/create-issue.md
skills/llm-project-workflow/workflows/work-issue.md
skills/llm-project-workflow/schemas/review-merge-final-report.md
skills/llm-project-workflow/schemas/create-issue-final-report.md
skills/llm-project-workflow/schemas/work-issue-final-report.md
skills/llm-project-workflow/gates/mutation-ledger-rules.md
skills/llm-project-workflow/gates/proof-wording-rules.md
skills/llm-project-workflow/gates/identity-capability-rules.md

Acceptance criteria

SKILL.md is a router, not the full rulebook.
SKILL.md requires the agent to identify task mode before mutation.
review-merge-pr.md contains PR inventory, queue ordering, validation, review, terminal mutation, merge, cleanup, and final-report rules.
create-issue.md contains duplicate search, exact issue capability, issue creation/commenting, and no-PR-mutation rules.
work-issue.md contains author workflow rules for implementing an issue, validating, committing, and creating a PR.
Mode isolation is explicit: review mode cannot create issues or edit code; issue-creation mode cannot review or merge; work-issue mode cannot approve or merge.
Each workflow has a separate final report schema.
Existing reviewer prompt hard walls are preserved in review-merge-pr.md.
Tests or verifier coverage ensure an agent cannot mutate before loading the required workflow file.
Tests or verifier coverage reject reports that use the wrong schema for the selected mode.

## Problem The current LLM workflow is becoming too large to paste and too broad to safely apply to every task. PR review/merge, issue creation, and issue implementation have different permissions, gates, reports, and stop conditions. Keeping all rules in one large prompt makes it easier for LLMs to mix modes, over-apply reviewer rules to issue creation, or accidentally perform reviewer mutations during unrelated work. ## Required design Make `skills/llm-project-workflow/SKILL.md` a small router and move task-specific rules into separate workflow files. ### Proposed structure - `skills/llm-project-workflow/SKILL.md` - `skills/llm-project-workflow/workflows/review-merge-pr.md` - `skills/llm-project-workflow/workflows/create-issue.md` - `skills/llm-project-workflow/workflows/work-issue.md` - `skills/llm-project-workflow/schemas/review-merge-final-report.md` - `skills/llm-project-workflow/schemas/create-issue-final-report.md` - `skills/llm-project-workflow/schemas/work-issue-final-report.md` - `skills/llm-project-workflow/gates/mutation-ledger-rules.md` - `skills/llm-project-workflow/gates/proof-wording-rules.md` - `skills/llm-project-workflow/gates/identity-capability-rules.md` ## Acceptance criteria - [ ] `SKILL.md` is a router, not the full rulebook. - [ ] `SKILL.md` requires the agent to identify task mode before mutation. - [ ] `review-merge-pr.md` contains PR inventory, queue ordering, validation, review, terminal mutation, merge, cleanup, and final-report rules. - [ ] `create-issue.md` contains duplicate search, exact issue capability, issue creation/commenting, and no-PR-mutation rules. - [ ] `work-issue.md` contains author workflow rules for implementing an issue, validating, committing, and creating a PR. - [ ] Mode isolation is explicit: review mode cannot create issues or edit code; issue-creation mode cannot review or merge; work-issue mode cannot approve or merge. - [ ] Each workflow has a separate final report schema. - [ ] Existing reviewer prompt hard walls are preserved in `review-merge-pr.md`. - [ ] Tests or verifier coverage ensure an agent cannot mutate before loading the required workflow file. - [ ] Tests or verifier coverage reject reports that use the wrong schema for the selected mode.

jcwalker3 referenced this issue

2026-07-07 02:25:31 -05:00

Extract review-merge-pr workflow from monolithic LLM project skill #334

jcwalker3 added the status:in-progress label 2026-07-07 02:31:26 -05:00

jcwalker3 referenced this issue from a commit

2026-07-07 02:33:05 -05:00

feat(skill): extract review-merge-pr workflow from monolithic SKILL.md

jcwalker3 referenced this issue

2026-07-07 02:33:16 -05:00

feat: extract review-merge-pr workflow from monolithic LLM skill #335

jcwalker3 referenced this issue from a commit

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