commit 6c30e293795420a09c1e65ff834bc74553342972 Author: Zhongwei Li Date: Sun Nov 30 08:41:15 2025 +0800 Initial commit diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..d432c12 --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,13 @@ +{ + "name": "orchestration", + "description": "Core orchestration guidelines for conversation style, code style, testing, tool conventions, and workflow automation", + "version": "0.18.0", + "author": { + "name": "Craig Motlin" + }, + "skills": [ + "./skills/orchestration/SKILL.md", + "./skills/llm-context/SKILL.md", + "./skills/conversation-style/SKILL.md" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..5474d40 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# orchestration + +Core orchestration guidelines for conversation style, code style, testing, tool conventions, and workflow automation diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..1758672 --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,53 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:motlin/claude-code-plugins:plugins/orchestration", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "14aa286375f4a0515c7741cee0ee1d420792e68f", + "treeHash": "3debacf38ab6cc303001456ffc61c9b04e198cc14960d41eedb8d880d406b543", + "generatedAt": "2025-11-28T10:27:10.743534Z", + "toolVersion": "publish_plugins.py@0.2.0" + }, + "origin": { + "remote": "git@github.com:zhongweili/42plugin-data.git", + "branch": "master", + "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390", + "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data" + }, + "manifest": { + "name": "orchestration", + "description": "Core orchestration guidelines for conversation style, code style, testing, tool conventions, and workflow automation", + "version": "0.18.0" + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "1150eec1cb9c49f5b2413784efb4e5ce94e2d9b5303780125bf7e6b41cc4265f" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "e9e28cc912e442757706da0de68079c4f37d5313881a9ea37361d994ed10426a" + }, + { + "path": "skills/conversation-style/SKILL.md", + "sha256": "2d1a054f9a1e7526d32d33cc4837093d1ea33a338c4d461cab1097b698226ab2" + }, + { + "path": "skills/orchestration/SKILL.md", + "sha256": "ba8f36080a49c43bc8fe34083fbdddaa7eace26549352ca7707bf92a86eedc26" + }, + { + "path": "skills/llm-context/SKILL.md", + "sha256": "e51aafc95ffb7276b09e4f925d992d562e3f4d8cb9196bb70724bacf63898862" + } + ], + "dirSha256": "3debacf38ab6cc303001456ffc61c9b04e198cc14960d41eedb8d880d406b543" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file diff --git a/skills/conversation-style/SKILL.md b/skills/conversation-style/SKILL.md new file mode 100644 index 0000000..e226f52 --- /dev/null +++ b/skills/conversation-style/SKILL.md @@ -0,0 +1,19 @@ +--- +name: conversation-style +description: Conversation style guidelines. Use when responding to the user. +--- + +# Conversation Style + +- If the user asks a question, only answer the question, do not edit code +- Never compliment the user + - Criticize the user's ideas + - Ask clarifying questions +- Don't say: + - "You're right" + - "You're absolutely right" + - "I apologize" + - "I'm sorry" + - "Let me explain" + - any other introduction or transition +- Immediately get to the point diff --git a/skills/llm-context/SKILL.md b/skills/llm-context/SKILL.md new file mode 100644 index 0000000..87766a8 --- /dev/null +++ b/skills/llm-context/SKILL.md @@ -0,0 +1,27 @@ +--- +name: llm-context +description: Guidelines for working with LLM context stored in the .llm/ directory. +--- + +# LLM Context Guidelines + +Extra context for LLMs may be stored in the `.llm/` directory at the root of a git repository. + +## Directory Structure + +- If `.llm/` exists, it will be at the root directory of the git repository +- The `.llm/` should not be tracked in version control +- If `.llm/` appears to contain untracked content, ensure that it appears in `.git/info/exclude` + +## Editable Context + +- If `.llm/todo.md` exists, it is the task list we are working on +- The `@markdown-tasks:tasks` skill will handle task completion +- As we work on an implementation, plans will change + - Feel free to edit the task list to keep it relevant and in sync with our plans + +## Read-only Context + +- Everything else in the `.llm/` directory is read-only context for your reference +- It may contain entire git clones for tools we use +- It may contain saved documentation diff --git a/skills/orchestration/SKILL.md b/skills/orchestration/SKILL.md new file mode 100644 index 0000000..412031a --- /dev/null +++ b/skills/orchestration/SKILL.md @@ -0,0 +1,40 @@ +--- +name: orchestration +description: Coordinates other skills and agents. ALWAYS use this skill on startup. +--- + +# Skill Guidelines + +Invoke these skills liberally - most tasks use multiple skills: + +| Skill | When to use | +| ----------------------------------- | ------------------------------------- | +| `@code:code-quality` | Before editing code | +| `@code:testing` | When writing or reviewing tests | +| `@code:cli` | When running shell commands | +| `@build:precommit` | Before running builds or tests | +| `@git:git-workflow` | For all git operations | +| `@orchestration:conversation-style` | For response guidelines | +| `@orchestration:llm-context` | When working with `.llm/` directories | + +## Workflow Orchestration + +When a code change is ready, and we are about to return control to the user, do these things in order: + +1. Verify the build passes using the `@build:precommit-runner` agent +2. Commit to git using the `@git:commit-handler` agent +3. Rebase on top of the upstream branch with the `@git:rebaser` agent + +## Plugin Health Check + +Run the master doctor script to verify all plugins are properly configured: + +```bash +${CLAUDE_PLUGIN_ROOT}/../orchestration/scripts/doctor-all.sh +``` + +This runs `doctor.sh` from each plugin, checking for: + +- Required binaries (just, git, gh, python3, tmux, etc.) +- Required files and scripts +- Proper file permissions