Compare commits

..

15 Commits

Author SHA1 Message Date
ecc-tools[bot]
6855d312f9 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-new-skill.md) 2026-04-02 03:26:16 +00:00
ecc-tools[bot]
a38bbda48d feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md) 2026-04-02 03:26:15 +00:00
ecc-tools[bot]
e79b18d92a feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md) 2026-04-02 03:26:14 +00:00
ecc-tools[bot]
a11f1bcf19 feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md) 2026-04-02 03:26:13 +00:00
ecc-tools[bot]
22da7d3255 feat: add everything-claude-code-conventions ECC bundle (.claude/team/everything-claude-code-team-config.json) 2026-04-02 03:26:13 +00:00
ecc-tools[bot]
7c43826e05 feat: add everything-claude-code-conventions ECC bundle (.claude/research/everything-claude-code-research-playbook.md) 2026-04-02 03:26:12 +00:00
ecc-tools[bot]
6bb9c2bb75 feat: add everything-claude-code-conventions ECC bundle (.claude/rules/everything-claude-code-guardrails.md) 2026-04-02 03:26:11 +00:00
ecc-tools[bot]
d166ca2a7a feat: add everything-claude-code-conventions ECC bundle (.codex/agents/docs-researcher.toml) 2026-04-02 03:26:10 +00:00
ecc-tools[bot]
d8ea7b8f9a feat: add everything-claude-code-conventions ECC bundle (.codex/agents/reviewer.toml) 2026-04-02 03:26:09 +00:00
ecc-tools[bot]
141251f446 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/explorer.toml) 2026-04-02 03:26:08 +00:00
ecc-tools[bot]
8fd89187ee feat: add everything-claude-code-conventions ECC bundle (.claude/identity.json) 2026-04-02 03:26:07 +00:00
ecc-tools[bot]
7cc68b4bdf feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml) 2026-04-02 03:26:07 +00:00
ecc-tools[bot]
d7a1397df7 feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/SKILL.md) 2026-04-02 03:26:06 +00:00
ecc-tools[bot]
c3a0485b57 feat: add everything-claude-code-conventions ECC bundle (.claude/skills/everything-claude-code/SKILL.md) 2026-04-02 03:26:05 +00:00
ecc-tools[bot]
d9987eecb7 feat: add everything-claude-code-conventions ECC bundle (.claude/ecc-tools.json) 2026-04-02 03:26:04 +00:00
8 changed files with 309 additions and 331 deletions

View File

