@hybridlabor-api/aos 4.2.0-beta.0 → 4.3.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 (133) hide show
  1. package/.agents/graph.md +3 -1
  2. package/.agents/nodes.json +4 -2
  3. package/.claude/workflows/startcycle-dispatch.mjs +18 -5
  4. package/.claude/workflows/teamwork-dispatch.mjs +287 -0
  5. package/CLAUDE.md +37 -84
  6. package/CODEX.md +31 -12
  7. package/GEMINI.md +51 -58
  8. package/README.de.md +13 -12
  9. package/README.md +13 -12
  10. package/README.pt.md +13 -12
  11. package/THIRD_PARTY_NOTICES.md +104 -0
  12. package/docs/skills_table.md +1 -0
  13. package/installer.js +27 -10
  14. package/package.json +6 -1
  15. package/scripts/validate-skills.mjs +402 -0
  16. package/skills/basic/bdbmediastorm/SKILL.md +7 -5
  17. package/skills/basic/godmode-engineering/SKILL.md +1 -1
  18. package/skills/basic/godmode-shipping/SKILL.md +1 -1
  19. package/skills/basic/startcycle/SKILL.md +3 -1
  20. package/skills/basic/startcycle-graph/SKILL.md +18 -2
  21. package/skills/basic/startcycle-graph-user/SKILL.md +3 -1
  22. package/skills/basic/teamwork-preview/SKILL.md +209 -0
  23. package/skills/bdbrainstorm/SKILL.md +4 -3
  24. package/skills/github-repo/SKILL.md +1 -0
  25. package/skills/global_config/agent-tool-builder/SKILL.md +5 -4
  26. package/skills/global_config/ai-product/SKILL.md +3 -2
  27. package/skills/global_config/ask-tim/SKILL.md +75 -6
  28. package/skills/global_config/{bdb-adobe-suite-mcp.md → bdb-adobe-suite-mcp/SKILL.md} +1 -0
  29. package/skills/global_config/{bdb-after-effects-mcp.md → bdb-after-effects-mcp/SKILL.md} +1 -0
  30. package/skills/global_config/{bdb-blender-mcp.md → bdb-blender-mcp/SKILL.md} +1 -0
  31. package/skills/global_config/{bdb-computer-use-mcp.md → bdb-computer-use-mcp/SKILL.md} +1 -0
  32. package/skills/global_config/{bdb-davinci-mcp.md → bdb-davinci-mcp/SKILL.md} +1 -0
  33. package/skills/global_config/bdb-ecosystem-health/SKILL.md +3 -3
  34. package/skills/global_config/{bdb-grandma3-mcp.md → bdb-grandma3-mcp/SKILL.md} +1 -0
  35. package/skills/global_config/{bdb-memb-mcp.md → bdb-memb-mcp/SKILL.md} +10 -0
  36. package/skills/global_config/{bdb-resolume-mcp.md → bdb-resolume-mcp/SKILL.md} +1 -0
  37. package/skills/global_config/{bdb-rhino-mcp.md → bdb-rhino-mcp/SKILL.md} +1 -0
  38. package/skills/global_config/{bdb-touchdesigner-mcp.md → bdb-touchdesigner-mcp/SKILL.md} +1 -0
  39. package/skills/global_config/{bdb-unreal-mcp.md → bdb-unreal-mcp/SKILL.md} +1 -0
  40. package/skills/global_config/{bdb-vectorworks-mcp.md → bdb-vectorworks-mcp/SKILL.md} +1 -0
  41. package/skills/global_config/bdbresilience/SKILL.md +216 -0
  42. package/skills/global_config/bdbresilience/contracts/nodes-integration.md +225 -0
  43. package/skills/global_config/bdbresilience/references/cicd-triage.md +179 -0
  44. package/skills/global_config/bdbresilience/references/distributed-locking.md +235 -0
  45. package/skills/global_config/bdbresilience/references/error-recovery.md +210 -0
  46. package/skills/global_config/bdbresilience/references/two-phase-go-gate.md +151 -0
  47. package/skills/global_config/bdbsaashost/SKILL.md +50 -50
  48. package/skills/global_config/browser-automation/SKILL.md +4 -4
  49. package/skills/global_config/crewai/SKILL.md +3 -2
  50. package/skills/global_config/debugger/SKILL.md +3 -6
  51. package/skills/global_config/domain-modeling/ADR-FORMAT.md +47 -0
  52. package/skills/global_config/domain-modeling/CONTEXT-FORMAT.md +60 -0
  53. package/skills/global_config/domain-modeling/SKILL.md +77 -0
  54. package/skills/global_config/git-advanced-workflows/SKILL.md +0 -1
  55. package/skills/global_config/github-actions-templates/SKILL.md +0 -2
  56. package/skills/global_config/google-sheets-automation/SKILL.md +2 -2
  57. package/skills/global_config/grill-me/SKILL.md +14 -0
  58. package/skills/global_config/grill-with-docs/SKILL.md +24 -0
  59. package/skills/global_config/grilling/SKILL.md +42 -0
  60. package/skills/global_config/neon-postgres/SKILL.md +3 -2
  61. package/skills/global_config/openwiki-skill/scripts/install_daemon.sh +55 -12
  62. package/skills/global_config/playwright-skill/SKILL.md +1 -1
  63. package/skills/global_config/posix-shell-pro/SKILL.md +0 -1
  64. package/skills/global_config/postgres-best-practices/SKILL.md +1 -1
  65. package/skills/global_config/prompt-engineering-patterns/SKILL.md +0 -1
  66. package/skills/global_config/rag-engineer/SKILL.md +4 -3
  67. package/skills/global_config/react-best-practices/SKILL.md +1 -1
  68. package/skills/global_config/remotion/SKILL.md +0 -1
  69. package/skills/global_config/seo/SKILL.md +6 -41
  70. package/skills/global_config/systematic-debugging/CREATION-LOG.md +1 -1
  71. package/skills/global_config/systematic-debugging/root-cause-tracing.md +1 -1
  72. package/skills/global_config/turborepo-caching/SKILL.md +0 -1
  73. package/skills/global_config/using-neon/SKILL.md +1 -47
  74. package/skills/global_config/vector-database-engineer/SKILL.md +0 -1
  75. package/skills/global_config/web-artifacts-builder/LICENSE.txt +1 -1
  76. package/skills/global_config/web-artifacts-builder/SKILL.md +1 -1
  77. package/skills/global_config/webapp-testing/LICENSE.txt +1 -1
  78. package/skills/global_config/webapp-testing/SKILL.md +1 -1
  79. package/.agents/skills/firecrawl/SKILL.md +0 -149
  80. package/.agents/skills/firecrawl/rules/install.md +0 -82
  81. package/.agents/skills/firecrawl/rules/security.md +0 -26
  82. package/.agents/skills/firecrawl-agent/SKILL.md +0 -58
  83. package/.agents/skills/firecrawl-build/SKILL.md +0 -39
  84. package/.agents/skills/firecrawl-build-interact/SKILL.md +0 -68
  85. package/.agents/skills/firecrawl-build-onboarding/SKILL.md +0 -103
  86. package/.agents/skills/firecrawl-build-onboarding/references/auth-flow.md +0 -39
  87. package/.agents/skills/firecrawl-build-onboarding/references/project-setup.md +0 -20
  88. package/.agents/skills/firecrawl-build-onboarding/references/sdk-installation.md +0 -17
  89. package/.agents/skills/firecrawl-build-scrape/SKILL.md +0 -69
  90. package/.agents/skills/firecrawl-build-search/SKILL.md +0 -69
  91. package/.agents/skills/firecrawl-crawl/SKILL.md +0 -59
  92. package/.agents/skills/firecrawl-download/SKILL.md +0 -70
  93. package/.agents/skills/firecrawl-interact/SKILL.md +0 -84
  94. package/.agents/skills/firecrawl-map/SKILL.md +0 -51
  95. package/.agents/skills/firecrawl-scrape/SKILL.md +0 -69
  96. package/.agents/skills/firecrawl-search/SKILL.md +0 -60
  97. package/mcps/RhinoMCP/cc-plugin/.claude/settings.json +0 -10
  98. package/mcps/after-effects-mcp/build/index.js +0 -840
  99. package/mcps/after-effects-mcp/build/scripts/applyEffect.jsx +0 -153
  100. package/mcps/after-effects-mcp/build/scripts/applyEffectTemplate.jsx +0 -218
  101. package/mcps/after-effects-mcp/build/scripts/createComposition.jsx +0 -71
  102. package/mcps/after-effects-mcp/build/scripts/createShapeLayer.jsx +0 -147
  103. package/mcps/after-effects-mcp/build/scripts/createSolidLayer.jsx +0 -114
  104. package/mcps/after-effects-mcp/build/scripts/createTextLayer.jsx +0 -115
  105. package/mcps/after-effects-mcp/build/scripts/getLayerInfo.jsx +0 -192
  106. package/mcps/after-effects-mcp/build/scripts/getProjectInfo.jsx +0 -90
  107. package/mcps/after-effects-mcp/build/scripts/listCompositions.jsx +0 -50
  108. package/mcps/after-effects-mcp/build/scripts/mcp-bridge-auto.jsx +0 -1773
  109. package/mcps/after-effects-mcp/build/scripts/setLayerProperties.jsx +0 -160
  110. package/mcps/bdb-remoteos-mcp/queue.db +0 -0
  111. package/mcps/bdb-remoteos-mcp/src/bdb_remoteos_mcp/__pycache__/__init__.cpython-312.pyc +0 -0
  112. package/mcps/bdb-remoteos-mcp/src/bdb_remoteos_mcp/__pycache__/incus_client.cpython-312.pyc +0 -0
  113. package/mcps/bdb-remoteos-mcp/src/bdb_remoteos_mcp/__pycache__/main.cpython-312.pyc +0 -0
  114. package/mcps/bdb-remoteos-mcp/src/bdb_remoteos_mcp/__pycache__/queue.cpython-312.pyc +0 -0
  115. package/mcps/bdb-remoteos-mcp/src/bdb_remoteos_mcp/__pycache__/schemas.cpython-312.pyc +0 -0
  116. package/mcps/bdb-remoteos-mcp/src/bdb_remoteos_mcp/__pycache__/server.cpython-312.pyc +0 -0
  117. package/mcps/bdb-remoteos-mcp/src/bdb_remoteos_mcp/__pycache__/webhook.cpython-312.pyc +0 -0
  118. package/mcps/bdb-remoteos-mcp/tests/__pycache__/__init__.cpython-312.pyc +0 -0
  119. package/mcps/bdb-remoteos-mcp/tests/__pycache__/mock_incus.cpython-312.pyc +0 -0
  120. package/mcps/bdb-remoteos-mcp/tests/__pycache__/test_mcp_server.cpython-312-pytest-9.1.1.pyc +0 -0
  121. package/mcps/bdb-remoteos-mcp/tests/__pycache__/test_security_redteam.cpython-312-pytest-9.1.1.pyc +0 -0
  122. package/mcps/bdb-remoteos-mcp/tests/__pycache__/test_webhook.cpython-312-pytest-9.1.1.pyc +0 -0
  123. package/mcps/computer-use-mcp/dist/client.d.ts +0 -150
  124. package/mcps/computer-use-mcp/dist/client.js +0 -136
  125. package/mcps/computer-use-mcp/dist/entrypoint.d.ts +0 -16
  126. package/mcps/computer-use-mcp/dist/entrypoint.js +0 -26
  127. package/mcps/computer-use-mcp/dist/native.d.ts +0 -212
  128. package/mcps/computer-use-mcp/dist/native.js +0 -50
  129. package/mcps/computer-use-mcp/dist/server.d.ts +0 -32
  130. package/mcps/computer-use-mcp/dist/server.js +0 -342
  131. package/mcps/computer-use-mcp/dist/session.d.ts +0 -101
  132. package/mcps/computer-use-mcp/dist/session.js +0 -2372
  133. package/skills/bdbsaastraining/scripts/__pycache__/build_profile.cpython-314.pyc +0 -0
