agentera 3.0.0-dev.1 → 3.0.0-dev.11

package/bundle/skills/agentera/schemas/artifacts/changelog.yaml

@@ -1,6 +1,6 @@
 # Changelog Artifact Schema
 #
-# Release history maintained by realisera. Tracks versioned releases with
+# Release history maintained by build. Tracks versioned releases with
 # categorized changes (Added, Changed, Fixed, Removed).
 #
 # Note: CHANGELOG.md is a human-facing Markdown artifact. It remains at the
@@ -11,12 +11,12 @@ meta:
   name: changelog
   version: "1.0.0"
   description: >-
-    Release history. Produced by realisera. Consumed by users and agents
+    Release history. Produced by build. Consumed by users and agents
     for version context. Human-facing: remains Markdown at project root.
   artifact_type: human_facing
   path: "CHANGELOG.md"
-  producer: realisera
-  consumers: [hej, all_skills]
+  producer: build
+  consumers: [status, all_skills]
   format: markdown
 
 GROUP_PREFIXES:

package/bundle/skills/agentera/schemas/artifacts/decisions.yaml

@@ -1,7 +1,7 @@
 # Decisions Artifact Schema
 #
-# Reasoning trail maintained by resonera. Each deliberation session appends
-# one entry. Decisions are referenced by realisera, optimera, and profilera
+# Reasoning trail maintained by discuss. Each deliberation session appends
+# one entry. Decisions are referenced by build, optimize, and profile
 # for context on why choices were made.
 #
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
@@ -32,14 +32,14 @@ meta:
   name: decisions
   version: "1.0.0"
   description: >-
-    Reasoning trail maintained by resonera. Each deliberation session
-    appends one entry. Decisions are referenced by realisera, optimera,
-    profilera, planera, inspektera, hej, dokumentera, visionera, resonera,
-    and orkestrera for context on why choices were made.
+    Reasoning trail maintained by discuss. Each deliberation session
+    appends one entry. Decisions are referenced by build, optimize,
+    profile, plan, audit, status, document, vision, discuss,
+    and orchestrate for context on why choices were made.
   artifact_type: agent_facing
   path: ".agentera/decisions.yaml"
-  producer: resonera
-  consumers: [dokumentera, hej, inspektera, optimera, orkestrera, planera, profilera, realisera, resonera, visionera]
+  producer: discuss
+  consumers: [document, status, audit, optimize, orchestrate, plan, profile, build, discuss, vision]
   format: yaml
 
 GROUP_PREFIXES:
@@ -55,7 +55,7 @@ BUDGET:
   1:
     id: DB1
     scope: per_decision_entry
-    max_words: 200
+    max_words: 1000
     description: >-
       Maximum words per decision entry. Budgets are guidelines, not hard
       blockers.
@@ -103,7 +103,7 @@ COMPACTION:
       Decisions older than 50 are dropped entirely.
   5:
     id: DX5
-    trigger: "When resonera writes a new decision"
+    trigger: "When discuss writes a new decision"
     description: >-
       Compaction runs when the producing skill writes a new entry.
       If >10 full-detail entries exist, collapse the oldest to one-line.

package/bundle/skills/agentera/schemas/artifacts/design.yaml

@@ -1,6 +1,6 @@
 # Design Artifact Schema
 #
-# Visual identity system maintained by visualisera. Defines design tokens,
+# Visual identity system maintained by design. Defines design tokens,
 # palette, typography, spacing, and component styling rules.
 #
 # Note: DESIGN.md is a human-facing Markdown artifact. It remains at the
@@ -11,12 +11,12 @@ meta:
   name: design
   version: "1.0.0"
   description: >-
-    Visual identity system. Produced by visualisera. Consumed by capabilities
+    Visual identity system. Produced by design. Consumed by capabilities
     that need visual identity context. Human-facing: remains Markdown at root.
   artifact_type: human_facing
   path: "DESIGN.md"
-  producer: visualisera
-  consumers: [dokumentera, hej, inspektera, realisera, visionera, visualisera]
+  producer: design
+  consumers: [document, status, audit, build, vision, design]
   format: markdown
 
 GROUP_PREFIXES:

package/bundle/skills/agentera/schemas/artifacts/docs.yaml

@@ -1,6 +1,6 @@
 # Docs Artifact Schema
 #
