superpowers-optimized/plugin.universal.yaml at main · REPOZY/superpowers-optimized · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
# plugin.universal.yaml — single source of truth for superpowers-optimized
# Compile with: hookbridge compile
# (or before npm publish: node /path/to/hookbridge/hookbridge.js compile)

meta:
  name: superpowers-optimized
  version: "6.10.0"
  description: "Workflow skills and hooks for Claude Code and Codex"
  author: "Jesse Vincent, forked by REPOZY"
  homepage: "https://github.com/REPOZY/superpowers-optimized"
  repository: "https://github.com/REPOZY/superpowers-optimized"
  license: "MIT"
  keywords: ["skills", "tdd", "debugging", "code-review", "workflows", "agentic", "token-efficiency", "hooks", "safety", "subagent"]
  platforms: [claude-code, codex]

hooks:
  # --- SessionStart ---

  # Claude Code: polyglot CMD/bash wrapper for cross-platform startup
  - event: SessionStart
    matcher: "startup|clear|compact"
    command: "{PLUGIN_ROOT}/hooks/run-hook.cmd session-start"
    async: false
    platforms: [claude-code]

  # Claude Code: project memory. Its own hook so it gets its own 10,000-character
  # additionalContext budget — the router and memory overflowed one field together.
  - event: SessionStart
    matcher: "startup|clear|compact"
    command: "node {PLUGIN_ROOT}/hooks/session-memory.js"
    async: false
    platforms: [claude-code]

  # Claude Code: async context engine
  - event: SessionStart
    command: "node {PLUGIN_ROOT}/hooks/context-engine.js"
    async: true
    platforms: [claude-code]

  # Codex: dedicated session-start adapter
  - event: SessionStart
    matcher: "startup|resume"
    command: "node {PLUGIN_ROOT}/hooks/codex/session-start-adapter.js"
    platforms: [codex]

  # --- UserPromptSubmit ---

  # Claude Code: shared skill activator
  - event: UserPromptSubmit
    command: "node {PLUGIN_ROOT}/hooks/skill-activator.js"
    platforms: [claude-code]

  # Codex: dedicated prompt adapter
  - event: UserPromptSubmit
    command: "node {PLUGIN_ROOT}/hooks/codex/user-prompt-submit-adapter.js"
    platforms: [codex]

  # --- PostToolUse ---

  # Claude Code only: track file edits
  - event: PostToolUse
    matcher: "Edit|Write"
    command: "node {PLUGIN_ROOT}/hooks/track-edits.js"
    platforms: [claude-code]

  # Claude Code only: track skill usage
  - event: PostToolUse
    matcher: "Skill"
    command: "node {PLUGIN_ROOT}/hooks/track-session-stats.js"
    platforms: [claude-code]

  # Codex: reactive Bash output compression
  - event: PostToolUse
    matcher: "Bash"
    command: "node {PLUGIN_ROOT}/hooks/codex/posttool-bash-compress-adapter.js"
    platforms: [codex]

  # --- Stop ---

  # Claude Code: stop reminders
  - event: Stop
    command: "node {PLUGIN_ROOT}/hooks/stop-reminders.js"
    platforms: [claude-code]

  # Codex: dedicated stop adapter
  - event: Stop
    command: "node {PLUGIN_ROOT}/hooks/codex/stop-adapter.js"
    platforms: [codex]

  # --- SubagentStop ---

  # Claude Code only: subagent guard
  - event: SubagentStop
    command: "node {PLUGIN_ROOT}/hooks/subagent-guard.js"
    platforms: [claude-code]

  # --- PreToolUse ---

  # Claude Code: block dangerous bash commands
  - event: PreToolUse
    matcher: "Bash"
    command: "node {PLUGIN_ROOT}/hooks/safety/block-dangerous-commands.js"
    platforms: [claude-code]

  # Claude Code: protect secrets from file/bash ops
  - event: PreToolUse
    matcher: "Read|Edit|Write|Bash"
    command: "node {PLUGIN_ROOT}/hooks/safety/protect-secrets.js"
    platforms: [claude-code]

  # Claude Code: bash output compression
  - event: PreToolUse
    matcher: "Bash"
    command: "node {PLUGIN_ROOT}/hooks/bash-compress-hook.js"
    platforms: [claude-code]

  # Claude Code only: deny this plugin's skills inside subagents before they run
  - event: PreToolUse
    matcher: "Skill"
    command: "node {PLUGIN_ROOT}/hooks/subagent-guard.js"
    platforms: [claude-code]

  # Codex: dedicated pretool bash adapter
  - event: PreToolUse
    matcher: "Bash"
    command: "node {PLUGIN_ROOT}/hooks/codex/pretool-bash-adapter.js"
    platforms: [codex]

skills:
  - path: skills/
    recursive: true

extensions:
  claude-code:
    env_var: CLAUDE_PLUGIN_ROOT
    description: "Agentic development framework for Claude Code — disciplined workflow routing, TDD enforcement, safety hooks, systematic debugging, and code review"

  codex:
    install_path: "$HOME/.codex/{meta.name}"
    legacy_install_paths: ["$HOME/.codex/superpowers"]
    description: "Structured workflow skills for Codex — systematic debugging, TDD, brainstorming, code review, and 30+ expert workflows. Skills work on all platforms. Lifecycle hooks (routing, safety, reminders) require separate setup on macOS/Linux."
    display_name: "Superpowers Optimized"
    short_description: "30+ expert workflow skills — debugging, TDD, code review, brainstorming, and more"