@@ -0,0 +1,209 @@
1
+ ---
2
+ name: teamwork-preview
3
+ description: Interactive 9-step prompt crafting and delegation protocol for autonomous multi-agent teams. Enforces objective verification, integrity modes, and acceptance criteria across Antigravity, Claude Code, Cursor, OpenCode, Codex, and Roo Code.
4
+ category: bdb-core
5
+ ---
6
+
7
+ # 🤝 Teamwork Preview — Multi-Agent Prompt Crafting & Delegation
8
+
9
+ A structured workflow to turn high-level user ideas into robust, objectively verifiable multi-agent project specifications and delegate them cleanly to execution swarms.
10
+
11
+ Two-phase workflow:
12
+ 1. **Interactive Prompt Crafting (Steps 1–9)**: Iteratively define project goals, eliminate ambiguity, select integrity modes, and enforce objective verification mechanisms.
13
+ 2. **Delegation**: Hand off the validated specification to the target multi-agent team or execution harness.
14
+
15
+ ---
16
+
17
+ ## ▶️ On Claude Code: run the script, don't narrate the protocol
18
+
19
+ **Action:** call the `Workflow` tool with `scriptPath` set to
20
+ `$HOME/.claude/workflows/teamwork-dispatch.mjs` — resolve `$HOME` yourself rather
21
+ than hardcoding a username — and `args` set to whatever the user said after the
22
+ command, passed through verbatim. If they said nothing, pass no `args`; step 1
23
+ asks.
24
+
25
+ Use `scriptPath`, not `name`. By-name lookup for a custom workflow script has been
26
+ observed to fail with `Workflow "..." not found` even when the file exists and its
27
+ `meta.name` matches.
28
+
29
+ Then wait for the call to finish and relay its result — the draft path, the
30
+ validation outcome, and any issues it reports. Do not summarise or reinterpret it.
31
+
32
+ **Do NOT walk through the nine steps yourself in response to this skill.** The
33
+ protocol below is the specification the script implements; it is not a set of
34
+ instructions to follow inline. This repo has already paid for that mistake once,
35
+ recorded in `skills/basic/startcycle-graph/SKILL.md`: an earlier version embedded
36
+ its pipeline in prose, the model followed it "in spirit" instead of invoking the
37
+ script, and the entire graph — subagents, state, review, quality gate — silently
38
+ never ran. A 9-step protocol with integrity modes and acceptance criteria is
39
+ exactly the shape of thing that gets approximated.
40
+
41
+ If the `Workflow` tool is unavailable (some harnesses have none; Claude Code can
42
+ have Dynamic Workflows switched off in `/config`), *then* run the protocol below
43
+ manually, in order, one step at a time.
44
+
45
+ ## 🌐 Which harnesses get which
46
+
47
+ | | |
48
+ |---|---|
49
+ | **Claude Code** | The script above. Deterministic: it runs or it doesn't. |
50
+ | **Codex · Cursor · OpenCode · Roo · Antigravity** | The prose protocol below, interpreted by that harness's model. |
51
+
52
+ The `.mjs` script depends on Claude Code's Dynamic Workflows runtime — the ambient
53
+ `agent()` global and the `Workflow` tool. No other harness exposes an equivalent
54
+ today, so the prose is not a fallback there, it is the implementation. Both are
55
+ kept in this one file deliberately: two files would drift, and the drift would be
56
+ invisible until someone on the other harness got different behaviour.
57
+
58
+ **This is not Antigravity's `/teamwork-preview`.** That command is compiled into
59
+ the `agy` binary, with its own conductor/orchestrator/auditor agent types, and is
60
+ maintained by Google. This is an independent implementation of the same idea on a
61
+ different runtime. It will behave differently, and it does not claim otherwise.
62
+
63
+ ---
64
+
65
+ ## 🧭 Core Principles
66
+
67
+ | # | Principle | Rule |
68
+ |---|---|---|
69
+ | 1 | **Specify What, Not How** | Define requirements and acceptance criteria. Never prescribe implementation details (file structure, algorithms, libraries) unless the user explicitly mandates them. |
70
+ | 2 | **Objective Verification** | Every requirement needs an independent verification mechanism. Programmatic verification (tests, assertion scripts, CLI benchmarks) is preferred; explicit agent-as-judge rubrics are accepted when programmatic testing is impossible. |
71
+ | 3 | **Acceptance Criteria = Guardrails** | Acceptance criteria serve as the quality bar to prevent premature self-certification of incomplete or broken work. |
72
+ | 4 | **Minimal Requirements** | Only specify what the user explicitly cares about. Give the agent team maximal solution space. |
73
+
74
+ ---
75
+
76
+ ## 📋 Artifact-Based Workflow
77
+
78
+ Maintain a **prompt draft artifact** (`prompt_draft.md`) throughout the interaction. It provides real-time visibility to the user and tracks step progression.
79
+
80
+ ```markdown
81
+ # Teamwork Project Prompt — Draft
82
+
83
+ > Status: Step 1 — Eliciting project idea
84
+ > Goal: Craft prompt → get user approval → delegate
85
+ > Requested team: [none — routes automatically from description]
86
+
87
+ [Project description — 1-2 sentences]
88
+
89
+ Working directory: [TBD]
90
+ Integrity mode: [development | demo | benchmark]
91
+
92
+ ## Requirements
93
+
94
+ ### R1. [TBD]
95
+
96
+ ### R2. [TBD]
97
+
98
+ ## Acceptance Criteria
99
+
100
+ ### [Category]
101
+ - [ ] [Objective condition checkable without subjective bias]
102
+
103
+ ---
104
+ *Next: when approved → delegate via execution protocol*
105
+ ```
106
+
107
+ ---
108
+
109
+ ## 🔄 The 9-Step Interactive Workflow
110
+
111
+ ### Step 1: Elicit the Idea
112
+ - Ask: What do you want to build? What is the purpose (production, demo, eval, prototype)? Who is the audience?
113
+ - Condense into a 1–2 sentence project description.
114
+ - Initialize `prompt_draft.md` and set status to Step 2.
115
+
116
+ ### Step 2: Identify Ambiguity & Scale
117
+ - Probe points with multiple reasonable interpretations (data sources, third-party services, scope limits).
118
+ - Ask about effort and team scale:
119
+ - **Single self-contained fix/feature**: Keep focused (one implementer + repeated adversarial review). Prefix prompt: *"This is a single self-contained fix; keep it small and focused."*
120
+ - **Math, formal proofs, or massive search**: Offer standard pipeline vs. large-scale team. If large-scale selected, prefix prompt: *"Use a very large team of agents."*
121
+ - **Standard multi-agent build**: Standard workflow routes from task description.
122
+
123
+ ### Step 3: Determine Integrity Mode
124
+ Clarify operational boundaries:
125
+ - Can code be copied from existing open-source projects?
126
+ - Are pre-built external libraries permitted for core logic?
127
+ - Can test implementations be inspected before coding?
128
+ - **Mapping**:
129
+ - Unrestricted / default → `integrity_mode: development`
130
+ - Some shortcuts allowed (demo showcase) → `integrity_mode: demo`
131
+ - Strict isolation / zero external leakage → `integrity_mode: benchmark`
132
+
133
+ ### Step 4: Draft Requirements (R1, R2, ...)
134
+ - Write 2–5 concise requirement blocks.
135
+ - Focus strictly on **what** is required, not **how** to implement it.
136
+ - Apply litmus test: *"Would a senior engineer feel over-constrained by this requirement?"* If yes, prune.
137
+
138
+ ### Step 5: Design Verification Mechanisms (Forcing Function)
139
+ > **Why this matters:** Verification is a forcing function. Its job is to create an objective test target that forces a genuine build → test → debug loop and prevents premature self-certification.
140
+
141
+ - Design programmatic tests where feasible (unit test suites, test runners, CLI assertion scripts).
142
+ - If programmatic tests are not feasible, draft an explicit agent-as-judge scoring rubric.
143
+ - Inquire whether the user has existing test suites, schemas, or reference implementations to include in a `## Verification Resources` section.
144
+
145
+ ### Step 6: Set Acceptance Criteria
146
+ - Convert verification mechanisms into checkable markdown checkboxes (`- [ ]`).
147
+ - Calibrate strictly to the project purpose:
148
+ - Demo: Achievable within rapid time budget.
149
+ - Production: Full test coverage, strict error handling, production readiness.
150
+ - Eval: Strict reproducible metrics over polish.
151
+
152
+ ### Step 7: Infrastructure Constraints (If Applicable)
153
+ - Define sandboxing or controlled APIs for remote file operations, job launching, and external network calls.
154
+ - Skip if the project operates purely within local workspace files.
155
+
156
+ ### Step 8: Choose Working Directory
157
+ - Confirm the target working directory (default: `~/teamwork_projects/{project_name}` or a relative path in the current repo).
158
+ - Record as `Working directory: <path>` at top of prompt draft.
159
+
160
+ ### Step 9: Assemble, Validate & Seek Approval
161
+ Assemble the final structured prompt:
162
+
163
+ ```markdown
164
+ [1-2 sentence project description]
165
+
166
+ Working directory: <path>
167
+ Integrity mode: [development | demo | benchmark]
168
+ [Optional: Team scaling directive]
169
+
170
+ ## Requirements
171
+
172
+ ### R1. [Primary Deliverable]
173
+ [What it does, not how to build it]
174
+
175
+ ### R2. [Secondary Deliverable]
176
+ [What it does, not how to build it]
177
+
178
+ ## Acceptance Criteria
179
+
180
+ ### [Category]
181
+ - [ ] [Objective condition checkable without subjective bias]
182
+ ```
183
+
184
+ **Pre-flight Checklist:**
185
+ - [ ] No unsolicited implementation hints (file structures, algorithms).
186
+ - [ ] Every acceptance criterion is objectively verifiable.
187
+ - [ ] Scope matches actual user needs.
188
+ - [ ] Team scale directive included if requested in Step 2.
189
+
190
+ Seek explicit approval from the user before triggering execution.
191
+
192
+ ---
193
+
194
+ ## 🚀 Delegation Protocol
195
+
196
+ Once approved by the user:
197
+
198
+ ### 1. In Antigravity Harness
199
+ If running in Google Antigravity with native subagent support:
200
+ - Call `invoke_subagent`:
201
+ - `TypeName`: `teamwork_preview`
202
+ - `Role`: `Teamwork Coordinator`
203
+ - `Prompt`: Full prompt content from `prompt_draft.md`
204
+ - Set artifact status to `Launched`.
205
+
206
+ ### 2. In Other Agent Harnesses
207
+ - **Claude Code**: Feed the finalized prompt to dynamic workflows or dispatch via `/startcycle-graph` / subagents.
208
+ - **Cursor / Windsurf**: Inject the prompt into composer or project rules context.
209
+ - **OpenCode / Codex CLI**: Pass the prompt to `opencode run` or Codex runner.
@@ -16,9 +16,10 @@ You are strictly required to enforce the following 6 pillars in your process:
16
16
  - Instead of brainstorming alone, you MUST spawn specialized subagents (using `invoke_subagent`) to discuss ideas, architecture, and features.
