agentera 3.0.0-dev.2 → 3.0.0-dev.20

package/bundle/skills/agentera/capabilities/{visualisera → design}/schemas/validation.yaml

@@ -14,13 +14,13 @@ VALIDATION:
     id: V2
     rule: vision_identity_coherence
     description: >-
-      Design tokens MUST NOT conflict with VISION.md Identity. If the
+      Design tokens MUST NOT conflict with vision Identity. If the
       verbal identity says "warm and approachable" and the user wants a
       cold brutalist palette, the tension MUST be surfaced explicitly
       for the user to resolve.
     severity: critical
     checks:
-      - "Design tokens cohere with VISION.md Identity"
+      - "Design tokens cohere with vision Identity"
       - "Tensions surfaced when detected"
   3:
     id: V3
@@ -50,12 +50,12 @@ VALIDATION:
     id: V5
     rule: no_code_modification
     description: >-
-      Visualisera MUST NOT modify code files. It writes DESIGN.md only.
-      Realisera implements the design system in code. The separation
+      Design MUST NOT modify code files. It writes DESIGN.md only.
+      Build implements the design system in code. The separation
       of declaration and implementation is fundamental.
     severity: critical
     checks:
-      - "No code files modified during visualisera invocation"
+      - "No code files modified during design invocation"
   6:
     id: V6
     rule: codebase_exploration_required
@@ -70,8 +70,8 @@ VALIDATION:
     id: V7
     rule: exit_marker_required
     description: >-
-      Every visualisera invocation MUST emit an exit marker using the
-      canonical glyph ◰ (SG11) in the format ◰ visualisera · <status>
+      Every design invocation MUST emit an exit marker using the
+      canonical glyph ◰ (SG11) in the format ◰ design · <status>
       where status is one of EX1-EX4.
     severity: critical
     checks:

package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/artifacts.yaml

@@ -4,18 +4,19 @@ ARTIFACTS:
     artifact_id: decisions
     local_role: produces_and_consumes
     description: >-
-      Reasoning trail with confidence labels. Resonera reads existing decisions
-      through `agentera decisions --format json` and its source_contract to avoid
-      re-deliberation, and writes new decision entries with confidence (DL1
-      firm, DL2 provisional, DL3 exploratory). Compact older entries by applying
-      schema COMPACTION rules; incomplete compacted entries are caveated context,
-      not a reason for historical reconstruction during normal deliberation.
+      Reasoning trail with confidence labels. Discuss reads existing decisions
+      through `agentera state decisions --format json` and its source_contract
+      to avoid re-deliberation, and writes new decision entries with confidence
+      (DL1 firm, DL2 provisional, DL3 exploratory). Compact older entries by
+      applying schema COMPACTION rules; incomplete compacted entries are
+      caveated context, not a reason for historical reconstruction during
+      normal deliberation.
   2:
     id: A2
     artifact_id: vision
     local_role: produces_and_consumes
     description: >-
-      Resonera may update project direction only with explicit user
+      Discuss may update project direction only with explicit user
       confirmation when a decision feeds into project direction. Read for
       context during deliberation.
   3:
@@ -23,25 +24,25 @@ ARTIFACTS:
     artifact_id: todo
     local_role: produces_and_consumes
     description: >-
-      Resonera may add tech debt items surfaced during deliberation only with
+      Discuss may add tech debt items surfaced during deliberation only with
       explicit user confirmation. Severity per protocol SI1-SI4.
   4:
     id: A4
     artifact_id: objective
     local_role: produces_and_consumes
     description: >-
-      Resonera may write optimization decisions only with explicit user
+      Discuss may write optimization decisions only with explicit user
       confirmation when a decision feeds into what to optimize.
   5:
     id: A5
     artifact_id: profile
     local_role: consumes
     description: >-
-      Resonera reads this at session start to acknowledge high-confidence
+      Discuss reads this at session start to acknowledge high-confidence
       entries and avoid re-deliberating settled ground.
   6:
     id: A6
     artifact_id: docs
     local_role: consumes
     description: >-
-      Resonera reads this first to resolve project-local artifact mappings.
+      Discuss reads this first to resolve project-local artifact mappings.

package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/exit.yaml

@@ -4,7 +4,7 @@ EXIT_CONDITIONS:
     condition: complete
     description: >-
       Deliberation reached a conclusion the user chose to act on; any
