Compare commits

..

15 Commits

Author SHA1 Message Date
ecc-tools[bot]
789b93a2e2 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-or-update-skill.md) 2026-04-02 03:20:35 +00:00
ecc-tools[bot]
cd6e660ef7 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md) 2026-04-02 03:20:35 +00:00
ecc-tools[bot]
b8f24d34ac feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md) 2026-04-02 03:20:33 +00:00
ecc-tools[bot]
6c7a25d98a feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md) 2026-04-02 03:20:32 +00:00
ecc-tools[bot]
9d63f77dce feat: add everything-claude-code-conventions ECC bundle (.claude/team/everything-claude-code-team-config.json) 2026-04-02 03:20:31 +00:00
ecc-tools[bot]
24e325fc7c feat: add everything-claude-code-conventions ECC bundle (.claude/research/everything-claude-code-research-playbook.md) 2026-04-02 03:20:31 +00:00
ecc-tools[bot]
21d4f12a6d feat: add everything-claude-code-conventions ECC bundle (.claude/rules/everything-claude-code-guardrails.md) 2026-04-02 03:20:30 +00:00
ecc-tools[bot]
399f75a5f6 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/docs-researcher.toml) 2026-04-02 03:20:29 +00:00
ecc-tools[bot]
8c4ee56603 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/reviewer.toml) 2026-04-02 03:20:28 +00:00
ecc-tools[bot]
37b08054e3 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/explorer.toml) 2026-04-02 03:20:27 +00:00
ecc-tools[bot]
ca4bc8a07e feat: add everything-claude-code-conventions ECC bundle (.claude/identity.json) 2026-04-02 03:20:26 +00:00
ecc-tools[bot]
8195550e16 feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml) 2026-04-02 03:20:26 +00:00
ecc-tools[bot]
af1ab97b9b feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/SKILL.md) 2026-04-02 03:20:24 +00:00
ecc-tools[bot]
4113d8405f feat: add everything-claude-code-conventions ECC bundle (.claude/skills/everything-claude-code/SKILL.md) 2026-04-02 03:20:21 +00:00
ecc-tools[bot]
14889fcc66 feat: add everything-claude-code-conventions ECC bundle (.claude/ecc-tools.json) 2026-04-02 03:20:19 +00:00
8 changed files with 331 additions and 309 deletions

View File