17
17
  - Assign clear, distinct roles to subagents (e.g., "UI/UX Visionary", "Technical Architect", "Devil's Advocate") and have them debate and refine the concept before any code is written.
18
18
 
19
- ### 2. The `/grill-me` Approach
20
- - Actively challenge the user's initial ideas.
21
- - Initiate a `/grill-me` style interactive interview to uncover blind spots, resolve design decisions, and align on a robust plan. Do not accept vague requirements. Ask deep, targeted questions.
19
+ ### 2. The Grilling Interview
20
+ - **Invoke the `grill-with-docs` skill and follow it** — or `grill-me` when there is no working directory to leave a paper trail in. Do not paraphrase an interview here; those skills hold the protocol (design tree, frontier rounds, numbered questions each with a recommended answer), and a second description of it in this file would drift from the first.
21
+ - Actively challenge the user's initial ideas. Do not accept vague requirements.
22
+ - `grill-with-docs` additionally runs `domain-modeling`, so terminology and decisions settled during the debate land in `CONTEXT.md` and ADRs as they crystallise rather than evaporating with the session — which is usually what you want before a multi-agent build.
22
23
 
23
24
  ### 3. Target Folder Selection & Project Scaffolding
24
25
  - After the brainstorming and grilling phase produces a solid conceptual plan, you MUST explicitly ask the user: *"In which folder, workspace, or project directory should the output artifacts (e.g., plan, README.md, AGENTS.md) be stored?"*
