@event4u/agent-config 6.0.0 → 7.0.0

package/dist/agent-src/commands/knowledge/cross-repo.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: knowledge-cross-repo
 pack: product-discovery
 tier: 2
+visibility: internal
 cluster: knowledge
 sub: cross-repo
 description: Targeted, read-only retrieval over opted-in linked-project siblings (ADR-032 Option A). Pulls a shared type / API contract / config without bulk-including sibling files.
@@ -44,7 +45,7 @@ concept (≥ 1 term > 2 chars). A `--path-scope` glob narrows the search and is
 ### 2. Run the retrieval
 
 ```bash
-python3 scripts/cross_repo_retrieve.py "<query>" [--path-scope <glob>] [--max-chunks 8]
+./scripts-run src/scripts/cross_repo_retrieve "<query>" [--path-scope <glob>] [--max-chunks 8]
 ```
 
 The script reads opted-in siblings only, runs a targeted path-glob + content

package/dist/agent-src/commands/knowledge/forget.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: knowledge-forget
 pack: product-discovery
 tier: 2
+visibility: internal
 cluster: knowledge
 sub: forget
 description: Drop a knowledge ingest from `agents/memory/knowledge/` by id prefix. Atomic, no partial state. Pinning protects from LRU eviction, not from explicit forget — pinned ingests are dropped the same.

package/dist/agent-src/commands/knowledge/ingest.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: knowledge-ingest
 pack: product-discovery
 tier: 2
+visibility: internal
 cluster: knowledge
 sub: ingest
 description: Walk a local path (folder, .zip, single file), redact PII + secrets, chunk to 2 KB markdown, and persist into the agent memory namespace under `knowledge/<ingest-id>/`.

package/dist/agent-src/commands/knowledge/list.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: knowledge-list
 pack: product-discovery
 tier: 2
+visibility: internal
 cluster: knowledge
 sub: list
 description: List existing knowledge ingests in `agents/memory/knowledge/` (table or JSON); pin / unpin by id prefix to control LRU eviction.

package/dist/agent-src/commands/knowledge.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: knowledge
 pack: product-discovery
 tier: 2
+visibility: internal
 description: Knowledge orchestrator — routes to ingest, list, forget. Local-only file ingestion into the agent memory namespace.
 cluster: knowledge
 type: orchestrator

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

@@ -1,11 +1,12 @@
 ---
 model_tier: medium
 name: memory-add
-pack: meta
+pack: memory
 tier: 2
+visibility: internal
 cluster: memory
 sub: add
-description: Interactively add a validated entry to an engineering-memory file (domain-invariants, architecture-decisions, incident-learnings, product-rules)
+description: Interactively add a validated entry to an engineering-memory file (domain-invariants, incident-learnings, product-rules, ownership, historical-patterns)
 skills: [file-editor]
 suggestion:
   eligible: true
@@ -14,7 +15,7 @@ suggestion:
 workspaces:
   - agent-config-maintainer
 packs:
-  - meta
+  - memory
 ---
 
 # /memory add
@@ -41,9 +42,10 @@ the first write and for every subsequent addition.
 > Which memory type is this entry for?
 >
 > 1. domain-invariants  — architectural boundaries, module rules
-> 2. architecture-decisions — ADR-style decisions with alternatives
-> 3. incident-learnings — post-mortem patterns with guardrails
-> 4. product-rules — intentional business constraints
+> 2. incident-learnings — post-mortem patterns with guardrails
+> 3. product-rules — intentional business constraints
+>
+> (Architecture decisions belong in ADRs — `docs/decisions/` — not memory.)
 ```
 
 If the user cannot pick one confidently, stop and ask what the entry
@@ -109,7 +111,7 @@ On confirmation:
 ### 6. Cross-link
 
 If the entry has a `references:` block pointing to a skill, rule, or
-ADR file, run `python3 scripts/check_references.py` to verify the
+ADR file, run `./scripts-run src/scripts/check_references` to verify the
 link resolves. Broken link → block and ask the user to fix.
 
 ## When to reject

package/dist/agent-src/commands/memory/learn-low-impact.md

@@ -1,8 +1,9 @@
 ---
 model_tier: medium
 name: memory-learn-low-impact
-pack: meta
+pack: memory
 tier: 2
+visibility: internal
 cluster: memory
 sub: learn-low-impact
 skills: [ai-council, upstream-contribute]
@@ -14,7 +15,7 @@ suggestion:
 workspaces:
   - agent-config-maintainer
 packs:
-  - meta
+  - memory
 ---
 
 # /memory learn-low-impact

package/dist/agent-src/commands/memory/load.md

@@ -1,8 +1,9 @@
 ---
 model_tier: medium
 name: memory-load
-pack: meta
+pack: memory
 tier: 2
+visibility: internal
 cluster: memory
 sub: load
 description: Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analysis, never auto-triggered
@@ -13,7 +14,7 @@ suggestion:
 workspaces:
   - agent-config-maintainer
 packs:
-  - meta
+  - memory
 ---
 
 # /memory load
@@ -40,11 +41,10 @@ in the entry count and the signal-to-noise degrades fast on large types.
 > Which memory type should I load in full?
 >
 > 1. domain-invariants
-> 2. architecture-decisions
-> 3. incident-learnings
-> 4. product-rules
-> 5. historical-patterns
-> 6. ownership
+> 2. incident-learnings
+> 3. product-rules
+> 4. historical-patterns
+> 5. ownership
 ```
 
 ### 1b. Surface the Tier-0 critical slice

