@event4u/agent-config 2.14.0 → 2.15.0

package/.agent-src/commands/agents/user/accept.md

@@ -0,0 +1,117 @@
+---
+name: agents:user-accept
+tier: 2
+cluster: agents
+sub: user
+description: Apply a buffered observation to .agent-user.md after explicit user confirmation; bumps last_updated and drops the applied observations from the buffer.
+disable-model-invocation: true
+suggestion:
+  eligible: false
+  rationale: "Mutates .agent-user.md — only run from /agents user review or explicit user invocation."
+---
+
+# /agents user accept
+
+Apply a buffered observation from
+[`.agent-user.observations.jsonl`](../../../../../docs/contracts/agent-user-schema.md#observation-buffer)
+to `.agent-user.md` after explicit confirmation.
+
+Use when:
+
+- `/agents user review` surfaced an observation worth applying.
+- The user invoked `/agents user accept <field>` directly.
+
+Never runs autonomously — always asks before writing.
+
+## Steps
+
+### 1. Preconditions
+
+```bash
+ls .agent-user.md 2>/dev/null
+ls .agent-user.observations.jsonl 2>/dev/null
+```
+
+Either missing → print "Run `/agents user init` and accumulate
+observations first." and stop.
+
+### 2. Resolve target field
+
+| Invocation | Resolved field |
+|---|---|
+| Handed off from `/agents user review` option 1 | The most-frequent field |
+| `/agents user accept <field>` | `<field>` (must match the schema enum) |
+| `/agents user accept` with no arg | Print the field list, ask which |
+
+Invalid field → print the schema enum and stop.
+
+### 3. Compute proposed change
+
+For the resolved field:
+
+1. Read every matching observation from the buffer.
+2. Pick the **latest** `suggest` value (most recent `ts` wins).
+3. Read the current value from `.agent-user.md`.
+4. If they match, print "No change — current value already matches
+   the latest observation." and skip to step 6.
+
+### 4. Confirm
+
+```
+Apply this change to .agent-user.md?
+
+  field   : {field}
+  current : "{current_value}"
+  proposed: "{proposed_value}"
+  source  : {n} observations between {oldest_ts} and {newest_ts}
+  evidence: {latest_evidence, truncated to 200 chars}
+
+> 1. Apply
+> 2. Skip — keep current value, drop these observations from the buffer
+> 3. Cancel — leave .agent-user.md and buffer untouched
+```
+
+One question per turn. Wait for the user's number.
+
+### 5. Write
+
+On `1. Apply`:
+
+1. Rewrite the targeted field in `.agent-user.md` frontmatter.
+   Preserve every other field byte-for-byte (use a YAML round-trip
+   loader that keeps formatting).
+2. Bump `last_updated` to today (ISO `YYYY-MM-DD`).
+3. Validate the result: schema present, ≤100 lines, privacy floor
+   clean. Any violation → roll back and print the error.
+4. Drop **all** applied observations for that field from the buffer
+   (rewrite the JSONL minus matching lines).
+
+On `2. Skip`: leave `.agent-user.md` untouched but still drop the
+observations for that field from the buffer.
+
+On `3. Cancel`: stop without any write.
+
+### 6. Confirm
+
+```
+✅  .agent-user.md updated ({field}: "{old}" → "{new}", last_updated: YYYY-MM-DD).
+   Buffer: {n} observations removed, {m} remaining.
+```
+
+Do NOT commit. Do NOT auto-chain to a second field.
+
+## Rules
+
+- One field per invocation. The user runs `/agents user accept` again
+  for the next field.
+- Never write without explicit confirmation in step 4.
+- Never bypass the privacy-floor scan, even if the buffer writer
+  already redacted.
+- Mirror the user's language for prompts per
+  [`language-and-tone`](../../../../.agent-src/rules/language-and-tone.md).
+
+## See also
+
+- Schema + buffer contract: [`agent-user-schema § Observation buffer`](../../../../../docs/contracts/agent-user-schema.md#observation-buffer).
+- Parent: [`/agents user`](../user.md).
+- Sibling: [`/agents user review`](review.md), [`/agents user update`](update.md).

package/.agent-src/commands/agents/user/init.md

@@ -0,0 +1,163 @@
+---
+name: agents:user-init
+tier: 2
+cluster: agents
+sub: user
+description: Interactive interview that creates the project-root .agent-user.md from the locked v1 schema (name, language, role, style, voice_sample).
+disable-model-invocation: true
+suggestion:
+  eligible: false
+  rationale: "User-persona bootstrap — only deliberately, never auto-suggested."
+---
+
+# /agents user init
+
+Short interactive interview that creates **`.agent-user.md`** at the
+project root from the locked v1 schema in
+[`docs/contracts/agent-user-schema.md`](../../../../../docs/contracts/agent-user-schema.md).
+
+Use when:
+
+- The user wants the agent to address them by name / nickname / role.
+- A fresh consumer project does not yet have `.agent-user.md`.
+
+Refuses to overwrite an existing file without `--force`.
+
+## Steps
+
+### 1. Precondition checks
+
+```bash
+ls .agent-user.md 2>/dev/null
+ls docs/contracts/agent-user-schema.md 2>/dev/null
+```
+
+| State | Action |
+|---|---|
+| `.agent-user.md` missing | Proceed |
+| `.agent-user.md` exists, no `--force` | Abort; offer `/agents user update` instead |
+| `.agent-user.md` exists, `--force` set | Proceed (will overwrite); back up to `.agent-user.md.bak` first |
+| Schema contract missing | Abort with "package not installed / out of date" hint |
+
+### 2. Pre-fill from `.agent-settings.yml`
+
+If `.agent-settings.yml` exists, read `personal.user_name` and offer
+it as the default for `identity.name`. Do **not** read anything else —
+the persona file is a separate primitive.
+
+### 3. Interview (one question per turn, numbered options)
+
+Ask in this order. Each answer drives one frontmatter field.
+
+1. **Name** — required.
+   `Wie soll ich dich ansprechen? (Name)` / `What name should I use?`
+   Default: pre-fill from step 2 if available.
+
+2. **Nickname** — optional.
+   `Bevorzugter Spitzname für den Chat? (leer = wie Name)` /
+   `Preferred chat nickname? (blank = same as name)`
+
+3. **Language** — required, BCP-47-ish.
+   ```
+   > 1. de — Deutsch
+   > 2. en — English
+   > 3. other — type the code (e.g. "fr", "es")
+   ```
+   Default: detect from the user's last message.
+
+4. **Role** — required, short free-form.
+   `Kurze Rollenbeschreibung (z. B. "founder/engineer", "product manager", "designer")` /
+   `Short role label`
+
+5. **Style — formality**.
+   ```
+   > 1. informal — Du / first-name (default)
+   > 2. formal   — Sie / full name
+   ```
+
+6. **Style — pace**.
+   ```
+   > 1. pragmatic — balanced (default)
+   > 2. thorough  — more verification, longer replies
+   > 3. rapid     — shorter replies, fewer caveats
+   ```
+
+7. **Voice sample** — required.
+   `Paste eine typische Nachricht von dir (1–3 Sätze, im normalen Schreibstil)` /
+   `Paste one typical message of yours (1–3 sentences, your normal style)`
+
+### 4. Privacy-floor sanity check
+
+Before writing, scan the collected `voice_sample` and `role` for:
+
+- Credentials, API keys, tokens, passwords (regex on common formats).
+- Third-party full names that look like contacts (heuristic: capitalized first+last pair near words like "wife", "boss", "kid", "Frau", "Mann", "Chef").
+- Financial figures (currency symbols + numbers).
+- Health/legal status keywords.
+
+Hit → surface the line and ask the user to redact before proceeding.
+Per [`agent-user-schema § Explicit exclusions`](../../../../../docs/contracts/agent-user-schema.md#explicit-exclusions).
+
+### 5. Render and write
+
+Render the frontmatter exactly as locked in the schema. Add an empty
+`# Notes` body. Set `last_updated` to today (ISO date).
+
+```yaml
+---
+version: 1
+identity:
+  name: "..."
+  nickname: "..."          # omit if blank
+language: "..."
+role: "..."
+style:
+  formality: "..."
+  pace: "...""
+voice_sample: |
+  ...
+last_updated: "YYYY-MM-DD"
+---
+
+# Notes
+```
+
+Verify the rendered file is ≤100 lines (it will be — empty Notes body)
+before writing to `.agent-user.md`.
+
+### 6. Gitignore check
+
+If the consumer `.gitignore` does not yet contain `.agent-user.md`,
+print a one-line nudge:
+
+```
+ℹ️  .agent-user.md is not yet in your .gitignore. Run /sync-gitignore to add it.
+```
+
+The package-managed block adds it automatically; this nudge only
+fires when the block is missing or out of date.
+
+### 7. Confirm
+
+Print the file path and a one-line summary:
+
+```
+✅  .agent-user.md written ({n} lines).
+   identity: {nickname or name} · language: {lang} · role: {role} · style: {formality}/{pace}
+```
+
+Do NOT commit. Do NOT run any other `/agents user` sub-sub-command.
+
+## Rules
+
+- One question per turn. Never batch.
+- Numbered options where the answer is enum-like (per
+  [`user-interaction`](../../../../.agent-src/rules/user-interaction.md)).
+- Never invent fields not in the locked v1 schema.
+- Never write third-party PII even if the user pastes it — surface
+  and ask for redaction.
+
+## See also
+
+- Schema: [`agent-user-schema`](../../../../../docs/contracts/agent-user-schema.md).
+- Parent: [`/agents user`](../user.md).

package/.agent-src/commands/agents/user/review.md

@@ -0,0 +1,107 @@
+---
+name: agents:user-review
+tier: 2
+cluster: agents
+sub: user
+description: List buffered observations from .agent-user.observations.jsonl with numbered options to inspect or accept individually.
+disable-model-invocation: true
+suggestion:
+  eligible: true
+  trigger_description: "review user observations, see what the agent learned about me, list buffered persona updates"
+  trigger_context: "user wants to see what the agent has buffered about their preferences before applying changes"
+---
+
+# /agents user review
+
+List the buffered observations in `.agent-user.observations.jsonl`
+and let the user choose which to inspect or accept.
+
+Use when:
+
+- You want to see what the agent has learned about your preferences.
+- You suspect `.agent-user.md` is out of date and want a curated
+  diff before editing.
+- You want to dismiss observations the agent collected.
+
+Read-only by itself — actual changes go through
+[`/agents user accept`](accept.md) or
+[`/agents user update`](update.md).
+
+## Steps
+
+### 1. Locate buffer
+
+```bash
+ls .agent-user.observations.jsonl 2>/dev/null
+```
+
+| State | Action |
+|---|---|
+| Missing or empty | Print "No buffered observations. The agent has not learned anything new." and stop |
+| Present | Proceed |
+
+### 2. Parse + group
+
+Read every line as JSON. Drop malformed lines silently (one-line
+warning at the end with the count). Group by `field`:
+
+```
+.agent-user.observations.jsonl — {n} observations across {k} fields
+
+  1. style.pace          ({n}× since {oldest_ts})
+     latest suggest: "rapid" — evidence: user said 'mach kürzer' 3× this session
+  2. identity.nickname   ({n}× since {oldest_ts})
+     latest suggest: "Matze" — evidence: user signed last 3 messages "— Matze"
+  3. language            ({n}× since {oldest_ts})
+     latest suggest: "de" — evidence: last 12 messages in German, .agent-user.md says "en"
+```
+
+Sort by frequency (most observations first), then by recency.
+
+### 3. Ask
+
+```
+> 1. Accept the most-frequent suggestion ({field} → {value})
+> 2. Inspect a specific field
+> 3. Clear the buffer (discard all)
+> 4. Cancel
+```
+
+| Choice | Action |
+|---|---|
+| 1 | Hand off to [`/agents user accept`](accept.md) with the chosen field |
+| 2 | Print every observation for that field with evidence + ts, then re-ask |
+| 3 | Truncate `.agent-user.observations.jsonl` to zero bytes; print confirmation |
+| 4 | Stop without changes |
+
+One question per turn. Wait for the user's number.
+
+### 4. Privacy-floor verify
+
+Before printing any observation's `evidence` text, scan it for the
+[exclusions list](../../../../../docs/contracts/agent-user-schema.md#explicit-exclusions).
+Match → replace the offending substring with `[redacted]` in the
+rendered output.
+
+The buffer writer is expected to redact on write, but treat this as
+defense in depth — the user must never see leaked third-party PII or
+credentials from a downstream agent's bad write.
+
+### 5. Stop
+
+Do NOT commit. Do NOT auto-chain past one user-selected action per
+turn.
+
+## Rules
+
+- Read-only on `.agent-user.md`. Only `accept` writes to the persona
+  file.
+- Buffer is the only mutable artefact (truncate via option 3).
+- Mirror the user's language for prompts per
+  [`language-and-tone`](../../../../.agent-src/rules/language-and-tone.md).
+
+## See also
+
+- Schema + buffer contract: [`agent-user-schema § Observation buffer`](../../../../../docs/contracts/agent-user-schema.md#observation-buffer).
+- Parent: [`/agents user`](../user.md).
+- Sibling: [`/agents user accept`](accept.md), [`/agents user update`](update.md).

package/.agent-src/commands/agents/user/show.md

@@ -0,0 +1,109 @@
+---
+name: agents:user-show
+tier: 2
+cluster: agents
+sub: user
+description: Read-only render of .agent-user.md — prints the persona summary the host agent loads at session start.
+disable-model-invocation: true
+suggestion:
+  eligible: true
+  trigger_description: "show user persona, render .agent-user.md, print who the user is"
+  trigger_context: "user wants to see what's currently in .agent-user.md without editing"
+---
+
+# /agents user show
+
+Read-only render of the project-root `.agent-user.md` per
+[`docs/contracts/agent-user-schema.md`](../../../../../docs/contracts/agent-user-schema.md).
+
+Use when:
+
+- You want to see what persona the host agent currently loads.
+- You want to confirm `last_updated` is fresh (≤90 days).
+- You want a paste-ready summary for handoff or onboarding.
+
+Does **not** edit, observe, or buffer anything. Pure read.
+
+## Steps
+
+### 1. Locate the file
+
+```bash
+ls .agent-user.md 2>/dev/null
+```
+
+| State | Action |
+|---|---|
+| Present | Proceed |
+| Missing | Print "No `.agent-user.md` found at project root. Run `/agents user init` to create one." and stop |
+
+### 2. Parse frontmatter
+
+Parse the YAML frontmatter and the body (everything after the second
+`---`). Validate against the locked v1 schema:
+
+- `version` is `1`.
+- `identity.name`, `language`, `role`, `style.formality`, `style.pace`,
+  `voice_sample`, `last_updated` are all present.
+- File is ≤100 lines total.
+
+Any violation → print a one-line warning identifying the missing /
+malformed field and continue with the render (so the user can fix it
+via `/agents user update`).
+
+### 3. Render
+
+Print the persona in this exact shape:
+
+```
+.agent-user.md  ({n} lines, last_updated: YYYY-MM-DD{staleness_marker})
+
+  Identity   : {nickname or name}  ({name} if nickname is set)
+  Language   : {language}
+  Role       : {role}
+  Style      : {formality} · {pace}
+
+  Voice sample
+  ─────────────
+  {voice_sample, indented 2 spaces}
+
+  Notes
+  ─────────────
+  {body, indented 2 spaces; "(empty)" if no notes}
+```
+
+Where `{staleness_marker}` is:
+
+- empty when `last_updated` is within 90 days.
+- ` ⚠️  >90 days` when older (per the schema staleness rule).
+
+### 4. Loader hint
+
+If the host-agent loader has NOT yet picked up the file this session
+(detect via session memory if available), print one line:
+
+```
+ℹ️  Host agent will load this on next session start. Restart your chat to apply.
+```
+
+Otherwise omit — agent already knows.
+
+### 5. Stop
+
+Do NOT chain to other `/agents user *` commands. Do NOT commit.
+
+## Rules
+
+- Read-only. Never write `.agent-user.md` from this command.
+- Never print fields the schema does not define — even if they exist
+  in the file. (Forward-compat: an unexpected field is a warning, not
+  a render target.)
+- Mirror the user's language for the rendered labels (`Identity` /
+  `Identität`, `Language` / `Sprache`, etc.) per
+  [`language-and-tone`](../../../../.agent-src/rules/language-and-tone.md).
+
+## See also
+
+- Schema: [`agent-user-schema`](../../../../../docs/contracts/agent-user-schema.md).
+- Parent: [`/agents user`](../user.md).
+- Sibling: [`/agents user init`](init.md), [`/agents user update`](update.md).

package/.agent-src/commands/agents/user/update.md

@@ -0,0 +1,98 @@
+---
+name: agents:user-update
+tier: 2
+cluster: agents
+sub: user
+description: Open .agent-user.md in the user's IDE for manual edit; validates schema and 100-line cap on save.
+disable-model-invocation: true
+suggestion:
+  eligible: true
+  trigger_description: "edit user persona, update .agent-user.md, change nickname, change language, refresh voice sample"
+  trigger_context: "user wants to manually edit the persona file rather than answer interview questions"
+---
+
+# /agents user update
+
+Open `.agent-user.md` in the user's IDE for a manual edit, then
+validate against the locked v1 schema on save.
+
+Use when:
+
+- The user knows exactly what they want to change (nickname, language,
+  voice sample) and doesn't need the interview flow.
+- The user wants to edit the freeform `# Notes` body.
+- `/agents user show` flagged a malformed field.
+
+For agent-driven changes from buffered observations, use
+[`/agents user review`](review.md) → [`/agents user accept`](accept.md).
+
+## Steps
+
+### 1. Precondition
+
+```bash
+ls .agent-user.md 2>/dev/null
+```
+
+Missing → print "No `.agent-user.md` found. Run `/agents user init`
+first." and stop.
+
+### 2. Open in IDE
+
+Use the [`file-editor`](../../../../.agent-src/skills/file-editor/SKILL.md)
+skill — reads `personal.ide` from `.agent-settings.yml` (vscode,
+phpstorm, cursor, etc.) and opens the file.
+
+If `personal.ide` is unset or `auto_open_files: false`, print:
+
+```
+ℹ️  Open .agent-user.md in your editor and re-run /agents user update --validate when done.
+```
+
+### 3. Wait for save → validate
+
+When called with `--validate` (or after the user confirms "done"):
+
+1. Read `.agent-user.md`.
+2. Parse frontmatter; check every required field per
+   [`agent-user-schema § Field reference`](../../../../../docs/contracts/agent-user-schema.md#field-reference).
+3. Check file size ≤100 lines.
+4. Run the privacy-floor scan (same as `init` step 4): credentials,
+   third-party PII, financial figures, health/legal status.
+
+| Result | Action |
+|---|---|
+| All checks pass | Bump `last_updated` to today; print one-line confirmation |
+| Schema violation | Print the offending field + line, ask user to fix |
+| >100 lines | Print line count, ask user to trim |
+| Privacy-floor hit | Print the suspect line, ask user to redact |
+
+### 4. Bump `last_updated`
+
+On successful validation, rewrite the `last_updated` field with
+today's date (ISO `YYYY-MM-DD`). Preserve all other content
+verbatim.
+
+### 5. Confirm
+
+```
+✅  .agent-user.md validated ({n} lines, last_updated: YYYY-MM-DD).
+```
+
+Do NOT commit. Do NOT chain to another `/agents user *` command.
+
+## Rules
+
+- Never edit `.agent-user.md` directly from this command except for
+  the `last_updated` bump in step 4. All other edits go through the
+  user's IDE.
+- Never write third-party PII even if it appears in the user's edit —
+  re-surface and ask for redaction.
+- Mirror the user's language for all prompts per
+  [`language-and-tone`](../../../../.agent-src/rules/language-and-tone.md).
+
+## See also
+
+- Schema: [`agent-user-schema`](../../../../../docs/contracts/agent-user-schema.md).
+- Parent: [`/agents user`](../user.md).
+- Sibling: [`/agents user init`](init.md), [`/agents user show`](show.md), [`/agents user review`](review.md).

package/.agent-src/commands/agents/user.md

@@ -0,0 +1,66 @@
+---
+name: agents:user
+tier: 2
+cluster: agents
+sub: user
+description: User-persona file (.agent-user.md) — interview, render, and maintain who the user is and how they want to be addressed.
+disable-model-invocation: true
+type: orchestrator
+suggestion:
+  eligible: true
+  trigger_description: "create user persona, render .agent-user.md, review observations, accept observations, edit user file"
+  trigger_context: "user wants to bootstrap or maintain the .agent-user.md persona file (name, language, role, style, voice sample)"
+---
+
+# /agents user
+
+Sub-dispatcher for the user-persona file
+[`/.agent-user.md`](../../../docs/contracts/agent-user-schema.md) — a
+single, project-root, gitignored Markdown file that captures who the
+user is and how they want the agent to address them.
+
+**Why this is its own cluster:** `AGENTS.md` describes the *project*
+to the agent. `.agent-user.md` describes the *user* to the agent.
+Two distinct primitives — same `/agents` family for discoverability,
+separate sub-commands for separation of concerns.
+
+## Sub-sub-commands
+
+| Sub-sub-command | Routes to | Purpose |
+|---|---|---|
+| `/agents user init` | `commands/agents/user/init.md` | Short interview → creates `.agent-user.md` |
+| `/agents user show` | `commands/agents/user/show.md` | Read-only render of the persona |
+| `/agents user review` | `commands/agents/user/review.md` | List buffered observations from `.agent-user.observations.jsonl` |
+| `/agents user accept` | `commands/agents/user/accept.md` | Apply a buffered observation with confirmation |
+| `/agents user update` | `commands/agents/user/update.md` | Open in IDE for manual edit; validate on save |
+
+Schema contract:
+[`docs/contracts/agent-user-schema.md`](../../../docs/contracts/agent-user-schema.md).
+
+## Dispatch
+
+1. Parse the user's argument: `/agents user <sub-sub-command> [args]`.
+2. Look up the sub-sub-command in the table above.
+3. Load the routed file and follow its `## Steps` section verbatim
+   with the remaining args.
+4. Unknown or missing sub-sub-command → print the table above and
+   ask which one. **One sub-sub-command per turn**; do not chain.
+
+## Rules
+
+- **Do NOT commit, push, or open a PR** unless the sub-sub-command
+  explicitly authorizes it.
+- **Do NOT write third-party PII** — names, dates, financial figures,
+  health/legal status. See the
+  [exclusions list](../../../docs/contracts/agent-user-schema.md#explicit-exclusions).
+- **Do NOT introduce network code** in this package. External
+  enrichment is rejected for v1 — see the
+  [determinism floor](../../../docs/contracts/agent-user-schema.md#determinism-floor).
+- **Edit `.agent-src.uncompressed/` only.** `.agent-src/` and
+  `.augment/` regenerate from source.
+
+## See also
+
+- [`agent-user-schema`](../../../docs/contracts/agent-user-schema.md) — locked v1 frontmatter and field reference.
+- [`/agents`](../AGENTS.md) — parent cluster.
+- [`/agents init`](init.md) — project-side bootstrap (separate primitive).

package/.agent-src/commands/agents.md

@@ -28,6 +28,7 @@ agent infrastructure (rules, skills, pointers).
 | `/agents init` | `commands/agents/init.md` | Bootstrap the agent layer — create `AGENTS.md` + tool stubs from the canonical template |
 | `/agents optimize` | `commands/agents/optimize.md` | Refactor `AGENTS.md` to the Thin-Root contract; propagate to multi-tool stubs |
 | `/agents audit` | `commands/agents/audit.md` | Read-only health check — token overhead, rule triggers, AGENTS.md health, stale references |
+| `/agents user` | `commands/agents/user.md` | User-persona file (`.agent-user.md`) — interview, render, maintenance |
 
 Sub-command names match the locked contract in
 [`docs/contracts/command-clusters.md`](../docs/contracts/command-clusters.md).
@@ -43,6 +44,7 @@ Sub-command names match the locked contract in
    > 1. init — bootstrap AGENTS.md + tool stubs
    > 2. optimize — refactor AGENTS.md to the Thin-Root contract
    > 3. audit — read-only health check on the agent layer
+   > 4. user — manage `.agent-user.md` (user-persona file)
 
 ## Rules
 

package/.agent-src/templates/agents/agent-project-settings.example.yml

@@ -39,7 +39,7 @@ schema_version: 1
 # CI guard: a release bump of `package.json` must update this value
 # in lockstep — see scripts/check_template_pin_drift.py (road-to-
 # portable-runtime-and-update-check P3.3).
-agent_config_version: "2.13.0"
+agent_config_version: "2.14.0"
 
 # --- Project identity ---
 project:

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "2.14.0",
+    "version": "2.15.0",
     "keywords": [
       "agent-config",
       "skills",
@@ -53,6 +53,12 @@
         "./.claude/skills/agents-init",
         "./.claude/skills/agents-md-thin-root",
         "./.claude/skills/agents-optimize",
+        "./.claude/skills/agents-user",
+        "./.claude/skills/agents-user-accept",
+        "./.claude/skills/agents-user-init",
+        "./.claude/skills/agents-user-review",
+        "./.claude/skills/agents-user-show",
+        "./.claude/skills/agents-user-update",
         "./.claude/skills/ai-council",
         "./.claude/skills/analysis-autonomous-mode",
         "./.claude/skills/analysis-skill-router",

package/CHANGELOG.md

@@ -607,6 +607,35 @@ our recommendation order, not its support status.
 > that forces a new era split (`# Era: 2.12.x`, etc.) — see
 > [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
 
+## [2.15.0](https://github.com/event4u-app/agent-config/compare/2.14.0...2.15.0) (2026-05-15)
+
+### Features
+
+* **agent-user:** add /agents user command cluster (init, show, review, accept, update) ([15d53d8](https://github.com/event4u-app/agent-config/commit/15d53d8d9a2365b044831cd42127e247a70d7e20))
+* **agent-user:** add v1 schema contract for .agent-user.md persona file ([64f4eab](https://github.com/event4u-app/agent-config/commit/64f4eab62ccf6a2606fbca0c56d398372c05a7a0))
+
+### Bug Fixes
+
+* **agent-user:** inline council-reference summary per no-roadmap-references ([ee4d3ce](https://github.com/event4u-app/agent-config/commit/ee4d3cedf9f4429450d21ca5badc2ae5c2ecaaed))
+* **agent-user:** drop roadmap references per no-roadmap-references rule ([c8ade8d](https://github.com/event4u-app/agent-config/commit/c8ade8d7c5b495e0e4295aa0cb801e59076ee0b0))
+* **agent-user:** adjust keep-beta-until to fit 90-day window ([801b365](https://github.com/event4u-app/agent-config/commit/801b365117a2d1efb4505e504bdd730e4cbbc217))
+
+### Documentation
+
+* **persona:** README section + agent-settings legacy-fallback note ([4da7629](https://github.com/event4u-app/agent-config/commit/4da7629f1f0b5a35a64d0a861040ad8639a66ebe))
+* **roadmap:** mark step-3-agent-user-persona phases as in-progress ([f29d3bc](https://github.com/event4u-app/agent-config/commit/f29d3bce2380c0ea9c67e6094540b88d920ed9ff))
+
+### Chores
+
+* **roadmap:** close out + archive step-3-agent-user-persona ([09c0229](https://github.com/event4u-app/agent-config/commit/09c0229efd67af9cad7b2ca8202f4caa351d028d))
+* **ownership:** regenerate file-ownership-matrix for /agents user ([128890d](https://github.com/event4u-app/agent-config/commit/128890d880584704b4842a398555dd979ae54462))
+* **docs:** bump command count from 109 to 115 ([f8c61b1](https://github.com/event4u-app/agent-config/commit/f8c61b1d0ec48034e0d66e8d32534056ca4aa1f0))
+* **template:** bump agent_config_version pin to 2.14.0 ([fcb885f](https://github.com/event4u-app/agent-config/commit/fcb885fd19bdbca46ef91ec4d5e723cc6c186c6d))
+* **index:** regenerate agents/index.md + docs/catalog.md for /agents user ([56b281d](https://github.com/event4u-app/agent-config/commit/56b281d69960d3e57adbd24b9ec6fd24fc1a5aff))
+* **agent-user:** regenerate compressed sources + claude tool stubs ([f79b6d1](https://github.com/event4u-app/agent-config/commit/f79b6d1cfcf1caccde4a723ad779c65d9ed87198))
+
+Tests: 4352 (+12 since 2.14.0)
+
 ## [2.14.0](https://github.com/event4u-app/agent-config/compare/2.13.0...2.14.0) (2026-05-15)
 
 ### Features

package/README.md

@@ -7,7 +7,7 @@ Give your AI agents an audit-disciplined orchestration contract — testing, Git
 > Your agent picks up the project's stack, runs tests, prepares PRs, fixes CI — and follows your team's coding standards while doing it. Stack-aware skill sets ship for PHP (Laravel · Symfony · Zend/Laminas), JavaScript (Next.js · React · Node), and cross-stack concerns (API · testing · security · observability).
 
 <p align="center">
-  <strong>210 Skills</strong> · <strong>67 Rules</strong> · <strong>109 Commands</strong> · <strong>72 Guidelines</strong> · <strong>22 Personas</strong> · <strong>5 Advisors</strong> · <strong>8 AI Tools</strong>
+  <strong>210 Skills</strong> · <strong>67 Rules</strong> · <strong>115 Commands</strong> · <strong>72 Guidelines</strong> · <strong>22 Personas</strong> · <strong>5 Advisors</strong> · <strong>8 AI Tools</strong>
 </p>
 
 ---
@@ -524,7 +524,7 @@ kernel set: [`docs/contracts/kernel-membership.md`](docs/contracts/kernel-member
 | [`/jira-ticket`](.agent-src/commands/jira-ticket.md) | Read ticket from branch, implement feature |
 | [`/compress`](.agent-src/commands/compress.md) | Compress skills for token efficiency |
 
-→ [Browse all 109 active commands](.agent-src/commands/)
+→ [Browse all 115 active commands](.agent-src/commands/)
 
 ---
 
@@ -556,7 +556,7 @@ slash-commands) &nbsp; 📌 = informational marker only (no auto-discovery
 or manual wiring required)
 
 > **What this means in practice:** Claude Code gets the full project-scoped
-> package (rules + 210 skills + 109 native commands); Augment Code gets the
+> package (rules + 210 skills + 115 native commands); Augment Code gets the
 > same content but only from a single global install at `~/.augment/`.
 > Cursor, Cline, Windsurf, Gemini CLI, GitHub Copilot, Roo Code, Codex CLI,
 > and Continue.dev only get the **rules** natively; skills and commands are
@@ -605,6 +605,21 @@ for the per-rule routing.
 
 ---
 
+## User persona (`.agent-user.md`)
+
+A project-root `.agent-user.md` file captures who the user is — name,
+primary language, role, work style, and a single voice sample — so the
+agent can address them correctly from the first turn. The file is
+gitignored by default, paste-only, and contains zero PII beyond what the
+user explicitly volunteers. Schema is locked v1 in
+[`docs/contracts/agent-user-schema.md`](docs/contracts/agent-user-schema.md).
+
+Create it interactively with `/agents user init`. Inspect with
+`/agents user show`. Updates happen only through the explicit
+`review` / `accept` / `update` flow — never silent auto-writes. The
+legacy `personal.user_name` key in `.agent-settings.yml` stays as a
+fallback when `.agent-user.md` is absent.
+
 ## Core Principles
 
 - **Analyze before implementing** — no guessing, no blind edits

package/config/agent-settings.template.yml

@@ -40,6 +40,10 @@ personal:
   open_edited_files: false
 
   # User's first name — used to address the user personally
+  # NOTE (legacy fallback): Source of truth for user identity is now the
+  # project-root `.agent-user.md` file, created via `/agents user init`.
+  # This key is retained for backward compatibility; the agent only falls
+  # back to it when `.agent-user.md` is absent.
   user_name: ""
 
   # rtk (Rust Token Killer) installed for output filtering (true, false)

package/config/gitignore-block.txt

@@ -18,6 +18,17 @@
 .agent-settings
 .agent-settings.backup.key-value
 
+# Agent config — user-persona file (.agent-user.md, written by /agents user init)
+# Contains who the user is and how they want to be addressed. Local-only by
+# default; commit explicitly only via the deferred --shared opt-in.
+# See docs/contracts/agent-user-schema.md.
+.agent-user.md
+.agent-user.md.bak
+
+# Agent config — user-persona observation buffer (append-only JSONL,
+# never shared). Feeds /agents user review / accept only.
+.agent-user.observations.jsonl
+
 # Agent config — persistent chat history (crash recovery, never commit)
 /agents/.agent-chat-history
 /agents/.agent-chat-history.bak

package/docs/architecture.md

@@ -143,7 +143,7 @@ note, package-internal path-swap, description budget, and the
 |---|---|---|
 | **Skills** | 210 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
 | **Rules** | 67 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
-| **Commands** | 109 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
+| **Commands** | 115 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
 | **Guidelines** | 72 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
 | **Templates** | 7 | Scaffolds for features, roadmaps, contexts, skills, overrides |
 | **Contexts** | 5 | Shared knowledge about the system itself |

package/docs/catalog.md

@@ -1,6 +1,6 @@
 # agent-config — Public Catalog
 
-Consumer-facing catalog of all **455 public artefacts** shipped by
+Consumer-facing catalog of all **461 public artefacts** shipped by
 this package. Internal package-maintenance rules and deprecation shims
 are excluded.
 
@@ -291,7 +291,7 @@ are excluded.
 | rule | [`user-interaction`](../.agent-src/rules/user-interaction.md) | auto | Asking the user a question, presenting options, or summarizing progress — numbered-options Iron Law, single-recommendation rule, progress indicators |
 | rule | [`verify-before-complete`](../.agent-src/rules/verify-before-complete.md) | always | Verify before completion — run tests and quality tools before claiming done |
 
-## Commands (109)
+## Commands (115)
 
 | kind | name | cluster | description |
 |---|---|---|---|
@@ -300,6 +300,12 @@ are excluded.
 | command | [`agents:audit`](../.agent-src/commands/agents/audit.md) | cluster: agents | Audit agent infrastructure — token overhead, rule triggers, AGENTS.md health, Capability-over-Structure adherence, stale references. Read-only, suggest-only, never auto-apply. |
 | command | [`agents:init`](../.agent-src/commands/agents/init.md) | cluster: agents | Initialize the agent layer for a consumer project — creates AGENTS.md and .github/copilot-instructions.md from package templates, auto-detects stack, never leaks other projects' identifiers. |
 | command | [`agents:optimize`](../.agent-src/commands/agents/optimize.md) | cluster: agents | Refactor AGENTS.md to the Thin-Root contract (caps, pointer ratio, capability bullets, emergency-triage) and propagate to tool stubs. Suggest only, never auto-apply. |
+| command | [`agents:user-accept`](../.agent-src/commands/agents/user/accept.md) | cluster: agents | Apply a buffered observation to .agent-user.md after explicit user confirmation; bumps last_updated and drops the applied observations from the buffer. |
+| command | [`agents:user-init`](../.agent-src/commands/agents/user/init.md) | cluster: agents | Interactive interview that creates the project-root .agent-user.md from the locked v1 schema (name, language, role, style, voice_sample). |
+| command | [`agents:user-review`](../.agent-src/commands/agents/user/review.md) | cluster: agents | List buffered observations from .agent-user.observations.jsonl with numbered options to inspect or accept individually. |
+| command | [`agents:user-show`](../.agent-src/commands/agents/user/show.md) | cluster: agents | Read-only render of .agent-user.md — prints the persona summary the host agent loads at session start. |
+| command | [`agents:user-update`](../.agent-src/commands/agents/user/update.md) | cluster: agents | Open .agent-user.md in the user's IDE for manual edit; validates schema and 100-line cap on save. |
+| command | [`agents:user`](../.agent-src/commands/agents/user.md) | cluster: agents | User-persona file (.agent-user.md) — interview, render, and maintain who the user is and how they want to be addressed. |
 | command | [`agents`](../.agent-src/commands/agents.md) | cluster: agents | Agent-layer orchestrator — routes to init, optimize, audit. Covers AGENTS.md and its multi-tool stubs (CLAUDE.md, GEMINI.md, copilot-instructions.md, .cursorrules). |
 | command | [`analyze-reference-repo`](../.agent-src/commands/analyze-reference-repo.md) |  | Analyze an external reference repository (competitor, inspiration, peer) and produce a structured comparison + adoption plan for this project. |
 | command | [`bug-fix`](../.agent-src/commands/bug-fix.md) |  | Plan and implement a bug fix — based on investigation, with quality checks and test verification |

package/docs/contracts/agent-user-schema.md

@@ -0,0 +1,165 @@
+---
+stability: beta
+keep-beta-until: 2026-08-13
+---
+
+# `.agent-user.md` schema (v1)
+
+> **Status:** beta — locked for `1.18.0`. Re-evaluate fields after
+> Phase 3 has been in active use for ≥1 week.
+
+`.agent-user.md` is a single, project-root, gitignored Markdown file
+that captures who the user is and how they want the agent to address
+them. It is **deliberately minimal in v1** — name, language, role,
+style, and a single voice sample. Everything else is deferred until
+usage signal exists.
+
+The file is owned by the user. The agent never edits it without an
+explicit `accept` step.
+
+## Locked frontmatter (v1)
+
+```yaml
+---
+version: 1
+identity:
+  name: "Mathias"          # required — full name or how the user wants to be addressed
+  nickname: "Matze"        # optional — preferred shorthand (used by default in chat)
+language: "de"             # required — BCP-47-ish primary language ("de", "en", "fr", ...)
+role: "founder/engineer"   # required — short free-form role label
+style:
+  formality: "informal"    # informal | formal
+  pace: "pragmatic"        # pragmatic | thorough | rapid
+voice_sample: |            # required — one paste of the user's typical writing
+  Mach das einfach. Wenn unklar, frag im Council.
+last_updated: "2026-05-15" # YYYY-MM-DD — bumped on every accepted change
+---
+```
+
+After the frontmatter, the body is a single freeform **`# Notes`**
+section. Hard cap: **100 lines** total file size (including
+frontmatter, body, and the Notes section). The 100-line cap is
+enforced by `/agents user accept` and `/agents user update`.
+
+## Field reference
+
+| Field | Required | Purpose |
+|---|---|---|
+| `version` | yes | Schema version. v1 is the only valid value today. |
+| `identity.name` | yes | Default address form. |
+| `identity.nickname` | no | Preferred shorthand — agent uses this by default in chat replies when set. |
+| `language` | yes | Primary language; the agent mirrors per [`language-and-tone`](../../.agent-src/rules/language-and-tone.md). |
+| `role` | yes | Short free-form label — drives reviewer voice selection and persona pairing. |
+| `style.formality` | yes | `informal` (Du / first-name) or `formal` (Sie / full name). |
+| `style.pace` | yes | `pragmatic` (default), `thorough` (more verification), or `rapid` (shorter replies). |
+| `voice_sample` | yes | One representative paste — anchors mirror-back and tone calibration. |
+| `last_updated` | yes | ISO date, bumped on every accept. |
+
+## Explicit exclusions
+
+The agent NEVER writes any of the following to `.agent-user.md`, even
+with the user's explicit consent — they violate the privacy floor:
+
+- Credentials, API keys, passwords, tokens.
+- Third-party names (children, partners, colleagues, clients).
+- Third-party birthdays or dates.
+- Financial figures (salary, revenue, net worth, runway numbers).
+- Health, legal, or therapy status.
+- Demographics (relationship status, family context, age, location) —
+  **deferred to v2** pending usage data per the re-validation gate.
+- LinkedIn URL or any other external-source identifier — **deferred**
+  until a written host-agent-fetch contract and a "what counts as a
+  public profile field" privacy floor exist.
+
+## Loader contract
+
+Host agents read `.agent-user.md` at session start, in this priority
+order:
+
+1. `.agent-user.md` at project root (this contract).
+2. `personal.user_name` in `.agent-settings.yml` (legacy fallback).
+3. Nothing — agent uses generic address forms.
+
+The host agent surfaces the user's `identity.nickname` (or `name` if
+unset) on first reply when the file is present.
+
+## Determinism floor
+
+The `agent-config` package itself contains **zero network code**.
+External enrichment (e.g. LinkedIn profile fetch) was rejected on
+determinism / ToS / test-impossibility grounds, and the host-agent
+delegation workaround was additionally rejected on contract-floor
+grounds (AI Council convergence — Anthropic, OpenAI, Google · 2026-05-14).
+v1 is paste-only via `/agents user init`.
+
+## Staleness
+
+When `last_updated` is older than 90 days, any `/agents user *`
+command surfaces a one-line warning (not a blocker):
+
+```
+⚠️  .agent-user.md was last updated YYYY-MM-DD (>90 days ago). Run /agents user review or /agents user update.
+```
+
+## Commands
+
+| Command | Role |
+|---|---|
+| `/agents user init` | Creates the file from a short interview. Refuses overwrite without `--force`. |
+| `/agents user show` | Read-only render. (Phase 2.) |
+| `/agents user review` | List buffered observations. (Phase 3.) |
+| `/agents user accept` | Apply selected observations; bumps `last_updated`. (Phase 3.) |
+| `/agents user update` | Open in IDE for manual edit; validates on save. (Phase 3.) |
+
+See [`command-clusters.md`](command-clusters.md) for the locked
+cluster registration.
+
+## Observation buffer
+
+Agents MAY append observations about the user (preferred reply style,
+detected language drift, repeated correction patterns) to a separate
+JSONL buffer at the project root:
+
+```
+.agent-user.observations.jsonl
+```
+
+The buffer is **append-only**, gitignored, and never read by the
+host-agent loader directly. It only feeds `/agents user review` →
+`/agents user accept`.
+
+Each line is a single JSON object:
+
+```json
+{"ts":"2026-05-15T10:23:00Z","field":"style.pace","suggest":"rapid","source":"chat","evidence":"user said 'mach kürzer' 3× this session"}
+```
+
+Allowed `field` values mirror the schema (`identity.nickname`,
+`language`, `role`, `style.formality`, `style.pace`, `voice_sample`,
+`notes`). Anything outside that set is dropped on read.
+
+Privacy floor applies on write — never buffer credentials, third-party
+PII, financial figures, or health/legal status. The same
+[exclusions list](#explicit-exclusions) governs both `.agent-user.md`
+and the buffer.
+
+## Gitignore
+
+`.agent-user.md` and `.agent-user.observations.jsonl` are added to the
+package-managed `.gitignore` block
+([`config/gitignore-block.txt`](../../config/gitignore-block.txt)) and
+ignored by default. A `--shared` opt-in to commit `.agent-user.md` is
+deferred — only the doc note lands in v1. The observation buffer is
+**never** shared.
+
+## Example
+
+A complete, paste-ready fixture lives at
+[`docs/examples/agent-user.example.md`](../examples/agent-user.example.md).
+Copy it to the project root as `.agent-user.md` and edit, or run
+`/agents user init` for the interactive flow.
+
+## See also
+
+- [`language-and-tone`](../../.agent-src/rules/language-and-tone.md) — language-mirroring rule the loader feeds.
+- [`agents-md-thin-root`](../../.agent-src/skills/agents-md-thin-root/SKILL.md) — Thin-Root contract that this file complements (user-state vs project-state).

package/docs/contracts/command-clusters.md

@@ -32,7 +32,7 @@ column 1 of this table.
 | `optimize` | 1 | `agents-dir` · `augmentignore` · `rtk` · `skills` | `optimize-augmentignore` · `optimize-rtk-filters` · `optimize-skills` · former `/optimize agents` and `/optimize agents-md` moved to the `/agents` file-family cluster 2026-05-09; `/agents prepare/audit/cleanup` collapsed into the single `/optimize agents-dir` (flags or wizard) per the agent-doc consolidation |
 | `feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` · `dev` | `feature-explore` · `feature-plan` · `feature-refactor` · `feature-roadmap` · `feature-dev` |
 | `chat-history` | 2 | `show` · `import` · `learn` | `chat-history` (legacy status) — `resume` / `clear` / `checkpoint` removed in `road-to-chat-history-hook-only` (auto-adopt + structural hooks); `import` (verbatim cross-session render) and `learn` (project-improving learning extraction) added in the v4 stateless schema |
-| `agents` | 2 | `init` · `optimize` · `audit` | AGENTS.md file family (high-frequency) — repurposed 2026-05-09: `init` (was `/copilot-agents init`) · `optimize` (merger of `/optimize agents-md` + `/copilot-agents optimize`) · `audit` (was `/optimize agents`, collapses old `audit` + `check` verbs); legacy folder ops (`prepare` / `cleanup` / folder-`audit`) moved to `/optimize agents-dir` |
+| `agents` | 2 | `init` · `optimize` · `audit` · `user` | AGENTS.md file family (high-frequency) — repurposed 2026-05-09: `init` (was `/copilot-agents init`) · `optimize` (merger of `/optimize agents-md` + `/copilot-agents optimize`) · `audit` (was `/optimize agents`, collapses old `audit` + `check` verbs); legacy folder ops (`prepare` / `cleanup` / folder-`audit`) moved to `/optimize agents-dir`; `user` sub-cluster added 2026-05-15 — manages the project-root `.agent-user.md` persona file (sub-sub-commands: `init` · `show` · `review` · `accept` · `update`) per [`agent-user-schema`](agent-user-schema.md) |
 | `memory` | 2 | `add` · `load` · `promote` · `propose` · `mine-session` · `learn-low-impact` | `memory-add` · `memory-full` · `memory-promote` · `propose-memory`; `mine-session` added 2026-05-10 — manual transcript-mining sub-command from `road-to-dream-skill-adoption.md`, opt-in via `--confirm-transcript-access` per invocation; `learn-low-impact` added 2026-05-15 — upstreams `## Validated` entries from `agents/low-impact-decisions.md` to the package seed via a DRAFT PR (re-runs the privacy-floor redactor as a second gate per `low-impact-corpus-privacy-floor`) |
 | `roadmap` | 2 | `create` · `ai-council` · `process-step` · `process-phase` · `process-full` | `roadmap-create` · `roadmap-execute` (replaced — autonomous, no per-step gate; `process-phase` is the default execution scope); `ai-council` added 2026-05-07 — wraps `/council default` with `--input-mode roadmap --depth deep` |
 | `module` | 2 | `create` · `explore` | `module-create` · `module-explore` |

package/docs/contracts/file-ownership-matrix.json

@@ -39,6 +39,42 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/commands/agents/user.md": {
+      "kind": "command",
+      "rule_type": "orchestrator",
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/agents/user/accept.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/agents/user/init.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/agents/user/review.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/agents/user/show.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/agents/user/update.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/commands/analyze-reference-repo.md": {
       "kind": "command",
       "rule_type": null,
@@ -2902,6 +2938,160 @@
       "via": "body_link",
       "depth": 1
     },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user.md",
+      "target": ".agent-src.uncompressed/commands/agents/init.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user.md",
+      "target": ".agent-src.uncompressed/commands/agents/user.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/accept.md",
+      "target": ".agent-src.uncompressed/commands/agents/user.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/accept.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/accept.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/accept.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/review.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/accept.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/init.md",
+      "target": ".agent-src.uncompressed/commands/agents/user.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/init.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/init.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/review.md",
+      "target": ".agent-src.uncompressed/commands/agents/user.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/review.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/accept.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/review.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/review.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/review.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/show.md",
+      "target": ".agent-src.uncompressed/commands/agents/user.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/show.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/init.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/show.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/show.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/show.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "target": ".agent-src.uncompressed/commands/agents/user.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/accept.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/init.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/review.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/show.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "target": ".agent-src.uncompressed/commands/agents/user/update.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/commands/analyze-reference-repo.md",
       "target": ".agent-src.uncompressed/commands/analyze-reference-repo.md",

package/docs/examples/agent-user.example.md

@@ -0,0 +1,21 @@
+---
+version: 1
+identity:
+  name: "Mathias"
+  nickname: "Matze"
+language: "de"
+role: "founder/engineer"
+style:
+  formality: "informal"
+  pace: "pragmatic"
+voice_sample: |
+  Mach das einfach. Wenn unklar, frag im Council. Tokenverbrauch ist ok,
+  aber stell mir keine Fragen — entscheide oder frag die AIs.
+last_updated: "2026-05-15"
+---
+
+# Notes
+
+Pragmatic shipper. Prefers terse replies, real diffs, and named
+trade-offs over hedged options. Council-first for anything that looks
+like a contract decision.

package/docs/getting-started.md

@@ -146,7 +146,7 @@ Your agent now understands slash commands:
 | `/quality-fix` | Run and fix all quality checks |
 | `/chat-history` | Inspect the persistent chat-history log (read-only `show`) |
 
-→ [Browse all 109 active commands](../.agent-src/commands/)
+→ [Browse all 115 active commands](../.agent-src/commands/)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@event4u/agent-config",
-    "version": "2.14.0",
+    "version": "2.15.0",
     "description": "Shared agent configuration \u2014 skills, rules, commands, guidelines, and templates for AI coding tools",
     "license": "MIT",
     "private": false,