@event4u/agent-config 2.16.0 → 2.17.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 (88) hide show
  1. package/.agent-src/commands/ghostwriter/delete.md +118 -0
  2. package/.agent-src/commands/ghostwriter/fetch.md +185 -0
  3. package/.agent-src/commands/ghostwriter/list.md +102 -0
  4. package/.agent-src/commands/ghostwriter/show.md +113 -0
  5. package/.agent-src/commands/ghostwriter/write.md +160 -0
  6. package/.agent-src/commands/ghostwriter.md +96 -0
  7. package/.agent-src/commands/post-as/ghostwriter.md +66 -0
  8. package/.agent-src/commands/post-as/me.md +124 -0
  9. package/.agent-src/commands/post-as.md +58 -0
  10. package/.agent-src/ghostwriter/README.md +61 -0
  11. package/.agent-src/ghostwriter/fictional-fixture-v1.md +94 -0
  12. package/.agent-src/personas/README.md +8 -0
  13. package/.agent-src/rules/domain-safety-disclaimer-consulting.md +52 -0
  14. package/.agent-src/rules/domain-safety-disclaimer-financial.md +54 -0
  15. package/.agent-src/rules/domain-safety-disclaimer-legal.md +49 -0
  16. package/.agent-src/rules/domain-safety-disclaimer-medical.md +56 -0
  17. package/.agent-src/rules/domain-safety-export-redact.md +65 -0
  18. package/.agent-src/rules/domain-safety-logging-pii-floor.md +55 -0
  19. package/.agent-src/rules/domain-safety-pii-finance.md +57 -0
  20. package/.agent-src/rules/domain-safety-pii-marketing.md +60 -0
  21. package/.agent-src/rules/domain-safety-pii-recruiting.md +56 -0
  22. package/.agent-src/rules/domain-safety-pii-support.md +57 -0
  23. package/.agent-src/rules/domain-safety-retention-finance.md +48 -0
  24. package/.agent-src/rules/domain-safety-retention-support.md +55 -0
  25. package/.agent-src/skills/api-design/SKILL.md +3 -0
  26. package/.agent-src/skills/authz-review/SKILL.md +3 -0
  27. package/.agent-src/skills/competitive-moat-analysis/SKILL.md +3 -0
  28. package/.agent-src/skills/competitive-positioning/SKILL.md +3 -0
  29. package/.agent-src/skills/content-funnel-design/SKILL.md +3 -0
  30. package/.agent-src/skills/contracts-cognition/SKILL.md +3 -0
  31. package/.agent-src/skills/dashboard-design/SKILL.md +3 -0
  32. package/.agent-src/skills/data-handling-judgment/SKILL.md +3 -0
  33. package/.agent-src/skills/dcf-modeling/SKILL.md +3 -0
  34. package/.agent-src/skills/deal-qualification-meddic/SKILL.md +3 -0
  35. package/.agent-src/skills/discovery-interview/SKILL.md +3 -0
  36. package/.agent-src/skills/editorial-calendar/SKILL.md +3 -0
  37. package/.agent-src/skills/forecast-accuracy/SKILL.md +3 -0
  38. package/.agent-src/skills/forecasting/SKILL.md +3 -0
  39. package/.agent-src/skills/fundraising-narrative/SKILL.md +3 -0
  40. package/.agent-src/skills/gtm-launch/SKILL.md +3 -0
  41. package/.agent-src/skills/incident-commander/SKILL.md +3 -0
  42. package/.agent-src/skills/launch-readiness/SKILL.md +3 -0
  43. package/.agent-src/skills/messaging-architecture/SKILL.md +3 -0
  44. package/.agent-src/skills/okr-tree-modeling/SKILL.md +3 -0
  45. package/.agent-src/skills/pipeline-strategy/SKILL.md +3 -0
  46. package/.agent-src/skills/playwright-architect/SKILL.md +3 -0
  47. package/.agent-src/skills/privacy-review/SKILL.md +4 -1
  48. package/.agent-src/skills/quality-tools/SKILL.md +3 -0
  49. package/.agent-src/skills/release-comms/SKILL.md +3 -0
  50. package/.agent-src/skills/runway-cognition/SKILL.md +3 -0
  51. package/.agent-src/skills/scenario-modeling/SKILL.md +3 -0
  52. package/.agent-src/skills/secrets-management/SKILL.md +3 -0
  53. package/.agent-src/skills/tech-debt-tracker/SKILL.md +3 -0
  54. package/.agent-src/skills/unit-economics-modeling/SKILL.md +3 -0
  55. package/.agent-src/skills/voc-extract/SKILL.md +3 -0
  56. package/.agent-src/skills/voice-and-tone-design/SKILL.md +3 -0
  57. package/.agent-src/templates/agents/agent-project-settings.example.yml +16 -1
  58. package/.claude-plugin/marketplace.json +10 -1
  59. package/CHANGELOG.md +69 -0
  60. package/README.md +44 -23
  61. package/config/gitignore-block.txt +8 -0
  62. package/docs/announcements/2026-05-non-dev-launch.md +79 -0
  63. package/docs/architecture.md +2 -2
  64. package/docs/case-studies/_template.md +60 -0
  65. package/docs/catalog.md +24 -3
  66. package/docs/contracts/agent-user-schema.md +1 -0
  67. package/docs/contracts/command-clusters.md +2 -0
  68. package/docs/contracts/file-ownership-matrix.json +490 -0
  69. package/docs/contracts/ghostwriter-schema.md +337 -0
  70. package/docs/contracts/init-telemetry.md +133 -0
  71. package/docs/contracts/router-blending.md +71 -0
  72. package/docs/contracts/universal-skills.md +92 -0
  73. package/docs/contracts/write-engine.md +142 -0
  74. package/docs/getting-started-by-role.md +89 -0
  75. package/docs/getting-started-laravel.md +72 -0
  76. package/docs/getting-started.md +2 -2
  77. package/docs/safety.md +30 -0
  78. package/package.json +1 -1
  79. package/scripts/bench_runner.py +158 -0
  80. package/scripts/check_role_doc_links.py +110 -0
  81. package/scripts/compress.py +11 -0
  82. package/scripts/ghostwriter_fixture_allowlist.txt +16 -0
  83. package/scripts/install.py +133 -1
  84. package/scripts/lint_ghostwriter_source.py +240 -0
  85. package/scripts/measure_skill_reduction.py +102 -0
  86. package/scripts/schemas/rule.schema.json +5 -0
  87. package/scripts/schemas/skill.schema.json +6 -0
  88. package/scripts/update-github-metadata.sh +84 -0
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product, customer-segment]
9
+ recommended_for_user_types: [founder]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # fundraising-narrative
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product, customer-segment, channel-stage]
9
+ recommended_for_user_types: [gtm, founder]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # gtm-launch
@@ -6,6 +6,9 @@ personas:
6
6
  - critical-challenger