@@ -40,7 +40,7 @@ Follow these commit message conventions based on 500 analyzed commits.
### Message Guidelines
- Average message length: ~56 characters
- Average message length: ~57 characters
- Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature")
@@ -48,13 +48,13 @@ Follow these commit message conventions based on 500 analyzed commits.
*Commit message example*
```text
feat(skills): add argus-design-review — three-tier design doc review
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-or-update-skill.md)
```
*Commit message example*
```text
fix(tests): add USERPROFILE to repair.test.js for Windows
fix: port safe ci cleanup from backlog
```
*Commit message example*
@@ -78,19 +78,19 @@ chore: ignore local orchestration artifacts
*Commit message example*
```text
fix(lint): add missing trailing newlines to remotion rules
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md)
```
*Commit message example*
```text
fix(tests): normalize path separators in CLAUDE_PLUGIN_ROOT test
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md)
```
*Commit message example*
```text
fix(ci): resolve markdownlint errors and Windows install-apply test
feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md)
```
## Architecture
@@ -188,7 +188,7 @@ These workflows were detected from analyzing commit patterns.
Standard feature implementation workflow
**Frequency**: ~16 times per month
**Frequency**: ~19 times per month
**Steps**:
1. Add feature implementation
@@ -204,16 +204,16 @@ Standard feature implementation workflow
**Example commit sequence**:
```
feat(team-builder): use `claude agents` command for agent discovery (#1021)
fix: extract inline SessionStart bootstrap to separate file (#1035)
feat: add hexagonal architecture SKILL. (#1034)
feat(agents,skills): add opensource-pipeline — 3-agent workflow for safe public releases (#1036)
feat(install): add CodeBuddy(Tencent) adaptation with installation scripts (#1038)
chore(deps-dev): bump c8 from 10.1.3 to 11.0.0 (#1065)
```
### Refactoring
Code refactoring and cleanup workflow
**Frequency**: ~2 times per month
**Frequency**: ~3 times per month
**Steps**:
1. Ensure tests pass before refactor
@@ -230,173 +230,184 @@ feat: add connected operator workflow skills
feat: expand lead intelligence outreach channels
```
### Add New Skill
### Add Or Update Skill
Adds a new skill to the system, including documentation and registration in summary/index files.
Adds or updates a skill module, including documentation and references, and registers it in manifests and documentation.
**Frequency**: ~6 times per month
**Frequency**: ~4 times per month
**Steps**:
1. Create a new SKILL.md file under skills/{skill-name}/
2. Optionally add reference files or assets under skills/{skill-name}/references/ or assets/
3. Update AGENTS.md and README.md to document the new skill
4. Update docs/zh-CN/AGENTS.md and docs/zh-CN/README.md for Chinese documentation
5. Optionally update manifests/install-components.json or install-modules.json if the skill is installable
1. Create or update SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
2. Optionally add or update references or assets under skills/<skill-name>/references/ or assets/
3. Update manifests/install-modules.json and/or manifests/install-components.json
4. Update AGENTS.md, README.md, README.zh-CN.md, and docs/zh-CN/* as needed
5. Update WORKING-CONTEXT.md if context changes
6. Optionally update or create related test files
**Files typically involved**:
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `skills/*/references/*.md`
- `skills/*/assets/*`
- `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
- `manifests/install-components.json`
- `manifests/install-modules.json`
- `WORKING-CONTEXT.md`
**Example commit sequence**:
```
Create a new SKILL.md file under skills/{skill-name}/
Optionally add reference files or assets under skills/{skill-name}/references/ or assets/
Update AGENTS.md and README.md to document the new skill
Update docs/zh-CN/AGENTS.md and docs/zh-CN/README.md for Chinese documentation
Optionally update manifests/install-components.json or install-modules.json if the skill is installable
Create or update SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
Optionally add or update references or assets under skills/<skill-name>/references/ or assets/
Update manifests/install-modules.json and/or manifests/install-components.json
Update AGENTS.md, README.md, README.zh-CN.md, and docs/zh-CN/* as needed
Update WORKING-CONTEXT.md if context changes
Optionally update or create related test files
```
### Add Or Update Command Workflow
Adds or updates a command file describing a workflow, often for agent orchestration or developer automation.
Adds or updates command documentation and workflow scripts for agentic or PRP workflows.
**Frequency**: ~2 times per month
**Steps**:
1. Create or update command markdown files under commands/ (e.g., prp-prd.md, code-review.md)
2. If extending, update related commands (e.g., plan.md cross-references prp-plan.md)
3. Address review feedback and iterate on command logic and documentation
**Files typically involved**:
- `commands/*.md`
**Example commit sequence**:
```
Create or update command markdown files under commands/ (e.g., prp-prd.md, code-review.md)
If extending, update related commands (e.g., plan.md cross-references prp-plan.md)
Address review feedback and iterate on command logic and documentation
```
### Add Or Update Agent Or Agent Prompt
Adds or updates agent configuration, prompt files, and registers agents in orchestration manifests.
**Frequency**: ~2 times per month
**Steps**:
1. Create or update agent prompt files under .opencode/prompts/agents/
2. Update .opencode/opencode.json to register or modify agent configuration
3. Update AGENTS.md to document the new or updated agent
**Files typically involved**:
- `.opencode/prompts/agents/*.txt`
- `.opencode/opencode.json`
- `AGENTS.md`
**Example commit sequence**:
```
Create or update agent prompt files under .opencode/prompts/agents/
Update .opencode/opencode.json to register or modify agent configuration
Update AGENTS.md to document the new or updated agent
```
### Feature Development Skill And Docs
Implements a new feature or workflow by adding skills, updating documentation, and synchronizing manifests and context.
**Frequency**: ~3 times per month
**Steps**:
1. Create or modify a Markdown file under commands/ (e.g., commands/prp-*.md, commands/gan-*.md, commands/santa-loop.md)
2. Document the workflow with YAML frontmatter, usage, and output sections
3. Optionally update AGENTS.md, README.md, or other summary files if the command is significant
4. Address review feedback and iterate on the command file
1. Add or update SKILL.md and related files in skills/ or .agents/skills/
2. Update or create supporting documentation (README.md, AGENTS.md, docs/zh-CN/*, WORKING-CONTEXT.md)
3. Update manifests/install-modules.json and/or manifests/install-components.json
4. Synchronize or update related scripts or test files
**Files typically involved**:
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
- `WORKING-CONTEXT.md`
- `manifests/install-modules.json`
- `manifests/install-components.json`
**Example commit sequence**:
```
Add or update SKILL.md and related files in skills/ or .agents/skills/
Update or create supporting documentation (README.md, AGENTS.md, docs/zh-CN/*, WORKING-CONTEXT.md)
Update manifests/install-modules.json and/or manifests/install-components.json
Synchronize or update related scripts or test files
```
### Refactor Or Sync Manifests And Context
Refactors commands, skills, or agents and synchronizes manifests and working context documentation.
**Frequency**: ~2 times per month
**Steps**:
1. Update or remove command files under commands/
2. Update or create SKILL.md files as needed
3. Update manifests/install-modules.json and/or install-components.json
4. Update AGENTS.md, README.md, README.zh-CN.md, docs/zh-CN/*, WORKING-CONTEXT.md
**Files typically involved**:
- `commands/*.md`
- `skills/*/SKILL.md`
- `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
- `WORKING-CONTEXT.md`
**Example commit sequence**:
```
Create or modify a Markdown file under commands/ (e.g., commands/prp-*.md, commands/gan-*.md, commands/santa-loop.md)
Document the workflow with YAML frontmatter, usage, and output sections
Optionally update AGENTS.md, README.md, or other summary files if the command is significant
Address review feedback and iterate on the command file
Update or remove command files under commands/
Update or create SKILL.md files as needed
Update manifests/install-modules.json and/or install-components.json
Update AGENTS.md, README.md, README.zh-CN.md, docs/zh-CN/*, WORKING-CONTEXT.md
```
### Add Or Update Agent Definition
### Add Or Update Install Target
Adds or updates agent definition files to introduce or modify agent behaviors or roles.
Adds or updates an install target (e.g., CodeBuddy, Gemini) with scripts, schemas, and manifest registration.
**Frequency**: ~2 times per month
**Steps**:
1. Create or modify agent definition Markdown files under agents/
2. Optionally update AGENTS.md to reflect new or changed agents
3. Update skills or commands that reference the agent if necessary
1. Add or update install/uninstall scripts under .<target>/
2. Update or create README files for the target
3. Update schemas (ecc-install-config.schema.json, install-modules.schema.json)
4. Update scripts/lib/install-targets/<target>-project.js and registry.js
5. Update manifests/install-modules.json
6. Update or add related test files
**Files typically involved**:
- `agents/*.md`
- `AGENTS.md`
**Example commit sequence**:
```
Create or modify agent definition Markdown files under agents/
Optionally update AGENTS.md to reflect new or changed agents
Update skills or commands that reference the agent if necessary
```
### Add Install Target Or Adapter
Adds a new install target (integration with external tools/platforms) including schema, scripts, and tests.
**Frequency**: ~2 times per month
**Steps**:
1. Create a new directory under .{target}/ with README and install/uninstall scripts
2. Add or update scripts/lib/install-targets/{target}-project.js
3. Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
4. Update registry.js and install-manifests.js as needed
5. Add or update tests for the new install target
**Files typically involved**:
- `.*/README.md`
- `.*/install.*`
- `.*/uninstall.*`
- `scripts/lib/install-targets/*.js`
- `.<target>/*`
- `manifests/install-modules.json`
- `schemas/ecc-install-config.schema.json`
- `schemas/install-modules.schema.json`
- `scripts/lib/install-manifests.js`
- `scripts/lib/install-targets/<target>-project.js`
- `scripts/lib/install-targets/registry.js`
- `tests/lib/install-targets.test.js`
**Example commit sequence**:
```
Create a new directory under .{target}/ with README and install/uninstall scripts
Add or update scripts/lib/install-targets/{target}-project.js
Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
Update registry.js and install-manifests.js as needed
Add or update tests for the new install target
```
### Test Fix Or Portability Fix
Fixes or improves test scripts, especially for cross-platform (Windows/Linux) compatibility.
**Frequency**: ~3 times per month
**Steps**:
1. Edit test files under tests/scripts/ or tests/lib/
2. Normalize environment variables or path separators for Windows compatibility
3. Update related implementation files if needed (e.g., scripts/lib/install/apply.js)
4. Commit with a fix(tests): or fix(ci): message
**Files typically involved**:
- `tests/scripts/*.test.js`
- `tests/lib/*.test.js`
- `scripts/lib/install/*.js`
- `scripts/lib/install-manifests.js`
**Example commit sequence**:
```
Edit test files under tests/scripts/ or tests/lib/
Normalize environment variables or path separators for Windows compatibility
Update related implementation files if needed (e.g., scripts/lib/install/apply.js)
Commit with a fix(tests): or fix(ci): message
```
### Update Repo Documentation And Guidance
Updates documentation files to reflect new workflows, skills, or repo guidance.
**Frequency**: ~4 times per month
**Steps**:
1. Edit README.md, README.zh-CN.md, WORKING-CONTEXT.md, AGENTS.md, or the-shortform-guide.md
2. Edit docs/zh-CN/* as needed for Chinese documentation
3. Optionally update .claude-plugin/README.md, .codex-plugin/README.md, or related plugin docs
**Files typically involved**:
- `README.md`
- `README.zh-CN.md`
- `WORKING-CONTEXT.md`
- `AGENTS.md`
- `the-shortform-guide.md`
- `docs/zh-CN/*.md`
- `.claude-plugin/README.md`
- `.codex-plugin/README.md`
**Example commit sequence**:
```
Edit README.md, README.zh-CN.md, WORKING-CONTEXT.md, AGENTS.md, or the-shortform-guide.md
Edit docs/zh-CN/* as needed for Chinese documentation
Optionally update .claude-plugin/README.md, .codex-plugin/README.md, or related plugin docs
Add or update install/uninstall scripts under .<target>/
Update or create README files for the target
Update schemas (ecc-install-config.schema.json, install-modules.schema.json)
Update scripts/lib/install-targets/<target>-project.js and registry.js
Update manifests/install-modules.json
Update or add related test files
```

View File

@@ -1,42 +0,0 @@
---
name: add-new-skill
description: Workflow command scaffold for add-new-skill in everything-claude-code.
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
---
# /add-new-skill
Use this workflow when working on **add-new-skill** in `everything-claude-code`.
## Goal
Adds a new skill to the system, including documentation and registration in summary/index files.
## Common Files
- `skills/*/SKILL.md`
- `skills/*/references/*.md`
- `skills/*/assets/*`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
## 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
- Create a new SKILL.md file under skills/{skill-name}/
- Optionally add reference files or assets under skills/{skill-name}/references/ or assets/
- Update AGENTS.md and README.md to document the new skill
- Update docs/zh-CN/AGENTS.md and docs/zh-CN/README.md for Chinese documentation
- Optionally update manifests/install-components.json or install-modules.json if the skill is installable
## Notes
- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.

View File

@@ -0,0 +1,42 @@
---
name: add-or-update-skill
description: Workflow command scaffold for add-or-update-skill in everything-claude-code.
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
---
# /add-or-update-skill
Use this workflow when working on **add-or-update-skill** in `everything-claude-code`.
## Goal
Adds or updates a skill module, including documentation and references, and registers it in manifests and documentation.
## Common Files
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `skills/*/references/*.md`
- `skills/*/assets/*`
- `manifests/install-modules.json`
- `manifests/install-components.json`
## 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
- Create or update SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
- Optionally add or update references or assets under skills/<skill-name>/references/ or assets/
- Update manifests/install-modules.json and/or manifests/install-components.json
- Update AGENTS.md, README.md, README.zh-CN.md, and docs/zh-CN/* as needed
- Update WORKING-CONTEXT.md if context changes
## Notes
- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.

View File

@@ -2,7 +2,7 @@
"version": "1.3",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-04-02T03:25:20.900Z",
"generatedAt": "2026-04-02T03:14:01.196Z",
"repo": "https://github.com/affaan-m/everything-claude-code",
"profiles": {
"requested": "full",
@@ -150,7 +150,7 @@
".claude/enterprise/controls.md",
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
".claude/commands/add-or-update-skill.md"
],
"packageFiles": {
"runtime-core": [
@@ -180,7 +180,7 @@
"workflow-pack": [
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
".claude/commands/add-or-update-skill.md"
]
},
"moduleFiles": {
@@ -211,7 +211,7 @@
"workflow-pack": [
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
".claude/commands/add-or-update-skill.md"
]
},
"files": [
@@ -297,8 +297,8 @@
},
{
"moduleId": "workflow-pack",
"path": ".claude/commands/add-new-skill.md",
"description": "Workflow command scaffold for add-new-skill."
"path": ".claude/commands/add-or-update-skill.md",
"description": "Workflow command scaffold for add-or-update-skill."
}
],
"workflows": [
@@ -311,8 +311,8 @@
"path": ".claude/commands/refactoring.md"
},
{
"command": "add-new-skill",
"path": ".claude/commands/add-new-skill.md"
"command": "add-or-update-skill",
"path": ".claude/commands/add-or-update-skill.md"
}
],
"adapters": {
@@ -322,7 +322,7 @@
"commandPaths": [
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
".claude/commands/add-or-update-skill.md"
]
},
"codex": {

View File

@@ -10,5 +10,5 @@
"javascript"
],
"suggestedBy": "ecc-tools-repo-analysis",
"createdAt": "2026-04-02T03:26:02.848Z"
"createdAt": "2026-04-02T03:20:17.389Z"
}

View File

@@ -26,7 +26,7 @@ Generated by ECC Tools from repository history. Review before treating it as a h
- feature-development: Standard feature implementation workflow
- refactoring: Code refactoring and cleanup workflow
- add-new-skill: Adds a new skill to the system, including documentation and registration in summary/index files.
- add-or-update-skill: Adds or updates a skill module, including documentation and references, and registers it in manifests and documentation.
## Review Reminder

View File

@@ -40,7 +40,7 @@ Follow these commit message conventions based on 500 analyzed commits.
### Message Guidelines
- Average message length: ~56 characters
- Average message length: ~57 characters
- Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature")
@@ -48,13 +48,13 @@ Follow these commit message conventions based on 500 analyzed commits.
*Commit message example*
```text
feat(skills): add argus-design-review — three-tier design doc review
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-or-update-skill.md)
```
*Commit message example*
```text
fix(tests): add USERPROFILE to repair.test.js for Windows
fix: port safe ci cleanup from backlog
```
*Commit message example*
@@ -78,19 +78,19 @@ chore: ignore local orchestration artifacts
*Commit message example*
```text
fix(lint): add missing trailing newlines to remotion rules
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md)
```
*Commit message example*
```text
fix(tests): normalize path separators in CLAUDE_PLUGIN_ROOT test
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md)
```
*Commit message example*
```text
fix(ci): resolve markdownlint errors and Windows install-apply test
feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md)
```
## Architecture
@@ -188,7 +188,7 @@ These workflows were detected from analyzing commit patterns.
Standard feature implementation workflow
**Frequency**: ~16 times per month
**Frequency**: ~19 times per month
**Steps**:
1. Add feature implementation
@@ -204,16 +204,16 @@ Standard feature implementation workflow
**Example commit sequence**:
```
feat(team-builder): use `claude agents` command for agent discovery (#1021)
fix: extract inline SessionStart bootstrap to separate file (#1035)
feat: add hexagonal architecture SKILL. (#1034)
feat(agents,skills): add opensource-pipeline — 3-agent workflow for safe public releases (#1036)
feat(install): add CodeBuddy(Tencent) adaptation with installation scripts (#1038)
chore(deps-dev): bump c8 from 10.1.3 to 11.0.0 (#1065)
```
### Refactoring
Code refactoring and cleanup workflow
**Frequency**: ~2 times per month
**Frequency**: ~3 times per month
**Steps**:
1. Ensure tests pass before refactor
@@ -230,173 +230,184 @@ feat: add connected operator workflow skills
feat: expand lead intelligence outreach channels
```
### Add New Skill
### Add Or Update Skill
Adds a new skill to the system, including documentation and registration in summary/index files.
Adds or updates a skill module, including documentation and references, and registers it in manifests and documentation.
**Frequency**: ~6 times per month
**Frequency**: ~4 times per month
**Steps**:
1. Create a new SKILL.md file under skills/{skill-name}/
2. Optionally add reference files or assets under skills/{skill-name}/references/ or assets/
3. Update AGENTS.md and README.md to document the new skill
4. Update docs/zh-CN/AGENTS.md and docs/zh-CN/README.md for Chinese documentation
5. Optionally update manifests/install-components.json or install-modules.json if the skill is installable
1. Create or update SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
2. Optionally add or update references or assets under skills/<skill-name>/references/ or assets/
3. Update manifests/install-modules.json and/or manifests/install-components.json
4. Update AGENTS.md, README.md, README.zh-CN.md, and docs/zh-CN/* as needed
5. Update WORKING-CONTEXT.md if context changes
6. Optionally update or create related test files
**Files typically involved**:
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `skills/*/references/*.md`
- `skills/*/assets/*`
- `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
- `manifests/install-components.json`
- `manifests/install-modules.json`
- `WORKING-CONTEXT.md`
**Example commit sequence**:
```
Create a new SKILL.md file under skills/{skill-name}/
Optionally add reference files or assets under skills/{skill-name}/references/ or assets/
Update AGENTS.md and README.md to document the new skill
Update docs/zh-CN/AGENTS.md and docs/zh-CN/README.md for Chinese documentation
Optionally update manifests/install-components.json or install-modules.json if the skill is installable
Create or update SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
Optionally add or update references or assets under skills/<skill-name>/references/ or assets/
Update manifests/install-modules.json and/or manifests/install-components.json
Update AGENTS.md, README.md, README.zh-CN.md, and docs/zh-CN/* as needed
Update WORKING-CONTEXT.md if context changes
Optionally update or create related test files
```
### Add Or Update Command Workflow
Adds or updates a command file describing a workflow, often for agent orchestration or developer automation.
Adds or updates command documentation and workflow scripts for agentic or PRP workflows.
**Frequency**: ~2 times per month
**Steps**:
1. Create or update command markdown files under commands/ (e.g., prp-prd.md, code-review.md)
2. If extending, update related commands (e.g., plan.md cross-references prp-plan.md)
3. Address review feedback and iterate on command logic and documentation
**Files typically involved**:
- `commands/*.md`
**Example commit sequence**:
```
Create or update command markdown files under commands/ (e.g., prp-prd.md, code-review.md)
If extending, update related commands (e.g., plan.md cross-references prp-plan.md)
Address review feedback and iterate on command logic and documentation
```
### Add Or Update Agent Or Agent Prompt
Adds or updates agent configuration, prompt files, and registers agents in orchestration manifests.
**Frequency**: ~2 times per month
**Steps**:
1. Create or update agent prompt files under .opencode/prompts/agents/
2. Update .opencode/opencode.json to register or modify agent configuration
3. Update AGENTS.md to document the new or updated agent
**Files typically involved**:
- `.opencode/prompts/agents/*.txt`
- `.opencode/opencode.json`
- `AGENTS.md`
**Example commit sequence**:
```
Create or update agent prompt files under .opencode/prompts/agents/
Update .opencode/opencode.json to register or modify agent configuration
Update AGENTS.md to document the new or updated agent
```
### Feature Development Skill And Docs
Implements a new feature or workflow by adding skills, updating documentation, and synchronizing manifests and context.
**Frequency**: ~3 times per month
**Steps**:
1. Create or modify a Markdown file under commands/ (e.g., commands/prp-*.md, commands/gan-*.md, commands/santa-loop.md)
2. Document the workflow with YAML frontmatter, usage, and output sections
3. Optionally update AGENTS.md, README.md, or other summary files if the command is significant
4. Address review feedback and iterate on the command file
1. Add or update SKILL.md and related files in skills/ or .agents/skills/
2. Update or create supporting documentation (README.md, AGENTS.md, docs/zh-CN/*, WORKING-CONTEXT.md)
3. Update manifests/install-modules.json and/or manifests/install-components.json
4. Synchronize or update related scripts or test files
**Files typically involved**:
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
- `WORKING-CONTEXT.md`
- `manifests/install-modules.json`
- `manifests/install-components.json`
**Example commit sequence**:
```
Add or update SKILL.md and related files in skills/ or .agents/skills/
Update or create supporting documentation (README.md, AGENTS.md, docs/zh-CN/*, WORKING-CONTEXT.md)
Update manifests/install-modules.json and/or manifests/install-components.json
Synchronize or update related scripts or test files
```
### Refactor Or Sync Manifests And Context
Refactors commands, skills, or agents and synchronizes manifests and working context documentation.
**Frequency**: ~2 times per month
**Steps**:
1. Update or remove command files under commands/
2. Update or create SKILL.md files as needed
3. Update manifests/install-modules.json and/or install-components.json
4. Update AGENTS.md, README.md, README.zh-CN.md, docs/zh-CN/*, WORKING-CONTEXT.md
**Files typically involved**:
- `commands/*.md`
- `skills/*/SKILL.md`
- `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
- `WORKING-CONTEXT.md`
**Example commit sequence**:
```
Create or modify a Markdown file under commands/ (e.g., commands/prp-*.md, commands/gan-*.md, commands/santa-loop.md)
Document the workflow with YAML frontmatter, usage, and output sections
Optionally update AGENTS.md, README.md, or other summary files if the command is significant
Address review feedback and iterate on the command file
Update or remove command files under commands/
Update or create SKILL.md files as needed
Update manifests/install-modules.json and/or install-components.json
Update AGENTS.md, README.md, README.zh-CN.md, docs/zh-CN/*, WORKING-CONTEXT.md
```
### Add Or Update Agent Definition
### Add Or Update Install Target
Adds or updates agent definition files to introduce or modify agent behaviors or roles.
Adds or updates an install target (e.g., CodeBuddy, Gemini) with scripts, schemas, and manifest registration.
**Frequency**: ~2 times per month
**Steps**:
1. Create or modify agent definition Markdown files under agents/
2. Optionally update AGENTS.md to reflect new or changed agents
3. Update skills or commands that reference the agent if necessary
1. Add or update install/uninstall scripts under .<target>/
2. Update or create README files for the target
3. Update schemas (ecc-install-config.schema.json, install-modules.schema.json)
4. Update scripts/lib/install-targets/<target>-project.js and registry.js
5. Update manifests/install-modules.json
6. Update or add related test files
**Files typically involved**:
- `agents/*.md`
- `AGENTS.md`
**Example commit sequence**:
```
Create or modify agent definition Markdown files under agents/
Optionally update AGENTS.md to reflect new or changed agents
Update skills or commands that reference the agent if necessary
```
### Add Install Target Or Adapter
Adds a new install target (integration with external tools/platforms) including schema, scripts, and tests.
**Frequency**: ~2 times per month
**Steps**:
1. Create a new directory under .{target}/ with README and install/uninstall scripts
2. Add or update scripts/lib/install-targets/{target}-project.js
3. Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
4. Update registry.js and install-manifests.js as needed
5. Add or update tests for the new install target
**Files typically involved**:
- `.*/README.md`
- `.*/install.*`
- `.*/uninstall.*`
- `scripts/lib/install-targets/*.js`
- `.<target>/*`
- `manifests/install-modules.json`
- `schemas/ecc-install-config.schema.json`
- `schemas/install-modules.schema.json`
- `scripts/lib/install-manifests.js`
- `scripts/lib/install-targets/<target>-project.js`
- `scripts/lib/install-targets/registry.js`
- `tests/lib/install-targets.test.js`
**Example commit sequence**:
```
Create a new directory under .{target}/ with README and install/uninstall scripts
Add or update scripts/lib/install-targets/{target}-project.js
Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
Update registry.js and install-manifests.js as needed
Add or update tests for the new install target
```
### Test Fix Or Portability Fix
Fixes or improves test scripts, especially for cross-platform (Windows/Linux) compatibility.
**Frequency**: ~3 times per month
**Steps**:
1. Edit test files under tests/scripts/ or tests/lib/
2. Normalize environment variables or path separators for Windows compatibility
3. Update related implementation files if needed (e.g., scripts/lib/install/apply.js)
4. Commit with a fix(tests): or fix(ci): message
**Files typically involved**:
- `tests/scripts/*.test.js`
- `tests/lib/*.test.js`
- `scripts/lib/install/*.js`
- `scripts/lib/install-manifests.js`
**Example commit sequence**:
```
Edit test files under tests/scripts/ or tests/lib/
Normalize environment variables or path separators for Windows compatibility
Update related implementation files if needed (e.g., scripts/lib/install/apply.js)
Commit with a fix(tests): or fix(ci): message
```
### Update Repo Documentation And Guidance
Updates documentation files to reflect new workflows, skills, or repo guidance.
**Frequency**: ~4 times per month
**Steps**:
1. Edit README.md, README.zh-CN.md, WORKING-CONTEXT.md, AGENTS.md, or the-shortform-guide.md
2. Edit docs/zh-CN/* as needed for Chinese documentation
3. Optionally update .claude-plugin/README.md, .codex-plugin/README.md, or related plugin docs
**Files typically involved**:
- `README.md`
- `README.zh-CN.md`
- `WORKING-CONTEXT.md`
- `AGENTS.md`
- `the-shortform-guide.md`
- `docs/zh-CN/*.md`
- `.claude-plugin/README.md`
- `.codex-plugin/README.md`
**Example commit sequence**:
```
Edit README.md, README.zh-CN.md, WORKING-CONTEXT.md, AGENTS.md, or the-shortform-guide.md
Edit docs/zh-CN/* as needed for Chinese documentation
Optionally update .claude-plugin/README.md, .codex-plugin/README.md, or related plugin docs
Add or update install/uninstall scripts under .<target>/
Update or create README files for the target
Update schemas (ecc-install-config.schema.json, install-modules.schema.json)
Update scripts/lib/install-targets/<target>-project.js and registry.js
Update manifests/install-modules.json
Update or add related test files
```

View File

@@ -9,7 +9,7 @@
"commandFiles": [
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
".claude/commands/add-or-update-skill.md"
],
"updatedAt": "2026-04-02T03:25:20.900Z"
"updatedAt": "2026-04-02T03:14:01.196Z"
}