@@ -40,7 +40,7 @@ Follow these commit message conventions based on 500 analyzed commits.
### Message Guidelines
- Average message length: ~57 characters
- Average message length: ~56 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: add everything-claude-code-conventions ECC bundle (.claude/commands/add-or-update-skill.md)
feat(skills): add argus-design-review — three-tier design doc review
```
*Commit message example*
```text
fix: port safe ci cleanup from backlog
fix(tests): add USERPROFILE to repair.test.js for Windows
```
*Commit message example*
@@ -78,19 +78,19 @@ chore: ignore local orchestration artifacts
*Commit message example*
```text
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md)
fix(lint): add missing trailing newlines to remotion rules
```
*Commit message example*
```text
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md)
fix(tests): normalize path separators in CLAUDE_PLUGIN_ROOT test
```
*Commit message example*
```text
feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md)
fix(ci): resolve markdownlint errors and Windows install-apply test
```
## Architecture
@@ -188,7 +188,7 @@ These workflows were detected from analyzing commit patterns.
Standard feature implementation workflow
**Frequency**: ~19 times per month
**Frequency**: ~16 times per month
**Steps**:
1. Add feature implementation
@@ -204,16 +204,16 @@ Standard feature implementation workflow
**Example commit sequence**:
```
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)
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)
```
### Refactoring
Code refactoring and cleanup workflow
**Frequency**: ~3 times per month
**Frequency**: ~2 times per month
**Steps**:
1. Ensure tests pass before refactor
@@ -230,184 +230,173 @@ feat: add connected operator workflow skills
feat: expand lead intelligence outreach channels
```
### Add Or Update Skill
### Add New Skill
Adds or updates a skill module, including documentation and references, and registers it in manifests and documentation.
Adds a new skill to the system, including documentation and registration in summary/index files.
**Frequency**: ~4 times per month
**Frequency**: ~6 times per month
**Steps**:
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
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
**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`
- `WORKING-CONTEXT.md`
- `manifests/install-components.json`
- `manifests/install-modules.json`
**Example commit sequence**:
```
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
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
```
### Add Or Update Command Workflow
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.
Adds or updates a command file describing a workflow, often for agent orchestration or developer automation.
**Frequency**: ~3 times per month
**Steps**:
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
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
**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**:
```
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
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
```
### Add Or Update Install Target
### Add Or Update Agent Definition
Adds or updates an install target (e.g., CodeBuddy, Gemini) with scripts, schemas, and manifest registration.
Adds or updates agent definition files to introduce or modify agent behaviors or roles.
**Frequency**: ~2 times per month
**Steps**:
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
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
**Files typically involved**:
- `.<target>/*`
- `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`
- `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**:
```
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
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
```

View File

@@ -0,0 +1,42 @@
---
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

@@ -1,42 +0,0 @@
---
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:14:01.196Z",
"generatedAt": "2026-04-02T03:25:20.900Z",
"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-or-update-skill.md"
".claude/commands/add-new-skill.md"
],
"packageFiles": {
"runtime-core": [
@@ -180,7 +180,7 @@
"workflow-pack": [
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
".claude/commands/add-new-skill.md"
]
},
"moduleFiles": {
@@ -211,7 +211,7 @@
"workflow-pack": [
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
".claude/commands/add-new-skill.md"
]
},
"files": [
@@ -297,8 +297,8 @@
},
{
"moduleId": "workflow-pack",
"path": ".claude/commands/add-or-update-skill.md",
"description": "Workflow command scaffold for add-or-update-skill."
"path": ".claude/commands/add-new-skill.md",
"description": "Workflow command scaffold for add-new-skill."
}
],
"workflows": [
@@ -311,8 +311,8 @@
"path": ".claude/commands/refactoring.md"
},
{
"command": "add-or-update-skill",
"path": ".claude/commands/add-or-update-skill.md"
"command": "add-new-skill",
"path": ".claude/commands/add-new-skill.md"
}
],
"adapters": {
@@ -322,7 +322,7 @@
"commandPaths": [
".claude/commands/feature-development.md",
".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
".claude/commands/add-new-skill.md"
]
},
"codex": {

View File

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

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-or-update-skill: Adds or updates a skill module, including documentation and references, and registers it in manifests and documentation.
- add-new-skill: Adds a new skill to the system, including documentation and registration in summary/index files.
## Review Reminder

View File

@@ -40,7 +40,7 @@ Follow these commit message conventions based on 500 analyzed commits.
### Message Guidelines
- Average message length: ~57 characters
- Average message length: ~56 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: add everything-claude-code-conventions ECC bundle (.claude/commands/add-or-update-skill.md)
feat(skills): add argus-design-review — three-tier design doc review
```
*Commit message example*
```text
fix: port safe ci cleanup from backlog
fix(tests): add USERPROFILE to repair.test.js for Windows
```
*Commit message example*
@@ -78,19 +78,19 @@ chore: ignore local orchestration artifacts
*Commit message example*
```text
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md)
fix(lint): add missing trailing newlines to remotion rules
```
*Commit message example*
```text
feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md)
fix(tests): normalize path separators in CLAUDE_PLUGIN_ROOT test
```
*Commit message example*
```text
feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md)
fix(ci): resolve markdownlint errors and Windows install-apply test
```
## Architecture
@@ -188,7 +188,7 @@ These workflows were detected from analyzing commit patterns.
Standard feature implementation workflow
**Frequency**: ~19 times per month
**Frequency**: ~16 times per month
**Steps**:
1. Add feature implementation
@@ -204,16 +204,16 @@ Standard feature implementation workflow
**Example commit sequence**:
```
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)
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)
```
### Refactoring
Code refactoring and cleanup workflow
**Frequency**: ~3 times per month
**Frequency**: ~2 times per month
**Steps**:
1. Ensure tests pass before refactor
@@ -230,184 +230,173 @@ feat: add connected operator workflow skills
feat: expand lead intelligence outreach channels
```
### Add Or Update Skill
### Add New Skill
Adds or updates a skill module, including documentation and references, and registers it in manifests and documentation.
Adds a new skill to the system, including documentation and registration in summary/index files.
**Frequency**: ~4 times per month
**Frequency**: ~6 times per month
**Steps**:
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
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
**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`
- `WORKING-CONTEXT.md`
- `manifests/install-components.json`
- `manifests/install-modules.json`
**Example commit sequence**:
```
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
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
```
### Add Or Update Command Workflow
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.
Adds or updates a command file describing a workflow, often for agent orchestration or developer automation.
**Frequency**: ~3 times per month
**Steps**:
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
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
**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**:
```
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
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
```
### Add Or Update Install Target
### Add Or Update Agent Definition
Adds or updates an install target (e.g., CodeBuddy, Gemini) with scripts, schemas, and manifest registration.
Adds or updates agent definition files to introduce or modify agent behaviors or roles.
**Frequency**: ~2 times per month
**Steps**:
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
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
**Files typically involved**:
- `.<target>/*`
- `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`
- `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**:
```
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
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
```

View File

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