package/dist/agent-src/commands/memory/mine-session.md

@@ -1,11 +1,12 @@
 ---
 model_tier: medium
 name: memory-mine-session
-pack: meta
+pack: memory
 tier: 2
+visibility: internal
 cluster: memory
 sub: mine-session
-description: Mine the active session transcript for memory signals (corrections, preferences, decisions, recurring patterns) — preview-by-default, opt-in transcript access, host-agnostic via TranscriptAdapter.
+description: Mine a session (cross-host chat-history log) for memory signals and/or rule/skill proposal seeds via --mode=[signals|proposals|both]. Preview-default, opt-in. Folds in /chat-history learn.
 skills: [memory-consolidation, file-editor]
 suggestion:
   eligible: false
@@ -13,15 +14,28 @@ suggestion:
 workspaces:
   - agent-config-maintainer
 packs:
-  - meta
+  - memory
 ---
 
 # /memory mine-session
 
-Runs the **GATHER SIGNAL** phase of the [`memory-consolidation`](../../skills/memory-consolidation/SKILL.md)
-loop against the current host's transcripts and surfaces normalised
-project-scoped facts as a preview. No file is written without
-`--commit-intake`. No transcript is read without
+The **single session-mining command**. Runs the **GATHER SIGNAL** phase of
+the [`memory-consolidation`](../../skills/memory-consolidation/SKILL.md) loop
+against the **cross-host chat-history JSONL log**
+(`agents/runtime/.agent-chat-history`, written by platform hooks on every
+host) — falling back to the per-host Claude-Code transcript when the log is
+absent — and surfaces normalised project-scoped facts as a preview.
+
+`--mode` selects the output:
+
+- **`signals`** (default) — normalised facts → intake preview / `--commit-intake`.
+- **`proposals`** — frames the facts as candidate rule/skill learnings, then
+  run [`learning-to-rule-or-skill`](../../skills/learning-to-rule-or-skill/SKILL.md)
+  on each seed to draft proposals. **This folds in the former
+  `/chat-history learn`.**
+- **`both`** — render signals + proposal seeds together.
+
+No file is written without `--commit-intake`. No source is read without
 `--confirm-transcript-access`.
 
 ## When to use
@@ -41,11 +55,13 @@ and confirmed.
 
 | Flag | Default | Purpose |
 |---|---|---|
+| `--mode <signals\|proposals\|both>` | `signals` | Output selector. `signals` → intake facts; `proposals` → proposal seeds for `learning-to-rule-or-skill`; `both` → both. |
+| `--source <auto\|chat-history\|claude-code>` | `auto` | `auto` prefers the cross-host chat-history log, then the Claude-Code transcript. |
 | `--since <ISO-date>` | 14 days ago | Only mine turns at or after this date. Re-anchors relative phrases like "yesterday" with `YYYY-MM-DD`. |
 | `--confirm-transcript-access` | off | Opt-in gate. Without it, the miner reads zero turns and prints the opt-in hint. Per-invocation, not persistent. |
