shep-ai/shep

Architecture Reviewer gives Clean Architecture guidance for TypeScript projects, including layer placement, dependency direction, ports, and pattern checks. Use it when planning features, reviewing PRs, or validating where code should live.

Commit PR creates a branch, commits changes, pushes them, and opens a pull request with CI watching. It then checks review feedback and applies fixes until the PR is approved or it needs user input.

Cross-Validate Artifacts checks documentation and codebase artifacts for consistency, conflicts, and contradictions. Use it to audit docs or run a validate-and-fix pass across related files and paths.

Fast Loop skips tests, builds, and commits so you can edit code and check changes in a running dev server. Use it for quick manual iteration when the user wants fast feedback.

Feature Status quickly orients you to the current branch, what has been completed, and what to do next. Use it when starting a session, resuming work, or checking progress on a feature branch.

Mermaid Diagrams helps create and document software diagrams with Mermaid syntax. Use it for class, sequence, flowchart, ERD, C4, state, git, and Gantt diagrams when mapping architecture, data models, or flows.

Parallel Task creates an isolated git worktree in .worktrees/ for work that can proceed alongside other changes. Use it for independent fixes, long-running tests, or any task that needs branch isolation.

Post-Merge Cleanup switches to main, pulls the latest changes, and deletes the local feature branch after a PR has merged. Use it to finish up merged work and keep the branch list clean.

React Flow builds interactive node-and-edge graphs for workflows, diagrams, and visual programming. Use it when you need custom nodes, custom edges, labels, or viewport control in a graph editor.

Shadcn UI provides patterns for installing and using shadcn/ui components in React and Next.js projects. Use it for accessible UI pieces, forms with validation, theme customization, and Tailwind-based component layouts.

Shep Fast-Track Feature collapses feature, research, and planning into one autonomous pass that writes the spec YAML files with minimal interaction. Use it for well-understood features when you want to skip the full interactive flow.

Shep Implement validates feature specs and then executes implementation tasks from YAML with status tracking. Use it after planning is complete and you're ready to start coding.

Shep New Feature creates a spec branch and scaffolds a new feature specification directory. Use it when starting a new feature, functionality, or enhancement in the Shep spec-driven workflow.

Shep Planning creates implementation plans, architecture overviews, and task breakdowns after research is complete. Use it when turning a feature spec into TDD phases, files to change, and a YAML plan and task list.

Shep Research analyzes technical approaches, library choices, and architecture decisions for a feature. Use it after a new-feature spec when you need trade-offs, recommendations, and documentation in research.yaml.

Shep Workstreams breaks a large body of work into parallel workstreams, then drives shep CLI execution wave by wave. Use it when planning docs, roadmaps, or epics need to be turned into isolated features with clear dependencies.

TSpec Model helps create, modify, and document TypeSpec domain models for Shep's Clean Architecture conventions. Use it when adding entities, value objects, enums, or working in the tsp/ directory.

Vercel React Best Practices gives performance guidelines for React and Next.js code. Use it when writing, reviewing, or refactoring components, data fetching, or bundles to reduce waterfalls and improve rendering.

Web UI Components guides creation, modification, and review of React web UI components. Use it for new components, updates, Storybook stories, data-testid attributes, and unit tests in the Shep presentation layer.