@event4u/agent-config 2.26.0 → 3.0.0

package/.agent-src/rules/size-enforcement.md

@@ -9,6 +9,18 @@ triggers:
   - intent: "create skill"
   - intent: "create command"
   - intent: "create guideline"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # size-enforcement

package/.agent-src/rules/skill-improvement-trigger.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2a"
-description: "After completing a meaningful task — trigger post-task learning capture if pipelines.skill_improvement is enabled"
+description: "After a meaningful task — trigger post-task learning capture if pipelines.skill_improvement is enabled"
 source: package
 triggers:
   - phrase: "after completing"
@@ -9,6 +9,18 @@ triggers:
   - keyword: "pipeline"
 routes_to:
   - "skill:skill-improvement-pipeline"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Skill Improvement Trigger

package/.agent-src/rules/skill-quality.md

@@ -1,12 +1,24 @@
 ---
 type: "auto"
 tier: "mechanical-already"
-description: "Creating, editing, or reviewing skills — minimum quality standard, every skill must be executable, validated, and self-contained"
+description: "Creating/editing/reviewing skills — minimum quality standard; every skill executable, validated, self-contained"
 source: package
 triggers:
   - path_prefix: ".agent-src.uncompressed/skills/"
 routes_to:
   - "guideline:agent-infra/skill-quality-checklist"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Skill Quality

package/.agent-src/rules/slash-command-routing-policy.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "1"
-description: "When user types a slash command like /create-pr, /commit, or pastes command file content"
+description: "User types a slash command like /create-pr, /commit, or pastes command file content"
 source: package
 triggers:
   - keyword: "/create-pr"
@@ -10,6 +10,18 @@ triggers:
   - phrase: "slash command"
 routes_to:
   - "skill:command-routing"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Slash Command Routing Policy

package/.agent-src/rules/symfony-routing.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "3"
-description: "Writing or reviewing Symfony code — DI, bundles, Doctrine, Messenger, Security voters, console commands — route to the symfony-workflow skill"
+description: "Writing/reviewing Symfony — DI, bundles, Doctrine, Messenger, Security voters, console commands — route to symfony-workflow"
 source: package
 triggers:
   - keyword: "symfony"
@@ -10,6 +10,18 @@ triggers:
   - keyword: "messenger"
 routes_to:
   - "skill:symfony-workflow"
+workspaces:
+  - engineering
+packs:
+  - symfony
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: false
+  removable: true
 ---
 
 # Symfony Routing

package/.agent-src/rules/think-before-action.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2b"
-description: "Before coding, modifying, or debugging — analyze first, verify with real tools, never guess or trial-and-error"
+description: "Before coding/modifying/debugging — analyze first, verify with real tools, never guess or trial-and-error"
 alwaysApply: false
 source: package
 load_context:
@@ -10,6 +10,18 @@ triggers:
   - intent: "before coding"
   - intent: "before debugging"
   - intent: "before modifying"
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # think-before-action

package/.agent-src/rules/token-efficiency.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2a"
-description: "When running CLI tools, fetching logs, or producing replies — redirect verbose output, minimize tool calls, keep replies concise"
+description: "Running CLI tools, fetching logs, or producing replies — redirect verbose output, minimize tool calls, keep replies concise"
 alwaysApply: false
 source: package
 load_context:
@@ -10,6 +10,18 @@ triggers:
   - intent: "verbose CLI output"
   - intent: "fetching logs"
   - keyword: "minimize tool calls"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Token Efficiency

package/.agent-src/rules/token-optimizer-maintenance.md

@@ -16,6 +16,18 @@ validator_ignore:
   - type: "substring"
     pattern: ".agent-src.uncompressed/"
     reason: "Rule lists the authoring-tree paths that must stay in sync with the catalog."
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Token Optimizer Maintenance

package/.agent-src/rules/tool-safety.md

@@ -2,11 +2,23 @@
 type: auto
 tier: "2b"
 source: package
-description: "When a skill uses external tools — enforce allowlist, deny-by-default, and no hidden credential patterns"
+description: "Skill uses external tools — enforce allowlist, deny-by-default, no hidden credential patterns"
 triggers:
   - keyword: "allowed_tools"
   - keyword: "tool registry"
   - intent: "external API"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Tool Safety

package/.agent-src/rules/ui-audit-gate.md

@@ -2,7 +2,7 @@
 type: "auto"
 tier: "2b"
 alwaysApply: false
-description: "Writing or editing UI — components, screens, partials, layouts, design tokens — require existing-ui-audit findings before non-trivial UI change"
+description: "Writing/editing UI — components, screens, layouts, design tokens — require existing-ui-audit findings first"
 source: package
 triggers:
   - path_prefix: "resources/views/"
