yarramate 0.6.0 → 0.7.0

package/README.md

@@ -5,9 +5,14 @@
 [![CodeQL](https://github.com/yarrasys/yarramate/actions/workflows/codeql.yml/badge.svg)](https://github.com/yarrasys/yarramate/actions/workflows/codeql.yml)
 [![license: MIT](https://img.shields.io/github/license/yarrasys/yarramate)](LICENSE)
 
-YarraMate is a tool-neutral semantic architecture engine and guided
-methodology. It turns architectural intent into deterministic, testable
-context shared by people and agents.
+YarraMate keeps your coding agents' architecture context correct. Declare
+the design once, as a checked model in git; agents receive prose rendered
+from it — bounded briefs and open design questions — and the CLI
+mechanically proves the model still matches the code as changes land.
+
+Prose is the interface; structure is the guarantee: every sentence an agent
+reads stands on a graph whose names resolve, whose drift is detected, and
+whose gaps are found deterministically.
 
 > YarraMate is pre-release software. Interfaces may evolve before the first
 > stable release.
@@ -57,6 +62,7 @@ src/                 compiler, CLI, graph, and adapter sources
 schema/              normative JSON Schemas
 test/                tests and acceptance fixtures
 skills/              portable architecture workflow for agent harnesses
+.claude-plugin/      plugin marketplace manifest offering that skill
 docs/                contracts, guides, and decisions
 .yarramate/          canonical dogfooded architecture
 .yarramate-out/      reproducible generated output (ignored)
@@ -106,7 +112,14 @@ npm install --global yarramate
 yarramate --help
 
 npx yarramate check .yarramate/workspace.yaml
-npx yarramate status .yarramate/workspace.yaml --json
+npx yarramate ask .yarramate/workspace.yaml
+```
+
+The CLI is seven verbs, one per lifecycle stage:
+
+```text
+init → design → apply → ask → check → reconcile → export
+create  fill    write   read  gate    drift       derive
 ```
 
 When developing the repository, build and invoke the same executable surface:
@@ -115,19 +128,26 @@ When developing the repository, build and invoke the same executable surface:
 pnpm build
 
 node dist/cli.js init .
+node dist/cli.js design .yarramate/workspace.yaml
+node dist/cli.js apply operations.yaml .yarramate/workspace.yaml
+node dist/cli.js ask .yarramate/workspace.yaml
+node dist/cli.js ask .yarramate/workspace.yaml "free text about the model"
+node dist/cli.js ask .yarramate/workspace.yaml --subjects
+node dist/cli.js ask .yarramate/workspace.yaml --advise "a design question"
 node dist/cli.js check .yarramate/workspace.yaml --json
-node dist/cli.js compile .yarramate/workspace.yaml
-node dist/cli.js context .yarramate/projections/context.yaml .yarramate/workspace.yaml
-node dist/cli.js view .yarramate/projections/context.yaml .yarramate/workspace.yaml
-node dist/cli.js next .yarramate/projections/context.yaml .yarramate/workspace.yaml
-node dist/cli.js evidence .yarramate/evidence/repository.yaml .yarramate/workspace.yaml
 node dist/cli.js reconcile .yarramate/workspace.yaml
+node dist/cli.js export graph .yarramate/workspace.yaml
+node dist/cli.js export briefs .yarramate/projections/context.yaml .yarramate/workspace.yaml --out handoff
 ```
 
 `init` creates `.yarramate/architecture/main.yaml` and
-`.yarramate/workspace.yaml`. Commands accept explicit source documents or one
-explicit workspace manifest. `check --strict` additionally fails when any
-evidence observation contradicts the model, for gates that want one knob.
+`.yarramate/workspace.yaml` and delivers the agent pointer. `design`
+serves the top open design question; `apply` lands answers as one
+validated atomic batch; `ask` is every consumed-now read; `export`
+derives persisted artifacts. `check --strict` additionally fails when
+any evidence observation contradicts the model, for gates that want one
+knob. The full contract is
+[docs/AGENT-INTERFACE.md](docs/AGENT-INTERFACE.md).
 
 For a local consumer test, create a package artifact:
 
@@ -140,6 +160,13 @@ yarramate --help
 See [Consuming YarraMate](docs/CONSUMING-YARRAMATE.md) for the packaged CLI,
 schemas, agent skill, and optional adapters.
 
+In Claude Code, this repository is its own plugin marketplace:
+
+```sh
+/plugin marketplace add yarrasys/yarramate
+/plugin install yarramate-architecture@yarramate
+```
+
 ## Library API
 
 The typed library exposes the same deep compiler seam: