Innate: Instructions file for Claude Code

AGENTS.md

This file is the single source of truth for AI coding agents (Claude Code, Codex, opencode, Gemini CLI, …) working in this repository. Tool-specific shells such as CLAUDE.md import this file via @AGENTS.md — keep all shared guidance here.

Editing rule (applies to all agents): Any request to "update / improve CLAUDE.md" or the project guidance means edit AGENTS.md. CLAUDE.md is a generated shell that only contains @AGENTS.md — never add real guidance to it. Other tool shells (GEMINI.md, etc.) follow the same rule.

Commands

# Build the binary
cd core && cargo build --release
# Binary: core/target/release/innate

# Run tests
cd core && cargo test

# Recall-quality eval suite (regression safety net for fused-score / ACT-R tuning)
cd core && cargo test --release eval -- --nocapture

# Run the CLI (after adding to PATH or using full path)
innate recall "query" --format json
innate inspect                      # includes llm_health — check it when distillation looks off
innate evolve --trigger manual

# KPI baseline vs now — "did the last change help?"
innate metrics snapshot             # pin a baseline
innate metrics delta --days 7       # baseline / current / delta table

# Start MCP server (for Claude Code / Claude Desktop integration)
innate mcp

# Daemon (Linux only) — background log/hook watcher
innate daemon start --watch /path/to/log/dir
innate daemon status
innate daemon stop

MCP Integration

Add to .claude/settings.json to enable MCP tools directly in Claude Code:

{
  "mcpServers": {
    "innate": {
      "command": "/path/to/core/target/release/innate",
      "args": ["mcp"]
    }
  }
}

Authoritative Design Reference

docs/Innate-设计文档-v0.1.9.md is the 编码基线 (latest; supersedes the v0.1.8 doc after the modular refactor). Every design decision references a section. When behavior is ambiguous, consult the doc first.

Schema 5.0 / v0.2.0 (living-knowledge model) changes how knowledge is born and matures; for those parts docs/Innate-活知识库重构-整体改进方案-v1.md (with its decision record §8) overrides v0.1.9. Summary: experience (episodes) and rules are separate; rules are born from episodes recurring across sessions (or an explicit nomination); a rule matures only on validated, transferable evidence; counterexamples suspend and revise it.