Skip to Content
Core ConceptsCore Concepts

Core Concepts

A short tour of the ideas you need to use Shep effectively.

TopicRead it for
How Shep WorksThe big picture: a description goes in, a branch and PR come out.
The AI-Native SDLCWhy Shep works spec-first, why the specs are YAML, and how agents hand off through them.
Features & TasksThe unit of work, what’s in it, and how features relate to repos and apps.
SDLC LifecycleThe phases a feature moves through, and the gates where it waits for you.
Agent activity & statesWorking, needs you, waiting, done or failed — and why.
DecisionsHow agents ask you questions, with a recommended answer and a deadline.
Parallel Execution & WorktreesWhy running ten agents at once doesn’t blow up your repo.
SpacesGrouping repos into product areas with their own logins and rules.

What’s next