@event4u/agent-config 1.33.0 → 1.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (218) hide show
  1. package/.agent-src/commands/review-changes.md +13 -8
  2. package/.agent-src/commands/roadmap/process-full.md +17 -15
  3. package/.agent-src/contexts/execution/roadmap-process-loop.md +11 -10
  4. package/.agent-src/personas/README.md +12 -21
  5. package/.agent-src/personas/_template-specialist/persona.md +89 -0
  6. package/.agent-src/personas/backend-architect.md +96 -0
  7. package/.agent-src/personas/discovery-lead.md +99 -0
  8. package/.agent-src/personas/eloquent-tamer.md +96 -0
  9. package/.agent-src/personas/frontend-engineer.md +100 -0
  10. package/.agent-src/personas/product-owner.md +71 -52
  11. package/.agent-src/personas/qa.md +27 -2
  12. package/.agent-src/personas/revops-maintainer.md +100 -0
  13. package/.agent-src/personas/security-engineer.md +100 -0
  14. package/.agent-src/personas/tech-writer.md +99 -0
  15. package/.agent-src/skills/accessibility-auditor/SKILL.md +132 -0
  16. package/.agent-src/skills/adr-create/SKILL.md +1 -0
  17. package/.agent-src/skills/adversarial-review/SKILL.md +1 -0
  18. package/.agent-src/skills/agent-docs-writing/SKILL.md +1 -0
  19. package/.agent-src/skills/agents-md-thin-root/SKILL.md +1 -0
  20. package/.agent-src/skills/ai-council/SKILL.md +1 -0
  21. package/.agent-src/skills/analysis-autonomous-mode/SKILL.md +1 -0
  22. package/.agent-src/skills/analysis-skill-router/SKILL.md +1 -0
  23. package/.agent-src/skills/api-design/SKILL.md +3 -0
  24. package/.agent-src/skills/api-endpoint/SKILL.md +1 -0
  25. package/.agent-src/skills/api-testing/SKILL.md +1 -0
  26. package/.agent-src/skills/architecture-review-lens/SKILL.md +137 -0
  27. package/.agent-src/skills/artisan-commands/SKILL.md +1 -0
  28. package/.agent-src/skills/async-python-patterns/SKILL.md +1 -0
  29. package/.agent-src/skills/authz-review/SKILL.md +4 -0
  30. package/.agent-src/skills/aws-infrastructure/SKILL.md +1 -0
  31. package/.agent-src/skills/blade-ui/SKILL.md +1 -0
  32. package/.agent-src/skills/blast-radius-analyzer/SKILL.md +3 -0
  33. package/.agent-src/skills/bug-analyzer/SKILL.md +1 -0
  34. package/.agent-src/skills/check-refs/SKILL.md +1 -0
  35. package/.agent-src/skills/code-refactoring/SKILL.md +1 -0
  36. package/.agent-src/skills/code-review/SKILL.md +1 -0
  37. package/.agent-src/skills/command-routing/SKILL.md +1 -0
  38. package/.agent-src/skills/command-writing/SKILL.md +1 -0
  39. package/.agent-src/skills/competitive-positioning/SKILL.md +152 -0
  40. package/.agent-src/skills/composer-packages/SKILL.md +1 -0
  41. package/.agent-src/skills/context-authoring/SKILL.md +1 -0
  42. package/.agent-src/skills/context-document/SKILL.md +1 -0
  43. package/.agent-src/skills/conventional-commits-writing/SKILL.md +1 -0
  44. package/.agent-src/skills/copilot-agents-optimization/SKILL.md +1 -0
  45. package/.agent-src/skills/copilot-config/SKILL.md +1 -0
  46. package/.agent-src/skills/customer-research/SKILL.md +116 -0
  47. package/.agent-src/skills/dashboard-design/SKILL.md +1 -0
  48. package/.agent-src/skills/data-flow-mapper/SKILL.md +1 -0
  49. package/.agent-src/skills/database/SKILL.md +3 -0
  50. package/.agent-src/skills/dcf-modeling/SKILL.md +1 -0
  51. package/.agent-src/skills/decision-record/SKILL.md +218 -0
  52. package/.agent-src/skills/deep-reading-analyst/SKILL.md +1 -0
  53. package/.agent-src/skills/defense-in-depth/SKILL.md +1 -0
  54. package/.agent-src/skills/dependency-upgrade/SKILL.md +1 -0
  55. package/.agent-src/skills/description-assist/SKILL.md +1 -0
  56. package/.agent-src/skills/design-review/SKILL.md +1 -0
  57. package/.agent-src/skills/devcontainer/SKILL.md +1 -0
  58. package/.agent-src/skills/developer-like-execution/SKILL.md +1 -0
  59. package/.agent-src/skills/discovery-interview/SKILL.md +152 -0
  60. package/.agent-src/skills/docker/SKILL.md +1 -0
  61. package/.agent-src/skills/dto-creator/SKILL.md +1 -0
  62. package/.agent-src/skills/eloquent/SKILL.md +3 -0
  63. package/.agent-src/skills/error-handling-patterns/SKILL.md +1 -0
  64. package/.agent-src/skills/estimate-ticket/SKILL.md +1 -0
  65. package/.agent-src/skills/existing-ui-audit/SKILL.md +3 -0
  66. package/.agent-src/skills/fe-design/SKILL.md +4 -1
  67. package/.agent-src/skills/feature-planning/SKILL.md +1 -0
  68. package/.agent-src/skills/file-editor/SKILL.md +1 -0
  69. package/.agent-src/skills/finishing-a-development-branch/SKILL.md +1 -0
  70. package/.agent-src/skills/flux/SKILL.md +1 -0
  71. package/.agent-src/skills/form-handler/SKILL.md +145 -0
  72. package/.agent-src/skills/funnel-analysis/SKILL.md +1 -0
  73. package/.agent-src/skills/git-workflow/SKILL.md +1 -0
  74. package/.agent-src/skills/github-ci/SKILL.md +1 -0
  75. package/.agent-src/skills/grafana/SKILL.md +1 -0
  76. package/.agent-src/skills/guideline-writing/SKILL.md +1 -0
  77. package/.agent-src/skills/incident-commander/SKILL.md +140 -0
  78. package/.agent-src/skills/jira-integration/SKILL.md +1 -0
  79. package/.agent-src/skills/jobs-events/SKILL.md +1 -0
  80. package/.agent-src/skills/judge-bug-hunter/SKILL.md +1 -0
  81. package/.agent-src/skills/judge-code-quality/SKILL.md +1 -0
  82. package/.agent-src/skills/judge-security-auditor/SKILL.md +3 -0
  83. package/.agent-src/skills/judge-test-coverage/SKILL.md +1 -0
  84. package/.agent-src/skills/laravel/SKILL.md +1 -0
  85. package/.agent-src/skills/laravel-horizon/SKILL.md +1 -0
  86. package/.agent-src/skills/laravel-mail/SKILL.md +1 -0
  87. package/.agent-src/skills/laravel-middleware/SKILL.md +1 -0
  88. package/.agent-src/skills/laravel-notifications/SKILL.md +1 -0
  89. package/.agent-src/skills/laravel-pennant/SKILL.md +1 -0
  90. package/.agent-src/skills/laravel-pulse/SKILL.md +1 -0
  91. package/.agent-src/skills/laravel-reverb/SKILL.md +1 -0
  92. package/.agent-src/skills/laravel-scheduling/SKILL.md +1 -0
  93. package/.agent-src/skills/laravel-validation/SKILL.md +1 -0
  94. package/.agent-src/skills/launch-readiness/SKILL.md +156 -0
  95. package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +1 -0
  96. package/.agent-src/skills/lint-skills/SKILL.md +1 -0
  97. package/.agent-src/skills/livewire/SKILL.md +1 -0
  98. package/.agent-src/skills/livewire-architect/SKILL.md +158 -0
  99. package/.agent-src/skills/logging-monitoring/SKILL.md +1 -0
  100. package/.agent-src/skills/markitdown/SKILL.md +1 -0
  101. package/.agent-src/skills/mcp/SKILL.md +1 -0
  102. package/.agent-src/skills/mcp-builder/SKILL.md +1 -0
  103. package/.agent-src/skills/md-language-check/SKILL.md +1 -0
  104. package/.agent-src/skills/merge-conflicts/SKILL.md +1 -0
  105. package/.agent-src/skills/migration-architect/SKILL.md +119 -0
  106. package/.agent-src/skills/migration-creator/SKILL.md +1 -0
  107. package/.agent-src/skills/mobile-e2e-strategy/SKILL.md +2 -1
  108. package/.agent-src/skills/module-management/SKILL.md +1 -0
  109. package/.agent-src/skills/multi-tenancy/SKILL.md +1 -0
  110. package/.agent-src/skills/okr-tree-modeling/SKILL.md +1 -0
  111. package/.agent-src/skills/openapi/SKILL.md +1 -0
  112. package/.agent-src/skills/override-management/SKILL.md +1 -0
  113. package/.agent-src/skills/performance/SKILL.md +1 -0
  114. package/.agent-src/skills/performance-analysis/SKILL.md +1 -0
  115. package/.agent-src/skills/persona-writing/SKILL.md +1 -0
  116. package/.agent-src/skills/pest-testing/SKILL.md +1 -0
  117. package/.agent-src/skills/php-coder/SKILL.md +1 -0
  118. package/.agent-src/skills/php-debugging/SKILL.md +1 -0
  119. package/.agent-src/skills/php-service/SKILL.md +1 -0
  120. package/.agent-src/skills/playwright-architect/SKILL.md +141 -0
  121. package/.agent-src/skills/playwright-testing/SKILL.md +1 -0
  122. package/.agent-src/skills/po-discovery/SKILL.md +127 -0
  123. package/.agent-src/skills/project-analysis-core/SKILL.md +1 -0
  124. package/.agent-src/skills/project-analysis-hypothesis-driven/SKILL.md +1 -0
  125. package/.agent-src/skills/project-analysis-laravel/SKILL.md +1 -0
  126. package/.agent-src/skills/project-analysis-nextjs/SKILL.md +1 -0
  127. package/.agent-src/skills/project-analysis-node-express/SKILL.md +1 -0
  128. package/.agent-src/skills/project-analysis-react/SKILL.md +1 -0
  129. package/.agent-src/skills/project-analysis-symfony/SKILL.md +1 -0
  130. package/.agent-src/skills/project-analysis-zend-laminas/SKILL.md +1 -0
  131. package/.agent-src/skills/project-analyzer/SKILL.md +1 -0
  132. package/.agent-src/skills/project-docs/SKILL.md +1 -0
  133. package/.agent-src/skills/prompt-engineering-patterns/SKILL.md +1 -0
  134. package/.agent-src/skills/prompt-optimizer/SKILL.md +1 -0
  135. package/.agent-src/skills/quality-tools/SKILL.md +1 -0
  136. package/.agent-src/skills/react-native-setup/SKILL.md +1 -0
  137. package/.agent-src/skills/react-shadcn-ui/SKILL.md +1 -0
  138. package/.agent-src/skills/readme-reviewer/SKILL.md +1 -0
  139. package/.agent-src/skills/readme-writing/SKILL.md +1 -0
  140. package/.agent-src/skills/readme-writing-package/SKILL.md +1 -0
  141. package/.agent-src/skills/receiving-code-review/SKILL.md +1 -0
  142. package/.agent-src/skills/refine-prompt/SKILL.md +1 -0
  143. package/.agent-src/skills/refine-ticket/SKILL.md +1 -0
  144. package/.agent-src/skills/release-comms/SKILL.md +123 -0
  145. package/.agent-src/skills/repomix-packer/SKILL.md +1 -0
  146. package/.agent-src/skills/requesting-code-review/SKILL.md +1 -0
  147. package/.agent-src/skills/review-routing/SKILL.md +1 -0
  148. package/.agent-src/skills/rice-prioritization/SKILL.md +1 -0
  149. package/.agent-src/skills/risk-officer/SKILL.md +141 -0
  150. package/.agent-src/skills/roadmap-management/SKILL.md +1 -0
  151. package/.agent-src/skills/roadmap-writing/SKILL.md +2 -1
  152. package/.agent-src/skills/rtk-output-filtering/SKILL.md +1 -0
  153. package/.agent-src/skills/rule-writing/SKILL.md +1 -0
  154. package/.agent-src/skills/script-writing/SKILL.md +1 -0
  155. package/.agent-src/skills/secrets-management/SKILL.md +1 -0
  156. package/.agent-src/skills/security/SKILL.md +1 -0
  157. package/.agent-src/skills/security-audit/SKILL.md +1 -0
  158. package/.agent-src/skills/sentry-integration/SKILL.md +1 -0
  159. package/.agent-src/skills/sequential-thinking/SKILL.md +1 -0
  160. package/.agent-src/skills/skill-improvement-pipeline/SKILL.md +1 -0
  161. package/.agent-src/skills/skill-management/SKILL.md +1 -0
  162. package/.agent-src/skills/skill-reviewer/SKILL.md +1 -0
  163. package/.agent-src/skills/skill-writing/SKILL.md +1 -0
  164. package/.agent-src/skills/sql-writing/SKILL.md +1 -0
  165. package/.agent-src/skills/stakeholder-tradeoff/SKILL.md +237 -0
  166. package/.agent-src/skills/subagent-orchestration/SKILL.md +13 -0
  167. package/.agent-src/skills/systematic-debugging/SKILL.md +1 -0
  168. package/.agent-src/skills/tailwind-engineer/SKILL.md +130 -0
  169. package/.agent-src/skills/tech-debt-tracker/SKILL.md +152 -0
  170. package/.agent-src/skills/technical-specification/SKILL.md +1 -0
  171. package/.agent-src/skills/terraform/SKILL.md +1 -0
  172. package/.agent-src/skills/terragrunt/SKILL.md +1 -0
  173. package/.agent-src/skills/test-driven-development/SKILL.md +1 -0
  174. package/.agent-src/skills/test-performance/SKILL.md +1 -0
  175. package/.agent-src/skills/testing-anti-patterns/SKILL.md +1 -0
  176. package/.agent-src/skills/threat-modeling/SKILL.md +3 -0
  177. package/.agent-src/skills/token-optimizer/SKILL.md +1 -0
  178. package/.agent-src/skills/traefik/SKILL.md +1 -0
  179. package/.agent-src/skills/ui-component-architect/SKILL.md +153 -0
  180. package/.agent-src/skills/unit-economics-modeling/SKILL.md +1 -0
  181. package/.agent-src/skills/universal-project-analysis/SKILL.md +1 -0
  182. package/.agent-src/skills/upstream-contribute/SKILL.md +1 -0
  183. package/.agent-src/skills/using-git-worktrees/SKILL.md +1 -0
  184. package/.agent-src/skills/validate-feature-fit/SKILL.md +1 -0
  185. package/.agent-src/skills/verify-completion-evidence/SKILL.md +1 -0
  186. package/.agent-src/skills/voc-extract/SKILL.md +164 -0
  187. package/.agent-src/skills/websocket/SKILL.md +1 -0
  188. package/.agent-src/templates/roadmaps.md +9 -0
  189. package/.claude-plugin/marketplace.json +21 -1
  190. package/AGENTS.md +1 -0
  191. package/CHANGELOG.md +75 -0
  192. package/README.md +2 -2
  193. package/docs/architecture.md +2 -2
  194. package/docs/catalog.md +21 -4
  195. package/docs/contracts/context-spine.md +133 -0
  196. package/docs/contracts/file-ownership-matrix.json +616 -0
  197. package/docs/contracts/mental-models.md +336 -0
  198. package/docs/contracts/persona-schema.md +136 -0
  199. package/docs/contracts/skill-domains.md +143 -0
  200. package/docs/decisions/ADR-005-subagent-worktrees.md +120 -0
  201. package/docs/decisions/ADR-006-skill-tools-python-pilot.md +114 -0
  202. package/docs/decisions/INDEX.md +3 -0
  203. package/docs/guidelines/cross-role-handoff.md +127 -0
  204. package/docs/personas.md +115 -0
  205. package/package.json +1 -1
  206. package/scripts/_backfill_skill_domains.py +140 -0
  207. package/scripts/_emit_domain_table.py +35 -0
  208. package/scripts/install-hooks.sh +21 -4
  209. package/scripts/lint_context_spine_usage.py +133 -0
  210. package/scripts/lint_roadmap_complexity.py +37 -0
  211. package/scripts/lint_skill_tools.py +168 -0
  212. package/scripts/schemas/skill.schema.json +15 -1
  213. package/scripts/skill_linter.py +19 -4
  214. package/scripts/skill_tools/__init__.py +22 -0
  215. package/scripts/skill_tools/audit_persona_coverage.py +147 -0
  216. package/scripts/skill_tools/run_block_d_eval.py +129 -0
  217. package/scripts/skill_tools/score_skill_relevance.py +169 -0
  218. package/scripts/skill_tools/suggest_skill_for_task.py +113 -0
