{
  "markdown": "# Nourivex Runtime\n\n**Nourivex Runtime** is a provider-agnostic AI engineering framework. It enforces a strict **Research → Architecture → Planning → TDD Execution** workflow with **17 discipline skills**, **5 specialized agents**, a **persistent memory system**, and an **MCP server with 25 executable tools** so agents never forget your goals across sessions. Supports **OpenCode**, **Gemini CLI**, **Claude**, and **Codex**.\n\n## 🚀 Key Features\n\n- **Engineering Discipline:** 17 built-in skills for TDD, Goal Preservation, Scope Watchdog, Anti-Overengineering, and more.\n- **Persistent Memory:** Agents store and recall patterns, lessons, and user preferences across sessions via `.nourivex/`.\n- **Goal Tracking:** Objective locks survive session restarts — agents always remember what you're building.\n- **Living Todo Lists:** Plans automatically become tracked todo lists with progress that persists across sessions.\n- **Session Manager:** Every session starts with a brief of active goals, unfinished tasks, and relevant memory.\n- **Collaborative Team:** 5 specialized agents (Researcher, Architect, Planner, Implementer, Reviewer) that work as partners.\n- **Multi-Platform:** Works with OpenCode, Gemini CLI, Claude, and Codex via platform adapters.\n- **Auto-Discovery:** OpenCode auto-discovers skills from `.agents/skills/` and agents from `.opencode/agents/`.\n- **npm Installable:** Can be installed via npm and used as a plugin/MCP.\n- **MCP Server with 25 Tools:** Available via `npx nourivex-mcp-server` — tools for goals, memory, todos, and session management.\n- **CLI Tools:** `nourivex memory`, `nourivex goals`, `nourivex todos`, `nourivex mcp` for inspecting persistent state from terminal.\n\n---\n\n## 🛠️ Installation\n\nNourivex Runtime has **two modes** that complement each other:\n\n| Mode | What It Does | How |\n|------|-------------|-----|\n| 🧩 **Plugin** | Provides 17 skills + 5 agents (agentic workflow) | `plugin: [\"nourivex-runtime\"]` |\n| 🔌 **MCP Server** | Exposes 25 tools via MCP protocol (tool-based) | `npx -y nourivex-mcp-server` |\n\n### Step 1: Install the Runtime\n\n```bash\n# Install CLI globally (recommended)\nnpm install -g nourivex-runtime\n\n# Or install in your project\nnpm install nourivex-runtime\n```\n\n### Step 2: Configure\n\n#### For OpenCode users — dual config (`opencode.json`):\n\nAdd both **plugin** and **MCP** entries to your `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"nourivex-runtime\"],\n\n  \"mcp\": {\n    \"nourivex\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"nourivex-mcp-server\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n> **Plugin** enables agentic workflow: `skill()`, `task()`, specialized sub-agents.\n> **MCP** enables direct tool access: 26 atomic tools for goals/memory/todos/sessions.\n> Keduanya coexist — bukan either/or.\n\n#### For CLI-only use:\n\n```bash\n# Initialize your project for a specific AI assistant\ncd /path/to/your/project\nnourivex init --ai opencode      # OpenCode\nnourivex init --ai claude        # Claude Code\nnourivex init --ai gemini        # Gemini CLI\nnourivex init --ai codex         # Codex CLI\nnourivex init --ai cursor        # Cursor\nnourivex init --ai windsurf      # Windsurf\nnourivex init --ai copilot       # GitHub Copilot\nnourivex init --ai continue      # Continue\nnourivex init --ai all           # All assistants\n```\n\n#### Or add the MCP server only (no plugin):\n\nAny MCP-compatible client can use just the server:\n\n```json\n{\n  \"mcp\": {\n    \"nourivex\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"nourivex-mcp-server\"]\n    }\n  }\n}\n```\n\n#### Local Plugin (development):\n\n```bash\nopencode plugin add ./opencode-plugin.mjs\n```\n\n#### Register Custom Subagents (Advanced):\n\nTo use agents via `task(subagent_type=\"nvx-researcher\", ...)`, merge `opencode.agents.json` into your project's `opencode.json` under the `\"agent\"` field.\n\n#### Gemini CLI:\n\n```bash\ngemini extensions install <path-to-nourivex-runtime> --consent\n```\n\n---\n\n## 🎯 OpenCode Quick Start (v5.0.0)\n\n```typescript\n// 0. ALWAYS FIRST — restore session context\nskill(name=\"nvx-session-manager\")\n// → SESSION BRIEF shows active goal, todo progress, relevant memory\n\n// 1. Load discipline skills\nskill(name=\"nvx-goal-preservation\")   // Lock objective + persist to .nourivex/goals/\nskill(name=\"nvx-watchdog\")            // Patrol scope drift + log alerts\nskill(name=\"nvx-superpower-memory\")   // RECALL patterns, STORE lessons\n\n// 2. Delegate to specialized agents\ntask(category=\"deep\", load_skills=[\"nvx-researcher\"], run_in_background=true, prompt=\"Research...\")\ntask(category=\"deep\", load_skills=[\"nvx-architect\"], run_in_background=false, prompt=\"Design...\")\ntask(category=\"deep\", load_skills=[\"nvx-planner\"], run_in_background=false, prompt=\"Plan...\")\n// → Plan auto-persists as .nourivex/todos/ living list\n\ntask(category=\"deep\", load_skills=[\"nvx-implementer\", \"nvx-tdd-enforcer\"], run_in_background=false, prompt=\"Implement...\")\n// → Todo progress updated automatically\n\ntask(subagent_type=\"oracle\", load_skills=[\"nvx-reviewer\"], run_in_background=false, prompt=\"Review...\")\n// → 7 passes including memory capture (Pass 7)\n```\n\nSee `adapters/opencode/AGENTS.md` for the full OpenCode handbook.\n\n---\n\n## 🔌 MCP Server\n\n> **MCP** (Model Context Protocol) lets any MCP-compatible AI client call tools directly — no plugin or skill system needed.\n> Install via: `npx -y nourivex-mcp-server` (no global install required)\n\n### 25 Tools\n\n| Domain | Tool | What It Does |\n|--------|------|-------------|\n| **Goals** (7) | `goal_get` | Read the current active goal |\n| | `goal_create` | Create a new active goal with title, objective, success criteria |\n| | `goal_update` | Update a field on the active goal |\n| | `goal_complete` | Complete and archive the active goal |\n| | `goal_abandon` | Abandon the active goal with a reason |\n| | `goal_add_scope_alarm` | Log a scope drift alarm to the active goal |\n| | `goal_history` | Read completed and abandoned goals from history |\n| **Memory** (8) | `memory_store` | Store a new memory entry (pattern, lesson, or note) |\n| | `memory_list` | List all memory entries with search and filter |\n| | `memory_get` | Get a specific memory entry by ID |\n| | `memory_recall` | Recall patterns before planning — returns relevant memories |\n| | `memory_update_user_dna` | Update user preferences and coding style profile |\n| | `memory_get_user_dna` | Get stored user preferences and coding profile |\n| | `memory_get_domain_rules` | Get stored business domain rules (invariants) |\n| | `memory_add_domain_rule` | Add a new business domain rule |\n| **Sessions** (3) | `session_init` | Initialize a new session with project context |\n| | `session_restore` | Restore session context — returns active goal, todo, and recent memory |\n| | `session_save` | Save the current session summary to persistent storage |\n| **Todos** (7) | `todo_create` | Create a new todo list from a plan |\n| | `todo_get` | Get a todo list by ID |\n| | `todo_list` | List all active todo lists |\n| | `todo_update_item` | Update a single todo item (status, description, priority) |\n| | `todo_add_item` | Add an item to an existing todo list |\n| | `todo_complete` | Mark a todo list as completed and archive it |\n| | `todo_progress` | Get aggregated progress across all todo lists |\n\n> These tools interact with the same `.nourivex/` persistent storage as the plugin skills — data written via MCP is visible to plugin skills and vice versa.\n\n---\n\n## 🧠 CLI Commands (v5.0.0)\n\nInspect and manage your persistent state from the terminal:\n\n```bash\n# Memory vault\nnourivex memory list              # List all stored patterns & lessons\nnourivex memory --search express  # Search by keyword or tag\nnourivex memory --show <id>       # Full entry detail\n\n# Goals\nnourivex goals                    # Show active goal + scope alarm history\nnourivex goals --complete <id>    # Archive completed goal\nnourivex goals --history          # Show all past goals\n\n# Todos\nnourivex todos                    # Show active todo list\nnourivex todos --progress         # Visual progress bar\nnourivex todos --show <id>        # Detailed view\n\n# MCP Server\nnourivex mcp                      # Spawn MCP server locally (stdio)\n```\n\n---\n\n## 🗂️ Persistent Storage (`.nourivex/`)\n\n```\n.nourivex/\n├── goals/\n│   ├── _active.json        # Current active goal + scope alarm log\n│   ├── _history.json       # Completed and abandoned goals\n│   └── archive/            # Full goal details\n├── todos/\n│   ├── _active.json        # Pointer to active todo list\n│   ├── _completed.json     # Index of completed lists\n│   └── lists/              # Individual todo lists with progress\n│       └── {id}.json\n├── memory/\n│   ├── _index.json         # Master registry of all memory entries\n│   ├── knowledge-vault/\n│   │   ├── patterns/       # Reusable implementation patterns\n│   │   └── lessons/        # Bug post-mortems & lessons learned\n│   ├── user-dna/\n│   │   └── profile.json    # User preferences & coding style\n│   └── project-map/\n│       ├── architecture.json   # Module relationships\n│       └── domain-rules.json   # Business invariants (never violate)\n└── sessions/\n    └── latest.json         # Most recent session summary\n```\n\n---\n\n## 👥 The Dream Team\n\n| Agent | Role | Phase |\n|-------|------|-------|\n| 🕵️ **nvx-researcher** | Deep technical discovery & approach proposals | Phase 1: Research |\n| 📐 **nvx-architect** | System design & structural blueprints | Phase 2: Architecture |\n| 📝 **nvx-planner** | Task breakdown & TDD roadmap + todo list creation | Phase 3: Planning |\n| 💻 **nvx-implementer** | TDD code execution + todo progress tracking | Phase 4: Execution |\n| 🧐 **nvx-reviewer** | 7-pass review + memory capture (Pass 7) | Phase 5: Review |\n\n## 📦 Available Skills (17)\n\nAll skills are registered in `.agents/skills/` for OpenCode auto-discovery.\n\n| Skill | Description |\n|-------|-------------|\n| `nvx-session-manager` | Restore/save session context (goals, todos, memory) |\n| `nvx-goal-preservation` | Lock objective + persist to `.nourivex/goals/` — survives restarts |\n| `nvx-superpower-memory` | STORE patterns after GREEN, RECALL before planning |\n| `nvx-watchdog` | Scope patrol + logs all alerts to goal file |\n| `nvx-planner` | Plan + auto-persist as living todo list |\n| `nvx-reviewer` | 7-pass review including memory capture (Pass 7) |\n| `nvx-agent-synchronizer` | Context Pack v2 with PERSISTENT_REFS for handoffs |\n| `nvx-tdd-enforcer` | Test-first discipline enforcement |\n| `nvx-anti-overengineering` | Enforce simplicity & YAGNI |\n| `nvx-architectural-consistency` | Match naming/pattern conventions |\n| `nvx-verification` | Verify before completion claims |\n| `nvx-idempotency-guard` | Ensure idempotent operations |\n| `nvx-context-pruning` | Keep context window lean |\n| `nvx-dependency-lockdown` | Control dependency additions |\n| `nvx-reasoning-trace` | Reasoning transparency |\n| `nvx-systematic-debugging` | Structured debugging protocol |\n| `nvx-token-efficiency` | Token optimization |\n\n## 📁 Project Structure\n\n```\nnourivex-runtime/\n├── .agents/skills/              # 17 skill definitions (OpenCode auto-discovered)\n│   ├── nvx-session-manager/\n│   ├── nvx-superpower-memory/\n│   ├── nvx-goal-preservation/\n│   ├── nvx-planner/\n│   ├── nvx-watchdog/\n│   ├── nvx-reviewer/\n│   └── nvx-agent-synchronizer/\n├── .opencode/\n│   ├── agents/                  # Agent instruction files (5 agents)\n│   └── skills/                  # OpenCode skill entry point\n├── .nourivex/                   # Persistent storage (auto-created)\n│   ├── goals/                   # Goal tracking\n│   ├── todos/                   # Todo lists\n│   ├── memory/                  # Knowledge vault\n│   └── sessions/                # Session summaries\n├── adapters/\n│   ├── opencode/AGENTS.md       # OpenCode handbook (v5.0.0)\n│   ├── gemini/GEMINI.md         # Gemini CLI handbook (v5.0.0)\n│   ├── claude/CLAUDE.md         # Claude adapter (v5.0.0)\n│   └── codex/AGENTS.md          # Codex adapter (v5.0.0)\n├── agents/                      # Agent role definitions\n├── cli/src/\n│   ├── commands/\n│   │   ├── init.ts              # nourivex init\n│   │   ├── memory.ts            # nourivex memory\n│   │   ├── goals.ts             # nourivex goals\n│   │   ├── todos.ts             # nourivex todos\n│   │   └── mcp.ts               # nourivex mcp\n│   └── index.ts                 # CLI entry point\n├── mcp/                         # MCP server source\n│   ├── src/\n│   │   ├── server.ts            # MCP entry point (26 tools)\n│   │   ├── tools/               # Tool implementations (goals, memory, session, todos)\n│   │   ├── prompts/             # MCP prompt definitions\n│   │   ├── resources/           # MCP resource definitions\n│   │   └── schemas/             # Zod schemas for all operations\n│   ├── dist/                    # Build output\n│   ├── tsconfig.json\n│   └── package.json             # nourivex-mcp-server@5.0.0 (published to npm)\n├── opencode-plugin.mjs          # OpenCode plugin entry\n├── opencode-mcp.json            # Project-local MCP server config\n├── package.json                 # v5.0.0\n└── skill.json                   # v5.0.0\n```\n\n## 📜 Principles\n\n1. **Evidence before Implementation:** No code without a plan.\n2. **Test-First:** Failing tests are mandatory before production code.\n3. **Simplicity Wins:** Abstractions must be earned, not assumed.\n4. **Full Traceability:** Every change must trace back to an approved plan.\n5. **Memory Compounds:** Every session builds on the last. Store lessons. Recall patterns.\n6. **Goals Persist:** Objectives are never lost to session restarts.\n\n---\n\n*Maintained by Nourivex — No code without a plan. No plan without verification. No session without memory.*\n",
  "bytes": 13681,
  "sha": "7c217a369329663b6be91215c30288fe734d957845762a4ca140ce6e0aa1aa67",
  "repo_slug": "nourivex/nourivex-runtime",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_nourivex_nourivex_runtime_31ae6d30/readme"
}