@@ -37,6 +37,7 @@ Whenever the `github-repo` skill is invoked, the agent MUST perform an automated
37
37
  Before pushing any commit to GitHub, execute this 5-point sanitization audit:
38
38
 
39
39
  ### Rule 1: No Absolute Local Paths or Usernames
40
+ <!-- validate-skills-ignore -->
40
41
  - **Forbidden:** Paths like `/Users/john/projects/...`, `C:\Users\dev\...`, `/home/ubuntu/...`.
41
42
  - **Allowed:** Relative paths (`./src/index.ts`, `config/settings.json`) or environment placeholders (`~/.config/`, `$HOME/`).
42
43
 
@@ -1,10 +1,11 @@
1
1
  ---
2
2
  name: agent-tool-builder
3
- description: Tools are how AI agents interact with the world. A well-designed
3
+ description: >-
4
+ Tools are how AI agents interact with the world. A well-designed tool is the
5
+ difference between an agent that works and one that hallucinates, fails
6
+ silently, or costs 10x more tokens than necessary. This skill covers tool
7
+ design from schema to error handling.
4
8
  category: engineering-method
5
- tool is the difference between an agent that works and one that hallucinates,
6
- fails silently, or costs 10x more tokens than necessary. This skill covers
7
- tool design from schema to error handling.
8
9
  risk: unknown