-      requested artifacts (DECISIONS.md, VISION.md, OBJECTIVE.md, TODO.md)
+      requested artifacts (decisions, vision, objective, todo)
       were written with user approval, and the decision confidence level
       was captured.
     exit_signal: complete
@@ -15,7 +15,7 @@ EXIT_CONDITIONS:
       Deliberation concluded but the decision remains unresolved or
       provisional: the user wrapped up without a clear choice, significant
       tensions could not be resolved, or the conclusion contradicts prior
-      decisions in DECISIONS.md without explicit acknowledgment.
+      decisions without explicit acknowledgment.
     exit_signal: flagged
   3:
     id: E3

package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/triggers.yaml

@@ -3,11 +3,13 @@ TRIGGERS:
     id: T1
     description: >-
       Direct invocation by name or slash command. Matches when the user
-      explicitly requests resonera for structured deliberation.
+      explicitly requests discuss for structured deliberation.
     priority: high
     patterns:
-      - "resonera"
-      - "/resonera"
+      - "discuss"
+      - "/discuss"
+    confidence_threshold: 60
+    borderline_band: 10
   2:
     id: T2
     description: >-
@@ -23,6 +25,7 @@ TRIGGERS:
       - "what are the tradeoffs"
       - "brainstorm"
       - "rubber duck"
+    confidence_threshold: 50
   3:
     id: T3
     description: >-
@@ -34,6 +37,7 @@ TRIGGERS:
       - "I'm torn between"
       - "what's the right approach"
       - "let's reason about"
+    confidence_threshold: 50
   4:
     id: T4
     description: >-
@@ -44,3 +48,7 @@ TRIGGERS:
       - "scope this out"
       - "before I build this"
       - "talk me through"
+    confidence_threshold: 50
+    disambiguates_against:
+      - capability: plan
+        hint: "discuss explores options before committing; plan structures committed work"

package/bundle/skills/agentera/capabilities/{resonera → discuss}/schemas/validation.yaml

@@ -3,7 +3,7 @@ VALIDATION:
     id: V1
     rule: one_question_per_turn
     description: >-
-      Resonera MUST ask exactly one question per turn. Compound questions
+      Discuss MUST ask exactly one question per turn. Compound questions
       are not allowed. Every question MUST include a Done option.
     severity: critical
     checks:
@@ -13,16 +13,17 @@ VALIDATION:
     id: V2
     rule: user_approval_for_artifact_writes
     description: >-
-      Resonera MUST NOT modify VISION.md, OBJECTIVE.md, or TODO.md without
-      explicit user confirmation. Present drafts and get approval.
+      Discuss MUST NOT modify vision, objective, or todo artifacts (the
+      protected_write_boundaries) without explicit user confirmation. Present
+      drafts and get approval.
     severity: critical
     checks:
-      - "User confirmation obtained before writing to VISION.md, OBJECTIVE.md, or TODO.md"
+      - "User confirmation obtained before writing to vision, objective, or todo artifacts"
   3:
     id: V3
     rule: decision_confidence_required
     description: >-
-      Every DECISIONS.md entry MUST have a Confidence field with one of the
+      Every decision entry MUST have a Confidence field with one of the
       protocol-defined labels: firm (DL1), provisional (DL2), or
       exploratory (DL3).
     severity: critical
@@ -33,7 +34,7 @@ VALIDATION:
     id: V4
     rule: preserved_decision_fields
     description: >-
-      DECISIONS.md entries MUST preserve the canonical top-level fields:
+      Decision entries MUST preserve the canonical top-level fields:
       Question, Context, Alternatives, Choice, Reasoning, Confidence,
       Feeds into. Win conditions stay inside Alternatives bullets.
     severity: critical
@@ -43,7 +44,7 @@ VALIDATION:
     id: V5
     rule: no_implementation
     description: >-
-      Resonera MUST NOT skip to implementation. It deliberates; other
+      Discuss MUST NOT skip to implementation. It deliberates; other
       capabilities build. If the user wants to build, route to the
       appropriate capability.
     severity: critical
@@ -64,7 +65,7 @@ VALIDATION:
     id: V7
     rule: satisfaction_authority_boundary
     description: >-
