# cortex-ops — Ninjo agent operations playbook

> The reference an AI agent reads to create, analyze, and iterate Ninjo DM-sales agents through the cortex-gateway MCP. A Ninjo agent is a SYSTEM — system prompt + the 8 v5Config fields + triggers + automation — not just a prompt. Below: the operating manual, the validated knowledge base, the prompt-architecture templates, and fully worked sample SDKs. Raw markdown at stable URLs, mirrored from the cortex-ops repo and regenerated on every deploy.

## Operating manual
- [CLAUDE.md — cortex-ops](https://cortex-ops-wiki.pages.dev/CLAUDE.md): The gateway has working OAuth 2.1 auth, a correct-by-construction `deploy_agent_sdk` tool,
- [AGENTS.md — cortex-ops](https://cortex-ops-wiki.pages.dev/AGENTS.md): The gateway has working OAuth 2.1 auth, a correct-by-construction `deploy_agent_sdk` tool,

## Reference (knowledge)
- [AGENTS.md — Librería de patrones para agentes Ninjo](https://cortex-ops-wiki.pages.dev/knowledge/AGENTS.md): Referencia de conocimiento (MCP-agnóstica) para diseñar e iterar agentes Ninjo.
- [Agent Metrics — Queries estándar](https://cortex-ops-wiki.pages.dev/knowledge/agent-metrics.md): Queries reutilizables para ver el funnel diario de cualquier agente. Adaptar los valores marcados con `-- ⚙`.
- [Best Practices — Top 10 (Semantic Verifier rubric)](https://cortex-ops-wiki.pages.dev/knowledge/best-practices-top10.md): **Status:** draft for review · **Last updated:** 2026-04-30
- [Agent Custom Properties](https://cortex-ops-wiki.pages.dev/knowledge/custom-properties.md): **Custom Properties** are dynamic attributes used to extract, store, and process specific information from conversations. Unlike fixed fields, their flexibility allows the system t
- [Keyword Playbook](https://cortex-ops-wiki.pages.dev/knowledge/keyword-playbook.md): ⚠️ **Trampa histórica**: vika usaba `resource_with_qualify`, `resource_first`, `resource_first_then_qualify`, `immediate` — ninguno existe en el enum. Delivery rate de esas 
- [cortex-gateway MCP Tool Reference](https://cortex-ops-wiki.pages.dev/knowledge/mcp-tool-reference.md): The map of what Claude can actually do in this workspace. When a task seems blocked, the answer is usually
- [Ninjo Platform: Feature Reference for Cortex](https://cortex-ops-wiki.pages.dev/knowledge/platform-features.md): This document maps every platform capability that affects agent behavior. Cortex reads this to reason about the full stack when designing, iterating, or reviewing agents, not just 
- [Platform Internals — backend mechanics & known gotchas](https://cortex-ops-wiki.pages.dev/knowledge/platform-internals.md): `platform-features.md` documents the **operator feature surface** (what you can configure). This doc covers the
- [Prompt Anti-Patterns](https://cortex-ops-wiki.pages.dev/knowledge/prompt-antipatterns.md): **Cuándo actualizar este doc:** cuando se agrega o modifica un anti-patrón en el rubric de revisión estructurada, o cuando se promueve un patrón nuevo a `knowledge/fix-patterns
- [Prompt Engineering Guide — Platform-Aware](https://cortex-ops-wiki.pages.dev/knowledge/prompt-engineering-guide.md): Guía operativa para escribir e iterar prompts en Ninjo. Cada regla está respaldada por investigación documentada en `fix-lab/research/`.
- [Reasoning Leak — Diagnosis & Fix](https://cortex-ops-wiki.pages.dev/knowledge/reasoning-leak.md): **The leak.** The agent narrates its internal decision logic to the lead instead of just acting on it:
- [SDK Migration Playbook](https://cortex-ops-wiki.pages.dev/knowledge/sdk-migration-playbook.md): Cómo migrar un agente monolítico a SDK (`system.md` + los 8 campos de v5Config). **MCP-first**: todo
- [Self-Sufficiency Doctrine — Claude is the source of solutions](https://cortex-ops-wiki.pages.dev/knowledge/self-sufficiency.md): The single fastest way to lose the operator's trust is to bounce a problem back to them with
- [Trigger System](https://cortex-ops-wiki.pages.dev/knowledge/triggers.md): Example: `"prise"` matches `"price"`
- [Workflow & Automation Engine](https://cortex-ops-wiki.pages.dev/knowledge/workflows.md): Workflows automate actions that happen **outside of the real-time conversation** — follow-ups,

## Templates
- [KPI Profiles](https://cortex-ops-wiki.pages.dev/templates/kpi-profiles.md): Per-use-case KPI definitions with green/yellow/red thresholds. Used by `/cortex-qa`, `/cortex-monitor`, and `/cortex-status` to evaluate agent health and trigger alerts.
- [Principles — Book-the-Call flavor](https://cortex-ops-wiki.pages.dev/templates/principles-book-the-call.md): **Base:** `templates/principles.md` (all 7 sections + examples apply). This file is the **motion
- [Principles — Consultative flavor](https://cortex-ops-wiki.pages.dev/templates/principles-consultative.md): **Base:** `templates/principles.md` (all 7 sections + examples apply). This file is the **motion
- [Principles — Deep-Nurture flavor](https://cortex-ops-wiki.pages.dev/templates/principles-deep-nurture.md): **Base:** `templates/principles.md` (all 7 sections + examples apply). This file is the **motion
- [Principles — Express flavor](https://cortex-ops-wiki.pages.dev/templates/principles-express.md): **Base:** `templates/principles.md` (all 7 sections + examples apply). This file is the **motion
- [Principles Prompt Strategy](https://cortex-ops-wiki.pages.dev/templates/principles.md): **Motion flavors.** `principles` is the single architecture; the sales *motion* is set by a thin overlay loaded alongside it — `principles-express`, `principles-consultative`, `p

## Worked example SDKs
- [sample-finance-bookcall](https://cortex-ops-wiki.pages.dev/agents/sample-finance-bookcall/sdk/system.md): worked SDK — system prompt + 8 v5Config files in https://cortex-ops-wiki.pages.dev/agents/sample-finance-bookcall/sdk/ (examples.md, objections.md, knowledge_base.md, personal_story.md, keywords.json, program.json, resources.json, case_studies.json); see meta.md for vertical & sales motion.
- [sample-petcare-consultative](https://cortex-ops-wiki.pages.dev/agents/sample-petcare-consultative/sdk/system.md): worked SDK — system prompt + 8 v5Config files in https://cortex-ops-wiki.pages.dev/agents/sample-petcare-consultative/sdk/ (examples.md, objections.md, knowledge_base.md, personal_story.md, keywords.json, program.json, resources.json, case_studies.json); see meta.md for vertical & sales motion.
- [sample-prodev-consultative](https://cortex-ops-wiki.pages.dev/agents/sample-prodev-consultative/sdk/system.md): worked SDK — system prompt + 8 v5Config files in https://cortex-ops-wiki.pages.dev/agents/sample-prodev-consultative/sdk/ (examples.md, objections.md, knowledge_base.md, personal_story.md, keywords.json, program.json, resources.json, case_studies.json); see meta.md for vertical & sales motion.
- [sample-wellness-bookcall](https://cortex-ops-wiki.pages.dev/agents/sample-wellness-bookcall/sdk/system.md): worked SDK — system prompt + 8 v5Config files in https://cortex-ops-wiki.pages.dev/agents/sample-wellness-bookcall/sdk/ (examples.md, objections.md, knowledge_base.md, personal_story.md, keywords.json, program.json, resources.json, case_studies.json); see meta.md for vertical & sales motion.

## Optional
- [Operating guide — wiki (EN)](https://cortex-ops-wiki.pages.dev/site/wiki/index.html): the human-facing self-serve guide (English/Spanish). Narrative, not the build reference.
- [Full export](https://cortex-ops-wiki.pages.dev/llms-full.txt): every playbook markdown file concatenated into one document.