9
10
  source: vibeship-spawner-skills (Apache 2.0)
10
11
  date_added: 2026-02-27
@@ -1,8 +1,9 @@
1
1
  ---
2
2
  name: ai-product
3
- description: Every product will be AI-powered. The question is whether you'll
3
+ description: >-
4
+ Every product will be AI-powered. The question is whether you'll build it
5
+ right or ship a demo that falls apart in production.
4
6
  category: library
5
- build it right or ship a demo that falls apart in production.
6
7
  risk: safe
7
8
  source: vibeship-spawner-skills (Apache 2.0)
8
9
  date_added: 2026-02-27
@@ -1,12 +1,64 @@
1
1
  ---
2
2
  name: ask-tim
3
- description: Meta-skill for discovering and routing to the right skill out of the ~154 available options. Use when a user or agent is unsure which skill fits their intent, or needs to pick between overlapping choices (e.g. build pipelines, scraping tools, UI components).
3
+ description: Ask which skill or flow fits your situation. A route through AOS's skills for work that travels idea to ship, plus a catalogue of the 187 available options for lookup. Use when unsure where to start, or when picking between overlapping choices.
4
4
  category: bdb-core
5
+ disable-model-invocation: true
5
6
  ---
6
7
 
7
- # `ask-tim`: The BDB Skill Routing Meta-Skill
8
+ <!-- The flow map below is derived from mattpocock/skills' ask-matt (MIT, see
9
+ THIRD_PARTY_NOTICES.md). The route is AOS's own: most stations on
10
+ upstream's main flow have no AOS equivalent, so copying it verbatim would
11
+ have produced a router pointing at skills that do not exist. -->
8
12
 