@@ -11,6 +11,18 @@ triggers:
   - keyword: "design token"
 routes_to:
   - "skill:existing-ui-audit"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # UI Audit Gate

package/.agent-src/rules/upstream-proposal.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "2a"
-description: "After creating or significantly improving a skill, rule, guideline, or command — ask if it should be contributed upstream to the shared package"
+description: "After creating or improving a skill/rule/guideline/command — ask if it should be contributed upstream to the shared package"
 source: package
 triggers:
   - phrase: "after creating"
@@ -9,6 +9,18 @@ triggers:
   - keyword: "upstream"
 routes_to:
   - "skill:upstream-contribute"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Upstream Proposal

package/.agent-src/rules/user-interaction.md

@@ -1,7 +1,7 @@
 ---
 type: "auto"
 tier: "3"
-description: "Asking the user a question, presenting options, or summarizing progress — numbered-options Iron Law, single-recommendation rule, progress indicators"
+description: "Asking a question, presenting options, summarizing progress — numbered-options Iron Law, single-recommendation rule, progress indicators"
 alwaysApply: false
 source: package
 load_context:
@@ -10,6 +10,18 @@ triggers:
   - intent: "ask user a question"
   - intent: "numbered options"
   - intent: "summarizing progress"
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # User Interaction

package/.agent-src/rules/user-interrupt-priority.md

@@ -6,6 +6,18 @@ alwaysApply: true
 source: package
 load_context:
   - ../contexts/execution/interrupt-examples.md
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # User-Interrupt Priority

package/.agent-src/rules/verify-before-complete.md

@@ -6,6 +6,18 @@ alwaysApply: true
 source: package
 load_context:
   - ../contexts/execution/verification-mechanics.md
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Verify Before Completion

package/.agent-src/skills/accessibility-auditor/SKILL.md

@@ -5,6 +5,18 @@ personas:
   - frontend-engineer
 source: package
 domain: quality
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # accessibility-auditor

package/.agent-src/skills/activation-design/SKILL.md

@@ -6,6 +6,18 @@ tier: senior
 source: package
 domain: product
 context_spine: [product, customer-segment, funnel-stage]
+workspaces:
+  - product
+packs:
+  - product-discovery
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: false
+  removable: true
 ---
 
 # activation-design

package/.agent-src/skills/adr-create/SKILL.md

@@ -11,6 +11,18 @@ execution:
   command:
     - python3
     - scripts/adr/regenerate_index.py
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # adr-create

package/.agent-src/skills/adversarial-review/SKILL.md

@@ -6,6 +6,18 @@ personas:
 source: package
 domain: quality
 council_depth: deep
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # Adversarial Review

package/.agent-src/skills/agent-docs-writing/SKILL.md

@@ -3,6 +3,18 @@ name: agent-docs-writing
 description: "Use when reading, creating, or updating agent documentation, module docs, roadmaps, or AGENTS.md. Understands the full .augment/, agents/, and copilot-instructions structure."
 source: package
 domain: process
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # agent-docs
@@ -168,7 +180,7 @@ When starting work, read documentation in this order:
 | New module created | Create `app/Modules/{Module}/agents/` with module description |
 | Significant multi-step change | Ask user about creating a roadmap in `agents/roadmaps/` |
 | New convention introduced | Update relevant doc in `./agents/` or `.augment/guidelines/` |
-| Database schema changed | Update `agents/docs/database-setup.md` |
+| Database schema changed | Update `agents/reference/docs/database-setup.md` |
 | Architectural decision made | Use the [`adr-create`](../adr-create/SKILL.md) skill — writes a numbered ADR under `docs/adr/` (or `docs/decisions/`) and regenerates the index |
 
 ## When to update documentation
@@ -185,12 +197,12 @@ After completing a significant code change, run this mental checklist:
 
 | What changed | Doc to check |
 |---|---|
-| Database schema (migration) | `agents/docs/database-setup.md` |
+| Database schema (migration) | `agents/reference/docs/database-setup.md` |
 | New API endpoint | OpenAPI annotations, `AGENTS.md` API section |
 | New module created | Create `app/Modules/{Module}/agents/` |
-| Service/repository signature changed | Check if referenced in `agents/docs/services-and-repos.md` |
+| Service/repository signature changed | Check if referenced in `agents/reference/docs/services-and-repos.md` |
 | New environment variable | `.env.example`, `AGENTS.md` environment section |
-| Docker/compose change | `agents/docs/docker.md`, `Makefile` documentation |
+| Docker/compose change | `agents/reference/docs/docker.md`, `Makefile` documentation |
 | New Artisan command | `AGENTS.md` commands section |
 | New pattern/convention introduced | Relevant guideline in `.augment/guidelines/` |
 

package/.agent-src/skills/agents-md-thin-root/SKILL.md

@@ -7,6 +7,18 @@ execution:
   type: assisted
   handler: internal
   allowed_tools: []
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # agents-md-thin-root
@@ -24,7 +36,7 @@ Use when:
 
 - Edit `.github/copilot-instructions.md` with this skill (use `copilot-agents-optimization` instead).
 - Edit other `.md` files under `.augment/`, `.agent-src.uncompressed/`, or `agents/` with this skill.
-- Add a section to AGENTS.md without first checking whether an outboard target already exists in `agents/contexts/` or `docs/contracts/`.
+- Add a section to AGENTS.md without first checking whether an outboard target already exists in `agents/settings/contexts/` or `docs/contracts/`.
 - Replace prose with a bare link `[label](path)` — every pointer needs a *why*-clause ≥ 60 chars or it does not count toward the 40 % ratio.
 - Reuse the package-root anatomy in the consumer template — caps and target paths differ.
 
@@ -102,7 +114,7 @@ Each answer must fit on one line. The block exists so the root never silently de
 
 ## Procedure — apply Thin-Root to consumer template
 
-Same procedure, applied to `.agent-src.uncompressed/templates/AGENTS.md`. Hard cap shifts to 2,000 / 1,700. The consumer template intentionally lacks the package-self-references — its pointers target files that exist in the **consumer's** repo (`.augment/skills/`, `agents/contexts/`, ...), not this package's authoring tree.
+Same procedure, applied to `.agent-src.uncompressed/templates/AGENTS.md`. Hard cap shifts to 2,000 / 1,700. The consumer template intentionally lacks the package-self-references — its pointers target files that exist in the **consumer's** repo (`.augment/skills/`, `agents/settings/contexts/`, ...), not this package's authoring tree.
 
 ## Gotchas
 

package/.agent-src/skills/ai-council/SKILL.md

@@ -4,6 +4,18 @@ description: "Use when polling external AIs (OpenAI, Anthropic) outside the host
 source: package
 domain: process
 meta_skill: true
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 <!-- cloud_safe: degrade -->
@@ -351,9 +363,9 @@ Three directories, three modes:
 
 | Mode | Path | Format |
 |---|---|---|
-| **Topic-anchored question** (paired with a roadmap or ADR) | `agents/council-questions/<topic-slug>.md` | Markdown |
-| **Topic-anchored response** (paired with the question above) | `agents/council-responses/<topic-slug>.json` | JSON from `council:run --output` |
-| **Ad-hoc session** (no durable artefact yet) | `agents/council-sessions/<UTC-timestamp>.json` | JSON from `council:run --output` |
+| **Topic-anchored question** (paired with a roadmap or ADR) | `agents/runtime/council/questions/<topic-slug>.md` | Markdown |
+| **Topic-anchored response** (paired with the question above) | `agents/runtime/council/responses/<topic-slug>.json` | JSON from `council:run --output` |
+| **Ad-hoc session** (no durable artefact yet) | `agents/runtime/council/sessions/<UTC-timestamp>.json` | JSON from `council:run --output` |
 
 `<topic-slug>` is kebab-case and **must match** the corresponding
 roadmap / ADR slug if one exists (e.g. `path-fixes` mirrors the
@@ -361,10 +373,11 @@ matching `road-to-<topic-slug>` roadmap under `agents/roadmaps/`).
 
 ### Forbidden
 
-- Files at `agents/` root (e.g. `agents/council-question-foo.md`).
+- Files at `agents/` root (e.g. `agents/runtime/council/question-foo.md`).
 - Dot-prefix scratch (e.g. `agents/.council-question-foo.md`).
 - Any other directory below `agents/` (e.g. `agents/scratch/`,
-  `agents/tmp/`).
+  `agents/evidence/notes/`). Operator scratch belongs under
+  `agents/runtime/tmp/` (gitignored).
 - Cross-references from any artefact to specific council files —
   see [`no-roadmap-references`](../../rules/no-roadmap-references.md)
   (council clause). Inline the convergence summary instead, with
@@ -432,10 +445,10 @@ Input modes (`prompt` / `roadmap` / `diff` / `files`) inherit the
 
 **Source citations:**
 * Template shape — Round 2 council verdict
