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
# 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.5.2"
  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: 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]

  # 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"