# agents/

Each subfolder is one agent's SDK: `meta.md`, `changelog.md`, and `sdk/` (the system prompt + the 8 v5Config
files). When you create or improve an agent, this is where its source lives. **All 8 v5Config files are
required and deploy as a complete set**. `system`, `examples`, and
`knowledge_base` must carry real content; the other five may be empty (`[]` / minimal) when they don't apply,
but at least one of `keywords` / `program` must be populated. A keywords-only config is degenerate
(incomplete).

## Reference samples (start here)

Four **fully-built, sanitized** agents you can copy from or point Claude at — _"build me an agent like
`sample-petcare-consultative` but for a yoga studio"_, or _"how does `sample-finance-bookcall` handle a price
question?"_. They're not connected to any account (`agent_id: PENDING`), so nothing you do with them is live.

| Folder | Vertical | Sales motion | Good example of |
| ------ | -------- | ------------ | --------------- |
| `sample-wellness-bookcall` | Wellness / coaching | book-the-call | income-gated qualification → free discovery call; the booking link is never pitched cold in the DM |
| `sample-petcare-consultative` | Pet education / training | consultative | multi-turn discovery (5+ turns) before a mid-conversation link drop; same-day close in the DM |
| `sample-finance-bookcall` | Finance / trading education | book-the-call | challenger, insight-led rapport (a statement before the question); anti-guru positioning |
| `sample-prodev-consultative` | Professional development | consultative | audience bifurcation — sorting two buyer types up front — over a keyword-routed flow |

## Skeleton

- `_TEMPLATE/` — the empty structure to copy when starting a brand-new agent from scratch. The samples above are
  this skeleton filled in.

## Notes

- **No Claude Code? No filesystem? Still fine.** However you opened this — terminal, desktop app, or the web with
  the project files uploaded — you refer to a sample by its name and Claude reads it for you. You never edit these
  files by hand; you describe what you want and Claude authors the SDK and deploys it through the Ninjo connector.
- Real client agents are kept out of version control (and out of the downloadable zip); only `_TEMPLATE` and the
  `sample-*` references ship.