9
- This is a discovery and routing guide. It does not perform work itself. Use it to map a user's intent to the correct specialized skill(s).
13
+ # `ask-tim`: which way do I go?
14
+
15
+ You don't remember every skill, so ask. This does no work itself.
16
+
17
+ Two layers, answering different questions. **The flow map** answers *"which way?"* — the route work travels from an idea to something shipped, and which branch to take at each fork. **The catalogue** below it answers *"which skill?"* — grouped by domain, with overlap guidance for the cases where several look alike. Start with the flow; drop to the catalogue when you already know roughly where you are.
18
+
19
+ ---
20
+
21
+ ## The main flow: idea → ship
22
+
23
+ The route most work travels.
24
+
25
+ **1. Sharpen the idea.** `/grill-with-docs` whenever you are in a working directory — the interview *plus* a paper trail, writing settled terminology into `CONTEXT.md` and ADRs as it goes. Without a repo to write to, `/grill-me`. Both run the same `grilling` primitive; the difference is only whether the understanding survives the session.
26
+
27
+ For a bigger or fuzzier idea, `/bdbrainstorm` runs the same interview inside a multi-agent debate (`/bdbmediastorm` for live show-control and event tech). Don't grill twice — those skills already do this step.
28
+
29
+ **2. Branch: how much machinery does the build need?** This is the fork that matters, and picking wrong is expensive in both directions.
30
+
31
+ - **`/startcycle`** — the linear chain, and the right answer for most daily work. Architect → TechLead → Build → Reviewer, hand-offs as plain files, no state machine.
32
+ - **`/startcycle-graph`** — when you need the durable `state.json`, a Reviewer repair loop with a no-progress guard, an automated quality gate, and escalation to a human. Mission-critical or multi-session work. Runs headless.
33
+ - **`/startcycle-graph-user`** — a throwaway 2–4 node fan-out for one-off parallel work. Nothing persistent left behind.
34
+ - **Two-file edit?** No pipeline. Just do it.
35
+
36
+ **3. Review the plan before it is built.** At the Architect→TechLead gate, `aos-plan-canvas open production_artifacts/00_execution_plan.md` opens the plan in a browser where you point at what should change instead of retyping it. Mandatory at the end of `/bdbrainstorm` and `/bdbmediastorm`; optional in `/startcycle`; deliberately not forced in `/startcycle-graph`, which runs headless.
37
+
38
+ **4. Build, then review adversarially.** The pipelines invoke their own build and review nodes — you do not call these by hand. Reviewer's pass is a correctness check against the plan's contract; `godmode-shipping`'s gate is mechanical (lint, typecheck, tests). Two different checks, deliberately not merged.
39
+
40
+ Reach for `test-driven-development` or `tdd-workflow` on their own when you want one behaviour built test-first without a whole pipeline, and `git-pr-review` when reviewing a branch or PR against a fixed point.
41
+
42
+ **Forcing a specific skill into a run:** `--skill=<name>` on any startcycle variant makes it a hard requirement — for a private skill of your own no node would otherwise reach for. Validated before the run starts; a name that does not resolve halts rather than proceeding without it.
43
+
44
+ ---
45
+
46
+ ## On-ramps
47
+
48
+ A starting situation that generates work, then merges onto the main flow.
49
+
50
+ - **Issues piling up** → `/triage`. For work you did *not* create: bug reports, incoming requests, anything raw. Tickets a pipeline already produced are agent-ready — **do not triage them**.
51
+ - **Something is broken** → `systematic-debugging` for a structured hunt, `debugger` for a plain error. Both refuse to theorise before there is a reproduction.
52
+ - **You need a runnable answer, not an argument** → `/prototype`. Throwaway code to settle a question that conversation cannot, then bring what you learned back to the idea thread.
53
+ - **Deploying or shipping infrastructure** → `godmode-shipping` gates a release; `bdb-deploy`, `vercel-deployment` and `cloudflare-workers-expert` do the actual shipping.
54
+
55
+ ---
56
+
57
+ ## What this flow does not cover
58
+
59
+ Named so you don't go looking: AOS has no equivalent of a cross-session `handoff` file, and no `wayfinder`-style skill for charting a months-long effort as decision tickets. For work too large for one session, `/startcycle-graph`'s durable `state.json` is the closest thing — it is resumable, but it does not chart the fog for you.
60
+
61
+ ---
10
62
 