-# Documentation contract maintained by dokumentera. Tracks project doc
+# Documentation contract maintained by document. Tracks project doc
 # conventions, artifact path overrides, document index with status, coverage
 # metrics, and timestamped audit findings.
 #
@@ -47,11 +47,11 @@ meta:
   name: docs
   version: "1.0.0"
   description: >-
-    Documentation contract. Produced by dokumentera. Consumed by all skills
+    Documentation contract. Produced by document. Consumed by all skills
     for artifact path resolution and doc status tracking.
   artifact_type: agent_facing
   path: ".agentera/docs.yaml"
-  producer: dokumentera
+  producer: document
   consumers: [all_skills]
   format: yaml
 
@@ -123,7 +123,7 @@ CONVENTIONS:
     required: true
     description: >-
       Files whose content changes indicate a version bump is needed.
-      Tracked by planera, inspektera, and realisera for bump discipline.
+      Tracked by plan, audit, and build for bump discipline.
     validation:
       - "At least one entry required"
   5:
@@ -177,8 +177,9 @@ MAPPING:
     required: true
     description: >-
       File path for this artifact. May be absolute or relative.
-      Environment variable references (e.g., $PROFILERA_PROFILE_DIR)
-      are resolved at read time.
+      Environment variable references (e.g., $AGENTERA_PROFILE_DIR or
+      the deprecated $PROFILERA_PROFILE_DIR alias) are resolved at read
+      time with AGENTERA_PROFILE_DIR taking precedence.
     validation:
       - "Non-empty string"
   4:
@@ -288,7 +289,7 @@ AUDIT_LOG:
     type: map
     required: false
     description: >-
-      Each audit log entry. Timestamped findings from dokumentera audits.
+      Each audit log entry. Timestamped findings from document audits.
       Appended when an audit is performed.
   2:
     id: DA2

package/bundle/skills/agentera/schemas/artifacts/experiments.yaml

@@ -1,6 +1,6 @@
 # Experiments Artifact Schema
 #
-# Experiment log maintained by optimera. Each experiment records hypothesis,
+# Experiment log maintained by optimize. Each experiment records hypothesis,
 # method, metric results, kept/discarded status, and conclusions. Lives
 # alongside OBJECTIVE.md in .agentera/optimera/<name>/.
 #
@@ -40,12 +40,12 @@ meta:
   name: experiments
   version: "1.0.0"
   description: >-
-    Experiment log for optimera objectives. Produced and consumed by optimera.
+    Experiment log for optimize objectives. Produced and consumed by optimize.
     Lives in .agentera/optimera/<name>/ alongside the objective.
   artifact_type: agent_facing
   path: ".agentera/optimera/<name>/experiments.yaml"
-  producer: optimera
-  consumers: [hej, optimera]
+  producer: optimize
+  consumers: [status, optimize]
   format: yaml
 
 GROUP_PREFIXES:
@@ -108,7 +108,7 @@ COMPACTION:
       Experiments older than 50 are dropped entirely.
   5:
     id: EX_CMP5
-    trigger: "When optimera writes a new experiment"
+    trigger: "When optimize writes a new experiment"
     description: >-
       Compaction runs when the producing skill writes a new entry.
       If >10 full-detail entries exist, collapse the oldest to one-line.

package/bundle/skills/agentera/schemas/artifacts/health.yaml

@@ -1,6 +1,6 @@
 # Health Artifact Schema
 #
-# Audit log maintained by inspektera. Each audit entry records assessed
+# Audit log maintained by audit. Each audit entry records assessed
 # dimensions, findings (critical/warning/info counts), overall trajectory,
 # per-dimension grades (A-F), per-dimension findings with confidence, and
 # trend analysis against the prior audit.
@@ -49,12 +49,12 @@ meta:
   name: health
   version: "1.0.0"
   description: >-
-    Audit log maintained by inspektera. Consumed by capabilities that need
+    Audit log maintained by audit. Consumed by capabilities that need
     codebase health context.
   artifact_type: agent_facing
   path: ".agentera/health.yaml"
-  producer: inspektera
-  consumers: [dokumentera, hej, inspektera, orkestrera, planera, realisera, visionera]
+  producer: audit
+  consumers: [document, status, audit, orchestrate, plan, build, vision]
   format: yaml
 
 GROUP_PREFIXES:
