story-feedback-loop

Orchestrates user story implementation with worktree isolation, dual-role review, and GitHub issue tracking.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/jacobmiller22/chrishop --skill story-feedback-loop-jacobmiller22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-feedback-loop
Source: https://github.com/jacobmiller22/chrishop/tree/main/.agents/skills/story-feedback-loop
Command: npx skills add https://github.com/jacobmiller22/chrishop --skill story-feedback-loop-jacobmiller22

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementing user stories without a structured process leads to untracked progress, unreviewed code, orphaned Git worktrees, and issues closed before their pull requests merge. This Skill enforces a complete, auditable story lifecycle from initialization through teardown. ## Core Features & Use Cases - Isolated Worktree Workflow: Provisions dedicated Git worktrees via wt (worktrunk) based on origin/staging, then reaps processes and removes them after PR submission. - Dual-Role Feedback Loop: Coordinates an Implementor and an SME Reviewing Judge who validates architectural intent, adjudicates scope, and monitors CI via gh pr checks. - GitHub Audit Trail: Mandates periodic progress comments, bidirectional PR-to-issue linking with Fixes keywords, high-detail completion summaries, and PR-merge-gated issue closure. - Use Case: An agent picks up story 2.3 (Product Filter Component), creates a worktree, implements and verifies with pnpm run verify:local, passes SME review, opens a PR targeting staging, posts completion documentation, and tears down the worktree. ## Quick Start Use the story-feedback-loop skill to implement GitHub issue #42 in an isolated worktree with full progress tracking and SME review.

Frequently Asked Questions about story-feedback-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement a GitHub user story in an isolated Git worktree?

Fetch origin/staging, then run wt switch --create feature/story-X-Y-name --base origin/staging to provision an isolated worktree. Implement changes there, verify locally, push the branch, and open a PR targeting staging.

How do I link a pull request to a GitHub issue automatically?

Include a closing keyword such as Fixes #42 on its own line in the PR body when creating it with gh pr create. Also post the PR URL as an issue comment so both sides are bidirectionally linked and board automation triggers.

When should I close a GitHub issue after opening a pull request?

Only close the issue after its linked PR is merged. Check merge status with gh pr view <PR_NUMBER> --json state,merged. While the PR is open, keep the issue open with the status:completed label.

How do I remove a Git worktree and kill its background processes?

Switch out of the worktree first with wt switch staging, then run wt remove --reap <branch> to terminate lingering dev servers and delete the worktree. Finish with git worktree prune and verify with wt list.

What is a dual-role Implementor and SME Judge feedback loop?

The Implementor writes and locally verifies code, while the SME Judge reviews it against architectural intent, adjudicates immediate versus deferred scope, and monitors CI. They iterate until the solution satisfies the story's true design goals.