7
7
  source: package
8
8
  domain: process
9
+ recommended_for_user_types: [ops, developer]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # incident-commander
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: process
8
8
  context_spine: [team, product]
9
+ recommended_for_user_types: [ops, developer, founder]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # launch-readiness
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product, customer-segment]
9
+ recommended_for_user_types: [creator, gtm, consultant]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # messaging-architecture
@@ -5,6 +5,9 @@ status: active
5
5
  tier: senior
6
6
  source: package
7
7
  domain: product
8
+ recommended_for_user_types: [founder]
9
+
10
+
8
11
  ---
9
12
 
10
13
  # okr-tree-modeling
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product, customer-segment, channel-stage]
9
+ recommended_for_user_types: [gtm]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # pipeline-strategy
@@ -5,6 +5,9 @@ personas:
5
5
  - frontend-engineer
6
6
  source: package
7
7
  domain: quality
8
+ recommended_for_user_types: [developer]
9
+
10
+
8
11
  ---
9
12
 
10
13
  # playwright-architect
@@ -1,11 +1,14 @@
1
1
  ---
2
2
  name: privacy-review
3
- description: "Use when reviewing data flows for GDPR / CCPA / HIPAA fit — regulatory-regime delta, consent shape, breach-impact triage. Triggers on 'is this GDPR-safe', 'do we need a DPA'."
3
+ description: "Use when reviewing data flows, support macros, refund templates for GDPR/CCPA/HIPAA fit — regime, consent, PII redaction (email, order-id), breach triage. Triggers 'is this GDPR-safe', 'PII redact'."
4
4
  status: active
5
5
  tier: senior
6
6
  source: package
7
7
  domain: process
8
8
  context_spine: [regulatory-regime, customer-segment, product]
9
+ recommended_for_user_types: [ops, finance, creator]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # privacy-review
@@ -7,6 +7,9 @@ execution:
7
7
  type: assisted
8
8
  handler: shell
9
9
  allowed_tools: []
10
+ recommended_for_user_types: [developer]
11
+
12
+
10
13
  ---
11
14
 
12
15
  # quality-tools
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product, team]
9
+ recommended_for_user_types: [creator, gtm, founder]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # release-comms
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: process
8
8
  context_spine: [org-stage, fiscal-period, product]
9
+ recommended_for_user_types: [founder, finance]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # runway-cognition
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: process
8
8
  context_spine: [org-stage, fiscal-period, product]
9
+ recommended_for_user_types: [founder, finance]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # scenario-modeling
@@ -6,6 +6,9 @@ domain: devops
6
6
  status: active
7
7
  refresh_trigger: "A cited provider deprecates an auth method, OR External Secrets Operator ships a major version with breaking CRD changes, OR ≥30% of cited scanner tools change their gate semantics."
8
8
  sunset_criterion: "When provider docs (Vault, AWS Secrets Manager, Azure Key Vault, GCP Secret Manager) all converge on a single rotation + scanning standard AND consumer projects no longer cite this skill in PR reviews for two consecutive review cycles."
9
+ recommended_for_user_types: [ops, developer]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # secrets-management
@@ -7,6 +7,9 @@ personas:
7
7
  - critical-challenger
8
8
  source: package
9
9
  domain: process
10
+ recommended_for_user_types: [developer, founder]
11
+
12
+
10
13
  ---
11
14
 
12
15
  # tech-debt-tracker
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product, fiscal-period]
9
+ recommended_for_user_types: [founder, finance]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # unit-economics-modeling
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product]
9
+ recommended_for_user_types: [gtm, creator]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # voc-extract
@@ -6,6 +6,9 @@ tier: senior
6
6
  source: package
7
7
  domain: product
8
8
  context_spine: [product, customer-segment]
9
+ recommended_for_user_types: [creator, consultant, gtm]
10
+
11
+
9
12
  ---
10
13
 
11
14
  # voice-and-tone-design
@@ -39,7 +39,7 @@ schema_version: 1
39
39
  # CI guard: a release bump of `package.json` must update this value