@@ -119,7 +119,7 @@ COMPACTION:
       Audits older than 50 are dropped entirely.
   5:
     id: HX5
-    trigger: "When inspektera writes a new audit"
+    trigger: "When audit writes a new audit"
     description: >-
       Compaction runs when the producing skill writes a new entry.
       If >10 full-detail entries exist, collapse the oldest to one-line.

package/bundle/skills/agentera/schemas/artifacts/objective.yaml

@@ -1,6 +1,6 @@
 # Objective Artifact Schema
 #
-# Optimization objective maintained by optimera. Each objective lives in its
+# Optimization objective maintained by optimize. Each objective lives in its
 # own subdirectory under .agentera/optimera/<name>/ and captures the metric,
 # target, baseline, constraints, measurement method, gates, and scope.
 #
@@ -47,12 +47,12 @@ meta:
   name: objective
   version: "1.0.0"
   description: >-
-    Optimization objective. Produced by optimera and resonera. Each objective
+    Optimization objective. Produced by optimize and discuss. Each objective
     lives in its own subdirectory under .agentera/optimera/<name>/.
   artifact_type: agent_facing
   path: ".agentera/optimera/<name>/objective.yaml"
-  producer: [optimera, resonera]
-  consumers: [hej, optimera, resonera]
+  producer: [optimize, discuss]
+  consumers: [status, optimize, discuss]
   format: yaml
 
 GROUP_PREFIXES:

package/bundle/skills/agentera/schemas/artifacts/plan.yaml

@@ -1,6 +1,6 @@
 # Plan Artifact Schema
 #
-# Active work plan maintained by planera. Each plan captures what will be built,
+# Active work plan maintained by plan. Each plan captures what will be built,
 # why, constraints, scope boundaries, design approach, tasks with dependencies
 # and acceptance criteria, overall acceptance, and surprises.
 #
@@ -41,12 +41,12 @@ meta:
   name: plan
   version: "1.0.0"
   description: >-
-    Active work plan. Produced by planera and updated by plan executors.
+    Active work plan. Produced by plan and updated by plan executors.
     Consumed by capabilities that inspect or execute plan state.
   artifact_type: agent_facing
   path: ".agentera/plan.yaml"
-  producer: [orkestrera, planera, realisera]
-  consumers: [hej, inspektera, orkestrera, planera, realisera]
+  producer: [orchestrate, plan, build]
+  consumers: [status, audit, orchestrate, plan, build]
   format: yaml
 
 GROUP_PREFIXES:
@@ -191,7 +191,7 @@ PLAN:
     required: false
     description: >-
       Runtime surprises discovered during plan execution. Populated
-      by realisera when reality diverges from plan. Default: empty.
+      by build when reality diverges from plan. Default: empty.
   7:
     id: PL22
     field: previous_plan_archived

package/bundle/skills/agentera/schemas/artifacts/progress.yaml

@@ -1,7 +1,7 @@
 # Progress Artifact Schema
 #
-# Cycle-by-cycle operational log for realisera. Each entry records what happened
-# in one development cycle: phase, work done, commit, discoveries, verification,
+# Cycle-by-cycle operational log for build. Each entry records what happened
+# in one development cycle: phase, work done, discoveries, verification,
 # next steps, and context envelope.
 #
 # Structural pattern: UPPER_CASE groups with numbered entries and stable IDs,
@@ -16,12 +16,11 @@
 # (type-prefix from heading)            CYCLE.type             PR3
 # **Phase**: <phase>                    CYCLE.phase            PR4
 # **What**: <text>                      CYCLE.what             PR5
-# **Commit**: <hash/N/A>                CYCLE.commit           PR6
-# **Inspiration**: <text>               CYCLE.inspiration      PR7
-# **Discovered**: <text>                CYCLE.discovered       PR8
-# **Verified**: <text>                  CYCLE.verified         PR9
-# **Next**: <text>                      CYCLE.next             PR10
-# **Context**: <text>                   CYCLE.context          PR11
+# **Inspiration**: <text>               CYCLE.inspiration      PR6
+# **Discovered**: <text>                CYCLE.discovered       PR7
+# **Verified**: <text>                  CYCLE.verified         PR8
+# **Next**: <text>                      CYCLE.next             PR9
+# **Context**: <text>                   CYCLE.context          PR10
 # (intent from Context)                 CONTEXT.intent         PT1
 # (constraints from Context)            CONTEXT.constraints    PT2
 # (unknowns from Context)               CONTEXT.unknowns       PT3