@@ -0,0 +1,164 @@
1
+ ---
2
+ name: voc-extract
3
+ description: "Use when extracting Voice-of-Customer themes from existing artefacts — GH issues, PR threads, Sentry patterns. Triggers on 'what are users saying', 'recurring complaints', 'top themes'."
4
+ status: active
5
+ tier: senior
6
+ source: package
7
+ domain: product
8
+ context_spine: [product]
9
+ ---
10
+
11
+ # voc-extract
12
+
13
+ ## When to use
14
+
15
+ - A backlog or planning round needs grounded user-voice signal, not anecdotes.
16
+ - A round of bug reports / feature requests / Sentry events has accumulated and the team needs themes with citation per theme.
17
+ - A roadmap proposal needs a "what users keep telling us" backing section.
18
+
19
+ Do NOT use this skill for live interviews
20
+ ([`discovery-interview`](../discovery-interview/SKILL.md)) or for
21
+ quantitative funnel diagnosis ([`funnel-analysis`](../funnel-analysis/SKILL.md)).
22
+
23
+ ## Bounded scope
24
+
25
+ - **Read-only on artefacts the host already has** — local repo issues
26
+ (`gh issue list`), PR discussions (`gh pr view`), Sentry projects
27
+ the team owns. No external scrape, no SaaS API calls.
28
+ - **Chat-export sourcing (Discord, Slack) is deferred** pending
29
+ privacy review (council Q5, SHIP-WITHOUT). If a request asks for
30
+ chat-derived VoC, refuse and route the user to a privacy review.
31
+ - **No PII surfacing** — quotes are paraphrased to remove names,
32
+ emails, tenant identifiers; verbatim is reserved for product-team
33
+ artefacts inside the repo.
34
+
35
+ ## Cognition cluster
36
+
37
+ - **Mental model 15 — Signal vs noise.** A loud single reporter
38
+ swamps quiet recurring patterns; rank by **distinct authors**, not
39
+ comment count. See
40
+ [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 15.
41
+ - **Mental model 14 — Pareto.** Roughly 20% of themes carry 80% of
42
+ the contact volume; cut the long tail explicitly so the team acts
43
+ on the head. See `mental-models.md` § 14.
44
+ - **Mental model 22 — Data-informed, not data-driven.** Issue counts
45
+ are evidence, not voting; weight by recency, severity, and segment
46
+ before recommending. See `mental-models.md` § 22.
47
+ - **Product context-spine slot.** Read **product** for segments,
48
+ non-goals, and focal jobs; do not surface themes that fall outside
49
+ the declared scope without a scope-violation flag. See
50
+ [`context-spine`](../../../docs/contracts/context-spine.md).
51
+
52
+ ## Procedure
53
+
54
+ ### 1. Inventory the source artefacts
55
+
56
+ Identify what is in scope **for this run**:
57
+
58
+ - `gh issue list --state all --limit N` per repo.
59
+ - `gh pr list --state all --limit N` per repo.
60
+ - Sentry project names + date window.
61
+
62
+ Capture counts and date window in the output header so the verdict
63
+ is reproducible.
64
+
65
+ ### 2. Inspect each artefact and tag
66
+
67
+ Per artefact, capture:
68
+
69
+ - **Theme tag** (free-text, normalised in step 3).
70
+ - **Author** (distinct identity).
71
+ - **Severity** — blocking / friction / wish / praise.
72
+ - **Segment** — derived from the **product** spine slot.
73
+ - **Citation** — `repo#123`, PR URL, Sentry issue ID.
74
+
75
+ ### 3. Normalise and rank
76
+
77
+ Cluster theme tags into 5–12 themes max. For each:
78
+
79
+ - **Distinct-author count** (the rank key).
80
+ - **Severity mix** (blocking-share matters more than wish-share).
81
+ - **Recency** — last 90 days vs older; weight 2× recent.
82
+ - **Segment skew** — does the theme cluster in one segment?
83
+
84
+ Drop themes with `< 3` distinct authors **unless** severity is
85
+ blocking or the theme is brand-new in the recency window.
86
+
87
+ ### 4. Build the theme report and validate
88
+
89
+ One row per theme. Columns: **theme · distinct authors · severity
90
+ mix · recency · segment skew · representative citations (≤ 3) ·
91
+ proposed next step (refine / probe / defer)**.
92
+
93
+ Validate the report before handing back: verify each row cites
94
+ ≥ 1 artefact, check that distinct-author counts match the source
95
+ inventory from step 1, confirm no PII leaked into the citations,
96
+ and ensure no theme rated `defer` lacks a written rationale.
97
+
98
+ ### 5. Surface scope violations
99
+
100
+ Themes that fall outside the **product** spine slot's declared scope
101
+ go into a `scope-violation.md` block, never silently into the main
102
+ report. The team decides whether to expand scope or close the door.
103
+
104
+ ### 6. Hand back
105
+
106
+ Route refine candidates to [`refine-ticket`](../refine-ticket/SKILL.md);
107
+ route probe candidates (need live interview) to
108
+ [`discovery-interview`](../discovery-interview/SKILL.md); defer the
109
+ rest with explicit rationale.
110
+
111
+ ## Related Skills
112
+
113
+ **WHEN to use this**
114
+
115
+ - The signal needs to come from existing repo / Sentry artefacts.
116
+ - The output is a theme list with citation, not narrative summary.
117
+ - A roadmap proposal needs grounded VoC backing.
118
+
119
+ **WHEN NOT to use this**
120
+
121
+ - The signal needs a live conversation — route to
122
+ [`discovery-interview`](../discovery-interview/SKILL.md).
123
+ - The artefacts are chat-export sourced (Discord, Slack) — refuse
124
+ and route to a privacy review (deferred per bounded scope).
125
+ - The output is a quantitative funnel — route to
126
+ [`funnel-analysis`](../funnel-analysis/SKILL.md).
127
+ - A theme is already a ticket candidate — route directly to
128
+ [`refine-ticket`](../refine-ticket/SKILL.md).
129
+
130
+ ## When the agent should load this
131
+
132
+ - "Was sagen die User wirklich?"
133
+ - "Top-Themen aus den letzten 90 Tagen Issues."
134
+ - "Welche Sentry-Patterns sind recurring?"
135
+ - "Backe der Roadmap-Phase ein VoC-Block dazu."
136
+ - "Gibt es ein Segment, das uns überproportional pingt?"
137
+
138
+ ## Output
139
+
140
+ 1. **Header** — sources scanned, counts, date window, scope notes.
141
+ 2. **Theme report table** — themes, distinct authors, severity mix,
142
+ recency, segment skew, citations, next step.
143
+ 3. **Scope-violation block** — themes outside the product spine
144
+ slot, explicit, never collapsed into the main table.
145
+ 4. **Routing list** — refine / probe / defer rows with the named
146
+ downstream skill per theme.
147
+
148
+ ## Gotcha
149
+
150
+ - One articulate user can own three themes; rank by distinct authors
151
+ or you ship their backlog.
152
+ - A theme with no recency (all > 90 days) is archaeology, not VoC;
153
+ flag it explicitly.
154
+ - Chat-export requests are tempting (Discord copy-paste); refuse
155
+ per bounded scope until the privacy review lands.
156
+
157
+ ## Do NOT
158
+
159
+ - Do NOT scrape external sources or hit SaaS APIs the team does not
160
+ already own.
161
+ - Do NOT surface PII; paraphrase before quoting.
162
+ - Do NOT collapse scope-violations into the main table.
163
+ - Do NOT lock decisions inside this skill — hand off to
164
+ `refine-ticket` or `decision-record`.
@@ -2,6 +2,7 @@
2
2
  name: websocket
3
3
  description: "Use when building real-time features — WebSocket broadcasting, live updates, presence channels, connection state — even when the user just says 'push this to the client live'."
4
4
  source: package
5
+ domain: engineering
5
6
  ---
6
7
 
7
8
  # websocket
@@ -43,6 +43,15 @@ Templates for roadmap files stored in `agents/roadmaps/` or `app/Modules/{Module
43
43
  or budget-invariant changes; multi-round council, file-ownership
44
44
  matrices, > 600 lines. Enforced by `task lint-roadmap-complexity`.
45
45
  Standard: [`docs/contracts/roadmap-complexity-standard.md`](../docs/contracts/roadmap-complexity-standard.md).
46
+ 16. **No time-boxed plates, no visible-horizon sections.** Roadmaps describe
47
+ scope and phase ordering, not week-by-week commitments. No
48
+ `## Horizon (N-week visible plate)` sections, "Inside / outside the
49
+ plate" framings, `In-plate?` columns, or `**Out-of-plate.**` /
50
+ `**Out-of-horizon.**` / `(out-of-horizon, gated on Phase N)` suffixes.
51
+ AI execution does not operate on calendar plates; scope ordering and
52
+ dependency gates suffice. Pacing is the user's call, decided per turn
53
+ — never encoded into the plan. Enforced by `task lint-roadmap-complexity`
54
+ (plate-token detection).
46
55
 
47
56
  ---
48
57
 
@@ -6,7 +6,7 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
9
- "version": "1.33.0"
9
+ "version": "1.35.0"
10
10
  },
