Core Concepts
A short tour of the ideas you need to use Shep effectively.
| Topic | Read it for |
|---|---|
| How Shep Works | The big picture: a description goes in, a branch and PR come out. |
| The AI-Native SDLC | Why Shep works spec-first, why the specs are YAML, and how agents hand off through them. |
| Features & Tasks | The unit of work, what’s in it, and how features relate to repos and apps. |
| SDLC Lifecycle | The phases a feature moves through, and the gates where it waits for you. |
| Agent activity & states | Working, needs you, waiting, done or failed — and why. |
| Decisions | How agents ask you questions, with a recommended answer and a deadline. |
| Parallel Execution & Worktrees | Why running ten agents at once doesn’t blow up your repo. |
| Spaces | Grouping repos into product areas with their own logins and rules. |
What’s next
- Getting Started — install Shep and open your first PR.
- Your First Feature — a step-by-step walkthrough from repo to merged PR.
- Guides — practical walkthroughs of every part of Shep.