@event4u/agent-config 2.25.0 → 3.0.0

package/.agent-src/commands/fix/portability.md

@@ -8,6 +8,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Package-internal — only the event4u/agent-config repo runs this."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix portability

package/.agent-src/commands/fix/pr-bot-comments.md

@@ -10,6 +10,18 @@ suggestion:
   eligible: true
   trigger_description: "address the Copilot/Greptile comments, fix the bot review feedback"
   trigger_context: "open PR with bot review comments unresolved"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix pr-bot-comments

package/.agent-src/commands/fix/pr-comments.md

@@ -10,6 +10,18 @@ suggestion:
   eligible: true
   trigger_description: "fix all PR review comments, resolve the review feedback"
   trigger_context: "open PR with unresolved comments (bot + human)"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix pr-comments

package/.agent-src/commands/fix/pr-developer-comments.md

@@ -10,6 +10,18 @@ suggestion:
   eligible: true
   trigger_description: "fix the human reviewer comments, address the developer feedback"
   trigger_context: "open PR with unresolved human-reviewer comments"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix pr-developer-comments

package/.agent-src/commands/fix/refs.md

@@ -8,6 +8,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Package-internal — only the event4u/agent-config repo runs this."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix refs

package/.agent-src/commands/fix/seeder.md

@@ -10,6 +10,19 @@ suggestion:
   eligible: true
   trigger_description: "the seeder is broken, foreign key errors in seeders"
   trigger_context: "seeder error output or recent edits in database/seeders/"
+framework: laravel
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix seeder
@@ -64,9 +77,9 @@ where the seeder class is NOT the owner of the data file.
 
 ### Known Exceptions
 
-Currently there are **no exceptions**. All circular deps have been resolved.
+Currently there are **no exceptions**. All circular dependencies have been resolved.
 
-**Pattern for resolving circular deps:** Use two-phase seeding. The data file seeds
+**Pattern for resolving circular dependencies:** Use two-phase seeding. The data file seeds
 records with placeholder values (e.g., empty arrays). The Seeder's `run()` method then updates
 records with the real values using `getReference()`. Since `run()` is called after all seeders
 are initialized, the circular dependency is broken.

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

@@ -9,6 +9,18 @@ suggestion:
   eligible: true
   trigger_description: "fix CI, fix references, fix the broken seeder, fix PR comments, address bot review"
   trigger_context: "user wants to fix something that has a dedicated sub-command"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /fix

package/.agent-src/commands/ghostwriter/delete.md

@@ -3,17 +3,29 @@ name: ghostwriter:delete
 tier: 2
 cluster: ghostwriter
 sub: delete
-description: Hard-delete a ghostwriter profile at agents/ghostwriter/<slug>.md after a two-step confirmation. No backup, no soft delete — the file is gone after acceptance.
+description: Hard-delete a ghostwriter profile at agents/reference/ghostwriter/<slug>.md after a two-step confirmation. No backup, no soft delete — the file is gone after acceptance.
 disable-model-invocation: true
 suggestion:
   eligible: true
   trigger_description: "delete ghostwriter profile, remove public-figure voice, drop ghostwriter, retire captured profile"
-  trigger_context: "user wants to permanently remove a captured ghostwriter profile from agents/ghostwriter/"
+  trigger_context: "user wants to permanently remove a captured ghostwriter profile from agents/reference/ghostwriter/"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:delete
 
-Hard-delete a single `agents/ghostwriter/<slug>.md` profile after a
+Hard-delete a single `agents/reference/ghostwriter/<slug>.md` profile after a
 **two-step confirmation**. The file is gone after acceptance — no
 backup, no soft delete, no trash directory. Mirrors the destructive
 posture of `/agents:user:delete`.
@@ -31,7 +43,7 @@ Argument shapes:
 
 | State | Action |
 |---|---|
-| File missing | Abort. Print: *"No profile at `agents/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
+| File missing | Abort. Print: *"No profile at `agents/reference/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
 | File present, `fictional: true` | Abort. Print: *"`<slug>.md` is a package-side fixture. Delete it via the source tree, not this command."* |
 | File present, real | Proceed to Step 2 |
 
@@ -41,7 +53,7 @@ Show the user **exactly** what is about to disappear, sourced from
 the file's frontmatter (do not render the full profile body):
 
 ```
-About to delete agents/ghostwriter/<slug>.md
+About to delete agents/reference/ghostwriter/<slug>.md
   identity.name:       <name>
   role:                <role_or_title>
   category:            <public_figure_category>
@@ -80,11 +92,11 @@ other input → abort with the same cancel line as Step 3.
 Remove the file. Then print:
 
 ```