11
11
  "plugins": [
12
12
  {
@@ -15,6 +15,7 @@
15
15
  "source": "./",
16
16
  "strict": false,
17
17
  "skills": [
18
+ "./.claude/skills/accessibility-auditor",
18
19
  "./.claude/skills/adr-create",
19
20
  "./.claude/skills/adversarial-review",
20
21
  "./.claude/skills/agent-docs-writing",
@@ -32,6 +33,7 @@
32
33
  "./.claude/skills/api-design",
33
34
  "./.claude/skills/api-endpoint",
34
35
  "./.claude/skills/api-testing",
36
+ "./.claude/skills/architecture-review-lens",
35
37
  "./.claude/skills/artisan-commands",
36
38
  "./.claude/skills/async-python-patterns",
37
39
  "./.claude/skills/authz-review",
@@ -57,6 +59,7 @@
57
59
  "./.claude/skills/commit",
58
60
  "./.claude/skills/commit-in-chunks",
59
61
  "./.claude/skills/composer-packages",
62
+ "./.claude/skills/competitive-positioning",
60
63
  "./.claude/skills/compress",
61
64
  "./.claude/skills/context",
62
65
  "./.claude/skills/context-authoring",
@@ -74,10 +77,12 @@
74
77
  "./.claude/skills/council-pr",
75
78
  "./.claude/skills/create-pr",
76
79
  "./.claude/skills/create-pr-description-only",
80
+ "./.claude/skills/customer-research",
77
81
  "./.claude/skills/dashboard-design",
78
82
  "./.claude/skills/data-flow-mapper",
79
83
  "./.claude/skills/database",
80
84
  "./.claude/skills/dcf-modeling",
85
+ "./.claude/skills/decision-record",
81
86
  "./.claude/skills/deep-reading-analyst",
82
87
  "./.claude/skills/defense-in-depth",
83
88
  "./.claude/skills/dependency-upgrade",
@@ -85,6 +90,7 @@
85
90
  "./.claude/skills/design-review",
86
91
  "./.claude/skills/devcontainer",
87
92
  "./.claude/skills/developer-like-execution",
93
+ "./.claude/skills/discovery-interview",
88
94
  "./.claude/skills/docker",
89
95
  "./.claude/skills/dto-creator",
90
96
  "./.claude/skills/e2e-heal",
@@ -112,6 +118,7 @@
112
118
  "./.claude/skills/fix-refs",
113
119
  "./.claude/skills/fix-seeder",
114
120
  "./.claude/skills/flux",
121
+ "./.claude/skills/form-handler",
115
122
  "./.claude/skills/funnel-analysis",
116
123
  "./.claude/skills/git-workflow",
117
124
  "./.claude/skills/github-ci",
@@ -119,6 +126,7 @@
119
126
  "./.claude/skills/grill-me",
120
127
  "./.claude/skills/guideline-writing",
121
128
  "./.claude/skills/implement-ticket",
129
+ "./.claude/skills/incident-commander",
122
130
  "./.claude/skills/jira-integration",
123
131
  "./.claude/skills/jira-ticket",
124
132
  "./.claude/skills/jobs-events",
@@ -140,9 +148,11 @@
140
148
  "./.claude/skills/laravel-reverb",
141
149
  "./.claude/skills/laravel-scheduling",
142
150
  "./.claude/skills/laravel-validation",
151
+ "./.claude/skills/launch-readiness",
143
152
  "./.claude/skills/learning-to-rule-or-skill",
144
153
  "./.claude/skills/lint-skills",
145
154
  "./.claude/skills/livewire",
155
+ "./.claude/skills/livewire-architect",
146
156
  "./.claude/skills/logging-monitoring",
147
157
  "./.claude/skills/markitdown",
148
158
  "./.claude/skills/mcp",
@@ -154,6 +164,7 @@
154
164
  "./.claude/skills/memory-promote",
155
165
  "./.claude/skills/memory-propose",
156
166
  "./.claude/skills/merge-conflicts",
167
+ "./.claude/skills/migration-architect",
157
168
  "./.claude/skills/migration-creator",
158
169
  "./.claude/skills/mobile-e2e-strategy",
159
170
  "./.claude/skills/mode",
@@ -184,7 +195,9 @@
184
195
  "./.claude/skills/php-coder",
185
196
  "./.claude/skills/php-debugging",
186
197
  "./.claude/skills/php-service",
198
+ "./.claude/skills/playwright-architect",
187
199
  "./.claude/skills/playwright-testing",
200
+ "./.claude/skills/po-discovery",
188
201
  "./.claude/skills/prepare-for-review",
189
202
  "./.claude/skills/project-analysis-core",
190
203
  "./.claude/skills/project-analysis-hypothesis-driven",
@@ -210,6 +223,7 @@
210
223
  "./.claude/skills/receiving-code-review",
211
224
  "./.claude/skills/refine-prompt",
212
225
  "./.claude/skills/refine-ticket",
226
+ "./.claude/skills/release-comms",
213
227
  "./.claude/skills/repomix-packer",
214
228
  "./.claude/skills/requesting-code-review",
215
229
  "./.claude/skills/research",
@@ -218,6 +232,7 @@
218
232
  "./.claude/skills/review-changes",
219
233
  "./.claude/skills/review-routing",
220
234
  "./.claude/skills/rice-prioritization",
235
+ "./.claude/skills/risk-officer",
221
236
  "./.claude/skills/roadmap",
222
237
  "./.claude/skills/roadmap-ai-council",
223
238
  "./.claude/skills/roadmap-create",
@@ -241,10 +256,13 @@
241
256
  "./.claude/skills/skill-reviewer",
242
257
  "./.claude/skills/skill-writing",
243
258
  "./.claude/skills/sql-writing",
259
+ "./.claude/skills/stakeholder-tradeoff",
244
260
  "./.claude/skills/subagent-orchestration",
245
261
  "./.claude/skills/sync-agent-settings",
246
262
  "./.claude/skills/sync-gitignore",
247
263
  "./.claude/skills/systematic-debugging",
264
+ "./.claude/skills/tailwind-engineer",
265
+ "./.claude/skills/tech-debt-tracker",
248
266
  "./.claude/skills/technical-specification",
249
267
  "./.claude/skills/terraform",
250
268
  "./.claude/skills/terragrunt",
@@ -258,6 +276,7 @@
258
276
  "./.claude/skills/threat-modeling",
259
277
  "./.claude/skills/token-optimizer",
260
278
  "./.claude/skills/traefik",
279
+ "./.claude/skills/ui-component-architect",
261
280
  "./.claude/skills/unit-economics-modeling",
262
281
  "./.claude/skills/universal-project-analysis",
263
282
  "./.claude/skills/update-form-request-messages",
@@ -265,6 +284,7 @@
265
284
  "./.claude/skills/using-git-worktrees",
266
285
  "./.claude/skills/validate-feature-fit",
267
286
  "./.claude/skills/verify-completion-evidence",
287
+ "./.claude/skills/voc-extract",
268
288
  "./.claude/skills/websocket",
269
289
  "./.claude/skills/work"
270
290
  ]
package/AGENTS.md CHANGED
@@ -21,6 +21,7 @@ task ci # full pipeline — green before PR
21
21
  - **Multi-tool projection** — Augment, Claude Code, Cursor, Cline, Windsurf, Gemini CLI, Claude.ai bundle pipeline that ships from `.agent-src/` to consumer surfaces: [`docs/architecture.md`](docs/architecture.md#cloud-bundle-pipeline).
22
22
  - **Editing this repo** — Iron-Law rules (portability, source-of-truth, skill-quality) and the Thin-Root contract (caps · pointer-ratio · triage block) governing AGENTS.md: [`augment-portability`](.agent-src/rules/augment-portability.md), [`augment-source-of-truth`](.agent-src/rules/augment-source-of-truth.md), [`skill-quality`](.agent-src/rules/skill-quality.md), [`agents-md-thin-root`](.agent-src/skills/agents-md-thin-root/SKILL.md).
23
23
  - **Consumer story + architecture deep-dive** — what the package does for installers and how it ships: [`README.md`](README.md), [`docs/architecture.md`](docs/architecture.md).
24
+ - **Personas** — 11 review-lens cast (6 core · 5 specialist), `personas:` vs `/mode` axes, citation map, override pattern: [`docs/personas.md`](docs/personas.md), schema [`docs/contracts/persona-schema.md`](docs/contracts/persona-schema.md).
24
25
 
25
26
  ## Emergency triage — read this when nothing else is reachable
26
27
 
package/CHANGELOG.md CHANGED
@@ -318,6 +318,81 @@ our recommendation order, not its support status.
318
318
  users" tension without removing any path that an existing user
319
319
  might rely on.
320
320
 
321
+ ## [1.35.0](https://github.com/event4u-app/agent-config/compare/1.34.0...1.35.0) (2026-05-10)
322
+
323
+ ### Features
324
+
325
+ * **personas:** add three Wave-2 specialist personas ([fafe78c](https://github.com/event4u-app/agent-config/commit/fafe78cd1d6ec4aa7edb9e6ebbe8bc61f661818d))
326
+ * **skills:** add four senior product/strategy skills ([35e399d](https://github.com/event4u-app/agent-config/commit/35e399d4a805217d4e01a70b8795583eb11b046e))
327
+ * **skills:** promote decision-record and stakeholder-tradeoff to tier:senior ([dec2369](https://github.com/event4u-app/agent-config/commit/dec2369ec8e273b29d701ba72c9283b47d545732))
328
+ * **lint:** enforce context_spine slot citation in skill bodies ([2283472](https://github.com/event4u-app/agent-config/commit/22834723003ce515f6067ec228f273e13bf71cb2))
329
+ * **lint:** detect plate/horizon convention in lint-roadmap-complexity ([8dcd6c1](https://github.com/event4u-app/agent-config/commit/8dcd6c1c4d9f772df2495e114a1b1a03c64022dc))
330
+ * **personas:** upgrade product-owner to senior specialist ([e46fdad](https://github.com/event4u-app/agent-config/commit/e46fdadfd9645de6f07ee7516d265760f739ba73))
331
+ * **skills:** add senior customer-research and release-comms ([fb17b8f](https://github.com/event4u-app/agent-config/commit/fb17b8f1641cd26ceeb405537711bacd1059317d))
332
+ * **contracts:** add context-spine, mental-models, and cross-role-handoff ([a8bd106](https://github.com/event4u-app/agent-config/commit/a8bd106e77a092da385461aec508a8959179559d))
333
+
334
+ ### Bug Fixes
335
+
336
+ * **skills:** cite team spine slot in customer-research ([9279606](https://github.com/event4u-app/agent-config/commit/9279606fedc60377306c80a14c6379577233ce3d))
337
+ * **skill:** drop unused 'team' slot from customer-research context_spine ([e581c66](https://github.com/event4u-app/agent-config/commit/e581c664237f23c9804bce95fd0e8436d33d8bec))
338
+ * **context-spine:** drop transient roadmap references ([a2e17c7](https://github.com/event4u-app/agent-config/commit/a2e17c7ef287b89a92aa296f8eb519ced78e3dcd))
339
+
340
+ ### Chores
341
+
342
+ * **sync:** refresh compression hashes after main merge ([2689a99](https://github.com/event4u-app/agent-config/commit/2689a9959c0d8f5bb0b00a8b4cbc73485b81086d))
343
+ * **generate-tools:** register new skills + personas in distribution layers ([1c8081d](https://github.com/event4u-app/agent-config/commit/1c8081d54b14214ac5163986784af1f4e505aa7d))
344
+ * **roadmap:** archive road-to-unified-senior-roles, refresh dashboard ([0f7a203](https://github.com/event4u-app/agent-config/commit/0f7a203c9f3a6cb97837db52906fa7bd6ff9134a))
345
+ * **sync:** refresh compression hash for customer-research ([5296bd1](https://github.com/event4u-app/agent-config/commit/5296bd13976e105ff128a90de05de78183745f67))
346
+ * **sync:** refresh compression hashes after roadmap-plate removal ([75d06e1](https://github.com/event4u-app/agent-config/commit/75d06e1ec33d9472fd8ae4a08f5efd526b577905))
347
+ * **roadmaps:** strip plate/horizon framing from 7 active roadmaps ([186f98e](https://github.com/event4u-app/agent-config/commit/186f98e8fa3405927e5543c41f4ce797b46eaedf))
348
+ * **infra:** drop horizon-marker handling from process-loop and process-full ([9f9b968](https://github.com/event4u-app/agent-config/commit/9f9b9681f9b9d21305a69e3c413dc4b8ff7d5a9a))
349
+ * **template:** forbid time-boxed plates in roadmap template (rule 16) ([12748c2](https://github.com/event4u-app/agent-config/commit/12748c2e3354e324b2d4b889ecda5655f3286738))
350
+ * **ownership:** regenerate ownership matrix ([33d3775](https://github.com/event4u-app/agent-config/commit/33d37755e4af051df73cfae6b6c6ccc4981202e1))
351
+ * **sync:** regenerate counts, hashes, and roadmap progress ([e4397f8](https://github.com/event4u-app/agent-config/commit/e4397f83bf5c5b10c47f926a4eb605d8e6074063))
352
+
353
+ Tests: 2606 (+0 since 1.34.0)
354
+
355
+ ## [1.34.0](https://github.com/event4u-app/agent-config/compare/1.33.0...1.34.0) (2026-05-10)
356
+
357
+ ### Features
358
+
359
+ * **skills:** block D — eval gate runner + ADR-006 pilot pass (D5) ([afbc4fb](https://github.com/event4u-app/agent-config/commit/afbc4fb6c23949df56376e40b3f0bdda12ee70b5))
360
+ * **skills:** block D — discovery story trio score/audit/suggest (D2-D4) ([f79ff00](https://github.com/event4u-app/agent-config/commit/f79ff005555d84ca84aa5bda8dc4370547a135e9))
361
+ * **skills:** block D — lint_skill_tools meta-linter + CI gate (D1) ([eff36a6](https://github.com/event4u-app/agent-config/commit/eff36a6a254dda61e8639c5d2a6782c0144ebb6c))
362
+ * **skills:** block F UI engineers — tailwind, a11y, form-handler (F2, F3, F6) ([fb6c20a](https://github.com/event4u-app/agent-config/commit/fb6c20a6cbe2e4b6c7dc2f64ab8cad837a3a985a))
363
+ * **skills:** block F UI architects — livewire, playwright, ui-component (F1, F4, F5) ([eeb0eaa](https://github.com/event4u-app/agent-config/commit/eeb0eaaebaf70d7efaba28057f70342745cd623d))
364
+ * **skills:** block C architecture-review-lens — 5th judge in /review-changes (C8) ([197de6b](https://github.com/event4u-app/agent-config/commit/197de6b9687ee69803f53e13bdb9528aa95f4123))
365
+ * **skills:** block C ops/risk — risk-officer, incident-commander, migration-architect (C2, C5, C6) ([24252f6](https://github.com/event4u-app/agent-config/commit/24252f6d754e4b5cdc9a98fd7afc2eaee225d4fb))
366
+ * **skills:** block C product/discovery — po-discovery, decision-record, stakeholder-tradeoff, tech-debt-tracker (C1, C3, C4, C7) ([01a2725](https://github.com/event4u-app/agent-config/commit/01a27256ef175f4f25cde50f1d7b8a3d079855d3))
367
+ * **personas:** discovery surface + public catalog (A5, A6) ([d905639](https://github.com/event4u-app/agent-config/commit/d9056397f4ce687aad65a8fdb75c100ef1d90c01))
368
+ * **orchestration:** subagent mode 7 — do-in-worktrees competitive (A7) ([fa01033](https://github.com/event4u-app/agent-config/commit/fa0103303eaca0db1722a167e788c3a11b2f7ca7))
369
+ * **skills:** cite specialist personas from 9 existing skills (A4) ([d123ac6](https://github.com/event4u-app/agent-config/commit/d123ac6608cf96e0971b3c71e06723e50a6f19fe))
370
+ * **personas:** add 4 specialist personas + qa migration (A3) ([ec19dc5](https://github.com/event4u-app/agent-config/commit/ec19dc579cf69879c5fe339eb6f3d7eee6cf314d))
371
+ * **personas:** lock specialist schema + extend linter (A1, A2) ([79a9ea2](https://github.com/event4u-app/agent-config/commit/79a9ea21202ded3ba848b1e18bf041fecef127c3))
372
+ * **skills:** block B — lock 6-domain taxonomy + back-fill 153 skills ([dfc70fd](https://github.com/event4u-app/agent-config/commit/dfc70fdf8bf97ec30d53a3c81d0b5c4bb61291a9))
373
+
374
+ ### Bug Fixes
375
+
376
+ * **test:** disable retention pruning in council save() artefact test ([e04de7d](https://github.com/event4u-app/agent-config/commit/e04de7d037e3dbfe7a96cf05369d6940e27298b0))
377
+ * **refs:** post-archive ref fixes for road-to-better-skills + ADR-006 council carve-out ([b8922b7](https://github.com/event4u-app/agent-config/commit/b8922b736d40e370e1eef67500d752a028d7b1bf))
378
+
379
+ ### Chores
380
+
381
+ * **skills:** clear missing_inspect_step + weak_output_format on Block-C/F skills ([07a72b3](https://github.com/event4u-app/agent-config/commit/07a72b3f91792e99c3acb7e3448f31b7cff7df0a))
382
+ * **hooks:** gate command-count drift in pre-push ([7b0ff9e](https://github.com/event4u-app/agent-config/commit/7b0ff9e175bb59a9c4ca404f9b4b62149e2e8008))
383
+ * **roadmap:** close road-to-better-skills-and-profiles (Block D pass, B4 deferred) ([f5d7170](https://github.com/event4u-app/agent-config/commit/f5d7170a8c5947be273089839f99aab6dc56a693))
384
+ * **matrix:** regenerate file-ownership-matrix for block F skills ([83ad6a7](https://github.com/event4u-app/agent-config/commit/83ad6a777469ca0efe2da01a4d0173181356bbf1))
385
+ * **catalog:** regenerate index + catalog for block F ([bd57d56](https://github.com/event4u-app/agent-config/commit/bd57d56d9226d2a60658dbac2b8d4b82bf48b519))
386
+ * **sync:** refresh compression-hashes + marketplace for block F ([b45b8a9](https://github.com/event4u-app/agent-config/commit/b45b8a9cef1e74e1ee88f164f5f0cc6e92565fbc))
387
+ * **roadmap:** close block F — flip F1-F6 + F marker to done ([e4bd5cc](https://github.com/event4u-app/agent-config/commit/e4bd5cca56e2f30234bc7833ce3650ccbe1634d8))
388
+ * **roadmap:** flip Block C marker to done — 8 skills + 5th judge integrated ([cfd3ede](https://github.com/event4u-app/agent-config/commit/cfd3ede2cf3846570e410209df1ae18b96db2d18))
389
+ * **matrix:** regenerate file-ownership-matrix for Block C skills ([ad89c8f](https://github.com/event4u-app/agent-config/commit/ad89c8fbb50c7bfa7b7031a21e522d5dd582c2a8))
390
+ * **catalog:** regenerate index + catalog for Block C skills ([cfe94a5](https://github.com/event4u-app/agent-config/commit/cfe94a54d1ec448eabc4afa0810beb81e52471f0))
391
+ * **sync:** refresh compression-hashes for review-changes after Block C ([c56dbe2](https://github.com/event4u-app/agent-config/commit/c56dbe25085255a2fb8b5cd85f75d8e471792137))
392
+ * **roadmap:** close block C — flip C1-C8 to done, refresh counts ([954a2fd](https://github.com/event4u-app/agent-config/commit/954a2fd6205e493efd22619c73f8ff7f30b9121b))
393
+
394
+ Tests: 2606 (+46 since 1.33.0)
395
+
321
396
  ## [1.33.0](https://github.com/event4u-app/agent-config/compare/1.32.0...1.33.0) (2026-05-09)
322
397
 
323
398
  ### Features
package/README.md CHANGED
@@ -7,7 +7,7 @@ Give your AI agents an audit-disciplined orchestration contract — testing, Git
7
7
  > 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).
8
8
 
9
9
  <p align="center">
10
- <strong>153 Skills</strong> · <strong>60 Rules</strong> · <strong>103 Commands</strong> · <strong>68 Guidelines</strong> · <strong>8 AI Tools</strong>
10
+ <strong>173 Skills</strong> · <strong>60 Rules</strong> · <strong>103 Commands</strong> · <strong>69 Guidelines</strong> · <strong>8 AI Tools</strong>
11
11
  </p>
12
12
 
13
13
  ---
@@ -368,7 +368,7 @@ Every developer gets the same behavior. No per-user setup needed.
368
368
  native slash-commands)
369
369
 
370
370
  > **What this means in practice:** Augment Code and Claude Code get the full
371
- > package (rules + 153 skills + 103 native commands). Cursor, Cline, Windsurf,
371
+ > package (rules + 173 skills + 103 native commands). Cursor, Cline, Windsurf,
372
372
  > Gemini CLI, and GitHub Copilot only get the **rules** natively; skills and
373
373
  > commands are available to them as documentation the agent can read, not as
374
374
  > first-class features.
@@ -96,10 +96,10 @@ fails on any source-side violation, without producing artifacts.
96
96
 
97
97
  | Layer | Count | Purpose |
98
98
  |---|---|---|
99
- | **Skills** | 153 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
99
+ | **Skills** | 173 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
100
100
  | **Rules** | 60 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
101
101
  | **Commands** | 103 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
102
- | **Guidelines** | 68 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
102
+ | **Guidelines** | 69 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
103
103
  | **Templates** | 7 | Scaffolds for features, roadmaps, contexts, skills, overrides |
104
104
  | **Contexts** | 5 | Shared knowledge about the system itself |
105
105