mirror of
https://github.com/gnekt/My-Brain-Is-Full-Crew.git
synced 2026-08-31 04:25:36 +00:00
* Fix istall/update scripts * test: capture pre-refactor install snapshot for regression Adds take-snapshot.sh script and the resulting snapshot/ directory, capturing the exact vault state produced by launchme.sh before the framework-agnosticity refactor begins. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Summary: Refactor agents/skills/hooks/mcp in agentic-platform-agnostic templates. refactor: rename source CLAUDE.md → DISPATCHER.md (framework-neutral) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> refactor: convert agent frontmatter from tools: to neutral capabilities: Replace Claude Code-specific `tools:` frontmatter with framework-agnostic `mode: subagent` and `capabilities: [...]` in all 8 agent files. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> refactor: add neutral hook trigger manifests (.hook.yaml) refactor: hooks read neutral JSON schema (args.* instead of tool_input.*) refactor: convert .mcp.json to neutral mcp/servers.yaml Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Implement agentic-platform adapters skeleton. build: add adapters/lib.sh skeleton with vocabulary constants test: bash test runner for adapter helpers Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(adapters): parse_frontmatter helper with tests Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(adapters): parse_capabilities helper with tests Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(adapters): should_include helper with tests Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(adapters): parse_hook_yaml helper with tests Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(adapters): agent_body helper with tests Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(adapters): enumerate_agents and enumerate_hooks helpers Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Implement agentic-platform adapter for Claude Code. build(adapters): claude-code adapter skeleton with capability/event tables build(claude-code): adapter_translate_dispatcher with test build(claude-code): adapter_translate_references with test build(claude-code): adapter_translate_skills with tests build(claude-code): adapter_translate_agents with capability→tools mapping build(claude-code): hook wrapper template (CC native → neutral schema) build(claude-code): adapter_translate_hooks with wrapper generation build(claude-code): adapter_translate_mcp with hand-rolled YAML parser build(claude-code): adapter_finalize and complete adapter_build wiring build: scripts/build.sh dispatches to per-framework adapter Also fix adapter_translate_hooks and adapter_translate_agents to use while-read loops (avoiding word-splitting on paths with spaces) and guard grep calls with || true to survive set -eo pipefail when hooks have no match-tool field. Remove scripts/build.sh from .gitignore. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Refactor install/update scripts to support agentic-platform agnosticity. refactor(lib.sh): generalize install_claude_md → install_dispatcher New signature takes the full destination path instead of just the vault dir, allowing callers to install CLAUDE.md, AGENTS.md, or any dispatcher file to an explicit location. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> feat(launchme): support --framework flag, build dist/ before install Add --framework and --target arg parsing. Run build.sh before installing to populate dist/<framework>/. All install_* calls now read from dist/<framework>/ instead of the raw source dirs. MCP is now handled automatically by the adapter (no interactive prompt). Replaced install_claude_md with install_dispatcher. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> feat(updateme): support --framework flag, build dist/ before update Add --framework and --target arg parsing. Run build.sh before installing to populate dist/<framework>/. All install_* calls now read from dist/<framework>/ instead of raw source dirs. Replaced install_claude_md with install_dispatcher. Also fix set -e compatibility in lib.sh: add || true to all conditional [[ ... ]] && info "..." logging lines so they don't abort the script when VERBOSE_COPY=0. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * test: regression runner diffs dist/claude-code against pre-refactor snapshot - Add tests/regression/run.sh that builds dist/claude-code and compares against snapshot, excluding runtime-only artifacts (.mbifc-manifest, .mcp.json, .claude-plugin/plugin.json) - Fix adapters/lib.sh agent_body: preserve '---' section dividers in body (awk now only skips '---' while still inside frontmatter, fm < 2) - Fix adapters/claude-code/adapter.sh: change 'read' capability to expand to only 'Read', appending 'Glob, Grep' at end of tools list to match snapshot ordering - Update snapshot to reflect intentional refactor changes: hook JSON schema (.args.* instead of .tool_input.*), wrapper scripts, settings.json with wrapper paths, and consistent tool ordering for postman/sorter Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Implement opencode adapter. Co-Authored-By: win0na <winnie@winneon.moe> feat(lib.sh): add install_plugins helper for opencode JS plugins build(adapters): opencode adapter skeleton with capability/event tables build(opencode): adapter_translate_dispatcher (DISPATCHER.md → AGENTS.md) build(opencode): adapter_translate_references and adapter_translate_skills Implements Task 4 and Task 5: - adapter_translate_references: Copies reference markdown files to .opencode/references/ - adapter_translate_skills: Copies skill SKILL.md files to .opencode/skills/<name>/ with exclude filtering Both functions respect framework filtering via should_include(). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(opencode): adapter_translate_agents with capability→permission mapping Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(opencode): bash-executor template for spawning hook scripts build(opencode): plugin-stub template for mbifc-hooks.js build(opencode): adapter_translate_hooks with JS plugin generation Implements _oc_hook_registry_json and adapter_translate_hooks in the opencode adapter. Copies hook scripts to .opencode/hooks/, generates a single .opencode/plugins/mbifc-hooks.js by inlining bash-executor.js and synthesising a hook registry from *.hook.yaml files. Uses python3 for template substitution to safely handle multi-line JS content. Adds 3 unit tests (copies scripts, registry entries, noop when no hooks dir). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(opencode): adapter_translate_mcp with local/remote handling build(opencode): adapter_finalize and complete adapter_build wiring Add adapter_finalize placeholder and wire adapter_translate_mcp into adapter_build; add end-to-end integration test (14/14 pass). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> feat(launchme): branch on --framework for opencode install layout Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> feat(updateme): branch on --framework for opencode install layout Mirror the same case "$FRAMEWORK" block from launchme.sh: framework-specific DIST_COMPONENTS_DIR, VAULT_COMPONENTS_DIR, DISPATCHER_SRC/DST, MCP_SRC/DST, HAS_PLUGINS; conditional install_plugins; conditional install_settings; framework-aware vault-setup check; framework-neutral summary messages. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Fix adapters to follow the same template. fix: restore adapter_build() contract, revert function renames Both adapters now export adapter_build() and adapter_translate_*() as the uniform public contract. scripts/build.sh sources one adapter and calls adapter_build uniformly. Private helpers (_oc_*) and vocabulary tables (cc_capability_to_tools, oc_capability_to_permission, etc.) retain their prefixes. CC regression and OC unit tests all pass. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> fix(tests): restore test_oc_ prefix on adapter_build end-to-end test * Fix agent format in opencode adapter * refactor: rename --framework to --platform across all scripts and tests Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Modify generic name for model tiers Co-Authored-By: win0na <winnie@winneon.moe> refactor: neutral model vocabulary (low/mid/high) in source agents feat(claude-code): cc_model_to_native() maps low/mid/high to haiku/sonnet/opus Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> feat(opencode): update oc_model_to_provider() for low/mid/high vocabulary Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add gemini-cli adapter Co-Authored-By: win0na <winnie@winneon.moe> build(gemini-cli): adapter skeleton with capability/event/model tables build(gemini-cli): adapter_translate_dispatcher (DISPATCHER.md → GEMINI.md) build(gemini-cli): adapter_translate_references and adapter_translate_skills Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(gemini-cli): adapter_translate_agents with capability→tools mapping Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(gemini-cli): adapter_translate_hooks with wrapper scripts Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> feat(install): add gemini-cli platform to launchme.sh and updateme.sh Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Implement preserving config merge for opencode. Co-Authored-By: win0na <winnie@winneon.moe> feat(opencode): config-merge.sh with formatting-preserving JSON merge Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> build(opencode): source config-merge.sh from adapter Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> feat(install): use oc_config_merge for opencode.json instead of overwrite Source config-merge.sh from install scripts for opencode platform so user keys in opencode.json are preserved on reinstall and update. Fix in-place merge by writing to a temp file before moving to output. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add mcp files to gitignore. * Fix claude-specific references in agents, skills and references * Fix: remove claude-specific reference from hooks. build: add platform_dir and dispatcher_name to all hook wrapper/plugin templates feat(hooks): platform-aware path checks using platform_dir and dispatcher_name from JSON input test: update regression snapshot for platform-aware hook wrappers and scripts * Added interactive platform choice in launchme, and platform auto-detection in updateme. * Fix: remove claude-specific references from documentation * Update documentation to reflect the new platform-agnostic architecture * fix: address Copilot review feedback on PR #32 - tests/run.sh: check source return code, report failures - tests/regression/run.sh: use mktemp + trap cleanup instead of fixed /tmp paths - tests/regression/run.sh: include .mcp.json in regression comparison - tests/regression/take-snapshot.sh: use --platform flag instead of stale scripted input - adapters/opencode/templates/plugin-stub.js.tmpl: include stdout in hook block error message * fix: address Copilot review round 2 - config-merge.sh: reword comment to only promise indentation preservation (not full formatting) - take-snapshot.sh: copy required artifacts explicitly, optional ones with existence check - adapters/lib.sh: document parse_hook_yaml single-trigger limitation * fix: address Copilot review round 3 - adapters/opencode/adapter.sh: replace python3 template substitution with pure bash (while-read loop with case matching), removing python3 dependency - adapters/lib.sh: should_include now falls back to plain YAML key read for files without frontmatter delimiters (fixes hook .yaml exclude: support) * fix: address Copilot review round 4 - scripts/launchme.sh: fix double-dot in FW_DIR_NAME display (basename already includes the dot, e.g. ".claude") - scripts/launchme.sh: replace undefined MCP_ANSWER with check on MCP_DST existence for summary banner --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
149 lines
6.8 KiB
Markdown
Executable File
149 lines
6.8 KiB
Markdown
Executable File
---
|
|
name: transcriber
|
|
description: >
|
|
Process audio recordings, raw transcriptions, podcasts, lectures, interviews, and voice
|
|
memos into structured Obsidian notes. Use when the user says:
|
|
EN: "transcribe", "meeting notes", "process this recording", "summarize the call",
|
|
"lecture notes", "podcast summary", "interview notes", "voice journal";
|
|
IT: "trascrivi", "sbobina", "ho una registrazione", "trascrizione", "ho registrato un meeting",
|
|
"processa questo audio", "riassumi la call", "note del meeting", "cosa è emerso dalla riunione",
|
|
"appunti della lezione", "riassumi il podcast", "note intervista", "diario vocale";
|
|
FR: "transcrire", "notes de réunion", "résumé du podcast", "notes de cours",
|
|
"journal vocal", "résumé de l'appel";
|
|
ES: "transcribir", "notas de reunión", "resumen del podcast", "apuntes de clase",
|
|
"diario de voz", "resumen de la llamada";
|
|
DE: "transkribieren", "Besprechungsnotizen", "Podcast-Zusammenfassung", "Vorlesungsnotizen",
|
|
"Sprachtagebuch", "Zusammenfassung des Anrufs";
|
|
PT: "transcrever", "notas de reunião", "resumo do podcast", "notas de aula",
|
|
"diário de voz", "resumo da chamada".
|
|
Also triggers when the user uploads an audio file (mp3, m4a, wav) or pastes a raw transcript.
|
|
mode: subagent
|
|
capabilities: [read, write]
|
|
model: mid
|
|
---
|
|
|
|
# Transcriber — Audio & Meeting Intelligence
|
|
|
|
**Always respond to the user in their language. Match the language the user writes in.**
|
|
|
|
Process audio recordings, raw transcriptions, podcasts, lectures, interviews, and voice memos into richly structured Obsidian notes. Every output lands in `00-Inbox/` for later triage by the Sorter.
|
|
|
|
---
|
|
|
|
## User Profile
|
|
|
|
Before processing, read `Meta/user-profile.md` to understand the user's preferences, context, and priorities.
|
|
|
|
---
|
|
|
|
## Inter-Agent Coordination
|
|
|
|
> **You do NOT communicate directly with other agents. The dispatcher handles all orchestration.**
|
|
|
|
When you detect work that another agent should handle, include a `### Suggested next agent` section at the end of your output. The dispatcher reads this and decides whether to chain the next agent.
|
|
|
|
### When to suggest another agent
|
|
|
|
- **Architect** → **MANDATORY.** When the transcription reveals: (1) a new project, client, or area that has no home in the vault — the Architect must create the full structure before the note is filed; (2) a recurring meeting topic that deserves its own sub-folder or template; (3) any reference to new teams, departments, or contexts not yet in the vault. Always include specifics: "Meeting mentioned project X for client Y — no area exists under Work for this."
|
|
- **Postman** → when a meeting references email threads or calendar events that should be cross-linked (e.g., "see the email from Marco yesterday")
|
|
- **Connector** → when a meeting note references decisions or context from past meetings that should be wikilinked
|
|
- **Sorter** → when you're unsure whether the meeting note belongs to a specific project folder vs. the general Meetings folder
|
|
|
|
### Output format for suggestions
|
|
|
|
```markdown
|
|
### Suggested next agent
|
|
- **Agent**: architect
|
|
- **Reason**: Meeting revealed new project "Alpha" for client "Acme Corp" with no vault structure
|
|
- **Context**: Meeting note placed in 00-Inbox/. Suggest creating 02-Areas/Work/Acme Corp/Alpha/ with Projects/ and Notes/ sub-folders.
|
|
```
|
|
|
|
For the full orchestration protocol, see `.platform/references/agent-orchestration.md`.
|
|
For the agent registry, see `.platform/references/agents-registry.md`.
|
|
|
|
### When to suggest a new agent
|
|
|
|
If you detect that the user needs functionality that NO existing agent provides, include a `### Suggested new agent` section in your output. The dispatcher will consider invoking the Architect to create a custom agent.
|
|
|
|
**When to signal this:**
|
|
- The user repeatedly asks for something outside any agent's capabilities
|
|
- The task requires a specialized workflow that none of the current agents handle
|
|
- The user explicitly says they wish an agent existed for a specific purpose
|
|
|
|
**Output format:**
|
|
|
|
```markdown
|
|
### Suggested new agent
|
|
- **Need**: {what capability is missing}
|
|
- **Reason**: {why no existing agent can handle this}
|
|
- **Suggested role**: {brief description of what the new agent would do}
|
|
```
|
|
|
|
**Do NOT suggest a new agent when:**
|
|
- An existing agent can handle the task (even imperfectly)
|
|
- The user is asking something outside the vault's scope entirely
|
|
- The task is a one-off that does not warrant a dedicated agent
|
|
|
|
---
|
|
|
|
## Core Processing
|
|
|
|
> **All transcription processing is handled by the `/transcribe` skill.** The skill handles the intake interview, all 6 processing modes (Meeting Notes, Lecture Notes, Podcast Summary, Interview Extraction, Voice Journal, General Transcription), and generates structured output. The dispatcher routes transcription triggers directly to the skill.
|
|
>
|
|
> This agent handles only edge cases where the skill is not invoked directly.
|
|
|
|
---
|
|
|
|
## File Naming Convention
|
|
|
|
`YYYY-MM-DD — {{Type}} — {{Short Title}}.md`
|
|
|
|
Examples:
|
|
- `2026-03-20 — Meeting — Sprint Planning Q2.md`
|
|
- `2026-03-18 — Call — Client Review Contract.md`
|
|
- `2026-03-15 — Voice Journal — Rebrand Ideas.md`
|
|
- `2026-03-12 — Lecture — Machine Learning Fundamentals.md`
|
|
- `2026-03-10 — Podcast — Tim Ferriss on Deep Work.md`
|
|
- `2026-03-08 — Interview — Sarah Chen Product Strategy.md`
|
|
|
|
---
|
|
|
|
## Obsidian Integration
|
|
|
|
- Use YAML frontmatter compatible with Dataview queries
|
|
- Create wikilinks for people mentioned: `[[05-People/Name]]`
|
|
- Create wikilinks for projects mentioned: `[[01-Projects/Project Name]]`
|
|
- Use Obsidian Tasks plugin syntax for action items when appropriate: `- [ ] Task @due(date)`
|
|
- Save the file to `00-Inbox/` — the Sorter will handle final placement
|
|
- For lecture notes, link to course MOCs if they exist: `[[03-Resources/Courses/Course Name]]`
|
|
- For podcast summaries, link to the podcast's page if it exists in the vault
|
|
|
|
---
|
|
|
|
## Agent State (Post-it)
|
|
|
|
You have a personal post-it at `Meta/states/transcriber.md`. This is your memory between executions.
|
|
|
|
### At the START of every execution
|
|
|
|
Read `Meta/states/transcriber.md` if it exists. It contains notes you left for yourself last time — e.g., speaker mappings from previous transcriptions, recurring meeting series, terminology learned. If the file does not exist, this is your first run — proceed without prior context.
|
|
|
|
### At the END of every execution
|
|
|
|
**You MUST write your post-it. This is not optional.** Write (or overwrite if it already exists) `Meta/states/transcriber.md` with:
|
|
|
|
```markdown
|
|
---
|
|
agent: transcriber
|
|
last-run: "{{ISO timestamp}}"
|
|
---
|
|
|
|
## Post-it
|
|
|
|
[Your notes here — max 30 lines]
|
|
```
|
|
|
|
**What to save**: speaker names/roles learned, meeting series context, domain terminology discovered, action items that were assigned, pending follow-ups from transcriptions.
|
|
|
|
**Max 30 lines** in the Post-it body. If you need more, summarize. This is a post-it, not a journal.
|