11
63
  ## 🧭 Intent Index (Table of Contents)
12
64
 
@@ -231,12 +283,29 @@ Specific utilities for the BDB environment.
231
283
 
232
284
  ## 🧊 Media & EventTech
233
285
 
234
- Use these for 3D, motion, and live show control.
286
+ Use these for 3D, motion, video and live show control.
235
287
 
236
- * **Top Picks:** `godmode-eventtech`, `godmode-3d-creation`, `godmode-media-creation`
288
+ * **Top Picks:** `godmode-media-creation` (video and montage), `godmode-eventtech` (live shows), `godmode-3d-creation` (meshes and scenes)
237
289
 
238
290
  * **Godmodes**: Determine the overarching flow (3D, Media, EventTech).
239
- * **Implementations**: `MCP_Manage` (Unreal, Rhino, Resolve, TouchDesigner), `spline-3d-integration` (web 3D), `threejs-skills` (WebGL).
291
+ * **Implementations**: `MCP_Manage` drives the creative applications over MCP, `spline-3d-integration` (web 3D), `threejs-skills` (WebGL), `remotion` (React → MP4, deterministic frame counts).
292
+
293
+ * **Per-application MCP guides**: once `MCP_Manage` has told you *which* server to use, these document the tool surface of one application each — `bdb-touchdesigner-mcp`, `bdb-resolume-mcp`, `bdb-grandma3-mcp`, `bdb-davinci-mcp`, `bdb-adobe-suite-mcp`, `bdb-after-effects-mcp`, `bdb-blender-mcp`, `bdb-unreal-mcp`, `bdb-rhino-mcp`, `bdb-vectorworks-mcp`. Reach for one only when you already know the application; `MCP_Manage` is the way in.
294
+
295
+ ### Which video route?
296
+
297
+ The choice is driven by where the pixels come from, not by the output format — all four end in a video file.
298
+
299
+ | Source material | Route |
300
+ |---|---|
301
+ | Code-generated motion graphics, text, brand animation | `remotion` — React components rendered to MP4, deterministic and exactly frame-accurate |
302
+ | Existing footage: cutting, colour, beat-sync | `godmode-media-creation` + `MCP_Manage` → **DaVinci Resolve** (`davinci-resolve-mcp`) or **Adobe Premiere** (`adobe_uxp_mcp`) |
303
+ | Compositing, motion design over footage | `MCP_Manage` → **After Effects** (`ae-mcp`, `after-effects-mcp`), or **Photoshop** for stills (`adobe_uxp_mcp`) |
304
+ | Generative visuals: audio-reactive, shaders, real-time | `godmode-eventtech` → TouchDesigner MCP, then `record_movie` |
305
+ | Generative *assets*: text→3D, image→3D, AI video | The **Creator Extension** engines — TRELLIS and TripoSR (3D), Text-to-CAD, OpenMontage (multimodal montage), Video-Shotcraft (shot direction), Palmier-Pro (timeline and grading), driven through `comfyui-mcp`. Installed as a separate power-up module, not a skill in this catalogue. |
306
+ | Concept not settled yet | `bdbmediastorm` first — it runs the grilling interview for show-control and media work |
307
+
308
+ Resolve and Premiere are interchangeable at this level: pick whichever is actually installed. Both have a working MCP under `mcps/`.
240
309
 