-      When Resonera touches decision satisfaction, it may capture provisional
+      When Discuss touches decision satisfaction, it may capture provisional
       satisfaction with evidence but MUST NOT user-confirm satisfaction unless the
       user explicitly confirms it. Missing, compacted, open, provisional, or
       review-needed satisfaction state remains a caveat and review pressure;

package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/artifacts.yaml

@@ -5,24 +5,24 @@ ARTIFACTS:
     local_role: produces_and_consumes
     description: >-
       Documentation contract with conventions, artifact mapping, and
-      documentation index. Dokumentera writes and reads doc root, style
+      documentation index. Document writes and reads doc root, style
       conventions, auto-generated doc tracking, project-local artifact mappings,
       and a status index (current/stale/missing) for tracked docs. During
-      closeout, Dokumentera consumes docs state through CLI `closeout_context`
+      closeout, Document consumes docs state through CLI `closeout_context`
       before raw artifact fallback.
   2:
     id: A2
     artifact_id: vision
     local_role: consumes
     description: >-
-      Dokumentera reads this to understand who the documentation is for
+      Document reads this to understand who the documentation is for
       and what tone to use.
   3:
     id: A3
     artifact_id: progress
     local_role: consumes
     description: >-
-      Dokumentera reads this during explore-and-generate mode to understand
+      Document reads this during explore-and-generate mode to understand
       recent project context. During closeout, latest progress evidence and
       verification pointers are consumed through CLI `closeout_context` before
       raw artifact fallback.
@@ -31,21 +31,21 @@ ARTIFACTS:
     artifact_id: decisions
     local_role: consumes
     description: >-
-      Dokumentera reads this during explore-and-generate mode for project
+      Document reads this during explore-and-generate mode for project
       context and decision awareness.
   5:
     id: A5
     artifact_id: health
     local_role: consumes
     description: >-
-      Dokumentera reads this to discover documentation gaps surfaced
+      Document reads this to discover documentation gaps surfaced
       during health audits.
   6:
     id: A6
     artifact_id: todo
     local_role: produces_and_consumes
     description: >-