40
40
  # in lockstep — see scripts/check_template_pin_drift.py (road-to-
41
41
  # portable-runtime-and-update-check P3.3).
42
- agent_config_version: "2.15.0"
42
+ agent_config_version: "2.16.0"
43
43
 
44
44
  # --- Project identity ---
45
45
  project:
@@ -124,6 +124,21 @@ personas:
124
124
  # Leave empty to require explicit --personas=+<id> opt-in.
125
125
  auto_include: [qa]
126
126
 
127
+ # --- Ghostwriter (optional) ---
128
+ #
129
+ # Toggles for the /ghostwriter command cluster. Consumer-only —
130
+ # the package itself ignores this block (fixtures never carry aliases).
131
+ # See docs/contracts/ghostwriter-schema.md § Aliases.
132
+ ghostwriter:
133
+ # When true, `/ghostwriter:write --as=<value>` resolves <value> against
134
+ # both slug filenames AND every profile's `aliases:` list
135
+ # (case-insensitive). Conflicts are rejected at lint time
136
+ # (task lint-ghostwriter-source), never at runtime.
137
+ # Set to false to disable alias resolution (slug-only matching);
138
+ # any `aliases:` already in profiles are then ignored at resolve time
139
+ # but still validated by the lint.
140
+ aliases: true
141
+
127
142
  # --- Quality pipeline (optional) ---
128
143
  #
129
144
  # Per-language gate tools the `quality-fix` command invokes. Empty
