From c4559989737b97336bbeb2b193e942425c476e34 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:46 +0000 Subject: [PATCH 01/14] feat: add vosc ECC bundle (.claude/ecc-tools.json) --- .claude/ecc-tools.json | 261 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 261 insertions(+) create mode 100644 .claude/ecc-tools.json diff --git a/.claude/ecc-tools.json b/.claude/ecc-tools.json new file mode 100644 index 0000000..e1c6088 --- /dev/null +++ b/.claude/ecc-tools.json @@ -0,0 +1,261 @@ +{ + "version": "1.3", + "schemaVersion": "1.0", + "generatedBy": "ecc-tools", + "generatedAt": "2026-05-02T20:50:17.251Z", + "repo": "https://github.com/kasparsj/vosc", + "profiles": { + "requested": "full", + "recommended": "full", + "effective": "developer", + "requestedAlias": "full", + "recommendedAlias": "full", + "effectiveAlias": "developer" + }, + "requestedProfile": "full", + "profile": "developer", + "recommendedProfile": "full", + "effectiveProfile": "developer", + "tier": "free", + "requestedComponents": [ + "repo-baseline", + "workflow-automation", + "security-audits", + "research-tooling", + "team-rollout", + "governance-controls" + ], + "selectedComponents": [ + "repo-baseline", + "workflow-automation" + ], + "requestedAddComponents": [], + "requestedRemoveComponents": [], + "blockedRemovalComponents": [], + "tierFilteredComponents": [ + "security-audits", + "research-tooling", + "team-rollout", + "governance-controls" + ], + "requestedRootPackages": [ + "runtime-core", + "workflow-pack", + "agentshield-pack", + "research-pack", + "team-config-sync", + "enterprise-controls" + ], + "selectedRootPackages": [ + "runtime-core", + "workflow-pack" + ], + "requestedPackages": [ + "runtime-core", + "workflow-pack", + "agentshield-pack", + "research-pack", + "team-config-sync", + "enterprise-controls" + ], + "requestedAddPackages": [], + "requestedRemovePackages": [], + "selectedPackages": [ + "runtime-core", + "workflow-pack" + ], + "packages": [ + "runtime-core", + "workflow-pack" + ], + "blockedRemovalPackages": [], + "tierFilteredRootPackages": [ + "agentshield-pack", + "research-pack", + "team-config-sync", + "enterprise-controls" + ], + "tierFilteredPackages": [ + "agentshield-pack", + "research-pack", + "team-config-sync", + "enterprise-controls" + ], + "conflictingPackages": [], + "dependencyGraph": { + "runtime-core": [], + "workflow-pack": [ + "runtime-core" + ] + }, + "resolutionOrder": [ + "runtime-core", + "workflow-pack" + ], + "requestedModules": [ + "runtime-core", + "workflow-pack", + "agentshield-pack", + "research-pack", + "team-config-sync", + "enterprise-controls" + ], + "selectedModules": [ + "runtime-core", + "workflow-pack" + ], + "modules": [ + "runtime-core", + "workflow-pack" + ], + "managedFiles": [ + ".claude/skills/vosc/SKILL.md", + ".agents/skills/vosc/SKILL.md", + ".agents/skills/vosc/agents/openai.yaml", + ".claude/identity.json", + ".codex/config.toml", + ".codex/AGENTS.md", + ".codex/agents/explorer.toml", + ".codex/agents/reviewer.toml", + ".codex/agents/docs-researcher.toml", + ".claude/homunculus/instincts/inherited/vosc-instincts.yaml", + ".claude/commands/feature-development.md", + ".claude/commands/test-driven-development.md", + ".claude/commands/refactoring.md" + ], + "packageFiles": { + "runtime-core": [ + ".claude/skills/vosc/SKILL.md", + ".agents/skills/vosc/SKILL.md", + ".agents/skills/vosc/agents/openai.yaml", + ".claude/identity.json", + ".codex/config.toml", + ".codex/AGENTS.md", + ".codex/agents/explorer.toml", + ".codex/agents/reviewer.toml", + ".codex/agents/docs-researcher.toml", + ".claude/homunculus/instincts/inherited/vosc-instincts.yaml" + ], + "workflow-pack": [ + ".claude/commands/feature-development.md", + ".claude/commands/test-driven-development.md", + ".claude/commands/refactoring.md" + ] + }, + "moduleFiles": { + "runtime-core": [ + ".claude/skills/vosc/SKILL.md", + ".agents/skills/vosc/SKILL.md", + ".agents/skills/vosc/agents/openai.yaml", + ".claude/identity.json", + ".codex/config.toml", + ".codex/AGENTS.md", + ".codex/agents/explorer.toml", + ".codex/agents/reviewer.toml", + ".codex/agents/docs-researcher.toml", + ".claude/homunculus/instincts/inherited/vosc-instincts.yaml" + ], + "workflow-pack": [ + ".claude/commands/feature-development.md", + ".claude/commands/test-driven-development.md", + ".claude/commands/refactoring.md" + ] + }, + "files": [ + { + "moduleId": "runtime-core", + "path": ".claude/skills/vosc/SKILL.md", + "description": "Repository-specific Claude Code skill generated from git history." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/vosc/SKILL.md", + "description": "Codex-facing copy of the generated repository skill." + }, + { + "moduleId": "runtime-core", + "path": ".agents/skills/vosc/agents/openai.yaml", + "description": "Codex skill metadata so the repo skill appears cleanly in the skill interface." + }, + { + "moduleId": "runtime-core", + "path": ".claude/identity.json", + "description": "Suggested identity.json baseline derived from repository conventions." + }, + { + "moduleId": "runtime-core", + "path": ".codex/config.toml", + "description": "Repo-local Codex MCP and multi-agent baseline aligned with ECC defaults." + }, + { + "moduleId": "runtime-core", + "path": ".codex/AGENTS.md", + "description": "Codex usage guide that points at the generated repo skill and workflow bundle." + }, + { + "moduleId": "runtime-core", + "path": ".codex/agents/explorer.toml", + "description": "Read-only explorer role config for Codex multi-agent work." + }, + { + "moduleId": "runtime-core", + "path": ".codex/agents/reviewer.toml", + "description": "Read-only reviewer role config focused on correctness and security." + }, + { + "moduleId": "runtime-core", + "path": ".codex/agents/docs-researcher.toml", + "description": "Read-only docs researcher role config for API verification." + }, + { + "moduleId": "runtime-core", + "path": ".claude/homunculus/instincts/inherited/vosc-instincts.yaml", + "description": "Continuous-learning instincts derived from repository patterns." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/feature-development.md", + "description": "Workflow command scaffold for feature-development." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/test-driven-development.md", + "description": "Workflow command scaffold for test-driven-development." + }, + { + "moduleId": "workflow-pack", + "path": ".claude/commands/refactoring.md", + "description": "Workflow command scaffold for refactoring." + } + ], + "workflows": [ + { + "command": "feature-development", + "path": ".claude/commands/feature-development.md" + }, + { + "command": "test-driven-development", + "path": ".claude/commands/test-driven-development.md" + }, + { + "command": "refactoring", + "path": ".claude/commands/refactoring.md" + } + ], + "adapters": { + "claudeCode": { + "skillPath": ".claude/skills/vosc/SKILL.md", + "identityPath": ".claude/identity.json", + "commandPaths": [ + ".claude/commands/feature-development.md", + ".claude/commands/test-driven-development.md", + ".claude/commands/refactoring.md" + ] + }, + "codex": { + "configPath": ".codex/config.toml", + "agentsGuidePath": ".codex/AGENTS.md", + "skillPath": ".agents/skills/vosc/SKILL.md" + } + } +} \ No newline at end of file From 58468ef76242f0966a09df0782b7d3f1f866cc06 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:47 +0000 Subject: [PATCH 02/14] feat: add vosc ECC bundle (.claude/skills/vosc/SKILL.md) --- .claude/skills/vosc/SKILL.md | 200 +++++++++++++++++++++++++++++++++++ 1 file changed, 200 insertions(+) create mode 100644 .claude/skills/vosc/SKILL.md diff --git a/.claude/skills/vosc/SKILL.md b/.claude/skills/vosc/SKILL.md new file mode 100644 index 0000000..414cf4f --- /dev/null +++ b/.claude/skills/vosc/SKILL.md @@ -0,0 +1,200 @@ +```markdown +# vosc Development Patterns + +> Auto-generated skill from repository analysis + +## Overview + +This skill teaches you how to contribute to the `vosc` codebase, a Python project (with significant C++ components) focused on shader manipulation, OSC command processing, and inspector tooling. You'll learn the project's coding conventions, how to develop new features or fix bugs using established workflows, and how to write and organize tests. This guide includes step-by-step instructions and command suggestions for common development tasks. + +## Coding Conventions + +### File Naming + +- **PascalCase** is used for file names, e.g.: + - `ShaderInspector.cpp` + - `VariablePool.h` + - `BaseTex.cpp` + +### Import Style + +- **Relative imports** are preferred. + - Example (Python): + ```python + from .Shader import Shader + ``` + - Example (C++): + ```cpp + #include "ShaderInspector.hpp" + ``` + +### Export Style + +- **Named exports** are used. + - Example (Python): + ```python + def my_function(): + pass + ``` + - Example (C++ header): + ```cpp + class ShaderInspector { + // ... + }; + ``` + +### Commit Patterns + +- Commit messages are freeform, typically concise (~25 characters). +- No strict prefixing required. + +--- + +## Workflows + +### Shader Feature Development + +**Trigger:** When you want to add or modify shader functionality (e.g., new shader classes, passes, fragments, or inspectors). +**Command:** `/new-shader-feature` + +1. Edit or create shader C++ files: + - `src/shader/Shader.cpp`, `src/shader/Shader.h` + - `src/shader/ShaderPass.cpp`, `src/shader/ShaderPass.h` +2. Edit or add shader fragment files: + - `bin/data/shaders/**/*.frag` +3. Optionally update SuperCollider scripts for shader usage: + - `SuperCollider/*.scd` +4. Edit or update inspector files for shaders/textures: + - `src/inspector/ShaderInspector.cpp`, `src/inspector/TextureInspector.cpp`, etc. +5. Edit or update related texture or variable pool files if needed. + +**Example:** +```cpp +// src/shader/Shader.cpp +#include "Shader.h" +// ...implement new shader logic +``` +```glsl +// bin/data/shaders/new_effect.frag +void main() { + // shader code here +} +``` + +--- + +### Documentation Migration or Expansion + +**Trigger:** When you need to update, migrate, or generate documentation or reference material. +**Command:** `/update-docs` + +1. Edit or add markdown files in `docs/` (e.g., `docs/*.md`) +2. Edit `README.md` +3. Optionally add or update documentation scripts (`scripts/*.sh`, `scripts/*.py`) +4. Optionally update CI workflows for doc generation (`.github/workflows/*.yml`) + +**Example:** +```markdown +# New Feature +Detailed documentation for the new feature. +``` +```bash +# scripts/check_md_links.sh +./check_md_links.sh +``` + +--- + +### OSC Command Parser or Router Refactor + +**Trigger:** When you want to improve or extend the OSC command handling pipeline. +**Command:** `/refactor-osc-parser` + +1. Edit or create OSC parser/router C++ files: + - `src/osc/CommandParser.cpp`, `src/osc/CommandRouter.cpp`, etc. +2. Edit or create related header files: + - `src/osc/*.hpp` +3. Edit or update main VOSC files to integrate changes: + - `src/VOSC.cpp`, `src/VOSC.hpp` +4. Update or add tests for OSC commands: + - `tests/osc/CommandParserTests.cpp`, `tests/osc/README.md` + +**Example:** +```cpp +// src/osc/CommandParser.cpp +#include "CommandParser.hpp" +// ...refactored parsing logic +``` +```cpp +// tests/osc/CommandParserTests.cpp +void testNewParserFeature() { + // test implementation +} +``` + +--- + +### Inspector Feature Development or Bugfix + +**Trigger:** When you want to add, improve, or fix inspector functionality. +**Command:** `/update-inspector` + +1. Edit or create inspector C++ files: + - `src/inspector/*.cpp`, `src/inspector/*.hpp` +2. Optionally update related shader, texture, or variable files. +3. Optionally update SuperCollider scripts for inspector testing. + +**Example:** +```cpp +// src/inspector/Inspector.cpp +#include "Inspector.hpp" +// ...new inspector logic +``` + +--- + +### Texture or Variable Pool Extension + +**Trigger:** When you want to extend or fix texture/variable pool functionality. +**Command:** `/update-pool` + +1. Edit or create pool C++ files: + - `src/tex/*.cpp`, `src/tex/*.h` + - `src/var/*.cpp`, `src/var/*.h` +2. Edit or update main VOSC files or related shader/inspector files. +3. Optionally update SuperCollider scripts for pool usage. + +**Example:** +```cpp +// src/var/VariablePool.cpp +#include "VariablePool.h" +// ...add new variable management +``` + +--- + +## Testing Patterns + +- **Framework:** Unknown (not explicitly detected). +- **File Pattern:** Test files follow the pattern `*.test.ts` (for TypeScript) and `tests/osc/*.cpp` (for C++). +- **Organization:** Tests are grouped by feature or module, often mirroring the source directory structure. +- **Example:** + ```cpp + // tests/osc/CommandParserTests.cpp + void testCommandParsing() { + // test code here + } + ``` + +--- + +## Commands + +| Command | Purpose | +|-----------------------|--------------------------------------------------------| +| /new-shader-feature | Start a new shader-related feature or extension | +| /update-docs | Migrate, expand, or generate documentation | +| /refactor-osc-parser | Refactor or extend OSC command parser/router | +| /update-inspector | Develop, extend, or fix inspector features | +| /update-pool | Extend or fix texture/variable pool functionality | +``` From 5ad41cc8f7a5bb4f4209f5601a37fba695640636 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:48 +0000 Subject: [PATCH 03/14] feat: add vosc ECC bundle (.agents/skills/vosc/SKILL.md) --- .agents/skills/vosc/SKILL.md | 200 +++++++++++++++++++++++++++++++++++ 1 file changed, 200 insertions(+) create mode 100644 .agents/skills/vosc/SKILL.md diff --git a/.agents/skills/vosc/SKILL.md b/.agents/skills/vosc/SKILL.md new file mode 100644 index 0000000..414cf4f --- /dev/null +++ b/.agents/skills/vosc/SKILL.md @@ -0,0 +1,200 @@ +```markdown +# vosc Development Patterns + +> Auto-generated skill from repository analysis + +## Overview + +This skill teaches you how to contribute to the `vosc` codebase, a Python project (with significant C++ components) focused on shader manipulation, OSC command processing, and inspector tooling. You'll learn the project's coding conventions, how to develop new features or fix bugs using established workflows, and how to write and organize tests. This guide includes step-by-step instructions and command suggestions for common development tasks. + +## Coding Conventions + +### File Naming + +- **PascalCase** is used for file names, e.g.: + - `ShaderInspector.cpp` + - `VariablePool.h` + - `BaseTex.cpp` + +### Import Style + +- **Relative imports** are preferred. + - Example (Python): + ```python + from .Shader import Shader + ``` + - Example (C++): + ```cpp + #include "ShaderInspector.hpp" + ``` + +### Export Style + +- **Named exports** are used. + - Example (Python): + ```python + def my_function(): + pass + ``` + - Example (C++ header): + ```cpp + class ShaderInspector { + // ... + }; + ``` + +### Commit Patterns + +- Commit messages are freeform, typically concise (~25 characters). +- No strict prefixing required. + +--- + +## Workflows + +### Shader Feature Development + +**Trigger:** When you want to add or modify shader functionality (e.g., new shader classes, passes, fragments, or inspectors). +**Command:** `/new-shader-feature` + +1. Edit or create shader C++ files: + - `src/shader/Shader.cpp`, `src/shader/Shader.h` + - `src/shader/ShaderPass.cpp`, `src/shader/ShaderPass.h` +2. Edit or add shader fragment files: + - `bin/data/shaders/**/*.frag` +3. Optionally update SuperCollider scripts for shader usage: + - `SuperCollider/*.scd` +4. Edit or update inspector files for shaders/textures: + - `src/inspector/ShaderInspector.cpp`, `src/inspector/TextureInspector.cpp`, etc. +5. Edit or update related texture or variable pool files if needed. + +**Example:** +```cpp +// src/shader/Shader.cpp +#include "Shader.h" +// ...implement new shader logic +``` +```glsl +// bin/data/shaders/new_effect.frag +void main() { + // shader code here +} +``` + +--- + +### Documentation Migration or Expansion + +**Trigger:** When you need to update, migrate, or generate documentation or reference material. +**Command:** `/update-docs` + +1. Edit or add markdown files in `docs/` (e.g., `docs/*.md`) +2. Edit `README.md` +3. Optionally add or update documentation scripts (`scripts/*.sh`, `scripts/*.py`) +4. Optionally update CI workflows for doc generation (`.github/workflows/*.yml`) + +**Example:** +```markdown +# New Feature +Detailed documentation for the new feature. +``` +```bash +# scripts/check_md_links.sh +./check_md_links.sh +``` + +--- + +### OSC Command Parser or Router Refactor + +**Trigger:** When you want to improve or extend the OSC command handling pipeline. +**Command:** `/refactor-osc-parser` + +1. Edit or create OSC parser/router C++ files: + - `src/osc/CommandParser.cpp`, `src/osc/CommandRouter.cpp`, etc. +2. Edit or create related header files: + - `src/osc/*.hpp` +3. Edit or update main VOSC files to integrate changes: + - `src/VOSC.cpp`, `src/VOSC.hpp` +4. Update or add tests for OSC commands: + - `tests/osc/CommandParserTests.cpp`, `tests/osc/README.md` + +**Example:** +```cpp +// src/osc/CommandParser.cpp +#include "CommandParser.hpp" +// ...refactored parsing logic +``` +```cpp +// tests/osc/CommandParserTests.cpp +void testNewParserFeature() { + // test implementation +} +``` + +--- + +### Inspector Feature Development or Bugfix + +**Trigger:** When you want to add, improve, or fix inspector functionality. +**Command:** `/update-inspector` + +1. Edit or create inspector C++ files: + - `src/inspector/*.cpp`, `src/inspector/*.hpp` +2. Optionally update related shader, texture, or variable files. +3. Optionally update SuperCollider scripts for inspector testing. + +**Example:** +```cpp +// src/inspector/Inspector.cpp +#include "Inspector.hpp" +// ...new inspector logic +``` + +--- + +### Texture or Variable Pool Extension + +**Trigger:** When you want to extend or fix texture/variable pool functionality. +**Command:** `/update-pool` + +1. Edit or create pool C++ files: + - `src/tex/*.cpp`, `src/tex/*.h` + - `src/var/*.cpp`, `src/var/*.h` +2. Edit or update main VOSC files or related shader/inspector files. +3. Optionally update SuperCollider scripts for pool usage. + +**Example:** +```cpp +// src/var/VariablePool.cpp +#include "VariablePool.h" +// ...add new variable management +``` + +--- + +## Testing Patterns + +- **Framework:** Unknown (not explicitly detected). +- **File Pattern:** Test files follow the pattern `*.test.ts` (for TypeScript) and `tests/osc/*.cpp` (for C++). +- **Organization:** Tests are grouped by feature or module, often mirroring the source directory structure. +- **Example:** + ```cpp + // tests/osc/CommandParserTests.cpp + void testCommandParsing() { + // test code here + } + ``` + +--- + +## Commands + +| Command | Purpose | +|-----------------------|--------------------------------------------------------| +| /new-shader-feature | Start a new shader-related feature or extension | +| /update-docs | Migrate, expand, or generate documentation | +| /refactor-osc-parser | Refactor or extend OSC command parser/router | +| /update-inspector | Develop, extend, or fix inspector features | +| /update-pool | Extend or fix texture/variable pool functionality | +``` From 166d23878de63bbe6ad41eceed5ba27b5e05378e Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:49 +0000 Subject: [PATCH 04/14] feat: add vosc ECC bundle (.agents/skills/vosc/agents/openai.yaml) --- .agents/skills/vosc/agents/openai.yaml | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 .agents/skills/vosc/agents/openai.yaml diff --git a/.agents/skills/vosc/agents/openai.yaml b/.agents/skills/vosc/agents/openai.yaml new file mode 100644 index 0000000..0c09f2f --- /dev/null +++ b/.agents/skills/vosc/agents/openai.yaml @@ -0,0 +1,6 @@ +interface: + display_name: "Vosc" + short_description: "Repo-specific patterns and workflows for vosc" + default_prompt: "Use the vosc repo skill to follow existing architecture, testing, and workflow conventions." +policy: + allow_implicit_invocation: true \ No newline at end of file From 037f13076b4102f6fe396097acb680bd3cdc2aac Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:50 +0000 Subject: [PATCH 05/14] feat: add vosc ECC bundle (.claude/identity.json) --- .claude/identity.json | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 .claude/identity.json diff --git a/.claude/identity.json b/.claude/identity.json new file mode 100644 index 0000000..2d770b1 --- /dev/null +++ b/.claude/identity.json @@ -0,0 +1,14 @@ +{ + "version": "2.0", + "technicalLevel": "technical", + "preferredStyle": { + "verbosity": "minimal", + "codeComments": true, + "explanations": true + }, + "domains": [ + "python" + ], + "suggestedBy": "ecc-tools-repo-analysis", + "createdAt": "2026-05-02T20:50:44.740Z" +} \ No newline at end of file From 32329486330c707ceb410857b674bc4a19621917 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:51 +0000 Subject: [PATCH 06/14] feat: add vosc ECC bundle (.codex/config.toml) --- .codex/config.toml | 48 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 .codex/config.toml diff --git a/.codex/config.toml b/.codex/config.toml new file mode 100644 index 0000000..bc1ee67 --- /dev/null +++ b/.codex/config.toml @@ -0,0 +1,48 @@ +#:schema https://developers.openai.com/codex/config-schema.json + +# ECC Tools generated Codex baseline +approval_policy = "on-request" +sandbox_mode = "workspace-write" +web_search = "live" + +[mcp_servers.github] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-github"] + +[mcp_servers.context7] +command = "npx" +args = ["-y", "@upstash/context7-mcp@latest"] + +[mcp_servers.exa] +url = "https://mcp.exa.ai/mcp" + +[mcp_servers.memory] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-memory"] + +[mcp_servers.playwright] +command = "npx" +args = ["-y", "@playwright/mcp@latest", "--extension"] + +[mcp_servers.sequential-thinking] +command = "npx" +args = ["-y", "@modelcontextprotocol/server-sequential-thinking"] + +[features] +multi_agent = true + +[agents] +max_threads = 6 +max_depth = 1 + +[agents.explorer] +description = "Read-only codebase explorer for gathering evidence before changes are proposed." +config_file = "agents/explorer.toml" + +[agents.reviewer] +description = "PR reviewer focused on correctness, security, and missing tests." +config_file = "agents/reviewer.toml" + +[agents.docs_researcher] +description = "Documentation specialist that verifies APIs, framework behavior, and release notes." +config_file = "agents/docs-researcher.toml" \ No newline at end of file From 020f2366a5db262ab120a7699f3718f8e77cdbc2 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:52 +0000 Subject: [PATCH 07/14] feat: add vosc ECC bundle (.codex/AGENTS.md) --- .codex/AGENTS.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 .codex/AGENTS.md diff --git a/.codex/AGENTS.md b/.codex/AGENTS.md new file mode 100644 index 0000000..49bbfde --- /dev/null +++ b/.codex/AGENTS.md @@ -0,0 +1,28 @@ +# ECC for Codex CLI + +This supplements the root `AGENTS.md` with a repo-local ECC baseline. + +## Repo Skill + +- Repo-generated Codex skill: `.agents/skills/vosc/SKILL.md` +- Claude-facing companion skill: `.claude/skills/vosc/SKILL.md` +- Keep user-specific credentials and private MCPs in `~/.codex/config.toml`, not in this repo. + +## MCP Baseline + +Treat `.codex/config.toml` as the default ECC-safe baseline for work in this repository. +The generated baseline enables GitHub, Context7, Exa, Memory, Playwright, and Sequential Thinking. + +## Multi-Agent Support + +- Explorer: read-only evidence gathering +- Reviewer: correctness, security, and regression review +- Docs researcher: API and release-note verification + +## Workflow Files + +- `.claude/commands/feature-development.md` +- `.claude/commands/test-driven-development.md` +- `.claude/commands/refactoring.md` + +Use these workflow files as reusable task scaffolds when the detected repository workflows recur. \ No newline at end of file From da950097c4331fe0296af76779af236d69c62e0b Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:52 +0000 Subject: [PATCH 08/14] feat: add vosc ECC bundle (.codex/agents/explorer.toml) --- .codex/agents/explorer.toml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 .codex/agents/explorer.toml diff --git a/.codex/agents/explorer.toml b/.codex/agents/explorer.toml new file mode 100644 index 0000000..732df7a --- /dev/null +++ b/.codex/agents/explorer.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "medium" +sandbox_mode = "read-only" + +developer_instructions = """ +Stay in exploration mode. +Trace the real execution path, cite files and symbols, and avoid proposing fixes unless the parent agent asks for them. +Prefer targeted search and file reads over broad scans. +""" \ No newline at end of file From ef6238c13ec43b964c61a323f9e6b01deb81c6f3 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:53 +0000 Subject: [PATCH 09/14] feat: add vosc ECC bundle (.codex/agents/reviewer.toml) --- .codex/agents/reviewer.toml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 .codex/agents/reviewer.toml diff --git a/.codex/agents/reviewer.toml b/.codex/agents/reviewer.toml new file mode 100644 index 0000000..b13ed9c --- /dev/null +++ b/.codex/agents/reviewer.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "high" +sandbox_mode = "read-only" + +developer_instructions = """ +Review like an owner. +Prioritize correctness, security, behavioral regressions, and missing tests. +Lead with concrete findings and avoid style-only feedback unless it hides a real bug. +""" \ No newline at end of file From 5b6c4d246a42c21e9c2e86d0b28447d011bf5a46 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:54 +0000 Subject: [PATCH 10/14] feat: add vosc ECC bundle (.codex/agents/docs-researcher.toml) --- .codex/agents/docs-researcher.toml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 .codex/agents/docs-researcher.toml diff --git a/.codex/agents/docs-researcher.toml b/.codex/agents/docs-researcher.toml new file mode 100644 index 0000000..0daae57 --- /dev/null +++ b/.codex/agents/docs-researcher.toml @@ -0,0 +1,9 @@ +model = "gpt-5.4" +model_reasoning_effort = "medium" +sandbox_mode = "read-only" + +developer_instructions = """ +Verify APIs, framework behavior, and release-note claims against primary documentation before changes land. +Cite the exact docs or file paths that support each claim. +Do not invent undocumented behavior. +""" \ No newline at end of file From 02278b1d7d217bd662a9fb3fbfdd9f46a361f3f3 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:55 +0000 Subject: [PATCH 11/14] feat: add vosc ECC bundle (.claude/homunculus/instincts/inherited/vosc-instincts.yaml) --- .../instincts/inherited/vosc-instincts.yaml | 637 ++++++++++++++++++ 1 file changed, 637 insertions(+) create mode 100644 .claude/homunculus/instincts/inherited/vosc-instincts.yaml diff --git a/.claude/homunculus/instincts/inherited/vosc-instincts.yaml b/.claude/homunculus/instincts/inherited/vosc-instincts.yaml new file mode 100644 index 0000000..ff301f6 --- /dev/null +++ b/.claude/homunculus/instincts/inherited/vosc-instincts.yaml @@ -0,0 +1,637 @@ +# Instincts generated from https://github.com/kasparsj/vosc +# Generated: 2026-05-02T20:50:44.740Z +# Version: 2.0 +# NOTE: This file supplements (does not replace) any existing curated instincts. +# High-confidence manually curated instincts should be preserved alongside these. + +--- +id: vosc-commit-length +trigger: "when writing a commit message" +confidence: 0.6 +domain: git +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Commit Length + +## Action + +Keep commit messages concise (~25 characters) + +## Evidence + +- Average commit message length: 25 chars +- Based on 200 commits + +--- +id: vosc-naming-files +trigger: "when creating a new file" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Naming Files + +## Action + +Use PascalCase naming convention + +## Evidence + +- Analyzed file naming patterns in repository +- Dominant pattern: PascalCase + +--- +id: vosc-import-relative +trigger: "when importing modules" +confidence: 0.75 +domain: code-style +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Import Relative + +## Action + +Use relative imports for project files + +## Evidence + +- Import analysis shows relative import pattern +- Example: import { x } from '../lib/x' + +--- +id: vosc-export-style +trigger: "when exporting from a module" +confidence: 0.7 +domain: code-style +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Export Style + +## Action + +Prefer named exports + +## Evidence + +- Export pattern analysis +- Dominant style: named + +--- +id: vosc-test-separate +trigger: "when writing tests" +confidence: 0.8 +domain: testing +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Test Separate + +## Action + +Place tests in the tests/ or __tests__/ directory, mirroring src structure + +## Evidence + +- Separate test directory pattern detected +- Tests live in dedicated test folders + +--- +id: vosc-test-naming +trigger: "when creating a test file" +confidence: 0.85 +domain: testing +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Test Naming + +## Action + +Name test files using the pattern: *.test.ts + +## Evidence + +- File pattern: *.test.ts +- Consistent across test files + +--- +id: vosc-workflow-feature-development +trigger: "when implementing a new feature" +confidence: 0.7 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Feature Development + +## Action + +Follow the feature-development workflow: +1. Add feature implementation +2. Add tests for feature +3. Update documentation + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~4x per month +- Files: **/*.test.* + +--- +id: vosc-workflow-test-driven-development +trigger: "when adding new functionality" +confidence: 0.7 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Test Driven Development + +## Action + +Follow the test-driven-development workflow: +1. Write failing test +2. Implement code to pass test +3. Refactor if needed + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~4x per month +- Files: **/*.test.*, **/*.spec.*, src/**/* + +--- +id: vosc-workflow-refactoring +trigger: "when refactoring code" +confidence: 0.6 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Refactoring + +## Action + +Follow the refactoring workflow: +1. Ensure tests pass before refactor +2. Refactor code structure +3. Verify tests still pass + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~2x per month +- Files: src/**/* + +--- +id: vosc-workflow-shader-feature-development +trigger: "when doing shader feature development" +confidence: 0.65 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Shader Feature Development + +## Action + +Follow the shader-feature-development workflow: +1. Edit or create shader C++ files (src/shader/Shader.cpp, src/shader/Shader.h, src/shader/ShaderPass.cpp, src/shader/ShaderPass.h, etc.) +2. Edit or add shader fragment files (bin/data/shaders/**/*.frag) +3. Optionally update SuperCollider scripts for shader usage (SuperCollider/*.scd) +4. Edit or update inspector files for shaders/textures (src/inspector/ShaderInspector.cpp, src/inspector/TextureInspector.cpp, etc.) +5. Edit or update related texture or variable pool files if needed + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~3x per month +- Files: src/shader/Shader.cpp, src/shader/Shader.h, src/shader/ShaderPass.cpp + +--- +id: vosc-workflow-documentation-migration-or-expansion +trigger: "when doing documentation migration or expansion" +confidence: 0.55 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Documentation Migration Or Expansion + +## Action + +Follow the documentation-migration-or-expansion workflow: +1. Edit or add markdown files in docs/ (docs/*.md) +2. Edit README.md +3. Optionally add or update documentation scripts (scripts/*.sh, scripts/*.py) +4. Optionally update CI workflows for doc generation (.github/workflows/*.yml) + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~1x per month +- Files: README.md, docs/*.md, docs/_Sidebar.md + +--- +id: vosc-workflow-osc-command-parser-or-router-refactor +trigger: "when doing osc command parser or router refactor" +confidence: 0.55 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Osc Command Parser Or Router Refactor + +## Action + +Follow the osc-command-parser-or-router-refactor workflow: +1. Edit or create OSC parser/router C++ files (src/osc/CommandParser.cpp, src/osc/CommandRouter.cpp, etc.) +2. Edit or create related header files (src/osc/*.hpp) +3. Edit or update main VOSC files to integrate changes (src/VOSC.cpp, src/VOSC.hpp) +4. Update or add tests for OSC commands (tests/osc/*.cpp, tests/osc/README.md) + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~1x per month +- Files: src/osc/CommandParser.cpp, src/osc/CommandParser.hpp, src/osc/CommandRouter.cpp + +--- +id: vosc-workflow-inspector-feature-development-or-bugfix +trigger: "when doing inspector feature development or bugfix" +confidence: 0.6 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Inspector Feature Development Or Bugfix + +## Action + +Follow the inspector-feature-development-or-bugfix workflow: +1. Edit or create inspector C++ files (src/inspector/*.cpp, src/inspector/*.hpp) +2. Optionally update related shader, texture, or variable files +3. Optionally update SuperCollider scripts for inspector testing + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~2x per month +- Files: src/inspector/Inspector.cpp, src/inspector/Inspector.hpp, src/inspector/ShaderInspector.cpp + +--- +id: vosc-workflow-texture-or-variable-pool-extension +trigger: "when doing texture or variable pool extension" +confidence: 0.6 +domain: workflow +source: repo-analysis +source_repo: https://github.com/kasparsj/vosc +--- + +# Vosc Workflow Texture Or Variable Pool Extension + +## Action + +Follow the texture-or-variable-pool-extension workflow: +1. Edit or create pool C++ files (src/tex/*.cpp, src/tex/*.h, src/var/*.cpp, src/var/*.h) +2. Edit or update main VOSC files or related shader/inspector files +3. Optionally update SuperCollider scripts for pool usage + +## Evidence + +- Workflow detected from commit patterns +- Frequency: ~2x per month +- Files: src/tex/TexData.cpp, src/tex/TexData.h, src/tex/BaseTex.cpp + +--- +id: vosc-instinct-file-naming-pascalcase +trigger: "When creating a new file (source, header, or test)" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct File Naming Pascalcase + +## Action + +Name the file using PascalCase (e.g., ShaderInspector.cpp) + +## Evidence + +- Pattern in srcLayout and namingConventions: files are PascalCase +- Files like ShaderInspector.cpp, TextureInspector.cpp + +--- +id: vosc-instinct-function-naming-camelcase +trigger: "When defining a new function" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Function Naming Camelcase + +## Action + +Name the function using camelCase (e.g., parseCommand, addTestCase) + +## Evidence + +- Pattern in codeStyle.namingConventions: functions are camelCase + +--- +id: vosc-instinct-class-naming-pascalcase +trigger: "When defining a new class" +confidence: 0.9 +domain: code-style +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Class Naming Pascalcase + +## Action + +Name the class using PascalCase (e.g., CommandParser, ShaderPool) + +## Evidence + +- Pattern in codeStyle.namingConventions: classes are PascalCase +- Files like ShaderInspector.hpp, CommandParser.hpp + +--- +id: vosc-instinct-constant-naming-screaming-snake +trigger: "When defining a constant" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Constant Naming Screaming Snake + +## Action + +Name the constant using SCREAMING_SNAKE_CASE (e.g., DEFAULT_TIMEOUT) + +## Evidence + +- Pattern in codeStyle.namingConventions: constants are SCREAMING_SNAKE_CASE + +--- +id: vosc-instinct-import-style-relative +trigger: "When importing modules in code" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Import Style Relative + +## Action + +Use relative import paths + +## Evidence + +- Pattern in codeStyle.importStyle: relative + +--- +id: vosc-instinct-export-style-named +trigger: "When exporting modules or functions" +confidence: 0.8 +domain: code-style +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Export Style Named + +## Action + +Use named exports + +## Evidence + +- Pattern in codeStyle.exportStyle: named + +--- +id: vosc-instinct-test-file-pattern +trigger: "When creating a test file" +confidence: 0.85 +domain: testing +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Test File Pattern + +## Action + +Name the test file with the pattern *.test.ts + +## Evidence + +- Pattern in testing.filePattern: *.test.ts +- Example: src/utils/validation.test.ts + +--- +id: vosc-instinct-test-type-unit +trigger: "When writing tests" +confidence: 0.8 +domain: testing +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Test Type Unit + +## Action + +Write unit tests for individual functions or modules + +## Evidence + +- Pattern in testing.testTypes: unit + +--- +id: vosc-instinct-tdd-sequence +trigger: "When following test-driven development" +confidence: 0.85 +domain: testing +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Tdd Sequence + +## Action + +First write a failing test, then implement code to pass it, then refactor if needed + +## Evidence + +- Workflow: test-driven-development +- Commit sequence: Write failing test → Implement code → Refactor + +--- +id: vosc-instinct-commit-prefix-optional +trigger: "When making a commit" +confidence: 0.7 +domain: git +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Commit Prefix Optional + +## Action + +Optionally use a prefix (e.g., docs:, test:, chore:, refactor:) to indicate the type of change + +## Evidence + +- Commits like 'docs: migrate wiki pages into docs folder', 'test: add OSC harness and sanitizer CI', 'refactor: split VOSC into core subsystems' +- No strict enforcement, but common usage + +--- +id: vosc-instinct-commit-message-short +trigger: "When writing a commit message" +confidence: 0.8 +domain: git +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Commit Message Short + +## Action + +Keep the commit message concise, typically under 50 characters + +## Evidence + +- commits.averageLength: 25 +- Examples: 'add GenericTex', 'fixes for of_v12', 'Expand README with conceptual overview and quickstart example' + +--- +id: vosc-instinct-shader-feature-development +trigger: "When someone wants to add or modify shader functionality (e.g., Shader, ShaderPass, shader fragment files, or shader inspectors)" +confidence: 0.95 +domain: workflow +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Shader Feature Development + +## Action + +Edit or create shader C++ files, shader fragment files, optionally update SuperCollider scripts and inspector files, and related texture/variable pool files if needed + +## Evidence + +- Workflow: shader-feature-development +- Files: src/shader/Shader.cpp, bin/data/shaders/**/*.frag, src/inspector/ShaderInspector.cpp, SuperCollider/*.scd + +--- +id: vosc-instinct-documentation-migration-or-expansion +trigger: "When someone wants to update, migrate, or generate documentation or reference material" +confidence: 0.9 +domain: workflow +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Documentation Migration Or Expansion + +## Action + +Edit or add markdown files in docs/, edit README.md, optionally update documentation scripts and CI workflows for doc generation + +## Evidence + +- Workflow: documentation-migration-or-expansion +- Files: docs/*.md, README.md, scripts/generate_osc_reference.py, .github/workflows/*.yml + +--- +id: vosc-instinct-osc-command-parser-or-router-refactor +trigger: "When someone wants to improve or extend the OSC command handling pipeline" +confidence: 0.85 +domain: workflow +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Osc Command Parser Or Router Refactor + +## Action + +Edit or create OSC parser/router C++ files and headers, update main VOSC files, update or add tests for OSC commands + +## Evidence + +- Workflow: osc-command-parser-or-router-refactor +- Files: src/osc/CommandParser.cpp, src/osc/CommandRouter.cpp, tests/osc/CommandParserTests.cpp + +--- +id: vosc-instinct-inspector-feature-development-or-bugfix +trigger: "When someone wants to add, improve, or fix inspector functionality" +confidence: 0.85 +domain: workflow +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Inspector Feature Development Or Bugfix + +## Action + +Edit or create inspector C++ files, optionally update related shader, texture, or variable files, and optionally update SuperCollider scripts for inspector testing + +## Evidence + +- Workflow: inspector-feature-development-or-bugfix +- Files: src/inspector/Inspector.cpp, src/inspector/ShaderInspector.cpp, SuperCollider/*.scd + +--- +id: vosc-instinct-texture-or-variable-pool-extension +trigger: "When someone wants to extend or fix texture/variable pool functionality" +confidence: 0.8 +domain: workflow +source: repo-analysis +source_repo: kasparsj/vosc +--- + +# Vosc Instinct Texture Or Variable Pool Extension + +## Action + +Edit or create pool C++ files, update main VOSC or related shader/inspector files, optionally update SuperCollider scripts for pool usage + +## Evidence + +- Workflow: texture-or-variable-pool-extension +- Files: src/tex/TexData.cpp, src/var/VariablePool.cpp, SuperCollider/*.scd + From 61a6d9da6aa09dee3e2b00d5c5bd12fb57631bf9 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:56 +0000 Subject: [PATCH 12/14] feat: add vosc ECC bundle (.claude/commands/feature-development.md) --- .claude/commands/feature-development.md | 35 +++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 .claude/commands/feature-development.md diff --git a/.claude/commands/feature-development.md b/.claude/commands/feature-development.md new file mode 100644 index 0000000..f775889 --- /dev/null +++ b/.claude/commands/feature-development.md @@ -0,0 +1,35 @@ +--- +name: feature-development +description: Workflow command scaffold for feature-development in vosc. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /feature-development + +Use this workflow when working on **feature-development** in `vosc`. + +## Goal + +Standard feature implementation workflow + +## Common Files + +- `**/*.test.*` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Add feature implementation +- Add tests for feature +- Update documentation + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file From ca3c3cc455da0d27a67da9886bc134c6f1a2b2f2 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:57 +0000 Subject: [PATCH 13/14] feat: add vosc ECC bundle (.claude/commands/test-driven-development.md) --- .claude/commands/test-driven-development.md | 37 +++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 .claude/commands/test-driven-development.md diff --git a/.claude/commands/test-driven-development.md b/.claude/commands/test-driven-development.md new file mode 100644 index 0000000..6180b0a --- /dev/null +++ b/.claude/commands/test-driven-development.md @@ -0,0 +1,37 @@ +--- +name: test-driven-development +description: Workflow command scaffold for test-driven-development in vosc. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /test-driven-development + +Use this workflow when working on **test-driven-development** in `vosc`. + +## Goal + +Test-first development workflow (TDD) + +## Common Files + +- `**/*.test.*` +- `**/*.spec.*` +- `src/**/*` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Write failing test +- Implement code to pass test +- Refactor if needed + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file From bf231a1cbfb40de4a4aa349f2c0de066548e5296 Mon Sep 17 00:00:00 2001 From: "ecc-tools[bot]" <257055122+ecc-tools[bot]@users.noreply.github.com> Date: Sat, 2 May 2026 20:50:58 +0000 Subject: [PATCH 14/14] feat: add vosc ECC bundle (.claude/commands/refactoring.md) --- .claude/commands/refactoring.md | 35 +++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 .claude/commands/refactoring.md diff --git a/.claude/commands/refactoring.md b/.claude/commands/refactoring.md new file mode 100644 index 0000000..2a1da13 --- /dev/null +++ b/.claude/commands/refactoring.md @@ -0,0 +1,35 @@ +--- +name: refactoring +description: Workflow command scaffold for refactoring in vosc. +allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"] +--- + +# /refactoring + +Use this workflow when working on **refactoring** in `vosc`. + +## Goal + +Code refactoring and cleanup workflow + +## Common Files + +- `src/**/*` + +## Suggested Sequence + +1. Understand the current state and failure mode before editing. +2. Make the smallest coherent change that satisfies the workflow goal. +3. Run the most relevant verification for touched files. +4. Summarize what changed and what still needs review. + +## Typical Commit Signals + +- Ensure tests pass before refactor +- Refactor code structure +- Verify tests still pass + +## Notes + +- Treat this as a scaffold, not a hard-coded script. +- Update the command if the workflow evolves materially. \ No newline at end of file