@@ -37,12 +36,12 @@ meta:
   name: progress
   version: "1.0.0"
   description: >-
-    Cycle-by-cycle operational log. Produced by realisera. Consumed by
+    Cycle-by-cycle operational log. Produced by build. Consumed by
     capabilities that need recent work history and verification evidence.
   artifact_type: agent_facing
   path: ".agentera/progress.yaml"
-  producer: realisera
-  consumers: [dokumentera, hej, inspektera, optimera, orkestrera, planera, realisera, visionera, visualisera]
+  producer: build
+  consumers: [document, status, audit, optimize, orchestrate, plan, build, vision, design]
   format: yaml
 
 GROUP_PREFIXES:
@@ -105,7 +104,7 @@ COMPACTION:
       Cycles older than 50 are dropped entirely.
   5:
     id: PX5
-    trigger: "When realisera writes a new cycle entry"
+    trigger: "When build writes a new cycle entry"
     description: >-
       Compaction runs when the producing skill writes a new entry.
       If >10 full-detail entries exist, collapse the oldest to one-line.
@@ -172,57 +171,38 @@ CYCLE:
       - "Non-empty string"
   6:
     id: PR6
-    field: commit
-    type: string
-    required: true
-    description: >-
-      Git commit that contains the product change for this cycle—not the commit
-      that last edited progress metadata. Use `pending` until that hash is known;
-      then the product commit hash, optionally with subject (e.g.
-      `abc1234 Speed up pytest suite`). Use `N/A: …` when no product commit was
-      made.
-    validation:
-      - "Non-empty string"
-      - "Use `pending` until the product-change commit hash is known; do not amend solely to backfill this field"
-      - >-
-        Hashes that do not resolve as commit objects in the local clone (another
-        machine's copy, shallow CI checkout, or not yet fetched) are intentionally
-        not flagged by progress validation or `agentera check backfill`; reconcile
-        with a full clone or forward-fill once the product commit exists locally
-  7:
-    id: PR7
     field: inspiration
     type: string
     required: false
     description: >-
       What prompted this cycle. References to active plan tasks,
       decisions, or conventions that drove the work.
-  8:
-    id: PR8
+  7:
+    id: PR7
     field: discovered
     type: string
     required: false
     description: >-
       Unexpected findings during the cycle. Things learned that were
       not known before starting.
-  9:
-    id: PR9
+  8:
+    id: PR8
     field: verified
     type: string
     required: false
     description: >-
       Evidence that the work was verified. Test commands run, validation
       passed, manual checks performed.
-  10:
-    id: PR10
+  9:
+    id: PR9
     field: next
     type: string
     required: false
     description: >-
       What should happen next. Guidance for subsequent cycles.
       Explicit about scope boundaries to prevent scope creep.
-  11:
-    id: PR11
+  10:
+    id: PR10
     field: context
     type: map
     required: true
@@ -293,14 +273,13 @@ VALIDATION:
     severity: error
     description: >-
       Each full-detail cycle entry must have: number, timestamp, type,
-      phase, what, commit, and context (with intent).
+      phase, what, and context (with intent).
     checks:
       - "number is present and is a positive integer"
       - "timestamp is present and matches YYYY-MM-DD HH:MM"
       - "type is present and is a valid commit prefix"
       - "phase is present and is a valid phase name"
       - "what is present and non-empty"
-      - "commit is present"
       - "context is present with intent sub-field"
   3:
     id: PV3

package/bundle/skills/agentera/schemas/artifacts/todo.yaml

@@ -1,6 +1,6 @@
 # Todo Artifact Schema
 #
-# Open issues and tasks maintained by realisera and inspektera. Severity-ranked
+# Open issues and tasks maintained by build and audit. Severity-ranked
 # checklist of work to be done, resolved items, and deferred work.
 #
 # Note: TODO.md is a human-facing Markdown artifact. It remains at the
@@ -16,17 +16,8 @@ meta:
   artifact_type: human_facing
   path: "TODO.md"
   producer:
-    [
-      dokumentera,
-      inspektera,
-      inspirera,
-      optimera,
-      orkestrera,
-      realisera,
-      resonera,
-      visualisera,
-    ]
-  consumers: [hej, all_skills]
+    [document, audit, research, optimize, orchestrate, build, discuss, design]
+  consumers: [status, all_skills]
   format: markdown
 
 GROUP_PREFIXES:
@@ -76,16 +67,17 @@ CONVENTION:
     field: type_tag
     level: advisory
     description: >-
-      Each item should carry a type tag such as [fix], [feat], [chore],
-      [test], [perf], or [docs] for commit-scope alignment and scan
-      discoverability.
+      Each item should carry a type tag such as [fix], [feat], [refactor],
+      [chore], [test], [perf], or [docs] for commit-scope alignment and
+      scan discoverability.
   2:
     id: TC2
     field: version_suffix
     level: advisory
     description: >-
-      Feature and fix items should include a version scope like [fix:2.4.x]
-      or [feat:2.3.x] when the work targets a specific release train.
+      Optional train scope in `[type:train]` form, e.g. `[fix:train]`, when
+      the work targets a specific release train; most common on feat and fix
+      items. Omit the train suffix when the item is not train-scoped.
   3:
     id: TC3
     field: title_format
@@ -95,16 +87,43 @@ CONVENTION:
       either all plain prose or all "**BoldTitle**: description".
   4:
     id: TC4
-    field: resolved_summary
+    field: resolved_checkbox
     level: advisory
     description: >-
-      Resolved items should end with "· resolved by ..." to distinguish
-      completed work from open or deferred items at a glance.
+      Resolved items should use a checked GitHub task-list checkbox
+      (`- [x]`) before the task text. Open items use `- [ ]`. The
+      checkbox state is the canonical completion marker; do not wrap
+      resolved text in Markdown strikethrough.
   5:
     id: TC5
-    field: resolved_strikethrough
+    field: severity_band_policy
+    level: required
+    description: >-
+      Severity band policy: all four severity bands (⇶ Critical, ⇉
+      Degraded, → Normal, ⇢ Annoying) may be header-only when they
+      have no open work. Open items use `- [ ]` only. Resolved items
+      must not appear in severity bands (see TC6). Executable checks
+      live in packages/cli/src/hooks/validateArtifact/markdown.ts
+      `validateMdItems` and packages/cli/src/hooks/compaction/parse.ts.
+  6:
+    id: TC6
+    field: resolved_section_placement
+    level: required
+    description: >-
+      Resolved ledger policy: completed items live only under
+      `## ✓ Resolved` as `- [x] [type:train]` checkboxes. Severity
+      bands must not contain `- [x]` or legacy `~~` strikethrough
+      resolved rows. The compaction gate counts every resolved row
+      (including mis-placed rows until migrated) against the uniform
+      10/40/50 retention cap. `compact --mode fix` migrates mis-placed
+      rows into `## ✓ Resolved` before applying retention.
+  7:
+    id: TC7
+    field: resolved_line_provenance
     level: advisory
     description: >-
-      Resolved items should wrap the original task text in Markdown
-      strikethrough (~~text~~) before the resolution summary, keeping
-      the original intent readable while visually marking it closed.
+      Resolved provenance uses `resolved YYYY-MM-DD` or `resolved @
+      <semver>` after the item description. Do not use `resolved on
+      feat/v3 @ <hash>` or dual-branch hash reconciliation; git history
+      is the archaeology source. Fold the Resolved move into the
+      implementation commit — no follow-up hash-backfill commit.

package/bundle/skills/agentera/schemas/artifacts/vision.yaml

@@ -35,13 +35,13 @@ meta:
   name: vision
   version: "1.0.0"
   description: >-
-    Project vision. Produced by visionera and direction-shaping capabilities.
+    Project vision. Produced by vision and direction-shaping capabilities.
     Consumed by capabilities that need strategic alignment. No compaction:
     vision is not a growing artifact.
   artifact_type: agent_facing
   path: ".agentera/vision.yaml"
-  producer: [inspirera, realisera, resonera, visionera]
-  consumers: [dokumentera, hej, inspektera, orkestrera, planera, realisera, resonera, visionera, visualisera]
+  producer: [research, build, discuss, vision]
+  consumers: [document, status, audit, orchestrate, plan, build, discuss, vision, design]
   format: yaml
 
 GROUP_PREFIXES: