@event4u/agent-config 2.26.0 → 3.1.0

package/.agent-src/skills/check-refs/SKILL.md

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

package/.agent-src/skills/churn-prevention/SKILL.md

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

package/.agent-src/skills/code-refactoring/SKILL.md

@@ -3,6 +3,18 @@ name: code-refactoring
 description: "Use when the user says 'refactor this', 'rename class', or 'move method'. Safely refactors code in any language — finds all callers, updates downstream dependencies, verifies via quality tools."
 source: package
 domain: engineering
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # refactorer
@@ -19,7 +31,7 @@ Do NOT use when:
 
 ## Before refactoring
 
-1. **Read the agent docs** — check `agents/docs/` and `agents/contexts/` for the area you're refactoring.
+1. **Read the agent docs** — check `agents/reference/docs/` and `agents/settings/contexts/` for the area you're refactoring.
    For modules, also read the project's module-docs directory (path varies by stack — Laravel: `app/Modules/{Module}/agents/`; Nx: `apps/{app}/docs/`; mono-repo: per-package `docs/`). See the `project-docs` skill for the mapping.
 2. **Understand the scope** — what exactly needs to change and why?
 3. **Find ALL references** — use `codebase-retrieval` and `view` with `search_query_regex` to find every
@@ -116,8 +128,8 @@ After the code changes are verified, update all affected documentation:
 
 | Documentation layer | When to update | Location |
 |---|---|---|
-| **Project docs** | When conventions, patterns, or key files change | `agents/docs/*.md` |
-| **Project contexts** | When architecture or high-level flow changes | `agents/contexts/*.md` |
+| **Project docs** | When conventions, patterns, or key files change | `agents/reference/docs/*.md` |
+| **Project contexts** | When architecture or high-level flow changes | `agents/settings/contexts/*.md` |
 | **Module agent docs** | When module-specific behavior changes | `app/Modules/*/agents/` |
 | **Module Docs/** | When module internals change | `app/Modules/*/Docs/` |
 | **AGENTS.md** | When project-wide conventions change | `AGENTS.md` |
@@ -146,7 +158,7 @@ After the code changes are verified, update all affected documentation:
 
 ### Change API endpoint
 1. Update controller + request + resource + OpenAPI schemas + route → present test changes →
-   update docs (`agents/docs/controller.md`, `agents/docs/api-resources.md`) → run PHPStan → run tests.
+   update docs (`agents/reference/docs/controller.md`, `agents/reference/docs/api-resources.md`) → run PHPStan → run tests.
 
 ### Replace implementation (e.g. switch service)
 1. Create new implementation → update binding → find all direct references → update → present test

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

@@ -3,6 +3,18 @@ name: code-review
 description: "Use when the user says "review this", "check my code", or wants feedback on changes. Reviews for correctness, quality, security, and coding standards."
 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
 ---
 
 # code-review

package/.agent-src/skills/command-routing/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
 ---
 
 # commands

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

@@ -3,6 +3,18 @@ name: command-writing
 description: "Use when creating or editing a slash command in .agent-src.uncompressed/commands/ — frontmatter, numbered steps, safety gates — even when the user just says 'add a /command for X'."
 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
 ---
 
 <!-- cloud_safe: degrade -->
@@ -118,7 +130,7 @@ Suggestion-block rules (linter-enforced):
   override the global settings per command.
 
 Eligibility decisions are tracked in
-[`agents/contexts/command-suggestion-eligibility.md`](../../../agents/contexts/command-suggestion-eligibility.md).
+[`agents/settings/contexts/command-suggestion-eligibility.md`](../../../agents/settings/contexts/command-suggestion-eligibility.md).
 Add or revise entries there before changing a command's `suggestion` block.
 
 When iterating on the description, delegate to the
@@ -197,7 +209,7 @@ the pre-existing violations on `main` in a Markdown table:
 Forward-only: the new check applies to **the file under review** and to
 **future** edits. The baseline table is informational so reviewers can
 spot intent (fix-now vs. backlog) without diffing the full lint output.
-See `agents/analysis/lint-warning-triage.md` for the 3-bucket reference.
+See `agents/evidence/analysis/lint-warning-triage.md` for the 3-bucket reference.
 
 ## Output format
 

package/.agent-src/skills/comp-banding/SKILL.md

@@ -6,6 +6,18 @@ tier: senior
 source: package
 domain: process
 context_spine: [org-stage, customer-segment, regulatory-regime]
+workspaces:
+  - ops
+packs:
+  - ops-people
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: true
 ---
 
 # comp-banding

package/.agent-src/skills/competitive-moat-analysis/SKILL.md

@@ -7,8 +7,18 @@ source: package
 domain: process
 context_spine: [customer-segment, product, org-stage]
 recommended_for_user_types: [consultant, founder]
-
-
+workspaces:
+  - founder
+packs:
+  - founder-strategy
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: true
 ---
 
 # competitive-moat-analysis

package/.agent-src/skills/competitive-positioning/SKILL.md

@@ -7,8 +7,18 @@ source: package
 domain: product
 context_spine: [product]
 recommended_for_user_types: [consultant, gtm, founder]
-
-
+workspaces:
+  - gtm
+packs:
+  - gtm-marketing
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: true
 ---
 
 # competitive-positioning

package/.agent-src/skills/composer-packages/SKILL.md

@@ -3,6 +3,18 @@ name: composer-packages
 description: "Use when building or maintaining a Composer library — versioning, Laravel integration, autoloading, publishing to private registries — even when the user says 'release a new version'."
 source: package
 domain: engineering
+workspaces:
+  - engineering
+packs:
+  - php
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: false
+  removable: true
 ---
 
 # composer-packages

package/.agent-src/skills/compress-memory/SKILL.md

@@ -7,6 +7,18 @@ execution:
   type: assisted
   handler: internal
   allowed_tools: [Bash]
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # compress-memory

package/.agent-src/skills/content-funnel-design/SKILL.md

@@ -7,8 +7,18 @@ source: package
 domain: product
 context_spine: [product, customer-segment, channel-stage, funnel-stage]
 recommended_for_user_types: [creator, gtm]
-
-
+workspaces:
+  - gtm
+packs:
+  - gtm-marketing
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: true
 ---
 
 # content-funnel-design

package/.agent-src/skills/context-authoring/SKILL.md

@@ -3,6 +3,18 @@ name: context-authoring
 description: "Use when filling in knowledge-layer context files — auth-model, tenant-boundaries, data-sensitivity, deployment-order, observability — interactive walkthrough that turns templates into reviewer fuel."
 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
 ---
 
 # context-authoring
@@ -11,13 +23,13 @@ domain: process
 
 Use this skill when:
 
-- A new project has been scaffolded and the `agents/contexts/` files are still
+- A new project has been scaffolded and the `agents/settings/contexts/` files are still
   template stubs from `event4u/agent-config`.
 - The user asks "help me fill in the auth model context", "set up tenant
   boundaries", or similar knowledge-layer work.
 - A reviewer skill (`authz-review`, `data-flow-mapper`, `migration-safety`,
   `multi-tenant-boundary-review`, `secrets-and-config-review`) reports *"I
-  cannot proceed — `agents/contexts/<file>.md` is still a template"*.
+  cannot proceed — `agents/settings/contexts/<file>.md` is still a template"*.
 - After a significant architecture change that invalidates one of the five
   context files.
 
@@ -40,13 +52,13 @@ Do NOT use when:
 | `observability.md` | Error tracking, log channels, metrics, known alerts | deploy reviewers, `bug-analyzer`, incident mode |
 
 The templates ship in `.agent-src.uncompressed/templates/contexts/` and are
-copied into `agents/contexts/` by the installer.
+copied into `agents/settings/contexts/` by the installer.
 
 ## Procedure: context-authoring
 
 ### Step 0: Inspect
 
-1. List `agents/contexts/` — which of the five files exist? Which still contain
+1. List `agents/settings/contexts/` — which of the five files exist? Which still contain
    the `<!-- Template shipped by event4u/agent-config. -->` HTML comment?
 2. Ask the user which file to work on. Use numbered options:
 
@@ -123,7 +135,7 @@ has to confirm or correct, not invent from scratch.
 
 ## Output format
 
-1. `agents/contexts/<file>.md` updated with project-specific content; every
+1. `agents/settings/contexts/<file>.md` updated with project-specific content; every
    section either authored or explicitly marked `<!-- TBD: ... -->`.
 2. A short summary comment back to the user: which sections are complete,
    which are `TBD`, and which downstream reviewer skills are now unblocked.
@@ -150,7 +162,7 @@ has to confirm or correct, not invent from scratch.
 
 If the context file declares its own `load_context:` (chain reasoning),
 use logical names rooted at the source — `contexts/<area>/<file>.md`
-for package material or `agents/contexts/<file>.md` for project-local
+for package material or `agents/settings/contexts/<file>.md` for project-local
 material. The `.agent-src.uncompressed/` prefix is rejected by the
 schema regex and by `scripts/lint_load_context.py`. Body links to
 `docs/guidelines/...` use the verbatim `../../docs/...` relative form.

package/.agent-src/skills/context-document/SKILL.md

@@ -3,6 +3,18 @@ name: context-document
 description: "Use when the user says "create context", "document this area", or wants a structured snapshot of a codebase area for agent orientation."
 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
 ---
 
 # context
@@ -44,10 +56,10 @@ Unlike feature plans (future-focused) or roadmaps (task-focused), contexts are
 ├── skills-and-commands.md
 └── documentation-hierarchy.md
 
-agents/contexts/                         # Project-wide contexts
+agents/settings/contexts/                         # Project-wide contexts
 ├── {context-name}.md
 
-app/Modules/{Module}/agents/contexts/    # Module-scoped contexts
+app/Modules/{Module}/agents/settings/contexts/    # Module-scoped contexts
 ├── {context-name}.md
 
 .augment/templates/
@@ -69,8 +81,8 @@ app/Modules/{Module}/agents/contexts/    # Module-scoped contexts
 | Content | Location |
 |---|---|
 | About the `.augment/` system itself | `.augment/contexts/` (shared package) |
-| Project-wide or cross-module | `agents/contexts/` |
-| Module-specific | `app/Modules/{Module}/agents/contexts/` |
+| Project-wide or cross-module | `agents/settings/contexts/` |
+| Module-specific | `app/Modules/{Module}/agents/settings/contexts/` |
 | If unsure | Ask the user |
 
 ### Shared vs. project-specific contexts
@@ -79,7 +91,7 @@ app/Modules/{Module}/agents/contexts/    # Module-scoped contexts
 how overrides work, what skills/commands exist, the documentation hierarchy.
 These are read-only at project level (like all `.augment/` content).
 
-**`agents/contexts/`** — Project-specific. Describes the project's business domain:
+**`agents/settings/contexts/`** — Project-specific. Describes the project's business domain:
 modules, services, integrations, database architecture.
 These are created and maintained per project.
 

package/.agent-src/skills/contracts-cognition/SKILL.md

@@ -7,8 +7,18 @@ source: package
 domain: process
 context_spine: [regulatory-regime, customer-segment, org-stage]
 recommended_for_user_types: [consultant, finance, ops]
-
-
+workspaces:
+  - ops
+packs:
+  - ops-people
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: true
 ---
 
 # contracts-cognition

package/.agent-src/skills/conventional-commits-writing/SKILL.md

@@ -7,6 +7,18 @@ execution:
   type: assisted
   handler: internal
   allowed_tools: []
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # conventional-commits-writing

package/.agent-src/skills/copilot-agents-optimization/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
 ---
 
 # Copilot & AGENTS Optimizer Skill
@@ -129,7 +141,7 @@ both. Instead, reference with a table:
 ### Reduction strategies (when over budget)
 
 1. **Extract to `agents/`** — Move project-specific details to dedicated files in `agents/`
-   and link from AGENTS.md (e.g., `agents/docs/database-setup.md`, `agents/docs/testing.md`)
+   and link from AGENTS.md (e.g., `agents/reference/docs/database-setup.md`, `agents/reference/docs/testing.md`)
 2. **Remove duplicates** — If content exists in `.augment/`, remove from AGENTS.md
 3. **Compress** — Turn verbose explanations into concise tables or bullet points
 4. **Remove ECS/Rector-enforced rules** — From copilot-instructions.md (auto-fixed anyway)

package/.agent-src/skills/copilot-config/SKILL.md

@@ -3,6 +3,18 @@ name: copilot-config
 description: "Tune the GitHub Copilot AI — `copilot-instructions.md`, PR-review patterns, suggestion behavior, output verbosity. NOT for dev-environment setup (use `devcontainer`)."
 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
 ---
 
 # Copilot Skill

package/.agent-src/skills/customer-research/SKILL.md

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

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

@@ -5,6 +5,18 @@ source: package
 domain: devops
 recommended_for_user_types: [ops, gtm]
 framework: laravel
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # dashboard-design

package/.agent-src/skills/data-flow-mapper/SKILL.md

@@ -3,6 +3,18 @@ name: data-flow-mapper
 description: "Use BEFORE editing code that touches user data — traces the value from entry → validation → transformation → storage → egress, every hop cited with file:line."
 source: package
 domain: discovery
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # data-flow-mapper

package/.agent-src/skills/data-handling-judgment/SKILL.md

@@ -7,8 +7,18 @@ source: package
 domain: process
 context_spine: [regulatory-regime, customer-segment, product]
 recommended_for_user_types: [ops, finance]
-
-
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # data-handling-judgment

package/.agent-src/skills/database/SKILL.md

@@ -5,6 +5,18 @@ personas:
   - eloquent-tamer
 source: package
 domain: engineering
+workspaces:
+  - engineering
+packs:
+  - engineering-base
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # database
@@ -21,7 +33,7 @@ Do NOT use when:
 
 ### Step 0: Inspect
 
-1. Read project docs in `agents/docs/` for database architecture.
+1. Read project docs in `agents/reference/docs/` for database architecture.
 2. Check `config/database.php` for connection definitions.
 3. Detect engine: check `.env` driver and `docker-compose.yml`.
 
@@ -58,7 +70,7 @@ Re-run `EXPLAIN` and confirm improved plan.
    - Rails: `bin/rails runner "p ActiveRecord::Base.connection.columns('table').map(&:name)"`
    - Prisma: `npx prisma db pull --print | grep -A20 "model Table"`
    - Generic SQL: `psql -d mydb -c "\d table"` / `mysql -e "DESCRIBE table"`
-4. **Check project docs** — `agents/docs/` for conventions
+4. **Check project docs** — `agents/reference/docs/` for conventions
 
 | Trap | Reality |
 |---|---|

package/.agent-src/skills/dcf-modeling/SKILL.md

@@ -6,8 +6,18 @@ tier: senior
 source: package
 domain: product
 recommended_for_user_types: [finance]
-
-
+workspaces:
+  - finance
+packs:
+  - finance-advanced
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: false
+  removable: true
 ---
 
 # dcf-modeling

package/.agent-src/skills/deal-qualification-meddic/SKILL.md

@@ -7,8 +7,18 @@ source: package
 domain: product
 context_spine: [product, customer-segment]
 recommended_for_user_types: [gtm]
-
-
+workspaces:
+  - gtm
+packs:
+  - gtm-sales
+lifecycle: active
+trust:
+  level: professional
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: true
 ---
 
 # deal-qualification-meddic

package/.agent-src/skills/decision-record/SKILL.md

@@ -10,6 +10,18 @@ personas:
   - senior-engineer
   - critical-challenger
   - product-owner
+workspaces:
+  - agent-config-maintainer
+packs:
+  - meta
+lifecycle: active
+trust:
+  level: core
+  confidence: high
+  human_review_required: false
+install:
+  default: true
+  removable: false
 ---
 
 # decision-record