-| `--preview` | on | Render normalised facts to stdout. No file write. Default behaviour. |
-| `--commit-intake` | off | Mutually exclusive with `--preview`. Append normalised facts to `agents/memory/intake/<primary-tag>.jsonl`. |
-| `--host <claude-code\|cursor\|augment>` | auto-detect | Force the `TranscriptAdapter`. Phase 1 ships `claude-code` only; others print `not-supported-on-this-host` and exit. |
+| `--preview` | on | Render to stdout. No file write. Default behaviour. |
+| `--commit-intake` | off | `signals` only. Append normalised facts to `agents/memory/intake/<primary-tag>.jsonl`. |
+| `--host <name>` | auto-detect | Labels the source host. The chat-history log is cross-host, so any host mines via it; `claude-code` additionally resolves the local transcript fallback. |
 
 ## Steps
 
@@ -91,6 +107,17 @@ If the normalised count exceeds 5, **stop after the 5th** and print:
 
 This is the strict-gate exit per the skill's exit criteria.
 
+**Failure-mode review lens** (adapted from MemSkill, Apache-2.0). Before
+emitting a fact, ask which failure it prevents — and drop it if it prevents
+none:
+
+- **Storage failure** — a durable fact the next agent will need was never
+  written. Capture it.
+- **Retrieval failure** — the fact exists but its `key` / anchor path won't
+  match how a future skill queries. Fix the anchor, don't duplicate.
+- **Quality failure** — the fact is too vague or narrative to act on. Sharpen
+  it to one durable PATTERN / INVARIANT / GOTCHA, or drop it.
+
 ### 4. Render preview
 
 Print one Markdown block to stdout:
@@ -153,5 +180,5 @@ Confirm:
   `TranscriptAdapter` matches the current host.
 - [`memory:promote`](promote.md) — lifts validated intake lines into
   curated YAML.
