# Cortex-Ops Wiki

A self-serve, bilingual catalog of **everything you can do** with your Ninjo agents — written for
creators, not engineers. Every use case leads with the outcome and gives you a sentence you can copy,
paste, and tweak when talking to Claude.

## Read it

**As plain Markdown (works anywhere, including on GitHub):**

- 🇬🇧 English → [`en/index.md`](en/index.md)
- 🇪🇸 Español → [`es/index.md`](es/index.md)

**As a browsable site:** open [`site/wiki/index.html`](../../site/wiki/index.html) when the repo is
served over HTTP (GitHub Pages or a local server). It renders these same Markdown files with a sidebar,
a one-click English/Español toggle, and deep links — there's no duplicated content and no build step.

> Want a one-minute orientation to the whole workspace first? See the quick guide at
> [`site/index.html`](../../site/index.html).

## How it's organized

The Markdown files in `en/` and `es/` are the **single source of truth**; the site just renders them.
Each language has the same eight chapters:

| Chapter | What's in it |
| ------- | ------------ |
| Getting started | Connect, see your agents, learn the loop |
| Creating agents | Build agents for every kind of offer |
| Keywords & triggers | Decide what makes your agent reply |
| Analyzing & improving | See how it's doing and fix it safely |
| Live conversations | Take over a chat or hand it back |
| Automation & follow-ups | Nudges, alerts, reminders, message caps |
| Content & media | Make images, manage what the agent shares |
| Custom data & insights | Capture lead info, see the big picture |

## Run it locally

```bash
# from the repo root
python3 -m http.server 8000
# then open http://localhost:8000/site/wiki/
```

## Editing

Edit the Markdown in `en/` and `es/` — the site picks up changes automatically (no rebuild). Keep the
two languages in sync: when you add or change a use case in one, mirror it in the other. To add a whole
new chapter, also add it to the `NAV` list in [`site/wiki/index.html`](../../site/wiki/index.html).
