Home
Knowledge Wiki
Welcome to the shared knowledge wiki. It is designed for both human browsing and LLM consumption, with a stable taxonomy, consistent frontmatter, and cross-agent handoff pages.
Orchestrata documentation — start here
Orchestrata is a governance and agentic workflow engine: a person states an intent, a WebSocket gateway hands it to the kernel, Prolog policy authorizes it, and specialist agents called volks do the work, on real infrastructure in three isolated Incus fleets. Read these in order:
- Orchestrata, explained: the whole system in eleven sections with diagrams, from what it is to the components cut-over.
- The project hub: one section per page family, and a per-package table linking the code reference and the curated module pages.
- Starting context: the first-hour orientation and the rules that bind.
- Table of contents: every orchestrata page family in reading order.
- Glossary: volk, kernel, gateway, CXP, cxpt, orchkg, orchgraph, RTM and every other term, each linked to its page.
Browse by Category
| Section | Purpose |
|---|---|
| Agents | Per-agent context and the shared handoff board. |
| Claude | Claude Code user-level setup: skills, tools, hooks. |
| Concepts | Domain knowledge: semantic graph, repository pattern, HA controller, graph databases. |
| Dr. Hannah | Post-pivot Dr. Hannah personal-assistant docs; pre-pivot reference under projects/dr-hannah. |
| Infrastructure | Runtime services: Memgraph, Neo4j, Redis, Gateway, Kernel, Wiki.js, Incus. |
| LLMs | LLM model profiles, benchmarks, and deployment notes. |
| Meta | Rules, taxonomy, style guide, changelog, and agent contract. |
| Procedures | Step-by-step guides and runbooks. |
| Prolog | SWI-Prolog capability atlas — threads, tabling, CLP, DCG, engines, janus bridge — mapped to orchestrata touchpoints. |
| Projects | Active projects, decisions, blockers, runbooks, and session notes. Also: n8n, pi-harness, deepseek-harness. |
| Reference | Commands, environment variables, container IPs, URLs, and ports. |
| Rulings | Standing user rulings canon (RUL-001..NNN): id, ruling, enforcement mechanism, status. |
All Pages (A-Z)
- README — README
- agents/claude — Claude Agent Context
- agents/deepseek — DeepSeek Agent Context
- agents/kimi — Kimi Agent Context
- agents/shared-handoff — Shared Handoff Board
- claude/hooks/ast-toolkit-hint — ast-toolkit-hint.sh — AST toolkit advisory hint
- claude/hooks/block_except_pass — block_except_pass.py — Block error-swallowing patterns
- claude/hooks/block_file_tools — block_file_tools.py — Neo4j context injection hook
- claude/hooks/context_graph-init — init.py — context_graph package facade
- claude/hooks/context_graph-compactor — compactor.py — tiered context graph pruning
- claude/hooks/context_graph-loader — loader.py — graph-backed session context reads
- claude/hooks/context_graph-schema — schema.py — context graph Neo4j schema
- claude/hooks/context_graph-updater — updater.py — context graph write API
- claude/hooks/deception_detector — deception_detector.py — Stop-hook deception checks
- claude/hooks/enforcement_hook — enforcement_hook.py — PreToolUse constraints enforcer
- claude/hooks/error_gate-init — init.py — error gate entry point
- claude/hooks/error_gate-checks_lint — checks_lint.py — critical flake8 lint check
- claude/hooks/error_gate-checks_structure — checks_structure.py — stub, nesting, god-object checks
- claude/hooks/error_gate-checks_syntax — checks_syntax.py — Python syntax error check
- claude/hooks/error_gate-checks_test — checks_test.py — quick test failure check
- claude/hooks/error_gate-utils — utils.py — shared error-gate helpers
- claude/hooks/error_gate_hook — error_gate_hook.py — Stop-hook error gate
- claude/hooks/forbidden-doubles-stop — forbidden-doubles-stop.sh — mock/fake/stub stop guard
- claude/hooks/force-test-observation — force-test-observation.sh — live test observation guard
- claude/hooks/index — Claude hooks
- claude/hooks/infra_check — infra_check.py — Session-start infra status hook
- claude/hooks/inject-codebase-map — inject-codebase-map.sh — two-tier codebase map refresh
- claude/hooks/instruction_enforcer_hook — instruction_enforcer_hook.py — PreToolUse rule enforcement hook
- claude/hooks/intercept_bash — intercept_bash.py — destructive Bash command blocker
- claude/hooks/intercept_edit — intercept_edit.py — Pre-edit git checkpoint hook
- claude/hooks/intercept_write — intercept_write.py — Write safety guard hook
- claude/hooks/log_operation — log_operation.py — PostToolUse operation audit logger
- claude/hooks/no-banned-deps — no-banned-deps.sh — Banned dependency guard
- claude/hooks/no-doubles-py — no-doubles-py.sh — Test double write guard
- claude/hooks/no-preexisting-excuse — no-preexisting-excuse.sh — RUL-024 stop hook
- claude/hooks/no-xdist — no-xdist.sh — Pytest-xdist ban guard
- claude/hooks/posttool_auditor — posttool_auditor.py — PostToolUse session audit recorder
- claude/hooks/read_throttle — read_throttle.py — PreToolUse read throttling hook
- claude/hooks/remember_hook — remember_hook.py — conversation memory recall hook
- claude/hooks/require-design-before-build — require-design-before-build.sh — RUL-022 design gate hook
- claude/hooks/session-prime — session-prime.sh — SessionStart digest hook
- claude/hooks/session_context_hook — session_context_hook.py — SessionStart context injector
- claude/hooks/session_handoff_reminder — session_handoff_reminder.py — Open-session handoff nagger
- claude/hooks/session_open_hook — session_open_hook.py — Start-new-session prompt hook
- claude/hooks/session_resume_context — session_resume_context.py — Prior-context SessionStart hook
- claude/hooks/start-architecture-sync — start-architecture-sync.sh — SessionStart graph sync hook
- claude/hooks/start-ast-daemon — start-ast-daemon.sh — SessionStart AST daemon warmer
- claude/hooks/stop_audit-init — init.py — stop_audit package marker
- claude/hooks/stop_audit-deception — deception.py — Stop-hook deception detection
- claude/hooks/stop_audit-subagent — subagent.py — subagent stop re-exports
- claude/hooks/stop_audit-transcript — transcript.py — transcript parsing utilities
- claude/hooks/stop_auditor — stop_auditor.py — Stop-hook deception auditor
- claude/hooks/stop_auditor_subagent — stop_auditor_subagent.py — SubagentStop deception auditor
- claude/hooks/sync_context_md — sync_context_md.py — Regenerate context.md from JSON
- claude/index — Claude configuration — skills, tools, hooks
- claude/skills/ask-openrouter — ask-openrouter — cross-vendor model queries
- claude/skills/ast-toolkit — SKILL.md — AST toolkit skill
- claude/skills/index — Claude skills
- claude/skills/knowledge-wiki — SKILL.md — knowledge-wiki skill reference
- claude/skills/orchgraph-memgraph — SKILL.md — orchgraph Memgraph build and ops
- claude/tools/context_parser — context_parser.py — context.md session parser
- claude/tools/file_count — file_count.py — line-count tool
- claude/tools/file_edit — file_edit.py — file create/edit with git checkpoint
- claude/tools/file_grep — file_grep.py — regex search over files
- claude/tools/file_read — file_read.py — file reader with offset/limit
- claude/tools/index — Claude tools
- claude/tools/kg_sync_jsonl — kg_sync_jsonl.py — transcript KG export/sync
- claude/tools/session-archive — archive.py — session history archiver
- claude/tools/session-carryover — carryover.py — cross-session work carryover
- claude/tools/session-context — context.py — session context persistence manager
- claude/tools/session-exceptions — exceptions.py — session lifecycle exception types
- claude/tools/session-facts — facts.py — Prolog fact generation from sessions
- claude/tools/session-handover — handover.py — Session handover data manager
- claude/tools/session-models — models.py — session and portfolio data models
- claude/tools/session-portfolio — portfolio.py — multi-project portfolio controller
- claude/tools/session-prolog_interface — prolog_interface.py — Session–Prolog fact bridge
- claude/tools/session-session — session.py — Session lifecycle controller
- claude/tools/session_cli — session_cli.py — session management CLI wrapper
- claude/tools/session_close — session_close.py — session handoff generator
- claude/tools/session_start — session_start.py — Session start section generator
- claude/tools/statusline_session — statusline_session.py — Status line session indicator
- claude/tools/test_block — test_block.py — Hook blocking probe script
- claude/tools/test_tools — test_tools.py — File tool unit tests
- concepts/graph-databases — Graph Databases
- concepts/ha-controller — HA Controller
- concepts/repository-pattern — Repository Pattern for Graph Databases
- concepts/semantic-graph — Semantic Graph
- dr-hannah/agents — Agents Channel (IRC)
- dr-hannah/architecture — Architecture
- dr-hannah/ast — AST Overview
- dr-hannah/class-diagrams — Class Diagrams
- dr-hannah/code-reference — Code Reference
- dr-hannah/data — Dr. Hannah — Live Data
- dr-hannah/data/decisions — Architecture Decisions
- dr-hannah/data/habits — Habits
- dr-hannah/data/knowledge-base — Knowledge Base
- dr-hannah/design — Design Principles
- dr-hannah/history/pre-llm-chatbots — Before LLMs: How AI Chat Applications Worked
- dr-hannah/home — Dr. Hannah
- dr-hannah/prolog — Prolog Layer
- dr-hannah/prolog-capabilities — What Prolog Can and Cannot Do
- glossary — Glossary — project vocabulary, node types, and edge types
- infrastructure/gateway — Gateway Service
- infrastructure/incus-containers — Incus Containers
- infrastructure/kernel — Kernel Service
- infrastructure/memgraph-cluster — Memgraph HA Cluster — Complete Build Log
- infrastructure/memgraph-ha-cluster-reference — Memgraph HA Cluster Reference
- infrastructure/neo4j — Neo4j Cluster (decommissioned)
- infrastructure/redis — Redis Queue
- infrastructure/wiki-graph-indexer-schema — Wiki Graph Indexer Schema
- infrastructure/wiki-js — Wiki.js Instance
- llms — LLMs
- llms/qwen-agentworld-35b-a3b — Qwen-AgentWorld-35B-A3B
- llms/qwen-agentworld-cost — Qwen-AgentWorld Cost Analysis
- llms/qwen-agentworld-vs-deepseek — Qwen-AgentWorld vs DeepSeek Comparison
- meta/agent-contract — Cross-Agent Contract
- meta/changelog — Wiki Changelog
- meta/style-guide — Wiki Style Guide
- meta/taxonomy — Knowledge Wiki Taxonomy
- meta/wiki-integration — Wiki Integration
- procedures/agent-session-handoff — Agent Session Handoff
- procedures/gitlab-glab-auth — GitLab / glab Auth
- procedures/knowledge-wiki-plan — Knowledge Wiki — Multi-Agent Shared Memory Plan
- procedures/new-project-onboarding — New Project Onboarding
- procedures/orchgraph-vector-search-deployment — Orchgraph Vector Search Deployment
- procedures/rag-pipeline — RAG Pipeline
- procedures/t9-incus-btrfs-qgroup-stall — Runbook — T9 Incus btrfs pool: full-qgroup stall and simple quotas
- procedures/todoist-integration — Todoist Integration
- procedures/wiki-cli-workflow — Wiki CLI Workflow
- procedures/wiki-diagram-rendering — Wiki diagram rendering — Mermaid to scalable SVG
- procedures/workflow-swarm-dsl — Workflow Swarm DSL — orchestrating multi-agent runs
- projects/CLI-PROPOSAL/design-evolution — CLI-PROPOSAL — Design evolution
- projects/CLI-PROPOSAL/index — CLI-PROPOSAL — Unified orchestrata CLI
- projects/CLI-PROPOSAL/open-decisions — CLI-PROPOSAL — Open decisions
- projects/_template/blockers —
Blockers - projects/_template/decisions —
Decisions - projects/_template/index —
- projects/_template/runbooks —
Runbooks - projects/cachyos/blockers — CachyOS Host Blockers
- projects/cachyos/decisions — CachyOS Host Decisions
- projects/cachyos/index — CachyOS Host
- projects/cachyos/runbooks — CachyOS Host Runbooks
- projects/cachyos/sessions/2026-07-29-aur-malware-audit — 2026-07-29 — AUR Malware Audit (atomic-lockfile campaign)
- projects/deepseek-harness/architecture — DeepSeek Harness Architecture
- projects/deepseek-harness/blockers — DeepSeek Harness Blockers
- projects/deepseek-harness/class-diagrams — DeepSeek Harness Class Diagrams
- projects/deepseek-harness/decisions — DeepSeek Harness Decisions
- projects/deepseek-harness/desktop — DeepSeek Harness Desktop
- projects/deepseek-harness/index — DeepSeek Harness
- projects/deepseek-harness/packages — DeepSeek Harness Packages
- projects/deepseek-harness/runbooks — DeepSeek Harness Runbooks
- projects/dr-hannah/api-reference — API Reference
- projects/dr-hannah/architecture — Architecture
- projects/dr-hannah/ast-diagrams — AST Diagram — Module Dependencies
- projects/dr-hannah/development — Development Guide
- projects/dr-hannah/global-memory — Global Memory
- projects/dr-hannah/home — Home
- projects/dr-hannah/index — Dr. Hannah Project (Pre-Pivot Reference)
- projects/dr-hannah/modules — Module Reference
- projects/dr-hannah/prolog-integration — Prolog Integration
- projects/ea-diagrammer/architecture — EA Diagrammer Architecture
- projects/ea-diagrammer/ast-diagrams — AST Diagrams — Backend & Frontend
- projects/ea-diagrammer/blockers — EA Diagrammer Blockers
- projects/ea-diagrammer/code-docs — EA Diagrammer Code Documentation
- projects/ea-diagrammer/decisions — EA Diagrammer Decisions
- projects/ea-diagrammer/diagrams — EA Diagrammer Diagrams
- projects/ea-diagrammer/index — EA Diagrammer
- projects/ea-diagrammer/runbooks — EA Diagrammer Runbooks
- projects/ea-diagrammer/specs — EA Diagrammer Specs and Requirements
- projects/ea-diagrammer/vision — EA Diagrammer Vision
- projects/n8n — n8n — AI Workflow Automation Platform
- projects/n8n/architecture — n8n Architecture Deep Dive
- projects/n8n/ast-diagrams — AST Diagram — Workspace Package Dependencies
- projects/n8n/customization — n8n Customization & Extension Guide
- projects/n8n/index — n8n — AI Workflow Automation Platform
- projects/orchestrata-ultimate/architecture — Orchestrata-Ultimate Architecture
- projects/orchestrata-ultimate/architecture-diagram — Architecture Diagram
- projects/orchestrata-ultimate/architecture-ontology — Architecture Ontology (RATIFIED)
- projects/orchestrata-ultimate/ast-diagrams — AST Diagram — Package Dependencies
- projects/orchestrata-ultimate/blockers — Orchestrata Ultimate Blockers
- projects/orchestrata-ultimate/claude-configuration — orchestrata-ultimate — Claude configuration
- projects/orchestrata-ultimate/code-review-generated-tests — Code Review Report — Generated Tests (2026-07-15)
- projects/orchestrata-ultimate/codegen-template-fixes — Codegen Template Fixes — Root Cause Analysis
- projects/orchestrata-ultimate/decisions — Orchestrata Ultimate Decisions
- projects/orchestrata-ultimate/faq/agent-creation — How are agents created and configured?
- projects/orchestrata-ultimate/faq/bare-except-handlers — How does the project enforce the rule against bare exception handlers?
- projects/orchestrata-ultimate/faq/basevolk-rename — What is the renamed class for
BaseVolkin the target codebase? - projects/orchestrata-ultimate/faq/coverage-requirement — What is the minimum per-file coverage required by the Definition of Done?
- projects/orchestrata-ultimate/faq/openrouter-out-of-order — How does
OpenRouterEmbedderhandle out-of-order provider responses? - projects/orchestrata-ultimate/faq/silent-exception-handlers — What is the rule about silent exception handlers?
- projects/orchestrata-ultimate/faq/wiki-js-access — How is the wiki.js instance accessed?
- projects/orchestrata-ultimate/free-threaded-prolog — Free-Threaded Prolog — PRODUCTION (janus-swi under Python 3.14t)
- projects/orchestrata-ultimate/free-threaded-prolog-poc — Moved: Free-Threaded Prolog (now PRODUCTION)
- projects/orchestrata-ultimate/governed-action-classification — Governed Action Classification (SPEC-034)
- projects/orchestrata-ultimate/graph-browser — Interactive Graph Browser
- projects/orchestrata-ultimate/graph-db-best-practices — Graph DB Best Practices — Neo4j & Memgraph (verified research)
- projects/orchestrata-ultimate/graph-engine-analysis — Graph Engine Analysis — Neo4j vs orchgraph (live-grounded)
- projects/orchestrata-ultimate/index — Orchestrata Ultimate Project
- projects/orchestrata-ultimate/kg-migration-to-orchgraph — Operational KG migration — Neo4j → orchgraph (orchkg database)
- projects/orchestrata-ultimate/module-docs-index — Orchestrata Ultimate Module Docs Index
- projects/orchestrata-ultimate/modules/agents — agents package
- projects/orchestrata-ultimate/modules/context — context package
- projects/orchestrata-ultimate/modules/core — core package
- projects/orchestrata-ultimate/modules/cxp — cxp package
- projects/orchestrata-ultimate/modules/di — di package
- projects/orchestrata-ultimate/modules/domaingen — domaingen package
- projects/orchestrata-ultimate/modules/drivers — drivers package
- projects/orchestrata-ultimate/modules/factory — factory package
- projects/orchestrata-ultimate/modules/gateway — gateway package
- projects/orchestrata-ultimate/modules/governance — governance package
- projects/orchestrata-ultimate/modules/harness — harness package
- projects/orchestrata-ultimate/modules/integrations — integrations package
- projects/orchestrata-ultimate/modules/kernel — kernel package
- projects/orchestrata-ultimate/modules/knowledge_graph — knowledge_graph package
- projects/orchestrata-ultimate/modules/llm — llm package
- projects/orchestrata-ultimate/modules/memory — memory package
- projects/orchestrata-ultimate/modules/openspec — openspec package
- projects/orchestrata-ultimate/modules/orchestrator — orchestrator package
- projects/orchestrata-ultimate/modules/planning — planning package
- projects/orchestrata-ultimate/modules/plugin — plugin package
- projects/orchestrata-ultimate/modules/postman — postman package
- projects/orchestrata-ultimate/modules/providers — providers package
- projects/orchestrata-ultimate/modules/refactor — refactor package
- projects/orchestrata-ultimate/modules/semantic_graph — semantic_graph package
- projects/orchestrata-ultimate/modules/session — session package
- projects/orchestrata-ultimate/modules/tools — tools package
- projects/orchestrata-ultimate/modules/verification — verification package
- projects/orchestrata-ultimate/open-decisions — Open decisions — awaiting user ruling
- projects/orchestrata-ultimate/orchestrata-integration — Orchestrata Integration — Kimi, Claude Code, and agentic harnesses
- projects/orchestrata-ultimate/org-mode-rejection — Org-Mode Rejection Rationale (ADR-021)
- projects/orchestrata-ultimate/overview — Orchestrata, explained
- projects/orchestrata-ultimate/process-and-delivery — How we work — process, deployment, testing, coverage
- projects/orchestrata-ultimate/project-overview — Orchestrata Ultimate — Project Overview
- projects/orchestrata-ultimate/qa-benchmark — Semantic Graph QA Benchmark (100 questions)
- projects/orchestrata-ultimate/reproducibility-iac — Reproducibility & IaC
- projects/orchestrata-ultimate/research-2026-07-21 — Research digest — 2026-07-21 investigation wave
- projects/orchestrata-ultimate/runbook-environment-replication — Runbook — replicate the full environment on a fresh machine
- projects/orchestrata-ultimate/runbooks — Orchestrata Ultimate Runbooks
- projects/orchestrata-ultimate/running-the-test-suite — Running the test suite
- projects/orchestrata-ultimate/semantic-graph — Orchestrata-Ultimate Semantic Graph
- projects/orchestrata-ultimate/sessions/040-059 — Sessions 40-59
- projects/orchestrata-ultimate/sessions/060-079 — Sessions 60-79
- projects/orchestrata-ultimate/sessions/080-099 — Sessions 80-99
- projects/orchestrata-ultimate/sessions/100-119 — Sessions 100-119
- projects/orchestrata-ultimate/sessions/120-139 — Sessions 120-139
- projects/orchestrata-ultimate/sessions/140-159 — Sessions 140-159
- projects/orchestrata-ultimate/sessions/160-179 — Sessions 160-179
- projects/orchestrata-ultimate/sessions/180-199 — Sessions 180-199
- projects/orchestrata-ultimate/sessions/200-219 — Sessions 200-219
- projects/orchestrata-ultimate/sessions/228-237 — Sessions 228-237
- projects/orchestrata-ultimate/sessions/238-242 — Sessions 238-242
- projects/orchestrata-ultimate/sessions/index — Session Log Index
- projects/orchestrata-ultimate/sessions/session-210 — Session 210 — Memgraph HA Cluster
- projects/orchestrata-ultimate/sessions/session-211 — Session 211 — SPEC-003 wired end-to-end + governed front door
- projects/orchestrata-ultimate/sessions/session-253 — Session 253 — SPEC-033 §9 build-factory waves to done: goal 10/10, master promoted
- projects/orchestrata-ultimate/suite-speedup-story — How We Made the Test Suite 32% Faster — The Story
- projects/orchestrata-ultimate/table-of-contents — Table of Contents
- projects/orchestrata-ultimate/test-memgraph-isolation — Dedicated Test Memgraph — isolating the suite from production
- projects/orchestrata-ultimate/upcoming-work — Upcoming work — actionable backlog highlights
- projects/orchestrata-ultimate/volks — The Volks
- projects/orchestrata-ultimate/word-cloud — Spec Word Cloud
- projects/orchgraph/ast-diagrams — AST Diagram — Source Include Graph
- projects/orchgraph/blockers — Orchgraph Blockers
- projects/orchgraph/decisions — Orchgraph Decisions
- projects/orchgraph/index — Orchgraph
- projects/orchgraph/runbooks — Orchgraph Runbooks
- projects/pi-harness/architecture — pi-harness Architecture
- projects/pi-harness/blockers — pi-harness Blockers
- projects/pi-harness/decisions — pi-harness Decisions
- projects/pi-harness/index — pi-harness
- projects/pi-harness/runbooks — pi-harness Runbooks
- prolog/clpfd — Constraint Solving in SWI-Prolog — CLP(FD), CLP(B), dif/2
- prolog/dcg — SWI-Prolog DCGs and Text Processing
- prolog/engines-coroutines — SWI-Prolog Engines, Coroutining and Attributed Variables
- prolog/index — SWI-Prolog Capability Atlas
- prolog/janus — Janus — the Python-Prolog Bridge
- prolog/modules-dynamic-state — SWI-Prolog Modules, Dynamic Predicates and Persistent State
- prolog/orchestrata-leverage — Prolog Leverage Roadmap for orchestrata
- prolog/plunit — Unit Testing with plunit
- prolog/redis — Redis from Prolog (library(redis))
- prolog/semweb-graphs — Graphs in Prolog — semweb/RDF, ugraphs, assoc
- prolog/tabling — SWI-Prolog Tabling (SLG Resolution) and Memoization
- prolog/threads — SWI-Prolog Threads, Message Queues and Concurrency
- reference/commands — Command Reference
- reference/container-ips — Container IPs
- reference/emacs-setup — Emacs Setup (workstation)
- reference/environment-variables — Environment Variables
- reference/ephemeral-port-injection — Ephemeral Port Injection — the pattern for tests that start a real server
- reference/urls-and-ports — URLs and Ports
- rulings/RUL-001-no-xdist — RUL-001 — No pytest-xdist
- rulings/RUL-002-no-mocks-stubs-fakes-skips-monkeypatch — RUL-002 — No mocking — real infra, real implementations only
- rulings/RUL-003-env-from-dotenv-no-hardcoding — RUL-003 — Env config from .env, read at call time — no hardcoding
- rulings/RUL-004-incus-not-docker — RUL-004 — Incus, not Docker, for containers
- rulings/RUL-005-threadpool-only — RUL-005 — Threadpool executor for test parallelism, never xdist
- rulings/RUL-006-fix-on-sight — RUL-006 — Fix on sight — seeing a defect is fixing it, automatically
- rulings/RUL-007-no-ai-attribution — RUL-007 — No AI attribution in commits, tags, or PRs
- rulings/RUL-008-review-before-commit — RUL-008 — Review before every commit
- rulings/RUL-009-force-test-observation — RUL-009 — Never run tests without live observation
- rulings/RUL-010-never-skip-infra-verification — RUL-010 — Never skip infra verification, including nested runs
- rulings/RUL-011-ports-from-env-no-defaults — RUL-011 — Ports from .env, no hardcoded numeric defaults anywhere
- rulings/RUL-012-done-means-wired-and-deployed — RUL-012 — Done means wired and deployed, not just built and tested
- rulings/RUL-013-specs-authoritative — RUL-013 — Specs are authoritative — resolve decisions from them, not guesses
- rulings/RUL-014-rulings-are-binding — RUL-014 — A ruling that exists only in prose is incomplete work
- rulings/RUL-015-plan-fidelity — RUL-015 — Plan fidelity — execute a ratified plan as written
- rulings/RUL-016-ontology-before-graph-import — RUL-016 — Design the ontology before importing into any graph
- rulings/RUL-017-no-weasel-words — RUL-017 — No weasel words — blunt engineering vocabulary everywhere
- rulings/RUL-018-kimi-runs-at-agent-level — RUL-018 — Kimi runs at the agent level, not the project level
- rulings/RUL-019-pydantic-dotenv-config-pattern — RUL-019 — Config modules: Pydantic BaseSettings + auto-loaded .env
- rulings/RUL-020-async-by-default — RUL-020 — Async/sync contract — an async def must always be awaited
- rulings/RUL-021-worktree-owns-its-env — RUL-021 — Every feature-branch worktree owns a full environment, deleted at merge
- rulings/RUL-022-design-before-build — RUL-022 — No implementation dispatch without a ratified design artifact
- rulings/RUL-023-feature-means-wired — RUL-023 — A feature request means the thing is WIRED, not that code exists
- rulings/RUL-024-preexisting-is-not-a-disposition — RUL-024 — "pre-existing" is a diagnosis, not a disposition
- rulings/index — Rulings canon — index
How It Works
For Agents
- Read
meta/taxonomy.mdandmeta/style-guide.mdbefore creating pages. - Update
agents/shared-handoff.mdwhen ending a session or transferring work. - Log significant structural changes in
meta/changelog.md. - Use the controlled tag vocabulary; prefer links over repetition.
Access
| Audience | Method |
|---|---|
| Human | Browse at http://172.16.0.26:3000 |
| LLM | GraphQL API at http://172.16.0.26:3000/graphql |
| Both | Write markdown directly — Wiki.js syncs from git |