241
310
  ---
242
311
 
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-adobe-suite-mcp
3
3
  description: Utilizes the Adobe Suite MCP servers (adobe_mcp.py and adobe_uxp_mcp) to automate Photoshop, Illustrator, Premiere Pro, and After Effects using ExtendScript and UXP WebSocket bridges.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # Adobe Creative Suite MCP — Integration and AI Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-after-effects-mcp
3
3
  description: Utilizes the After Effects MCP servers (after-effects-mcp and ae-mcp) to create compositions, layers, masks, keyframe animations, and run ExtendScript.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # After Effects MCP — Integration and AI Agent Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-blender-mcp
3
3
  description: Utilizes the Blender MCP server and addon to build 3D assets, apply materials, inspect scenes, and script bpy.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # Blender MCP — Integration and AI Agent Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-computer-use-mcp
3
3
  description: Utilizes native Rust/Node and Python-based computer-use-mcp servers to control macOS, Windows, and Linux desktops.
4
+ category: engineering-method
4
5
  ---
5
6
 
6
7
  # Computer Use & OS Control MCP — Integration and AI Agent Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-davinci-mcp
3
3
  description: Utilizes the DaVinci Resolve MCP servers to control timeline editing, media analysis, color grading, and Fusion/Fairlight scripting.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # DaVinci Resolve MCP — Integration and AI Agent Guide
@@ -36,7 +36,7 @@ Autonomous verification and remediation skill for maintaining 100% operational i
36
36
 
37
37
  ## Verification
38
38
  - [ ] Health check script `ecosystem-health-audit.js` run completed with exit code `0`.
39
- - [ ] HTML report generated and verifiable at `~/bdb-dev/marketing-intern/reports/ecosystem_health_latest.html`.
39
+ - [ ] HTML report generated and verifiable at `production_artifacts/ecosystem_health_latest.html`.
40
40
  - [ ] Git working trees for all 8 repositories are clean.
41
41
  - [ ] NPM versions are fully synchronized with remote packages.
42
42
 
@@ -53,11 +53,11 @@ Autonomous verification and remediation skill for maintaining 100% operational i
53
53
  ## Automated Health Check Script
54
54
  Run the automated audit at any time:
55
55
  ```bash
56
- ~/bdb-dev/scripts/ecosystem-health-audit.js
56
+ scripts/ecosystem-health-audit.js
57
57
  ```
58
58
 
59
59
  ### Script Output:
60
- * **HTML Dashboard**: `~/bdb-dev/marketing-intern/reports/ecosystem_health_latest.html`
60
+ * **HTML Dashboard**: `production_artifacts/ecosystem_health_latest.html`
61
61
  * **Browser Launch**: Automatically opens the report in Chrome / Default Browser.
62
62
  * **Exit Code**: Returns `0` if all healthy, `1` if attention/remediation is required.
63
63
 
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-grandma3-mcp
3
3
  description: Utilizes the grandMA3 MCP server to patch fixtures, execute console commands, and trigger macros via OSC.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # grandMA3 MCP — Integration and AI Agent Guide
@@ -1,3 +1,13 @@
1
+ ---
2
+ name: bdb-memb-mcp
3
+ description: >-
4
+ Model Context Protocol interface to the memB persistent agent memory layer.
5
+ Use when an agent needs to add, search, list or delete persistent memories
6
+ locally and offline. Exposes add_memory, search_memory, list_memories and
7
+ delete_memory.
8
+ category: bdb-core
9
+ ---
10
+
1
11
  # BDB memB Persistent Memory MCP Server
2
12
 
3
13
  The `memb-mcp` server provides a standard Model Context Protocol (MCP) interface to the **memB** persistent agent memory layer. It allows any compatible developer agent (such as Cursor, Google Antigravity, Claude Code, or VS Code Cline) to read, write, and query persistent memories locally and offline.
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-resolume-mcp
3
3
  description: Utilizes the Resolume Arena MCP server to trigger clips, clear layers, adjust speeds, and query composition status via the Resolume REST API.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # Resolume Arena MCP — Integration and AI Agent Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-rhino-mcp
3
3
  description: Utilizes the Rhino MCP servers (RhinoMCP and golem-rhino-mcp) to create and manipulate 3D models and run Grasshopper graphs.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # Rhino 3D MCP — Integration and AI Agent Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-touchdesigner-mcp
3
3
  description: Utilizes the TouchDesigner MCP servers (tdmcp and touchdesigner-mcp) to create TOP/CHOP chains, script operators, inspect parameters, and debug node networks.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # TouchDesigner MCP — Integration and AI Agent Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-unreal-mcp
3
3
  description: Utilizes the Unreal Engine MCP server to control UE5 via a native C++ Automation Bridge plugin.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # Unreal Engine MCP — Integration and AI Agent Guide
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: bdb-vectorworks-mcp
3
3
  description: Utilizes the Vectorworks RAG + MCP server to search and retrieve Python and VectorScript API documentation.
4
+ category: media-eventtech
4
5
  ---
5
6
 
6
7
  # Vectorworks RAG MCP — Integration and AI Agent Guide