-- [`agent-memory-contract`](../../../docs/contracts/agent-memory-contract.md) —
-  intake JSONL schema, including the `tags` field.
+- [`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md) —
+  file-backed retrieval contract for curated + intake entries.

package/dist/agent-src/commands/memory/promote.md

@@ -1,8 +1,9 @@
 ---
 model_tier: medium
 name: memory-promote
-pack: meta
+pack: memory
 tier: 2
+visibility: internal
 cluster: memory
 sub: promote
 description: Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the admission gate.
@@ -13,7 +14,7 @@ suggestion:
 workspaces:
   - agent-config-maintainer
 packs:
-  - meta
+  - memory
 ---
 
 # /memory promote

package/dist/agent-src/commands/memory/propose.md

@@ -1,8 +1,9 @@
 ---
 model_tier: medium
 name: memory-propose
-pack: meta
+pack: memory
 tier: 2
+visibility: internal
 cluster: memory
 sub: propose
 description: Append a provisional memory signal to the intake stream — the universal fallback for any producer (human or agent) to record a finding without committing to a curated entry.
@@ -13,7 +14,7 @@ suggestion:
 workspaces:
   - agent-config-maintainer
 packs:
-  - meta
+  - memory
 ---
 
 # /memory propose
@@ -35,8 +36,9 @@ not yet justify a human reviewer's attention.
 
 Do NOT use when:
 
-- The entry is a **decision** — go to [`/memory-add`](memory-add.md)
-  with `architecture-decisions` or `product-rules`.
+- The entry is a **product decision** — go to [`/memory-add`](memory-add.md)
+  with `product-rules`. (Architecture decisions belong in ADRs —
+  `docs/decisions/` — not memory.)
 - The finding contradicts an existing curated entry — open a
   supersede-chain discussion instead.
 
@@ -51,8 +53,7 @@ Do NOT use when:
 > 2. incident-learnings  — a post-mortem guardrail
 > 3. ownership           — a path → team mapping
 > 4. domain-invariants   — a module boundary rule
-> 5. architecture-decisions — a decision to revisit
-> 6. product-rules       — an intentional constraint
+> 5. product-rules       — an intentional constraint
 ```
 
 ### 2. Gather minimum fields

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

@@ -2,11 +2,12 @@
 model_tier: medium
 name: memory
 disable-model-invocation: true
-pack: meta
+pack: memory
 intent: "Manage the agent memory layer — add, load, promote, propose"
 routes_to: [memory-add, memory-load, memory-promote, memory-propose]
 replaces: []
 tier: 1
+visibility: advanced
 description: Memory orchestrator — routes to add, load, mine-session, promote, propose
 cluster: memory
 type: orchestrator
@@ -17,7 +18,7 @@ suggestion:
 workspaces:
   - agent-config-maintainer
 packs:
-  - meta
+  - memory
 ---
 
 # /memory

package/dist/agent-src/commands/mission/upgrade.md

@@ -0,0 +1,182 @@
+---
+model_tier: medium
+name: mission-upgrade
+pack: engineering-base
+intent: "Upgrade a Laravel application one major version (10→11, 11→12) via the gated /work engine with a structured breaking-change catalog"
+routes_to: [dependency-upgrade]
+replaces: []
+tier: 1
+visibility: advanced
+skills: [dependency-upgrade]
+framework: laravel
+description: Gated Laravel major-version upgrade mission — provisional branch, breaking-change catalog, size-tier surfaced, git-as-rollback. Never auto-commits or auto-PRs.
+suggestion:
+  eligible: true
+  trigger_description: "upgrade Laravel to version X, Laravel 10 to 11 upgrade, bump framework major version"
+  trigger_context: "composer.json present with a laravel/framework constraint and user asks for a major version bump"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - engineering-base
+disable-model-invocation: true
+---
+
+# /mission:upgrade
+
+## Overview
+
+Structured, catalog-driven Laravel major-version upgrade through the existing gated `/work` engine. **Not** a new autonomous runtime:
+
+- Every phase uses `/work`'s confidence-band gating, N=3 retry budget, persisted `.work-state.json`.
+- Rollback = git. Changes land on a provisional branch (`mission/upgrade-…`); revert is `git reset` or `git revert`, never a daemon.
+- No auto-commit, no auto-PR. User reviews before anything is staged.
+
+## Single-mission-per-branch guard
+
+Before starting, confirm:
+
+1. Working tree clean (`git status --porcelain` empty).
+2. No other `mission/*` branch checked out.
+3. No `.work-state.json` with a mission envelope present.
+
+Any fail → surface the conflict and stop. Run:
+
+```bash
+python3 src/scripts/lint_missions.ts --check-precondition upgrade .
+```
+
+(Currently a documented stub — full live-repo check lands in Phase 1 PoC.)
+
+## Inputs
+
+| Input | Required | Description |
+|---|---|---|
+| `target_version` | Yes | Target major version to upgrade to (`11`, `12`, …) |
+| `framework` | No (default: `laravel`) | Framework slug — auto-detected from `composer.json` |
+
+## Execution flow
+
+### 1. Resolve inputs
+
+Accept inline arguments:
+
+```
+/mission:upgrade 11
+/mission:upgrade target_version=11 framework=laravel
+```
+
+`target_version` missing → ask once (numbered options per [`user-interaction`](../../rules/user-interaction.md)).
+
+### 2. Surface the size tier
+
+Read `size_tier` from `src/missions/upgrade/mission.yaml`; display before starting:
+
+```
+> Mission: upgrade Laravel {from} → {target_version}
+> Size tier: standard (touches public API and configuration)
+> Provisional branch: mission/upgrade-laravel-{from}-to-{target_version}
+>
+> 1. Proceed on a new branch
+> 2. Adjust size tier — I'll override
+> 3. Abort
+```
+
+`standard` is the floor for upgrade missions (public API + config changes).
+
+### 3. Create the provisional branch
+
+```bash
+git checkout -b mission/upgrade-laravel-{from}-to-{target_version}
+```
+
+Per [`scope-control`](../../rules/scope-control.md), requires explicit user confirmation (step 2 provides it).
+
+### 4. Load the breaking-change catalog
+
+Read `src/missions/upgrade/laravel-10-to-11.yaml` (or the matching version). Lists breaking changes with `detection`, `fix`, `verification` command blocks restricted to safe prefixes (`composer`, `php`, `php artisan`, `git`, `sed`, `rector`, `vendor/bin/*`).
+
+### 5. Drive the /work engine
+
+```bash
+./agent-config work \
+    --state-file .work-state.json \
+    --prompt-file prompt.txt
+```
+
+Write a structured prompt to `prompt.txt` describing the mission phases (`analyze` → `plan` → `implement` → `test` → `verify` → `report`) referencing the catalog entries the engine should address.
+
+**Candidate phase (opt-in, never auto-on):** the `test` → `verify` step MAY use
+[`verify-repair-loop`](../../skills/verify-repair-loop/SKILL.md) when the upgrade's
+catalog fixes are test-driven — a bounded generate→run→revise→re-run loop gated by
+a numeric threshold (then a judge confirms), reusing the same N=3 cap. Use
+test/quality verdicts only; the live-app Playwright verdict stays deferred. The
+loop is multi-turn reasoning, not a runtime — honors
+[`no-runtime-boundary`](../../docs/contracts/no-runtime-boundary.md) exactly as the
+mission does.
+
+Handle exit codes per the `/work` contract:
+
+| Exit | Meaning | Action |
+|---|---|---|
+| `0` | SUCCESS — final report on stdout | Go to step 6 |
+| `1` | BLOCKED — halt surface on stdout | Inspect `questions[0]`, respond, re-run |
+| `2` | Config/IO error | Surface stderr to the user, stop |
+
+### 6. Rollback path
+
+Fix step fails beyond the N=3 budget:
+
+```bash
+git revert HEAD        # revert the last mission commit
+# or
+git reset --hard HEAD~1  # if no remote tracking the branch yet
+```
+
+Rollback is always manual — the mission surfaces the command, never auto-runs it.
+
+### 7. Final report and close-prompt
+
+On `/work` exit `0`, surface the delivery report unchanged, then append:
+
+```
+> Mission: upgrade complete. Review the changes on branch mission/upgrade-…
+>
+> 1. /commit — stage + commit per the delivery report
+> 2. /create-pr — open a pull request from this branch
+> 3. Keep working — hold the state file for follow-up
+> 4. Discard — delete .work-state.json and reset the branch
+```
+
+Per [`scope-control`](../../rules/scope-control.md), git operations are permission-gated. Never run `/commit` or `/create-pr` without the user choosing them.
+
+## Rules
+
+- Honour [`scope-control`](../../rules/scope-control.md), [`non-destructive-by-default`](../../rules/non-destructive-by-default.md), [`minimal-safe-diff`](../../rules/minimal-safe-diff.md), [`verify-before-complete`](../../rules/verify-before-complete.md).
+- Every catalog `command:` field is restricted to the safe-prefix allowlist. Never run arbitrary shell from the catalog.
+- The N=3 retry budget from [`autonomous-execution`](../../rules/autonomous-execution.md) applies per breaking-change fix step, not per mission.
+- Never skip the size-tier surface step — user must see scope before the provisional branch is created.
+
+## Breaking-change catalog
+
+Knowledge source: `src/missions/upgrade/laravel-10-to-11.yaml`. Versionable, diffable, CI-tested via `lint_missions.py`. Each entry carries:
+
+- `id` — unique checkpoint key (used in `.work-state.json`)
+- `severity` — `critical` / `high` / `medium` / `low`
+- `detection` — how to check if this change affects the project
+- `fix` — how to apply the fix (may reference a Rector rule)
+- `verification` — how to confirm the fix is complete
+
+## See also
+
+- [`/work`](../../work/command.md) — the gated engine this mission drives
+- [`dependency-upgrade`](../../skills/dependency-upgrade/SKILL.md) — the stack-agnostic upgrade skill this mission specialises
+- `src/missions/upgrade/mission.yaml` — the mission manifest
+- `src/missions/upgrade/laravel-10-to-11.yaml` — the breaking-change catalog
+- `src/scripts/lint_missions.ts` — validates the manifest and catalog
+
+## Examples
+
+```
+/mission:upgrade 11
+/mission:upgrade target_version=11
+```

package/dist/agent-src/commands/mode.md

@@ -6,6 +6,7 @@ intent: "Switch the active role-mode (developer/reviewer/tester/po/incident/plan
 routes_to: [role-mode-adherence]
 replaces: []
 tier: 1
+visibility: advanced
 description: Set the active role mode — prints the contract, lists default skills, and refuses work outside the contract (see role-contracts)
 suggestion:
   eligible: false

package/dist/agent-src/commands/module/create.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: module-create
 pack: engineering-base
 tier: 2
+visibility: internal
 cluster: module
 sub: create
 skills: [laravel]

package/dist/agent-src/commands/module/explore.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: module-explore
 pack: engineering-base
 tier: 2
+visibility: internal
 cluster: module
 sub: explore
 skills: [laravel, symfony-workflow, php-coder]

package/dist/agent-src/commands/module.md

@@ -4,6 +4,7 @@ name: module
 disable-model-invocation: true
 pack: engineering-base
 tier: 2
+visibility: internal
 description: Module orchestrator — routes to create, explore
 cluster: module
 type: orchestrator

package/dist/agent-src/commands/optimize/agents-dir.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: optimize-agents-dir
 pack: meta
 tier: 2
+visibility: internal
 cluster: optimize
 sub: agents-dir
 description: Manage the agents/ directory — scaffold, folder-audit, fix. Single command with three modes (--scaffold / --audit / --fix); default = interactive wizard.

package/dist/agent-src/commands/optimize/augmentignore.md

@@ -4,6 +4,7 @@ skills: [agent-docs-writing]
 name: optimize-augmentignore
 pack: meta
 tier: 2
+visibility: internal
 cluster: optimize
 sub: augmentignore
 description: Creates or updates .augmentignore based on the project's actual tech stack, large files, generated artifacts, and irrelevant agent skills/rules.

package/dist/agent-src/commands/optimize/rtk.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: optimize-rtk
 pack: meta
 tier: 2
+visibility: internal
 cluster: optimize
 sub: rtk
 skills: [agent-docs-writing]

package/dist/agent-src/commands/optimize/skills.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: optimize-skills
 pack: meta
 tier: 2
+visibility: internal
 cluster: optimize
 sub: skills
 description: Audits skills — measures baseline, finds duplicates/merge candidates, runs linter. Suggest only, never auto-apply.
@@ -27,7 +28,7 @@ Skill audit: measure, find duplicates/merge candidates, run linter, present find
 ### 1. Measure baseline
 
 ```bash
-total=$(ls -d .agent-src.uncondensed/skills/*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
+total=$(ls -d src/skills/*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
 total_lines=$(cat .agent-src.uncondensed/skills/*/SKILL.md 2>/dev/null | wc -l | tr -d ' ')
 echo "Skills: $total, Total lines: $total_lines"
 
@@ -42,7 +43,7 @@ done | sort -rn | head -15
 ### 2. Run skill linter
 
 ```bash
-python3 scripts/skill_linter.py --pairs --duplicates .agent-src.uncondensed/skills/*/SKILL.md 2>&1 | tail -20
+./scripts-run src/scripts/skill_linter --pairs --duplicates src/skills/*/SKILL.md 2>&1 | tail -20
 ```
 
 Report FAIL/WARN counts. Do NOT fix linter issues here — that's the linter's or `skill-reviewer`'s job.

package/dist/agent-src/commands/optimize-prompt.md

@@ -3,6 +3,7 @@ model_tier: inherit
 name: optimize-prompt
 pack: meta
 tier: 2
+visibility: internal
 cluster: optimize
 description: "Optimize a raw prompt for ChatGPT, Claude, Gemini, or another AI via the 4-D methodology — BASIC vs DETAIL auto-detect, one clarifying question per turn, returns the polished prompt."
 skills: [prompt-optimizer]

package/dist/agent-src/commands/optimize.md

@@ -7,6 +7,7 @@ intent: "Optimization dispatcher — skills, rtk, augmentignore, agents-dir"
 routes_to: [optimize-skills, optimize-rtk, optimize-augmentignore, optimize-agents-dir]
 replaces: []
 tier: 1
+visibility: advanced
 description: Optimize orchestrator — routes to skills, agents-dir, augmentignore, rtk-filters
 cluster: optimize
 type: orchestrator

package/dist/agent-src/commands/orchestrate.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: orchestrate
 pack: meta
 tier: 2
+visibility: internal
 cluster: orchestrate
 skills: [subagent-orchestration]
 description: Run a YAML pipeline defined under `.agent-config/orchestrations/` — chains personas / skills / commands / sub-agents per the orchestration-dsl-v1 contract
@@ -43,7 +44,7 @@ side; this command reads the same shape and dispatches each step.
 Run the linter against the resolved file:
 
 ```
-python3 scripts/lint_orchestration_dsl.py --file <path>
+./scripts-run src/scripts/lint_orchestration_dsl --file <path>
 ```
 
 Exit code ≠ 0 → surface the linter output and stop. **Never** run

package/dist/agent-src/commands/override/create.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: override-create
 pack: meta
 tier: 2
+visibility: internal
 cluster: override
 sub: create
 description: Creates a project-level override for a shared skill, rule, or command.

package/dist/agent-src/commands/override/manage.md

@@ -3,6 +3,7 @@ model_tier: medium
 name: override-manage
 pack: meta
 tier: 2
+visibility: internal
 cluster: override
 sub: manage
 description: Reviews, updates, and refactors existing project-level overrides.