-  (`agents/council-sessions/2026-05-14-ai-council-redesign/round-1.md`,
+  (`agents/runtime/council/sessions/2026-05-14-ai-council-redesign/round-1.md`,
   Opus's lens-adaptive synthesis proposal).
 * Decision/creative split — Round 4 Q4 verdict
-  (`agents/council-sessions/2026-05-14-ai-council-redesign/round-3-responses.json`).
+  (`agents/runtime/council/sessions/2026-05-14-ai-council-redesign/round-3-responses.json`).
   R4 reframed `optimize` as creative because perf trade-offs resist
   pre-templated shape — Performance-wins / Trade-offs /
   Implementation-order is too rigid for the variety of optimize-lens
@@ -540,7 +553,7 @@ per-invocation caps from `ai_council.cost_budget`:
   if the callback returns False or is absent, tags the member
   `daily_budget_exceeded` instead of `cost_budget_exceeded`.
 
-Prices come from `agents/.agent-prices.md` (gitignored, refreshed weekly).
+Prices come from `agents/runtime/.agent-prices.md` (gitignored, refreshed weekly).
 The pricing module bootstraps it from `_default_prices.py` on first
 use and flags it stale when older than the most recent Monday 00:00
 UTC.
@@ -611,7 +624,7 @@ member can refine, agree, or push back on the previous critique
 without seeing which provider produced which point.
 
 The default round count comes from `defaults.min_rounds` in
-`agents/.ai-council.yml` (default `2` so members critique each other
+`agents/settings/.ai-council.yml` (default `2` so members critique each other
 at least once before convergence). The host agent does **not** ask
 "how many rounds?" when the requested count is `<= min_rounds` —
 the settings owner already made that decision. Ask only when a
@@ -703,7 +716,7 @@ between every round so the user can stop the spend at any point.
 | Cost gate | After every round the CLI prints `Spent so far: $X · Next round: ~$Y · Cap: $Z`. `n` exits cleanly with partial results; `y` continues. |
 | Hard cap | If the projected next-round cost would breach `max_total_usd`, `run_debate()` raises `DebateCapExceeded` and the CLI exits with the partial transcript. No silent overrun. |
 | `--continue-as-debate` | Seeds round 1 from an existing `/council default` (or analysis lens) session. No round-1 API calls are billed; round 2+ run normally. Member list must match. |
-| Session files | One file per round under `agents/council-sessions/<slug>/debate-round-NN.md`. |
+| Session files | One file per round under `agents/runtime/council/sessions/<slug>/debate-round-NN.md`. |
 | Anonymisation | Identical to `rounds:N`. The continue-as-debate path also anonymises the seeded round-1 responses when building the round-2 prompt. |
 
 Use this when the artefact is genuinely contentious and the user
@@ -720,7 +733,7 @@ blind spots before synthesis. Inspired by Andrej Karpathy's "ask the
 strongest models to review each other anonymously" pattern; see his
 [talks / threads on inter-model critique](https://karpathy.ai/) and the
 internal verdict in
-`agents/council-sessions/2026-05-14-ai-council-redesign/round-2.md`
+`agents/runtime/council/sessions/2026-05-14-ai-council-redesign/round-2.md`
 (R2 split: one approve-as-flag, one reject-as-default → opt-in only).
 
 Pipeline order when every feature is active:
@@ -733,7 +746,7 @@ Activation — two equivalent paths:
 
 * CLI: `--peer-review` on `council:estimate` or `council:run`.
 * Config: `ai_council.peer_review.enabled: true` in
-  `agents/.ai-council.yml`. Default is `false`.
+  `agents/settings/.ai-council.yml`. Default is `false`.
 
 Mechanics:
 
@@ -777,7 +790,7 @@ swaps.
 | **Outsider** | `openai` | naive-but-sharp questions, beginner's-mind probes |
 | **Executor** | `anthropic` | what ships this quarter, what blocks delivery |
 
-Activation — edit `agents/.ai-council.yml` and flip the advisor's
+Activation — edit `agents/settings/.ai-council.yml` and flip the advisor's
 `enabled: true`. Optional `model: <name>` overrides the bound
 member's default model. An advisor referencing a disabled member
 fails closed at config load — never silently skipped.
@@ -861,7 +874,7 @@ for its own answer.
 ### Session artefact
 
 Every fast-path attempt appends one line to
-`agents/council-sessions/<date>-<slug>/low-impact-resolutions.md`:
+`agents/runtime/council/sessions/<date>-<slug>/low-impact-resolutions.md`:
 
 ```
 2025-05-14T10:00:00Z | resolved | members=2/2 | members(anthropic, openai) cost=$0.0034 | Q=Service vs Repository for this read path?
@@ -875,7 +888,7 @@ headers around canonical lines.
 Re-projection of session log → summary block:
 
 ```
-$ council replay agents/council-sessions/2025-05-14-foo/responses.json --low-impact-stats
+$ council replay agents/runtime/council/sessions/2025-05-14-foo/responses.json --low-impact-stats
 # Low-impact fast-path · session summary
 
 - attempts: 4

package/.agent-src/skills/analysis-autonomous-mode/SKILL.md

@@ -3,6 +3,18 @@ name: analysis-autonomous-mode
 description: "ONLY when user explicitly requests autonomous analysis, deep investigation, multi-step research, or 'dig into this end-to-end without asking me each step' — NOT for normal feature work."
 source: package
 domain: discovery
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # analysis-autonomous-mode