Concepts
Give project knowledge a structure.
Cumaru gives an agent a way to discover the context a task needs, without loading the whole repository.
A map beside your work
The .cumaru/ directory holds the framework and the project's knowledge. Directory indexes explain purpose. Short file summaries help an agent select relevant material before reading its body.
The filesystem supplies the candidates. The agent decides which candidates matter, reads them, and follows the relevant declared relationships. Cumaru makes that path explicit; it does not replace the agent's judgment.
Source: the kernel's loading rule.
One kernel, different domains
The kernel defines the recursive knowledge model and loading rules. A domain supplies the vocabulary, pillars, roles, and workflow for a kind of work. A software project, an infrastructure project, and a memory vault can use the same discovery model with different durable records.
Install one domain per project. Its domain.md declares the workflow; its config.yaml declares the structural contract. Do not assume every domain has a specs/ directory or a Lead role.
Source: domain overview.
Separate work from what is true
In SDLC Light, explorations hold ideas and plans hold active work. Specs record verified current behavior. Completing a task does not automatically make its claims durable: the close workflow verifies the evidence and updates the exact spec owners before removing transient material.
That lifecycle is an SDLC Light example. Other domains declare their own retained knowledge and cleanup rules.
Source: SDLC Light's pillars and cycle.
Structure and meaning are different checks
The CLI can validate configured structure, metadata, tags, and references. The agent must still judge whether a statement is accurate, a relationship is useful, or a task meets its acceptance criteria. A structurally valid file can contain an incorrect claim.
Source: doctor's validation boundary.
Explore the model
- The knowledge treeHow indexes, summaries, and relationships guide discovery.
- Framework and project ownershipWhere your facts live and what an update preserves.
- Roles, skills, and disciplinesWho can act, which recipe to follow, and how to work.
Set up a project to put the model into practice.