AKMS Core

AKMS core is a deterministic knowledge graph and task-context service for project agents and tools.

It reads validated knowledge artifacts, compiles a directed graph, selects ranked or exact task knowledge, and writes inspectable loadouts and resolution manifests. It also provides explicit local update operations and pluggable code mirror ingestion.

What core owns

• Frozen akms/v2 Pydantic schemas and validators
• Global/local/code-mirror graph compilation
• Local experiential overlays and explicit update semantics
• Role-aware ranked graph queries
• Path- and symbol-aware exact task-context resolution
• Required/coactivated/advisory selection classes
• Loadout rendering and resolution manifests
• Mirror-provider protocol, validation, status, and refresh surfaces
• CLI and MCP adapters over those capabilities

What core does not own

• Canonical source papers or generated knowledge-vault content
• Project failure registries
• Learning packet compilation
• Domain-specific executable backends
• The lifecycle of every coding agent

The package includes an optional staged runner and agent adapters, but neither is required to use the core knowledge services.

Data layers

Layer	Default path	Mutability
Global vault	~/.claude/akms/nodes/	Read-only to automated AKMS operations
Local nodes	<repo>/knowledge/local-nodes/	Project-owned
Code mirrors	<repo>/knowledge/code-mirror/	Regenerated by the selected provider
Experiential overlay	<repo>/knowledge/graph/local_state.yaml	Written by explicit update operations
Compiled graph	<repo>/knowledge/graph/graph.json	Generated
Loadouts	<repo>/knowledge/loadouts/	Generated
Resolution manifests	<repo>/knowledge/resolution-manifests/	Generated

First steps

1. Install from the workspace.
2. Run the valid-v2 quickstart.
3. Choose between a ranked graph workflow and exact task resolution.
4. Add mirror or runtime integrations only when the project needs them.