-✅  agents/ghostwriter/<slug>.md deleted.
+✅  agents/reference/ghostwriter/<slug>.md deleted.
     /ghostwriter:list now shows N profiles.
 ```
 
-`N` reflects the post-delete count under `agents/ghostwriter/`
+`N` reflects the post-delete count under `agents/reference/ghostwriter/`
 (excluding `README.md`).
 
 ### 6. Stale-warning surface (optional)
@@ -104,7 +116,7 @@ post-write surface in `/ghostwriter:fetch` Step 7. Non-blocking.
   consumer ghostwriter files are gitignored by default.
 - **Do NOT delete package-side fixtures.** `fictional: true` files
   belong to the source tree and are out of scope for this command.
-- **Do NOT delete `agents/ghostwriter/README.md`.** The directory
+- **Do NOT delete `agents/reference/ghostwriter/README.md`.** The directory
   anchor is not a profile.
 - **Do NOT bulk-delete.** One slug per invocation, even when the user
   passes a glob.

package/.agent-src/commands/ghostwriter/fetch.md

@@ -3,18 +3,30 @@ name: ghostwriter:fetch
 tier: 2
 cluster: ghostwriter
 sub: fetch
-description: Build or refresh a public-figure voice profile at agents/ghostwriter/<slug>.md from a URL or bare name; runs the public-figure attestation gate; delegates web-fetch / web-search to the host agent.
+description: Build or refresh a public-figure voice profile under agents/reference/ghostwriter/ from a URL or bare name; runs the public-figure attestation gate; delegates web-fetch/web-search to host.
 disable-model-invocation: true
 suggestion:
   eligible: true
   trigger_description: "fetch public figure writing voice, capture LinkedIn / blog / Substack style, build ghostwriter profile from name, refresh stale profile"
-  trigger_context: "user wants to capture a documented public figure's writing voice from a URL or by name into agents/ghostwriter/<slug>.md"
+  trigger_context: "user wants to capture a documented public figure's writing voice from a URL or by name into agents/reference/ghostwriter/<slug>.md"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:fetch
 
 Build (or refresh) a ghostwriter profile at
-`agents/ghostwriter/<slug>.md` from one of two inputs:
+`agents/reference/ghostwriter/<slug>.md` from one of two inputs:
 
 | Input | Mode | Host-agent capability used |
 |---|---|---|
@@ -37,7 +49,7 @@ Argument shape: `/ghostwriter:fetch <input> [--force-refresh]`.
   (`alice-walker`). If a slug already exists with a different role,
   ask the user for a discriminator suffix (`alice-walker-novelist`).
 
-Existing `agents/ghostwriter/<slug>.md`?
+Existing `agents/reference/ghostwriter/<slug>.md`?
 
 | State | Action |
 |---|---|
@@ -134,7 +146,7 @@ Body: a single `# Notes` section, empty for fresh fetches.
 
 Print the proposed file content as a fenced markdown block. Ask:
 
-> 1. write — save to `agents/ghostwriter/<slug>.md`
+> 1. write — save to `agents/reference/ghostwriter/<slug>.md`
 > 2. edit — open in IDE first (per `file-editor` skill), save after
 > 3. cancel — discard
 
@@ -142,7 +154,7 @@ Only on choice 1 or 2 (after save) write the file. Print the
 post-write summary:
 
 ```
-✅  agents/ghostwriter/<slug>.md written.
+✅  agents/reference/ghostwriter/<slug>.md written.
     confidence: <low|med|high>  ·  sources: <n>  ·  verification: <fetched|user-asserted>
 ```
 
@@ -157,7 +169,7 @@ per-field changes (numbered options). Bump `last_updated` and
 ### 7. Stale-warning surface (always)
 
 After any write (or no-op accept), if any other profile under