@@ -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": "2.16.0",
9
+ "version": "2.17.0",
10
10
  "keywords": [
11
11
  "agent-config",
12
12
  "skills",
@@ -170,6 +170,12 @@
170
170
  "./.claude/skills/form-handler",
171
171
  "./.claude/skills/fundraising-narrative",
172
172
  "./.claude/skills/funnel-analysis",
173
+ "./.claude/skills/ghostwriter",
174
+ "./.claude/skills/ghostwriter-delete",
175
+ "./.claude/skills/ghostwriter-fetch",
176
+ "./.claude/skills/ghostwriter-list",
177
+ "./.claude/skills/ghostwriter-show",
178
+ "./.claude/skills/ghostwriter-write",
173
179
  "./.claude/skills/git-workflow",
174
180
  "./.claude/skills/github-ci",
175
181
  "./.claude/skills/grafana",
@@ -264,6 +270,9 @@
264
270
  "./.claude/skills/playwright-testing",
265
271
  "./.claude/skills/po-discovery",
266
272
  "./.claude/skills/positioning-strategy",
273
+ "./.claude/skills/post-as",
274
+ "./.claude/skills/post-as-ghostwriter",
275
+ "./.claude/skills/post-as-me",
267
276
  "./.claude/skills/prepare-for-review",
268
277
  "./.claude/skills/privacy-review",
269
278
  "./.claude/skills/project-analysis-core",
package/CHANGELOG.md CHANGED
@@ -702,6 +702,75 @@ our recommendation order, not its support status.
702
702
  > that forces a new era split (`# Era: 2.16.x`, etc.) — see
703
703
  > [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
704
704
 
705
+ ## [2.17.0](https://github.com/event4u-app/agent-config/compare/2.16.0...2.17.0) (2026-05-15)
706
+
707
+ ### Features
708
+
709
+ * **user-types:** seed install-time axis directory with 7 user-type YAMLs ([d3264a5](https://github.com/event4u-app/agent-config/commit/d3264a5fd2e76e671b415c4a40279427d738c21c))
710
+ * **eval:** measure skill-count reduction per user-type (step-12 P3) ([db74b3f](https://github.com/event4u-app/agent-config/commit/db74b3ff2f79499a29eb06ec12b64b054435e7d5))
711
+ * **eval:** wire task bench + non-dev baseline 93.75% (step-12 P1) ([b3a0cde](https://github.com/event4u-app/agent-config/commit/b3a0cde598b592de7150bc118190083f181a7279))
712
+ * **install:** add --interactive flag for user-type / stack / verbosity capture ([779c368](https://github.com/event4u-app/agent-config/commit/779c3680b22ec3afdd427dfcd32ed4816d541773))
713
+ * **schema:** add recommended_for_user_types to skill schema + tag 32 skills ([afb90af](https://github.com/event4u-app/agent-config/commit/afb90af34118036902fb9d2054b1b8c743e650aa))
714
+ * **rules:** add 12 domain-safety rules (PII, disclaimers, retention) ([dc9d7f7](https://github.com/event4u-app/agent-config/commit/dc9d7f70644d1b41df7af43f0acfeb8105472345))
715
+ * **eval:** add non-dev evaluation corpus for step-12 phase 1 ([9d4881e](https://github.com/event4u-app/agent-config/commit/9d4881e9c366c701f44fcfc9ac3c689665ec91ad))
716
+ * **ghostwriter:** enforce alias validation in lint_ghostwriter_source ([3862a08](https://github.com/event4u-app/agent-config/commit/3862a08194037433a721f58795bbc1a60a86b5d8))
717
+ * **ghostwriter:** resolve --as=<value> against aliases in write command ([5ae4933](https://github.com/event4u-app/agent-config/commit/5ae493334bd41956a839fd88f0036d6098fb0884))
718
+ * **ghostwriter:** add aliases schema + consumer settings toggle ([0d551c9](https://github.com/event4u-app/agent-config/commit/0d551c9818e40fec9fdc3320f1c5d615902f0e7f))
719
+ * **ghostwriter:** /ghostwriter:list, :show, :delete maintenance commands ([0cdc009](https://github.com/event4u-app/agent-config/commit/0cdc009c60082d323efe6e495ab84bb4ad6cb48f))
720
+ * **ghostwriter:** /post-as cluster (me · ghostwriter) + sync artifacts ([f6aca57](https://github.com/event4u-app/agent-config/commit/f6aca57a178d22cc865a1a0f81065fbae11b3dd1))
721
+ * **ghostwriter:** /ghostwriter:write command + disclosure footer ([2f7349e](https://github.com/event4u-app/agent-config/commit/2f7349ec7b40580ab2b9a3b5d19059cd3f750503))
722
+ * **ghostwriter:** /ghostwriter cluster dispatcher + /ghostwriter:fetch ([c4d9c09](https://github.com/event4u-app/agent-config/commit/c4d9c09609ddc3de063126ba8c5549069cc49595))
723
+ * **ghostwriter:** consumer-side README + gitignore-by-default block ([4ffcb01](https://github.com/event4u-app/agent-config/commit/4ffcb017149cba4ee3207bcfb537e42626831276))
724
+ * **ghostwriter:** add package-side fictional fixture + README ([c3daeea](https://github.com/event4u-app/agent-config/commit/c3daeea34dfbcf460930d115053ae439055c87d6))
725
+
726
+ ### Bug Fixes
727
+
728
+ * **rules:** trim 8 domain-safety descriptions to ≤150 chars ([1f095c1](https://github.com/event4u-app/agent-config/commit/1f095c1c140d2f071a1b6143283b946e94c0d209))
729
+ * **contracts:** scrub roadmap refs from router-blending + universal-skills ([36dc8a4](https://github.com/event4u-app/agent-config/commit/36dc8a44012b4cad431c2d46223a738bf476f0a8))
730
+ * **contracts:** keep-beta-until within 90-day window (2026-08-13) ([c6f1082](https://github.com/event4u-app/agent-config/commit/c6f108246b48fafad9fd564d1e4d4a493642bc91))
731
+ * **schema:** allow applies_to_user_types in rule frontmatter ([80f73f6](https://github.com/event4u-app/agent-config/commit/80f73f639dcb0c8d347b4ccda88ad52ed091747e))
732
+
733
+ ### Documentation
734
+
735
+ * **roadmaps:** step-12 closure run #2 — author step-9/13/14, flip in-scope, defer external ([6191506](https://github.com/event4u-app/agent-config/commit/6191506a7d70472d164385b4a7b3ab514bd5deb1))
736
+ * **roadmaps:** step-12 autonomous closure (Phases 0/1/3/5/7 closed) ([32f3177](https://github.com/event4u-app/agent-config/commit/32f317725f2a5000be0caf64d21d40103ec0be86))
737
+ * **announcements:** draft non-dev launch posts + case-study tpl (step-12 P7) ([d624ad6](https://github.com/event4u-app/agent-config/commit/d624ad65392d1994fc65dd1b6b7d33ba18fc80f1))
738
+ * **roadmaps:** close step-12 P6 L113 (GitHub repo metadata applied) ([b7099ee](https://github.com/event4u-app/agent-config/commit/b7099ee493d483e3aec07c6d33e767dbf99edc4d))
739
+ * **roadmaps:** step-12 final-push annotations + closure report ([0c0e575](https://github.com/event4u-app/agent-config/commit/0c0e5752300a25dfdf1cf09569df2dc37eaf5f6e))
740
+ * **contracts:** add init-telemetry v1 wire contract (step-12 P7 L127) ([dc9ea0a](https://github.com/event4u-app/agent-config/commit/dc9ea0a44b801a821ab3a6309c64fadf990eec3a))
741
+ * **roadmaps:** step-12 closure report — terminal in-branch state ([70cc0f8](https://github.com/event4u-app/agent-config/commit/70cc0f8adc6485a61c4f1c75ff8bf926f22f1aad))
742
+ * **readme:** drop duplicate Laravel-featured-domain section (5 lines) ([a7c332b](https://github.com/event4u-app/agent-config/commit/a7c332bdf61ccb2de358c65f14cb62caf24008bd))
743
+ * **contracts:** add stability frontmatter to router-blending + universal-skills ([3273392](https://github.com/event4u-app/agent-config/commit/3273392a9d87d82dd8baad8fc8a61914ffa2bed6))
744
+ * **readme:** reframe identity as Universal AI Agent OS ([4b2a328](https://github.com/event4u-app/agent-config/commit/4b2a3282a08ce4c568722597741931c47d21a6b8))
745
+ * **readme:** trim README under 750-line floor, extract docs/safety.md ([2b74b1b](https://github.com/event4u-app/agent-config/commit/2b74b1bffed90ea5495fb96de6d9cce2db9415fb))
746
+ * **readme:** add data governance & domain safety section ([8aa2b8e](https://github.com/event4u-app/agent-config/commit/8aa2b8edef5a29a3bcbef810c23083c4cfb4e237))
747
+ * add role-based + laravel getting-started + CI link check ([ea65555](https://github.com/event4u-app/agent-config/commit/ea655557c785631df83766dd1d63458bf83c876f))
748
+ * **ghostwriter:** cross-links, command counts, beta dates, roadmap-ref cleanup ([b8d0fb8](https://github.com/event4u-app/agent-config/commit/b8d0fb8ec230aa5992aedc00d78b0aa56e8ce430))
749
+ * **contracts:** write-engine v1 + register /post-as cluster ([94d0cd8](https://github.com/event4u-app/agent-config/commit/94d0cd89d046251ffed6a8c42f415a5c47451503))
750
+ * **roadmaps:** mark step-4 Phase 2 complete + regenerate progress ([7ec448d](https://github.com/event4u-app/agent-config/commit/7ec448dc872072ad93921dc0b9b166e5bf122237))
751
+ * **contracts:** register /ghostwriter cluster (fetch · write · list · show · delete) ([01b4525](https://github.com/event4u-app/agent-config/commit/01b4525e3272dfb089bdac215f52a6175b9ab47e))
752
+ * **roadmaps:** mark step-4 Phase 1 complete + regenerate progress ([5a574e2](https://github.com/event4u-app/agent-config/commit/5a574e27337fc598935281cda331cca0ecc34324))
753
+ * **contracts:** lock ghostwriter v1 schema with verification + attestation fields ([421fc2e](https://github.com/event4u-app/agent-config/commit/421fc2e5fee09834590ca2594bf06875e38acfb3))
754
+
755
+ ### Build
756
+
757
+ * **ghostwriter:** wire lint + copy-as-is sync for package fixtures ([c5a3c79](https://github.com/event4u-app/agent-config/commit/c5a3c791bf51ceb23fde186d3b2f60675107c923))
758
+
759
+ ### Chores
760
+
761
+ * **scripts:** draft update-github-metadata.sh (step-12 P6 L113) ([2a2c5c2](https://github.com/event4u-app/agent-config/commit/2a2c5c20cadb4ba653a5660797b28add7dfc43a6))
762
+ * **index:** regen index + catalog after description trimming ([f4915e4](https://github.com/event4u-app/agent-config/commit/f4915e47172a7b4482a5440f17d543072c90c303))
763
+ * **compression:** propagate trimmed descriptions to .agent-src + hashes ([0a9352d](https://github.com/event4u-app/agent-config/commit/0a9352d7d20856301746a5839d25e2d52398920b))
764
+ * **ownership:** regen file-ownership matrix ([bc13dd2](https://github.com/event4u-app/agent-config/commit/bc13dd2fe67d5c571f05964b84702cb6d7b193c2))
765
+ * **index:** regen agents/index.md + docs/catalog.md ([20fefb0](https://github.com/event4u-app/agent-config/commit/20fefb043a25034a715cb7e76ec6174831357061))
766
+ * **roadmaps:** step-12 phases 3 / 5 / 6 done + regen dashboard ([f07a0b1](https://github.com/event4u-app/agent-config/commit/f07a0b15cbe784eb17b9b75d06cae91e726b08f8))
767
+ * **generated:** add 12 domain-safety rule symlinks to .claude/rules ([b95364a](https://github.com/event4u-app/agent-config/commit/b95364ae8e52a582ecb8c2598402782e06bfa83d))
768
+ * **roadmap:** close step-12 Phase 4 — domain safety rules shipped ([b02290f](https://github.com/event4u-app/agent-config/commit/b02290f50b034ede8f725b9558d1060578024855))
769
+ * **roadmaps:** add step-12 universal-os-reframe + regen dashboard ([89e06ca](https://github.com/event4u-app/agent-config/commit/89e06caf5ae21d21fa7f2705720e53888eb53c69))
770
+ * **ghostwriter:** close out step-4 — archive roadmap, regen index + ownership matrix, bump template version ([70521c4](https://github.com/event4u-app/agent-config/commit/70521c41bc9305f5d39a7f8f7775388b724c56a6))
771
+
772
+ Tests: 4459 (+54 since 2.16.0)
773
+
705
774
  ## [2.16.0](https://github.com/event4u-app/agent-config/compare/2.15.0...2.16.0) (2026-05-15)
706
775
 
707
776
  ### Features
package/README.md CHANGED
@@ -1,13 +1,15 @@
1
- # Agent Config — Governed Agent System
1
+ # Agent Config — Universal AI Agent OS
2
2
 
3
- > **agent-config is not a runtime, but it ships a deterministic orchestration contract / state machine for host agents.**
3
+ > **A deterministic orchestration contract for AI agents audited skills, governance rules, replayable state usable by developers, founders, and creators alike.**
4
4
 
5
- Give your AI agents an audit-disciplined orchestration contract testing, Git, CI, code review, and **120+ stack-aware skills** with quality guardrails built in.
5
+ Give your AI agents an audit-disciplined execution layer: **210 skills**, **79 governance rules**, **124 commands**, and a replayable state machine that turns any host agent (Claude Code, Augment, Cursor, Copilot, Windsurf) into a reliable team member.
6
6
 
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).
7
+ | 👩‍💻 Developers | 🚀 Founders & Operators | ✍️ Creators & Consultants |
8
+ |---|---|---|
9
+ | Implement tickets, fix CI, write tests, run PR reviews — `/implement-ticket`, `/work`, `/commit`, `/fix ci`, `/create-pr` — with stack-aware skills for Laravel · Symfony · Next.js · React · Node. | Pitch decks, runway math, OKR trees, GTM launches, pricing reviews — `runway-cognition`, `unit-economics-modeling`, `fundraising-narrative`, `gtm-launch`, `okr-tree-modeling`. | Editorial calendars, brand voice, ghostwriting, content funnels, discovery interviews — `voice-and-tone-design`, `editorial-calendar`, `ghostwriter`, `content-funnel-design`, `discovery-interview`. |
8
10
 
9
11
  <p align="center">
10
- <strong>210 Skills</strong> · <strong>67 Rules</strong> · <strong>115 Commands</strong> · <strong>72 Guidelines</strong> · <strong>22 Personas</strong> · <strong>5 Advisors</strong> · <strong>8 AI Tools</strong>
12
+ <strong>210 Skills</strong> · <strong>79 Rules</strong> · <strong>124 Commands</strong> · <strong>72 Guidelines</strong> · <strong>22 Personas</strong> · <strong>5 Advisors</strong> · <strong>8 AI Tools</strong>
11
13
  </p>
12
14
 
13
15
  ---
@@ -67,6 +69,12 @@ work-engine phases ran end-to-end. Stack-aware skills auto-load.
67
69
  > or wire optional memory — see [**Detailed installation**](#detailed-installation)
68
70
  > below. Contributors rebuilding the package — jump to
69
71
  > [**Development**](#development).
72
+ >
73
+ > **Non-developer? No terminal?** Skip `npx` entirely — host
74
+ > agent-config as a [Cloudflare MCP endpoint](#self-hosted-mcp-on-cloudflare--zero-local-install)
75
+ > and connect from Claude Desktop. The [role-based getting started](docs/getting-started-by-role.md)
76
+ > guide names the three skills each role reaches for first (Creator,
77
+ > Founder, Consultant, GTM, Finance/Ops, Developer).
70
78
 
71
79
  ### Detailed installation
72
80
 
@@ -497,6 +505,12 @@ kernel set: [`docs/contracts/kernel-membership.md`](docs/contracts/kernel-member
497
505
 
498
506
  ---
499
507
 
508
+ ## Data governance & domain safety
509
+
510
+ 12 domain-safety rules (`.agent-src.uncompressed/rules/domain-safety-*.md`) act as a per-domain output floor — PII redaction for support / finance / recruiting / marketing, advice disclaimers for legal / financial / medical / consulting drafts, retention guidance for finance / support, and ops floors for logging / export. Full surface → rule(s) → floor matrix: [`docs/safety.md`](docs/safety.md).
511
+
512
+ ---
513
+
500
514
  ## Featured Skills
501
515
 
502
516
  | Skill | What your agent learns |
@@ -535,7 +549,7 @@ kernel set: [`docs/contracts/kernel-membership.md`](docs/contracts/kernel-member
535
549
  | [`/jira-ticket`](.agent-src/commands/jira-ticket.md) | Read ticket from branch, implement feature |
536
550
  | [`/compress`](.agent-src/commands/compress.md) | Compress skills for token efficiency |
537
551
 
538
- → [Browse all 115 active commands](.agent-src/commands/)
552
+ → [Browse all 124 active commands](.agent-src/commands/)
539
553
 
540
554
  ---
541
555
 
@@ -567,7 +581,7 @@ slash-commands) &nbsp; 📌 = informational marker only (no auto-discovery
567
581
  or manual wiring required)
568
582
 
569
583
  > **What this means in practice:** Claude Code gets the full project-scoped
570
- > package (rules + 210 skills + 115 native commands); Augment Code gets the
584
+ > package (rules + 210 skills + 124 native commands); Augment Code gets the
571
585
  > same content but only from a single global install at `~/.augment/`.
572
586
  > Cursor, Cline, Windsurf, Gemini CLI, GitHub Copilot, Roo Code, Codex CLI,
573
587
  > and Continue.dev only get the **rules** natively; skills and commands are
@@ -631,6 +645,28 @@ Create it interactively with `/agents user init`. Inspect with
631
645
  legacy `personal.user_name` key in `.agent-settings.yml` stays as a
632
646
  fallback when `.agent-user.md` is absent.
633
647
 
648
+ ## Ghostwriter (`agents/ghostwriter/<slug>.md`)
649
+
650
+ Third voice primitive — captures **public-facing writing voice of
651
+ documented public figures** (authors, executives, academics,
652
+ journalists, public speakers, deceased historical figures).
653
+ `/ghostwriter:fetch <url-or-name>` runs an attestation gate, delegates
654
+ to the host agent's `web-fetch` / `web-search` (zero network code in
655
+ the package), and writes `agents/ghostwriter/<slug>.md` — **gitignored
656
+ by default**, never shipped in the OSS package. `/ghostwriter:write
657
+ --as=<slug>` drafts in that voice and appends the **mandatory
658
+ non-removable disclosure footer** (`*Written in the style of <name>,
659
+ not by them.*`); `/post-as:ghostwriter` is a thin alias. Private
660
+ individuals are rejected; paywalled / leaked / DM content banned at
661
+ the schema level. `:list`, `:show`, `:delete` round out the cluster.
662
+ Schema: [`docs/contracts/ghostwriter-schema.md`](docs/contracts/ghostwriter-schema.md).
663
+
664
+ | Primitive | Voice | Disclosure footer |
665
+ |---|---|---|
666
+ | `personas/*.md` | review-lens (internal critique) | n/a |
667
+ | `.agent-user.md` | maintainer's own voice (`/post-as:me`) | none — you are the author |
668
+ | `agents/ghostwriter/<slug>.md` | external public-figure (`/post-as:ghostwriter`) | mandatory, non-removable |
669
+
634
670
  ## Core Principles
635
671
 
636
672
  - **Analyze before implementing** — no guessing, no blind edits
@@ -662,22 +698,7 @@ step (package manager + `rm -rf` of generated dirs).
662
698
 
663
699
  ### Maintainer telemetry (opt-in, default-off)
664
700
 
665
- A local-only artefact-engagement log can be enabled by maintainers to see
666
- which skills, rules, commands, and guidelines the agent actually consults
667
- and applies during a `/implement-ticket` or `/work` run. The log is a
668
- JSONL file under the project root; nothing is uploaded, nothing is shared
669
- across projects. Default is off; consumers see no prompts.
670
-
671
- ```yaml
672
- # .agent-settings.yml — opt in only when you want measurement
673
- telemetry:
674
- artifact_engagement:
675
- enabled: true
676
- ```
677
-
678
- Reports: `./agent-config telemetry:report`. Full contract,
679
- privacy/redaction floor, and quartile semantics:
680
- [`contexts/contracts/artifact-engagement-flow.md`](.agent-src.uncompressed/contexts/contracts/artifact-engagement-flow.md) (beta).
701
+ Local-only artefact-engagement log (`telemetry.artifact_engagement.enabled: true` in `.agent-settings.yml`) records which skills / rules / commands / guidelines the agent consults during `/implement-ticket` / `/work`. JSONL under the project root, nothing uploaded, nothing shared. Reports via `./agent-config telemetry:report`. Contract + privacy floor: [`contexts/contracts/artifact-engagement-flow.md`](.agent-src.uncompressed/contexts/contracts/artifact-engagement-flow.md) (beta).
681
702
 
682
703
  ### Context-aware command suggestion
683
704
 
@@ -29,6 +29,14 @@
29
29
  # never shared). Feeds /agents user review / accept only.
30
30
  .agent-user.observations.jsonl
31
31
 
32
+ # Agent config — ghostwriter profiles (real-person public-figure voices,
33
+ # written by /ghostwriter:fetch). Local-only by default; commit explicitly
34
+ # only via the deferred --shared opt-in. README.md stays tracked.
35
+ # See docs/contracts/ghostwriter-schema.md.
36
+ /agents/ghostwriter/*.md
37
+ !/agents/ghostwriter/README.md
38
+ /agents/ghostwriter/*.md.bak
39
+
32
40
  # Agent config — persistent chat history (crash recovery, never commit)
33
41
  /agents/.agent-chat-history
34
42
  /agents/.agent-chat-history.bak
@@ -0,0 +1,79 @@
1
+ # Non-dev launch announcements — step-12 Phase 7 L126
2
+
3
+ Three drafts, one per surface. Drafted via the `ghostwriter` cluster pattern; final voice tuning happens at post-merge surface time.
4
+
5
+ Status: **drafted, not yet posted**. Posting is out-of-scope for the autonomous merge — it lights up after the README and `--user-type` UX are live in `main`.
6
+
7
+ ---
8
+
9
+ ## 1. Product Hunt (no-code tag) — long-form launch post
10
+
11
+ **Title:** `agent-config — a governed skill suite that finally treats consultants, creators, and finance/ops as first-class AI-tool users`
12
+
13
+ **Tagline (60 chars):** `AI agent OS for non-developers — no terminal required`
14
+
15
+ **Body:**
16
+
17
+ Most "AI assistant" tools assume you write code. The rest assume you just want to chat. `agent-config` is the third option: a **governed skill, rule, and command suite** that gives every AI coding tool (Claude Code, Cursor, Windsurf, Copilot, Augment) a shared playbook — and it works just as well for a marketer drafting launch copy, a consultant building a discovery guide, or a founder modelling runway as it does for an engineer shipping a feature.
18
+
19
+ What's actually new:
20
+ - **`--user-type` axis.** `npx agent-config init --user-type=creator` loads the ~7 skills relevant to you, not all 195.
21
+ - **Domain safety floors.** PII never leaks into a support macro draft. Health, legal, financial outputs ship with mandatory disclaimers.
22
+ - **No fork required.** All projection trees regenerate from a single source-of-truth; consumer config is one `.agent-settings.yml`.
23
+
24
+ Open source, MIT. Comments welcome — especially "this is wrong for my workflow, here's why."
25
+
26
+ ---
27
+
28
+ ## 2. Indie Hackers — consulting forum post
29
+
30
+ **Title:** `[Open-source release] A shared skill library for solo consultants who use Claude or ChatGPT every day`
31
+
32
+ **Body:**
33
+
34
+ Hey IH —
35
+
36
+ If you run a one-person consulting practice and you already lean on an AI assistant for discovery guides, positioning audits, voice-of-customer extraction, or stakeholder trade-off matrices — I built (and just open-sourced) a shared library of skills for that.
37
+
38
+ It's called `agent-config`. The bit relevant to consultants:
39
+ - ~7 skills auto-loaded for `--user-type=consultant` (vs. 195 total) — `discovery-interview`, `competitive-positioning`, `voc-extract`, `stakeholder-tradeoff`, `market-entry-analysis`, `customer-research`, `competitive-moat-analysis`.
40
+ - Works inside Claude Code, Cursor, Windsurf, ChatGPT custom GPTs, and Copilot — same skills, different host.
41
+ - 16-prompt benchmark proves the agent picks the right skill 93.75 % of the time on real consulting prompts.
42
+
43
+ `npx agent-config init --user-type=consultant` and you're done.
44
+
45
+ Looking for **5 working consultants** to try it on a real client engagement and let me know where it breaks. Comment or DM if interested.
46
+
47
+ ---
48
+
49
+ ## 3. r/ContentWritingJobs — short link-and-ask post
50
+
51
+ **Title:** `Open-sourced a skill library for marketers and content writers who use AI assistants — looking for 3 real test runs`
52
+
53
+ **Body:**
54
+
55
+ Built and released `agent-config` — a governed skill, rule, and command suite for AI assistants (Claude, ChatGPT, Cursor). Includes the skills marketers actually use:
56
+
57
+ - `voice-and-tone-design` — three-attribute voice + tone-by-context matrix
58
+ - `messaging-architecture` — primary message, supporting proofs, audience matrix
59
+ - `editorial-calendar` — evergreen / campaign / reactive split, per-channel beats
60
+ - `release-comms` — turn changelogs into value-framed announcements
61
+ - `content-funnel-design` — per-stage content shape, mid-funnel leak diagnosis
62
+
63
+ Setup: `npx agent-config init --user-type=creator`. No coding, no terminal homework beyond one command.
64
+
65
+ Free, MIT, no telemetry without opt-in. Looking for **3 content writers** to walk through a real brief end-to-end and tell me where the skill descriptions confuse you. I'll credit you in the case studies.
66
+
67
+ DM or comment.
68
+
69
+ ---
70
+
71
+ ## Anti-patterns (what NOT to do)
72
+
73
+ - **No "the future of AI" framing.** Concrete artefacts only.
74
+ - **No fake testimonials.** Recruit live (5 IH + 3 Reddit + Product Hunt traffic) and run real case studies (Phase 7 L128–131).
75
+ - **No "killer of X" framing.** Position as the missing layer between general assistants and code-only tools.
76
+
77
+ ## Provenance
78
+
79
+ Drafts produced 2026-05-15 in the step-12 autonomous closure run. Voice tuning at post-merge time per the post-as cluster.
@@ -142,8 +142,8 @@ note, package-internal path-swap, description budget, and the
142
142
  | Layer | Count | Purpose |
143
143
  |---|---|---|
144
144
  | **Skills** | 210 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
145
- | **Rules** | 67 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
146
- | **Commands** | 115 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
145
+ | **Rules** | 79 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
146
+ | **Commands** | 124 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/compress`, … |
147
147
  | **Guidelines** | 72 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
148
148
  | **Templates** | 7 | Scaffolds for features, roadmaps, contexts, skills, overrides |
149
149
  | **Contexts** | 5 | Shared knowledge about the system itself |
@@ -0,0 +1,60 @@
1
+ # Case study — `<short-title>`
2
+
3
+ > **Step-12 Phase 7 L128–131 template.** Drop a copy into `docs/case-studies/` with filename `<YYYY-MM-DD>-<user-type>-<slug>.md`. Anonymise as needed; metrics must be real.
4
+
5
+ ## Subject
6
+
7
+ - **User-type:** (consultant | creator | founder | finance | ops | gtm | developer)
8
+ - **Tool host:** (claude-code | cursor | windsurf | copilot | claude.ai web | other)
9
+ - **`agent-config` install:** `npx agent-config init --user-type=<type>`
10
+ - **Anonymised:** yes / no (if yes — describe what was abstracted)
11
+
12
+ ## Workflow before
13
+
14
+ One paragraph. What was the specific job-to-be-done? How was it solved before `agent-config` (which tool, how many steps, where did it stall)? Include **time-to-output** as a baseline metric.
15
+
16
+ ## Workflow after
17
+
18
+ One paragraph. Same job, after install. Which **3–5 skills** carried the load? Which **commands** did the user actually invoke? Where did the agent ask vs. act?
19
+
20
+ ## Top-10 skill invocations (proof of non-dev workflow)
21
+
22
+ Paste output of `task bench --history --top 10` (or the equivalent host log). The closure gate (L130) requires this list to contain **zero** of: `test`, `deploy`, `ci`. If it does, the case study counts as proof of non-dev workflow rather than disguised dev work.
23
+
24
+ ```
25
+ 1. <skill-name> (N invocations)
26
+ 2. ...
27
+ ...
28
+ 10. ...
29
+ ```
30
+
31
+ ## Quantified outcomes
32
+
33
+ | Metric | Before | After | Δ |
34
+ |---|---:|---:|---:|
35
+ | Time-to-output (minutes) | | | |
36
+ | Number of revision passes | | | |
37
+ | Self-reported confidence (1–5) | | | |
38
+ | <domain-specific KPI> | | | |
39
+
40
+ Example: *"Brief drafting: 90 min → 25 min, 73 % time reduction."*
41
+
42
+ ## What broke
43
+
44
+ Be specific. The case study is only useful if it lists at least **two real friction points** — skill misfires, rule false-positives, missing user-type tags, confusing description language. These feed back into the corpus + skill descriptions.
45
+
46
+ 1. ...
47
+ 2. ...
48
+
49
+ ## Verbatim quote (optional, with consent)
50
+
51
+ > "...short quote that captures the value the user got, in their voice..."
52
+
53
+ — `<role>, <anonymised company shape>`
54
+
55
+ ## Provenance & consent
56
+
57
+ - **Interview / live walkthrough date:** YYYY-MM-DD
58
+ - **Consent for publication:** signed / verbal-recorded / declined-attribution
59
+ - **Author:** maintainer initials
60
+ - **Reviewed by user before merge:** yes / no