Cortex Taxonomy

How Cortex concepts are classified. Layers, roles, artifacts, and the relationships between them.


On this page
  1. Layers
  2. Roles a value can play
  3. Artifacts a contract can carry
  4. Namespaces
  5. Downstream Logos library
  6. Doc-kind taxonomy
  7. Related

Cortex Taxonomy

Glossary (glossary.md) defines terms one at a time. This page shows how they cluster.

Layers

Cortex separates four canonical substrate roots. Arrows here show operational relationships, not import or dependency direction:

flowchart TD
    A[Algebra<br/>graph/relation laws]
    W[Wire<br/>source, contracts, compiled circuit]
    P[Pulse<br/>durable runtime]
    C[Capability<br/>executor registration]

    A -- "topology laws for" --> W
    W -- "compiled circuit runs on" --> P
    C -- "grants registered authority to" --> P

Algebra is the pure substrate Wire authors over. Mechanized theory names the safety contracts that runtime implementation must enforce. Wire owns the compiled circuit form. Pulse executes compiled circuits durably. Capability exposes executor authority. Value provenance and artifact references are runtime/contract concepts, not a current public Haskell root.

Roles a value can play

A single Wire value often wears multiple hats. The roles are:

RoleWhat it isExamples
ExecutorRegistered recipe. Turns config + typed inputs into typed outputs. Referenced via @name.@review.analyst, @artifact.log, @cortex.report_run
Configured executor valueExecutor plus inert config, reusable in node bodies. Not a graph vertex.@review.gatherer { memory = topological { preset = "analyst" ; } ; }
NodeExplicit graph vertex with typed input/output ports and an implementation body.node analyst <- evidence: EvidenceBundle ; -> analysis: AnalysisFragment ; = ... ;
Composed wireResult of applying a graph operator. Has a derived boundary.planner => gatherer => analyst
Runtime wrapperA node whose role is to host a whole wire and provide runtime services.@cortex.report_run { title = ... ; }

The leading @ marks the executor-authority boundary. It stages a registered executor with pure config data; it does not run the executor. Wire-authored CorePure output equations are written directly without @; they lower to the native pure evaluator inside the admitted Wire semantics. See Reference/Wire/executors-and-alphabet.md.

Artifacts a contract can carry

Every contract declares a payload kind that selects validation and rendering:

Payload kindShapeExamples
jsonStructured domain objectAssetRef, AssetSet, ReportFragment
markdownLintable markdown textFinalReport, MarkdownSection
textMinimal-structure textSearchQuery, OperatorNote
tableRow/column typed dataPriceSeries, CorrelationMatrix
artifact_refReference to a persisted blobWorkbookRef, ReportArtifactRef

Namespaces

Cortex has a small closed set of globally-ambient namespaces:

NamespaceRegistered whereReferenced in Wire how
Executor alphabetExternal registry (Cortex.Capability + consumers)@qualified.name
Contract namespaceContract registry + contract X; assertionsbare Name in port signatures
Tool registryExternal registrybare name inside config tools = [...]
Config constructorsExecutor config schemasqualified.name { ... } inside config values

Beyond these four, every name is local: introduced by let, node, or import. The executor alphabet is authority-bearing; ordinary config constructors are not. The syntax distinction is the leading @.

Downstream Logos library

Logos is a downstream reasoning library built on Cortex. It adds reusable LLM-shaped catalogs above the substrate. Logos.Archetypes classifies modes of cognition, Logos.Thought names one bounded model-mediated node evaluation, Logos.Memory owns cognitive context construction, and Logos.Patterns names reusable reasoning programs. None of these grants executor authority or creates new runtime registries.

ArchetypeRole
Logos.Archetypes.LogosDiscursive reason, argument, symbolic reasoning
Logos.Archetypes.SophiaWisdom, judgment, synthesis
Logos.Archetypes.TechneCraft, engineering, implementation
Logos.Archetypes.EpistemeKnowledge, evidence, research
Logos.Archetypes.KritikosCriticism, adversarial review
Logos.Archetypes.ThemisAudit, law, correctness, constraints
Logos.Archetypes.PoiesisCreative generation, composition

Each archetype may have an operational activation bundle at Logos.Archetypes.<Archetype>.Activation. The archetype is the semantic definition; the activation bundle is the concrete set of prompt discipline, retrieval corpus, embedding spaces, tool surface, memory policy, evaluation criteria, and runtime contract. Thought frames compose one or more archetype activations.

Logos.Patterns.DeepReport is the planned extraction target for reusable deep-report reasoning contracts, ports, templates, prompts, memory presets, and evaluation policy.

Doc-kind taxonomy

Docs are classified on two axes:

Stable canonDated artifacts
Canonical authorityUsage/, Architecture/, Reference/, ADRs/none
Project workingRoadmap/Epics/, Roadmap/Plans/Research-notes/
HistoricalRoadmap/Completed/, Roadmap/Archive/Experiments/

Cross-cutting canon: Templates/, index.md, map.md, glossary.md, taxonomy.md Consumer-specific: Consumers/{consumer}.md, or Consumers/{consumer}/ for a larger public binding Papers: Publications/paper-N-*/