-`agents/ghostwriter/*.md` has `source_provenance.last_fetched_at` >
+`agents/reference/ghostwriter/*.md` has `source_provenance.last_fetched_at` >
 90 days old, print one line per stale profile:
 
 ```

package/.agent-src/commands/ghostwriter/list.md

@@ -3,18 +3,30 @@ name: ghostwriter:list
 tier: 2
 cluster: ghostwriter
 sub: list
-description: List captured ghostwriter profiles under agents/ghostwriter/ as a numbered table with confidence, last-fetched, and stale-warning flags. Read-only.
+description: List captured ghostwriter profiles under agents/reference/ghostwriter/ as a numbered table with confidence, last-fetched, and stale-warning flags. Read-only.
 disable-model-invocation: true
 suggestion:
   eligible: true
   trigger_description: "list ghostwriter profiles, show available public-figure voices, which ghostwriters do I have, ghostwriter inventory"
   trigger_context: "user wants to see which ghostwriter profiles exist locally and which are stale"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:list
 
 Read-only listing of every consumer-side ghostwriter profile under
-`agents/ghostwriter/`. Numbered, with the fields needed to pick one
+`agents/reference/ghostwriter/`. Numbered, with the fields needed to pick one
 for `/ghostwriter:write` or to spot stale profiles that need a
 re-fetch.
 
@@ -22,12 +34,12 @@ re-fetch.
 
 ### 1. Scan
 
-Enumerate `agents/ghostwriter/*.md`, excluding:
+Enumerate `agents/reference/ghostwriter/*.md`, excluding:
 
 - `README.md` (directory anchor, not a profile).
 - Any file whose frontmatter carries `fictional: true` (package-side
   fixtures are not consumer profiles; they should never appear in
-  `agents/ghostwriter/` — surface a warning if one is found).
+  `agents/reference/ghostwriter/` — surface a warning if one is found).
 
 For each remaining file, read the frontmatter and extract:
 
@@ -48,7 +60,7 @@ For each remaining file, read the frontmatter and extract:
 Empty result → print and exit:
 
 ```
-No ghostwriter profiles found under agents/ghostwriter/.
+No ghostwriter profiles found under agents/reference/ghostwriter/.
 Run /ghostwriter:fetch <url-or-name> to capture one.
 ```
 
@@ -71,10 +83,10 @@ Column widths are illustrative — pick the widest entry per column.
 ### 3. Fixture leak warning (defensive)
 
 If Step 1 encountered a `fictional: true` file under
-`agents/ghostwriter/`, print **after** the table:
+`agents/reference/ghostwriter/`, print **after** the table:
 
 ```
-⚠️  agents/ghostwriter/<file>.md carries `fictional: true` — fixtures
+⚠️  agents/reference/ghostwriter/<file>.md carries `fictional: true` — fixtures
     belong in the package source, not in consumer ghostwriter/. Move
     or delete this file.
 ```

package/.agent-src/commands/ghostwriter/show.md

@@ -9,11 +9,23 @@ suggestion:
   eligible: true
   trigger_description: "show ghostwriter profile, inspect public-figure voice, view ghostwriter details, what does this profile contain"
   trigger_context: "user wants to inspect a single captured ghostwriter profile before writing with it or deciding to refresh / delete it"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:show
 
-Read-only render of a single `agents/ghostwriter/<slug>.md` profile.
+Read-only render of a single `agents/reference/ghostwriter/<slug>.md` profile.
 Surfaces every field needed to decide whether to consume the voice
 (`/ghostwriter:write`), refresh it (`/ghostwriter:fetch <slug>
 --force-refresh`), or delete it (`/ghostwriter:delete`).
@@ -36,7 +48,7 @@ Resolution table:
 
 | State | Action |
 |---|---|
-| File missing | Abort. Print: *"No profile at `agents/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
+| File missing | Abort. Print: *"No profile at `agents/reference/ghostwriter/<slug>.md`. Run `/ghostwriter:list` to see what exists."* |
 | File present, `fictional: true` | Print a one-line warning before rendering: *"⚠️ This is a package-side fixture, not a real-person profile."* Then render normally. |
 | File present, real | Render (Step 2) |
 

package/.agent-src/commands/ghostwriter/write.md

@@ -9,12 +9,24 @@ suggestion:
   eligible: true
   trigger_description: "draft post in style of public figure, write in someone's voice, ghostwriter draft, LinkedIn post in style of X"
   trigger_context: "user wants to generate a copyable draft in a previously captured public-figure voice with the mandatory disclosure footer"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter:write
 
 Generate a copyable markdown draft in the voice of a captured
-ghostwriter profile under `agents/ghostwriter/<slug>.md`. Implements
+ghostwriter profile under `agents/reference/ghostwriter/<slug>.md`. Implements
 the [`write-engine`](../../../docs/contracts/write-engine.md) contract
 with **mandatory disclosure footer** appended by this command's output
 template (not by the model, no opt-out).
@@ -37,7 +49,7 @@ Argument shapes:
 on) the `aliases:` list of every consumer profile. See
 [`ghostwriter-schema § Aliases`](../../../docs/contracts/ghostwriter-schema.md#aliases).
 
-Scan `agents/ghostwriter/*.md`, excluding `README.md` and any file
+Scan `agents/reference/ghostwriter/*.md`, excluding `README.md` and any file
 with `fictional: true` (fixtures are not consumable from this
 command — they live in the package source as schema examples).
 
@@ -128,7 +140,7 @@ If the selected profile's `source_provenance.last_fetched_at` is
 > 90 days old, print one line **after** the fenced block:
 
 ```
-⚠️  agents/ghostwriter/<slug>.md last fetched YYYY-MM-DD (>90 days). Run /ghostwriter:fetch <slug> --force-refresh.
+⚠️  agents/reference/ghostwriter/<slug>.md last fetched YYYY-MM-DD (>90 days). Run /ghostwriter:fetch <slug> --force-refresh.
 ```
 
 Non-blocking.

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

@@ -9,6 +9,18 @@ suggestion:
   eligible: true
   trigger_description: "fetch a public figure's writing voice, write in someone's style, list ghostwriter profiles, refresh stale profile"
   trigger_context: "user wants to capture or use the public-facing writing voice of a documented public figure for AI-assisted drafting"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /ghostwriter
@@ -80,8 +92,8 @@ Cluster locked in
 
 | Location | Holds | Tracked in git? |
 |---|---|---|
-| `agents/ghostwriter/<slug>.md` (consumer) | Real-person public-figure profiles | **No** — gitignored by default. `--shared` opt-in deferred to v2. |
-| `agents/ghostwriter/README.md` (consumer) | Directory anchor + how-to | Yes |
+| `agents/reference/ghostwriter/<slug>.md` (consumer) | Real-person public-figure profiles | **No** — gitignored by default. `--shared` opt-in deferred to v2. |
+| `agents/reference/ghostwriter/README.md` (consumer) | Directory anchor + how-to | Yes |
 | `.agent-src.uncompressed/ghostwriter/*.md` (package) | `fictional: true` fixtures only | Yes — CI-enforced by `scripts/lint_ghostwriter_source.py` |
 
 Slug = full-name kebab-case with optional `-<discriminator>` suffix

package/.agent-src/commands/grill-me.md

@@ -9,6 +9,18 @@ suggestion:
   eligible: true
   trigger_description: "grill me, grill me on this, grill me on this plan, grill me through this, grill me on the idea, grill me until it's clear, grill me hard"
   trigger_context: "user has a fuzzy plan/idea/feature draft and wants it sharpened interactively rather than reconstructed in one shot"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /grill-me

package/.agent-src/commands/implement-ticket.md

@@ -8,6 +8,18 @@ suggestion:
   eligible: true
   trigger_description: "implement this ticket, setze ticket X um, build PROJ-123"
   trigger_context: "ticket key matching [A-Z]+-[0-9]+ in branch name or prompt"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # implement-ticket

package/.agent-src/commands/jira-ticket.md

@@ -8,6 +8,18 @@ suggestion:
   eligible: true
   trigger_description: "implement the ticket on this branch, work on the Jira ticket from the branch"
   trigger_context: "branch name matching feat/PROJ-123-* or similar"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # jira-ticket

package/.agent-src/commands/judge/on-diff.md

@@ -9,6 +9,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Subagent orchestration — overlaps /work and judge skills; keep explicit."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /judge on-diff

package/.agent-src/commands/judge/solo.md

@@ -9,6 +9,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Sibling of /review-changes — eligibility routed there; keep this explicit."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /judge solo

package/.agent-src/commands/judge/steps.md

@@ -9,6 +9,18 @@ disable-model-invocation: true
 suggestion:
   eligible: false
   rationale: "Subagent orchestration — overlaps /work and /roadmap:process-*; keep explicit."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /judge steps

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

@@ -9,6 +9,18 @@ suggestion:
   eligible: true
   trigger_description: "judge this diff, review with verdict, run an implementer→judge loop, step-by-step judged execution"
   trigger_context: "user wants a verdict on a diff, a do-and-judge loop, or a step-gated execution"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /judge

package/.agent-src/commands/memory/add.md

@@ -10,6 +10,18 @@ suggestion:
   eligible: true
   trigger_description: "remember this for later, add this to engineering memory, capture this learning"
   trigger_context: "post-incident or post-decision conversation"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # /memory add
@@ -137,6 +149,6 @@ Read `verbosity.post_action_reports` from `.agent-settings.yml` (default
 
 - [`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md)
   — full schema
-- [`capture-learnings`](../rules/capture-learnings.md) — when a
-  learning is better captured as an `incident-learnings` entry vs a
-  rule/skill proposal
+- [`skill:learning-to-rule-or-skill`](../skills/learning-to-rule-or-skill/SKILL.md) —
+  when a learning is better captured as an `incident-learnings` entry vs
+  a rule/skill proposal