mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-02 15:13:28 +08:00
Compare commits
15 Commits
ecc-tools/
...
ecc-tools/
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
789b93a2e2 | ||
|
|
cd6e660ef7 | ||
|
|
b8f24d34ac | ||
|
|
6c7a25d98a | ||
|
|
9d63f77dce | ||
|
|
24e325fc7c | ||
|
|
21d4f12a6d | ||
|
|
399f75a5f6 | ||
|
|
8c4ee56603 | ||
|
|
37b08054e3 | ||
|
|
ca4bc8a07e | ||
|
|
8195550e16 | ||
|
|
af1ab97b9b | ||
|
|
4113d8405f | ||
|
|
14889fcc66 |
@@ -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
|
||||
```
|
||||
|
||||
|
||||
|
||||
@@ -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.
|
||||
42
.claude/commands/add-or-update-skill.md
Normal file
42
.claude/commands/add-or-update-skill.md
Normal 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.
|
||||
@@ -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": {
|
||||
|
||||
@@ -10,5 +10,5 @@
|
||||
"javascript"
|
||||
],
|
||||
"suggestedBy": "ecc-tools-repo-analysis",
|
||||
"createdAt": "2026-04-02T03:26:02.848Z"
|
||||
"createdAt": "2026-04-02T03:20:17.389Z"
|
||||
}
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
|
||||
|
||||
@@ -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"
|
||||
}
|
||||
Reference in New Issue
Block a user