-      Dokumentera writes to this when code diverges from docs (per DTC,
+      Document writes to this when code diverges from docs (per DTC,
       the code is wrong). Also reads for context during documentation work;
       closeout blocker state is consumed through CLI `closeout_context` before
       raw artifact fallback.
@@ -54,20 +54,20 @@ ARTIFACTS:
     artifact_id: design
     local_role: consumes
     description: >-
-      Dokumentera reads this to respect the declared aesthetic and voice
+      Document reads this to respect the declared aesthetic and voice
       when generating user-facing documentation.
   8:
     id: A8
     artifact_id: profile
     local_role: consumes
     description: >-
-      Dokumentera reads this to calibrate documentation style preferences:
+      Document reads this to calibrate documentation style preferences:
       detail level, tone, format.
   9:
     id: A9
     artifact_id: changelog
     local_role: consumes
     description: >-
-      Dokumentera reads this during closeout synchronization through CLI
+      Document reads this during closeout synchronization through CLI
       `closeout_context` to preserve the changelog boundary and avoid inventing
       release, tag, publication, or remote state.

package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/triggers.yaml

@@ -3,11 +3,15 @@ TRIGGERS:
     id: T1
     description: >-
       Direct invocation by name or slash command. Matches when the user
-      explicitly requests dokumentera.
+      explicitly requests document.
     priority: high
     patterns:
-      - "dokumentera"
-      - "/dokumentera"
+      - "document"
+      - "/document"
+    confidence_threshold: 60
+    borderline_band: 10
+    patterns_regex:
+      - "\\b/document\\b"
   2:
     id: T2
     description: >-
@@ -18,10 +22,10 @@ TRIGGERS:
       - "write docs"
       - "document this"
       - "create README"
-      - "write CLAUDE.md"
       - "write AGENTS.md"
       - "docs first"
       - "document before building"
+    confidence_threshold: 50
   3:
     id: T3
     description: >-
@@ -33,3 +37,9 @@ TRIGGERS:
       - "audit docs"
       - "check documentation"
       - "docs out of sync"
+    confidence_threshold: 50
+    disambiguates_against:
+      - capability: audit
+        hint: "document maintains project docs; audit reviews codebase health"
+    patterns_regex:
+      - "\\baudit\\s+docs?\\b"

package/bundle/skills/agentera/capabilities/{dokumentera → document}/schemas/validation.yaml

@@ -73,8 +73,8 @@ VALIDATION:
     id: V8
     rule: exit_marker_required
     description: >-
-      Every dokumentera invocation MUST emit an exit marker using the
-      canonical glyph ▤ (SG8) in the format ▤ dokumentera · <status>
+      Every document invocation MUST emit an exit marker using the
+      canonical glyph ▤ (SG8) in the format ▤ document · <status>
       where status is one of EX1-EX4.
     severity: critical
     checks:
@@ -85,22 +85,22 @@ VALIDATION:
     id: V9
     rule: closeout_context_first
     description: >-
-      During final synchronization, Dokumentera MUST use `agentera prime
-      --context dokumentera --format json` and its `closeout_context`
+      During final synchronization, Document MUST use `agentera prime
+      --context document --format json` and its `closeout_context`
       before reading TODO, docs, changelog, or progress artifacts directly.
       Complete closeout context is the normal source for mappings, version
       policy, blockers, boundaries, progress evidence, benchmark evidence,
       caveats, fallback commands, raw-read policy, and completeness.
     severity: critical
     checks:
-      - "Closeout starts from hej capability context"
+      - "Closeout starts from status capability context"
       - "Complete closeout_context is used before raw artifact reads"
       - "Completeness and non-empty evidence flags are preserved"
   10:
     id: V10
     rule: closeout_fallback_before_raw
     description: >-
-      If closeout context is incomplete or caveated, Dokumentera MUST run the
+      If closeout context is incomplete or caveated, Document MUST run the
       listed existing CLI fallback commands before any last-resort raw artifact
       read. No unsupported capability-name command or new closeout command may
       be introduced.
@@ -113,7 +113,7 @@ VALIDATION:
     id: V11
     rule: closeout_caveat_preservation
     description: >-
-      Dokumentera MUST preserve closeout caveats about stale app/profile state,
+      Document MUST preserve closeout caveats about stale app/profile state,
       compacted or missing state, missing benchmark evidence, absent local
       metadata or tags, and unrecorded publication or remote state. Caveats must
       not be hidden, reconstructed, or converted into approval to refresh apps,
@@ -127,7 +127,7 @@ VALIDATION:
     id: V12
     rule: satisfaction_authority_boundary
     description: >-
-      When Dokumentera touches decision satisfaction, it may record provisional
+      When Document touches decision satisfaction, it may record provisional
       satisfaction with evidence but MUST NOT user-confirm satisfaction. Missing,
       compacted, open, provisional, or review-needed satisfaction state remains a
       caveat and review pressure; automation must not reconstruct hidden outcomes

package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/artifacts.yaml

@@ -5,12 +5,12 @@ ARTIFACTS:
     local_role: produces_and_consumes
     description: >-
       Optimization target definition: metric, current value, target, constraints,
-      scope, and measurement approach. Optimera writes this during brainstorm
+      scope, and measurement approach. Optimize writes this during brainstorm
       and reads it every cycle. Written to only during brainstorm, refine, or
       canonical closure.
   2:
     id: A2
-    artifact_id: optimera_harness
+    artifact_id: optimize_harness
     local_role: produces
     description: >-
       Eval script that measures the metric and outputs structured JSON. Written
@@ -23,41 +23,41 @@ ARTIFACTS:
     description: >-
       Log of every experiment: hypothesis, method, change, metric before/after,
       regression result, status (kept/discarded/error), conclusion, and next
-      suggestion. Optimera appends to this each cycle.
+      suggestion. Optimize appends to this each cycle.
   4:
     id: A4
     artifact_id: progress
     local_role: consumes
     description: >-
-      Optimera inspects the last 3 entries to detect 3 consecutive failures
+      Optimize inspects the last 3 entries to detect 3 consecutive failures
       before reporting exit status.
   5:
     id: A5
     artifact_id: todo
     local_role: produces
     description: >-
-      Optimera writes to this when logging a failure pattern after 3
+      Optimize writes to this when logging a failure pattern after 3
       consecutive failures.
   6:
     id: A6
     artifact_id: decisions
     local_role: consumes
     description: >-
-      Optimera reads this during Orient for context on prior deliberations
+      Optimize reads this during Orient for context on prior deliberations
       about the optimization objective.
   7:
     id: A7
     artifact_id: profile
     local_role: consumes
     description: >-
-      Optimera reads this to modulate experiment aggressiveness and constraint
+      Optimize reads this to modulate experiment aggressiveness and constraint
       tolerance based on user preferences.
   8:
     id: A8
     artifact_id: docs
     local_role: consumes
     description: >-
-      Optimera reads this first to resolve project-local artifact mappings
+      Optimize reads this first to resolve project-local artifact mappings
       before accessing other artifacts.
   9:
     id: A9
@@ -65,5 +65,5 @@ ARTIFACTS:
     local_role: consumes
     description: >-
       CLI-provided startup benchmark summary from `agentera prime --context
-      optimera --format json`. Optimera consumes this before any direct
+      optimize --format json`. Optimize consumes this before any direct
       latest-report.json, latest-report.md, or runs.jsonl diagnostic read.

package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/exit.yaml

@@ -5,7 +5,7 @@ EXIT_CONDITIONS:
     description: >-
       One experiment completed the full cycle: hypothesis formulated,
       implementation dispatched, regression check passed, metric measured,
-      decision made (kept or discarded), and EXPERIMENTS.md updated.
+      decision made (kept or discarded), and experiments.yaml updated.
     exit_signal: complete
   2:
     id: E2
@@ -20,7 +20,7 @@ EXIT_CONDITIONS:
     id: E3
     condition: stuck
     description: >-
-      Cannot proceed because OBJECTIVE.md is missing and the brainstorm cannot
+      Cannot proceed because objective.yaml is missing and the brainstorm cannot
       be completed without user input, the eval harness is broken and cannot
       be repaired without user approval, or the regression check infrastructure
       is unavailable.

package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/triggers.yaml

@@ -3,11 +3,16 @@ TRIGGERS:
     id: T1
     description: >-
       Direct invocation by name or slash command. Matches when the user
-      explicitly requests optimera.
+      explicitly requests optimize.
     priority: high
     patterns:
-      - "optimera"
-      - "/optimera"
+      - "optimize"
+      - "/optimize"
+    confidence_threshold: 60
+    borderline_band: 20
+    disambiguates_against:
+      - capability: audit
+        hint: "optimize tunes existing code; audit reviews codebase health"
   2:
     id: T2
     description: >-
@@ -26,6 +31,8 @@ TRIGGERS:
       - "get the score up"
       - "hit the target"
       - "improve the metric"
+    confidence_threshold: 50
+    borderline_band: 20
   3:
     id: T3
     description: >-
@@ -37,3 +44,4 @@ TRIGGERS:
       - "run experiments"
       - "tune"
       - "experiment until"
+    confidence_threshold: 50

package/bundle/skills/agentera/capabilities/{optimera → optimize}/schemas/validation.yaml

@@ -24,17 +24,17 @@ VALIDATION:
     id: V3
     rule: objective_readonly_during_cycle
     description: >-
-      OBJECTIVE.md MUST NOT be modified during a cycle except for canonical
+      objective.yaml MUST NOT be modified during a cycle except for canonical
       closure when the target is met. Other edits only happen during
       brainstorm or refine.
     severity: critical
     checks:
-      - "OBJECTIVE.md only modified for closure during cycle"
+      - "objective.yaml only modified for closure during cycle"
   4:
     id: V4
     rule: one_experiment_per_invocation
     description: >-
-      Each optimera invocation performs exactly one experiment. Multiple
+      Each optimize invocation performs exactly one experiment. Multiple
       experiments require multiple invocations or /loop setup.
     severity: critical
     checks:
@@ -53,8 +53,8 @@ VALIDATION:
     id: V6
     rule: exit_marker_required
     description: >-
-      Every optimera invocation MUST emit an exit marker. The marker uses
-      the canonical glyph ⎘ (SG7) in the format ⎘ optimera · <status>
+      Every optimize invocation MUST emit an exit marker. The marker uses
+      the canonical glyph ⎘ (SG7) in the format ⎘ optimize · <status>
       where status is one of EX1-EX4.
     severity: critical
     checks:
@@ -65,21 +65,21 @@ VALIDATION:
     id: V7
     rule: benchmark_context_first
     description: >-
-      For benchmark-oriented startup, Optimera MUST start from `agentera prime
-      --context optimera --format json` and consume complete
+      For benchmark-oriented startup, Optimize MUST start from `agentera prime
+      --context optimize --format json` and consume complete
       benchmark_context before direct retained benchmark file reads. Direct
       latest-report.json, latest-report.md, or runs.jsonl reads are last-resort
       diagnostics only when the CLI context is incomplete.
     severity: critical
     checks:
-      - "Optimera startup uses benchmark_context before direct retained benchmark files"
+      - "Optimize startup uses benchmark_context before direct retained benchmark files"
       - "Incomplete benchmark_context follows listed CLI fallback and manual refresh guidance"
       - "Direct benchmark file reads are treated as last-resort diagnostics"
   8:
     id: V8
     rule: benchmark_caveat_preservation
     description: >-
-      Benchmark caveats from benchmark_context MUST be preserved when Optimera
+      Benchmark caveats from benchmark_context MUST be preserved when Optimize
       reports measurement evidence. Agents must not hide, upgrade, reconstruct,
       or infer away caveats for manual-only execution, missing local history,
       runtime coverage degradation, missing token estimates, non-comparable

package/bundle/skills/agentera/capabilities/{orkestrera → orchestrate}/schemas/artifacts.yaml

@@ -4,16 +4,17 @@ ARTIFACTS:
     artifact_id: plan
     local_role: produces_and_consumes
     description: >-
-      Orkestrera consumes plan task queue state through
-      `agentera prime --context orkestrera --format json` before raw
+      Orchestrate consumes plan task queue state through
+      `agentera prime --context orchestrate --format json` before raw
       artifact access, then updates status (pending -> complete/blocked) only
-      when resolving a task.
+      when resolving a task. Failed evaluator results are recorded through the
+      retry-safe typed `record-evaluation` mutation before retry or blocking.
   2:
     id: A2
     artifact_id: progress
     local_role: consumes
     description: >-
-      Orkestrera consumes progress verification state from the returned
+      Orchestrate consumes progress verification state from the returned
       orchestration context first, then routine CLI fallback output before any
       last-resort raw artifact read for the Step 3 presence check.
   3:
@@ -21,7 +22,7 @@ ARTIFACTS:
     artifact_id: health
     local_role: consumes
     description: >-
-      Orkestrera consumes returned health state first after plan completion to
+      Orchestrate consumes returned health state first after plan completion to
       decide whether to start a new plan cycle; raw reads are last-resort after
       listed CLI fallbacks.
   4:
@@ -29,14 +30,14 @@ ARTIFACTS:
     artifact_id: todo
     local_role: produces
     description: >-
-      Orkestrera consumes TODO caveats from CLI startup context and writes
+      Orchestrate consumes TODO caveats from CLI startup context and writes
       blocked task logging only when a task exhausts its retry budget.
   5:
     id: A5
     artifact_id: decisions
     local_role: consumes
     description: >-
-      Orkestrera consumes included decision context or the listed
+      Orchestrate consumes included decision context or the listed
       `agentera decisions --format json` fallback before raw access, preserving
       firm constraints, exploratory uncertainties, and compacted-entry caveats.
   6:
@@ -44,14 +45,14 @@ ARTIFACTS:
     artifact_id: vision
     local_role: consumes
     description: >-
-      Orkestrera consumes returned vision state or missing-state caveats during
-      bootstrap when chaining inspirera for vision-gap analysis.
+      Orchestrate consumes returned vision state or missing-state caveats during
+      bootstrap when chaining research for vision-gap analysis.
   7:
     id: A7
     artifact_id: profile
     local_role: consumes
     description: >-
-      Orkestrera consumes returned profile status and caveats first for persona
+      Orchestrate consumes returned profile status and caveats first for persona
       context. If missing or stale, it proceeds without refreshing profile
       state and preserves the caveat.
   8:
@@ -59,6 +60,6 @@ ARTIFACTS:
     artifact_id: docs
     local_role: consumes
     description: >-
-      Orkestrera uses docs mapping from CLI startup context first to resolve
+      Orchestrate uses docs mapping from CLI startup context first to resolve
       project-local artifact mappings before any last-resort raw artifact read
       or artifact write.