Compare commits

...

15 Commits

Author SHA1 Message Date
ecc-tools[bot]
6a0b0b2ed2 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-or-update-skill.md) 2026-04-02 18:08:03 +00:00
ecc-tools[bot]
59d9a4bae4 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md) 2026-04-02 18:08:02 +00:00
ecc-tools[bot]
bb8afb7512 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md) 2026-04-02 18:08:01 +00:00
ecc-tools[bot]
78d31b7e64 feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md) 2026-04-02 18:08:00 +00:00
ecc-tools[bot]
0e231cceaf feat: add everything-claude-code-conventions ECC bundle (.claude/team/everything-claude-code-team-config.json) 2026-04-02 18:07:59 +00:00
ecc-tools[bot]
47328d8d0f feat: add everything-claude-code-conventions ECC bundle (.claude/research/everything-claude-code-research-playbook.md) 2026-04-02 18:07:58 +00:00
ecc-tools[bot]
e0c5d9932f feat: add everything-claude-code-conventions ECC bundle (.claude/rules/everything-claude-code-guardrails.md) 2026-04-02 18:07:57 +00:00
ecc-tools[bot]
203e29ee2f feat: add everything-claude-code-conventions ECC bundle (.codex/agents/docs-researcher.toml) 2026-04-02 18:07:56 +00:00
ecc-tools[bot]
7b0e05ccc8 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/reviewer.toml) 2026-04-02 18:07:55 +00:00
ecc-tools[bot]
f953e66a78 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/explorer.toml) 2026-04-02 18:07:54 +00:00
ecc-tools[bot]
3ab8690f01 feat: add everything-claude-code-conventions ECC bundle (.claude/identity.json) 2026-04-02 18:07:53 +00:00
ecc-tools[bot]
5c0020a9d3 feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml) 2026-04-02 18:07:53 +00:00
ecc-tools[bot]
a5e9cac888 feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/SKILL.md) 2026-04-02 18:07:52 +00:00
ecc-tools[bot]
781ca9b890 feat: add everything-claude-code-conventions ECC bundle (.claude/skills/everything-claude-code/SKILL.md) 2026-04-02 18:07:51 +00:00
ecc-tools[bot]
d5c7468f07 feat: add everything-claude-code-conventions ECC bundle (.claude/ecc-tools.json) 2026-04-02 18:07:50 +00:00
10 changed files with 403 additions and 386 deletions

View File

@@ -5,7 +5,7 @@ description: Development conventions and patterns for everything-claude-code. Ja
# Everything Claude Code Conventions # Everything Claude Code Conventions
> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-20 > Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-04-02
## Overview ## Overview
@@ -34,13 +34,13 @@ Follow these commit message conventions based on 500 analyzed commits.
### Prefixes Used ### Prefixes Used
- `fix` - `fix`
- `test`
- `feat` - `feat`
- `docs` - `docs`
- `chore`
### Message Guidelines ### Message Guidelines
- Average message length: ~65 characters - Average message length: ~57 characters
- Keep first line concise and descriptive - Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature") - Use imperative mood ("Add feature" not "Added feature")
@@ -48,49 +48,49 @@ Follow these commit message conventions based on 500 analyzed commits.
*Commit message example* *Commit message example*
```text ```text
feat(rules): add C# language support feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-skill.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
chore(deps-dev): bump flatted (#675) refactor: extract social graph ranking core
``` ```
*Commit message example* *Commit message example*
```text ```text
fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691) fix: port safe ci cleanup from backlog
``` ```
*Commit message example* *Commit message example*
```text ```text
docs: add Antigravity setup and usage guide (#552) docs: close bundle drift and sync plugin guidance
``` ```
*Commit message example* *Commit message example*
```text ```text
merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer chore: ignore local orchestration artifacts
``` ```
*Commit message example* *Commit message example*
```text ```text
Revert "Add Kiro IDE support (.kiro/) (#548)" feat: add everything-claude-code ECC bundle (.claude/commands/refactoring.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
Add Kiro IDE support (.kiro/) (#548) feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
feat: add block-no-verify hook for Claude Code and Cursor (#649) feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md)
``` ```
## Architecture ## Architecture
@@ -184,33 +184,11 @@ try {
These workflows were detected from analyzing commit patterns. These workflows were detected from analyzing commit patterns.
### Database Migration
Database schema changes with migration files
**Frequency**: ~2 times per month
**Steps**:
1. Create migration file
2. Update schema definitions
3. Generate/update types
**Files typically involved**:
- `**/schema.*`
- `migrations/*`
**Example commit sequence**:
```
feat: implement --with/--without selective install flags (#679)
fix: sync catalog counts with filesystem (27 agents, 113 skills, 58 commands) (#693)
feat(rules): add Rust language rules (rebased #660) (#686)
```
### Feature Development ### Feature Development
Standard feature implementation workflow Standard feature implementation workflow
**Frequency**: ~22 times per month **Frequency**: ~19 times per month
**Steps**: **Steps**:
1. Add feature implementation 1. Add feature implementation
@@ -218,205 +196,197 @@ Standard feature implementation workflow
3. Update documentation 3. Update documentation
**Files typically involved**: **Files typically involved**:
- `manifests/*` - `.opencode/*`
- `schemas/*` - `.opencode/plugins/*`
- `.opencode/plugins/lib/*`
- `**/*.test.*` - `**/*.test.*`
- `**/api/**` - `**/api/**`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer feat(install): add CodeBuddy(Tencent) adaptation with installation scripts (#1038)
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies chore(deps-dev): bump c8 from 10.1.3 to 11.0.0 (#1065)
fix: address PR review — skill template (When to use, How it works, Examples), bun.lock, next build note, rust-reviewer CI note, doc-lookup privacy/uncertainty chore(deps): bump actions/checkout from 4.3.1 to 6.0.2 (#1060)
``` ```
### Add Language Rules ### Refactoring
Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines. Code refactoring and cleanup workflow
**Frequency**: ~2 times per month
**Steps**:
1. Create a new directory under rules/{language}/
2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
3. Optionally reference or link to related skills
**Files typically involved**:
- `rules/*/coding-style.md`
- `rules/*/hooks.md`
- `rules/*/patterns.md`
- `rules/*/security.md`
- `rules/*/testing.md`
**Example commit sequence**:
```
Create a new directory under rules/{language}/
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
Optionally reference or link to related skills
```
### Add New Skill
Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts.
**Frequency**: ~4 times per month **Frequency**: ~4 times per month
**Steps**: **Steps**:
1. Create a new directory under skills/{skill-name}/ 1. Ensure tests pass before refactor
2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) 2. Refactor code structure
3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/ 3. Verify tests still pass
4. Address review feedback and iterate on documentation
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `src/**/*`
- `skills/*/scripts/*.sh`
- `skills/*/scripts/*.js`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under skills/{skill-name}/ refactor: collapse legacy command bodies into skills
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) feat: add connected operator workflow skills
Optionally add scripts or supporting files under skills/{skill-name}/scripts/ feat: expand lead intelligence outreach channels
Address review feedback and iterate on documentation
``` ```
### Add New Agent ### Add Or Update Skill
Adds a new agent to the system for code review, build resolution, or other automated tasks. Adds a new skill or updates an existing skill, including documentation and registration in manifests.
**Frequency**: ~2 times per month
**Steps**:
1. Create a new agent markdown file under agents/{agent-name}.md
2. Register the agent in AGENTS.md
3. Optionally update README.md and docs/COMMAND-AGENT-MAP.md
**Files typically involved**:
- `agents/*.md`
- `AGENTS.md`
- `README.md`
- `docs/COMMAND-AGENT-MAP.md`
**Example commit sequence**:
```
Create a new agent markdown file under agents/{agent-name}.md
Register the agent in AGENTS.md
Optionally update README.md and docs/COMMAND-AGENT-MAP.md
```
### Add New Workflow Surface
Adds or updates a workflow entrypoint. Default to skills-first; only add a command shim when legacy slash compatibility is still required.
**Frequency**: ~1 times per month
**Steps**:
1. Create or update the canonical workflow under skills/{skill-name}/SKILL.md
2. Only if needed, add or update commands/{command-name}.md as a compatibility shim
**Files typically involved**:
- `skills/*/SKILL.md`
- `commands/*.md` (only when a legacy shim is intentionally retained)
**Example commit sequence**:
```
Create or update the canonical skill under skills/{skill-name}/SKILL.md
Only if needed, add or update commands/{command-name}.md as a compatibility shim
```
### Sync Catalog Counts
Synchronizes the documented counts of agents, skills, and commands in AGENTS.md and README.md with the actual repository state.
**Frequency**: ~3 times per month **Frequency**: ~3 times per month
**Steps**: **Steps**:
1. Update agent, skill, and command counts in AGENTS.md 1. Create or modify SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
2. Update the same counts in README.md (quick-start, comparison table, etc.) 2. Update manifests/install-modules.json and/or manifests/install-components.json to register the skill
3. Optionally update other documentation files 3. Update AGENTS.md, README.md, and docs/zh-CN/AGENTS.md for documentation and agent tables
4. Optionally add or update reference files or assets under the skill directory
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md` - `AGENTS.md`
- `README.md` - `README.md`
- `docs/zh-CN/AGENTS.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Update agent, skill, and command counts in AGENTS.md Create or modify SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
Update the same counts in README.md (quick-start, comparison table, etc.) Update manifests/install-modules.json and/or manifests/install-components.json to register the skill
Optionally update other documentation files Update AGENTS.md, README.md, and docs/zh-CN/AGENTS.md for documentation and agent tables
Optionally add or update reference files or assets under the skill directory
``` ```
### Add Cross Harness Skill Copies ### Add Or Update Command
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms. Adds or updates a workflow command for the Claude agentic system.
**Frequency**: ~2 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md 1. Create or modify a markdown file in commands/ or .claude/commands/
2. Optionally add harness-specific openai.yaml or config files 2. Document the workflow, arguments, and usage
3. Address review feedback to align with CONTRIBUTING template 3. Optionally update related documentation (README.md, AGENTS.md, etc.)
**Files typically involved**: **Files typically involved**:
- `.agents/skills/*/SKILL.md` - `commands/*.md`
- `.cursor/skills/*/SKILL.md` - `.claude/commands/*.md`
- `.agents/skills/*/agents/openai.yaml`
**Example commit sequence**: **Example commit sequence**:
``` ```
Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md Create or modify a markdown file in commands/ or .claude/commands/
Optionally add harness-specific openai.yaml or config files Document the workflow, arguments, and usage
Address review feedback to align with CONTRIBUTING template Optionally update related documentation (README.md, AGENTS.md, etc.)
``` ```
### Add Or Update Hook ### Refactor Skill Or Agent Logic
Adds or updates git or bash hooks to enforce workflow, quality, or security policies. Refactors core logic or merges/splits skills, updating documentation and manifests accordingly.
**Frequency**: ~1 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Add or update hook scripts in hooks/ or scripts/hooks/ 1. Edit or move SKILL.md files in skills/ or .agents/skills/
2. Register the hook in hooks/hooks.json or similar config 2. Update manifests/install-modules.json and/or manifests/install-components.json
3. Optionally add or update tests in tests/hooks/ 3. Update documentation files (AGENTS.md, README.md, docs/zh-CN/AGENTS.md, etc.)
**Files typically involved**:
- `hooks/*.hook`
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
**Example commit sequence**:
```
Add or update hook scripts in hooks/ or scripts/hooks/
Register the hook in hooks/hooks.json or similar config
Optionally add or update tests in tests/hooks/
```
### Address Review Feedback
Addresses code review feedback by updating documentation, scripts, or configuration for clarity, correctness, or convention alignment.
**Frequency**: ~4 times per month
**Steps**:
1. Edit SKILL.md, agent, or command files to address reviewer comments
2. Update examples, headings, or configuration as requested
3. Iterate until all review feedback is resolved
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `skills/*/SKILL.md`
- `agents/*.md`
- `commands/*.md`
- `.agents/skills/*/SKILL.md` - `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md` - `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md`
- `README.md`
- `docs/zh-CN/AGENTS.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Edit SKILL.md, agent, or command files to address reviewer comments Edit or move SKILL.md files in skills/ or .agents/skills/
Update examples, headings, or configuration as requested Update manifests/install-modules.json and/or manifests/install-components.json
Iterate until all review feedback is resolved Update documentation files (AGENTS.md, README.md, docs/zh-CN/AGENTS.md, etc.)
```
### Add Or Update Install Target
Adds or updates an install target (e.g., Gemini, CodeBuddy) including scripts, schemas, and registration.
**Frequency**: ~2 times per month
**Steps**:
1. Add new directory and scripts under .<target>/ (e.g., .gemini/, .codebuddy/)
2. Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
3. Add or update scripts/lib/install-targets/<target>-project.js and registry.js
4. Update or add tests for install targets
**Files typically involved**:
- `.<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**:
```
Add new directory and scripts under .<target>/ (e.g., .gemini/, .codebuddy/)
Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
Add or update scripts/lib/install-targets/<target>-project.js and registry.js
Update or add tests for install targets
```
### Documentation Sync And Update
Synchronizes and updates documentation across multiple files and languages.
**Frequency**: ~3 times per month
**Steps**:
1. Edit AGENTS.md, README.md, README.zh-CN.md, WORKING-CONTEXT.md
2. Edit docs/zh-CN/AGENTS.md, docs/zh-CN/README.md
3. Optionally update .agents/skills/*/SKILL.md and related documentation
**Files typically involved**:
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `WORKING-CONTEXT.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
**Example commit sequence**:
```
Edit AGENTS.md, README.md, README.zh-CN.md, WORKING-CONTEXT.md
Edit docs/zh-CN/AGENTS.md, docs/zh-CN/README.md
Optionally update .agents/skills/*/SKILL.md and related documentation
```
### Update Or Add Hooks And Ci
Updates or adds new hooks, CI scripts, and related tests for code quality and automation.
**Frequency**: ~2 times per month
**Steps**:
1. Edit hooks/hooks.json and/or scripts/hooks/*.js
2. Update or add tests in tests/hooks/*.test.js or tests/scripts/*.test.js
3. Update CI workflow files in .github/workflows/
**Files typically involved**:
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `tests/scripts/*.test.js`
- `.github/workflows/*.yml`
**Example commit sequence**:
```
Edit hooks/hooks.json and/or scripts/hooks/*.js
Update or add tests in tests/hooks/*.test.js or tests/scripts/*.test.js
Update CI workflow files in .github/workflows/
``` ```

View File

@@ -0,0 +1,41 @@
---
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 a new skill or updates an existing skill, including documentation and registration in manifests.
## Common Files
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md`
- `README.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 or modify SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
- Update manifests/install-modules.json and/or manifests/install-components.json to register the skill
- Update AGENTS.md, README.md, and docs/zh-CN/AGENTS.md for documentation and agent tables
- Optionally add or update reference files or assets under the skill directory
## Notes
- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.

View File

@@ -14,8 +14,9 @@ Standard feature implementation workflow
## Common Files ## Common Files
- `manifests/*` - `.opencode/*`
- `schemas/*` - `.opencode/plugins/*`
- `.opencode/plugins/lib/*`
- `**/*.test.*` - `**/*.test.*`
- `**/api/**` - `**/api/**`

View File

@@ -0,0 +1,35 @@
---
name: refactoring
description: Workflow command scaffold for refactoring in everything-claude-code.
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
---
# /refactoring
Use this workflow when working on **refactoring** in `everything-claude-code`.
## Goal
Code refactoring and cleanup workflow
## Common Files
- `src/**/*`
## Suggested Sequence
1. Understand the current state and failure mode before editing.
2. Make the smallest coherent change that satisfies the workflow goal.
3. Run the most relevant verification for touched files.
4. Summarize what changed and what still needs review.
## Typical Commit Signals
- Ensure tests pass before refactor
- Refactor code structure
- Verify tests still pass
## Notes
- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.

View File

@@ -2,7 +2,7 @@
"version": "1.3", "version": "1.3",
"schemaVersion": "1.0", "schemaVersion": "1.0",
"generatedBy": "ecc-tools", "generatedBy": "ecc-tools",
"generatedAt": "2026-03-20T12:07:36.496Z", "generatedAt": "2026-04-02T17:50:22.851Z",
"repo": "https://github.com/affaan-m/everything-claude-code", "repo": "https://github.com/affaan-m/everything-claude-code",
"profiles": { "profiles": {
"requested": "full", "requested": "full",
@@ -148,9 +148,9 @@
".claude/research/everything-claude-code-research-playbook.md", ".claude/research/everything-claude-code-research-playbook.md",
".claude/team/everything-claude-code-team-config.json", ".claude/team/everything-claude-code-team-config.json",
".claude/enterprise/controls.md", ".claude/enterprise/controls.md",
".claude/commands/database-migration.md",
".claude/commands/feature-development.md", ".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md" ".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
], ],
"packageFiles": { "packageFiles": {
"runtime-core": [ "runtime-core": [
@@ -178,9 +178,9 @@
".claude/enterprise/controls.md" ".claude/enterprise/controls.md"
], ],
"workflow-pack": [ "workflow-pack": [
".claude/commands/database-migration.md",
".claude/commands/feature-development.md", ".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md" ".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
] ]
}, },
"moduleFiles": { "moduleFiles": {
@@ -209,9 +209,9 @@
".claude/enterprise/controls.md" ".claude/enterprise/controls.md"
], ],
"workflow-pack": [ "workflow-pack": [
".claude/commands/database-migration.md",
".claude/commands/feature-development.md", ".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md" ".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
] ]
}, },
"files": [ "files": [
@@ -285,11 +285,6 @@
"path": ".claude/enterprise/controls.md", "path": ".claude/enterprise/controls.md",
"description": "Enterprise governance scaffold for approvals, audit posture, and escalation." "description": "Enterprise governance scaffold for approvals, audit posture, and escalation."
}, },
{
"moduleId": "workflow-pack",
"path": ".claude/commands/database-migration.md",
"description": "Workflow command scaffold for database-migration."
},
{ {
"moduleId": "workflow-pack", "moduleId": "workflow-pack",
"path": ".claude/commands/feature-development.md", "path": ".claude/commands/feature-development.md",
@@ -297,22 +292,27 @@
}, },
{ {
"moduleId": "workflow-pack", "moduleId": "workflow-pack",
"path": ".claude/commands/add-language-rules.md", "path": ".claude/commands/refactoring.md",
"description": "Workflow command scaffold for add-language-rules." "description": "Workflow command scaffold for refactoring."
},
{
"moduleId": "workflow-pack",
"path": ".claude/commands/add-or-update-skill.md",
"description": "Workflow command scaffold for add-or-update-skill."
} }
], ],
"workflows": [ "workflows": [
{
"command": "database-migration",
"path": ".claude/commands/database-migration.md"
},
{ {
"command": "feature-development", "command": "feature-development",
"path": ".claude/commands/feature-development.md" "path": ".claude/commands/feature-development.md"
}, },
{ {
"command": "add-language-rules", "command": "refactoring",
"path": ".claude/commands/add-language-rules.md" "path": ".claude/commands/refactoring.md"
},
{
"command": "add-or-update-skill",
"path": ".claude/commands/add-or-update-skill.md"
} }
], ],
"adapters": { "adapters": {
@@ -320,9 +320,9 @@
"skillPath": ".claude/skills/everything-claude-code/SKILL.md", "skillPath": ".claude/skills/everything-claude-code/SKILL.md",
"identityPath": ".claude/identity.json", "identityPath": ".claude/identity.json",
"commandPaths": [ "commandPaths": [
".claude/commands/database-migration.md",
".claude/commands/feature-development.md", ".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md" ".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
] ]
}, },
"codex": { "codex": {

View File

@@ -10,5 +10,5 @@
"javascript" "javascript"
], ],
"suggestedBy": "ecc-tools-repo-analysis", "suggestedBy": "ecc-tools-repo-analysis",
"createdAt": "2026-03-20T12:07:57.119Z" "createdAt": "2026-04-02T18:07:47.335Z"
} }

View File

@@ -18,4 +18,4 @@ Use this when the task is documentation-heavy, source-sensitive, or requires bro
- Primary language: JavaScript - Primary language: JavaScript
- Framework: Not detected - Framework: Not detected
- Workflows detected: 10 - Workflows detected: 8

View File

@@ -4,7 +4,7 @@ Generated by ECC Tools from repository history. Review before treating it as a h
## Commit Workflow ## Commit Workflow
- Prefer `conventional` commit messaging with prefixes such as fix, test, feat, docs. - Prefer `conventional` commit messaging with prefixes such as fix, feat, docs, chore.
- Keep new changes aligned with the existing pull-request and review flow already present in the repo. - Keep new changes aligned with the existing pull-request and review flow already present in the repo.
## Architecture ## Architecture
@@ -24,9 +24,9 @@ Generated by ECC Tools from repository history. Review before treating it as a h
## Detected Workflows ## Detected Workflows
- database-migration: Database schema changes with migration files
- feature-development: Standard feature implementation workflow - feature-development: Standard feature implementation workflow
- add-language-rules: Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines. - refactoring: Code refactoring and cleanup workflow
- add-or-update-skill: Adds a new skill or updates an existing skill, including documentation and registration in manifests.
## Review Reminder ## Review Reminder

View File

@@ -5,7 +5,7 @@ description: Development conventions and patterns for everything-claude-code. Ja
# Everything Claude Code Conventions # Everything Claude Code Conventions
> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-20 > Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-04-02
## Overview ## Overview
@@ -34,13 +34,13 @@ Follow these commit message conventions based on 500 analyzed commits.
### Prefixes Used ### Prefixes Used
- `fix` - `fix`
- `test`
- `feat` - `feat`
- `docs` - `docs`
- `chore`
### Message Guidelines ### Message Guidelines
- Average message length: ~65 characters - Average message length: ~57 characters
- Keep first line concise and descriptive - Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature") - Use imperative mood ("Add feature" not "Added feature")
@@ -48,49 +48,49 @@ Follow these commit message conventions based on 500 analyzed commits.
*Commit message example* *Commit message example*
```text ```text
feat(rules): add C# language support feat: add everything-claude-code ECC bundle (.claude/commands/add-or-update-skill.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
chore(deps-dev): bump flatted (#675) refactor: extract social graph ranking core
``` ```
*Commit message example* *Commit message example*
```text ```text
fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691) fix: port safe ci cleanup from backlog
``` ```
*Commit message example* *Commit message example*
```text ```text
docs: add Antigravity setup and usage guide (#552) docs: close bundle drift and sync plugin guidance
``` ```
*Commit message example* *Commit message example*
```text ```text
merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer chore: ignore local orchestration artifacts
``` ```
*Commit message example* *Commit message example*
```text ```text
Revert "Add Kiro IDE support (.kiro/) (#548)" feat: add everything-claude-code ECC bundle (.claude/commands/refactoring.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
Add Kiro IDE support (.kiro/) (#548) feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
feat: add block-no-verify hook for Claude Code and Cursor (#649) feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md)
``` ```
## Architecture ## Architecture
@@ -184,33 +184,11 @@ try {
These workflows were detected from analyzing commit patterns. These workflows were detected from analyzing commit patterns.
### Database Migration
Database schema changes with migration files
**Frequency**: ~2 times per month
**Steps**:
1. Create migration file
2. Update schema definitions
3. Generate/update types
**Files typically involved**:
- `**/schema.*`
- `migrations/*`
**Example commit sequence**:
```
feat: implement --with/--without selective install flags (#679)
fix: sync catalog counts with filesystem (27 agents, 113 skills, 58 commands) (#693)
feat(rules): add Rust language rules (rebased #660) (#686)
```
### Feature Development ### Feature Development
Standard feature implementation workflow Standard feature implementation workflow
**Frequency**: ~22 times per month **Frequency**: ~19 times per month
**Steps**: **Steps**:
1. Add feature implementation 1. Add feature implementation
@@ -218,205 +196,197 @@ Standard feature implementation workflow
3. Update documentation 3. Update documentation
**Files typically involved**: **Files typically involved**:
- `manifests/*` - `.opencode/*`
- `schemas/*` - `.opencode/plugins/*`
- `.opencode/plugins/lib/*`
- `**/*.test.*` - `**/*.test.*`
- `**/api/**` - `**/api/**`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer feat(install): add CodeBuddy(Tencent) adaptation with installation scripts (#1038)
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies chore(deps-dev): bump c8 from 10.1.3 to 11.0.0 (#1065)
fix: address PR review — skill template (When to use, How it works, Examples), bun.lock, next build note, rust-reviewer CI note, doc-lookup privacy/uncertainty chore(deps): bump actions/checkout from 4.3.1 to 6.0.2 (#1060)
``` ```
### Add Language Rules ### Refactoring
Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines. Code refactoring and cleanup workflow
**Frequency**: ~2 times per month
**Steps**:
1. Create a new directory under rules/{language}/
2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
3. Optionally reference or link to related skills
**Files typically involved**:
- `rules/*/coding-style.md`
- `rules/*/hooks.md`
- `rules/*/patterns.md`
- `rules/*/security.md`
- `rules/*/testing.md`
**Example commit sequence**:
```
Create a new directory under rules/{language}/
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
Optionally reference or link to related skills
```
### Add New Skill
Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts.
**Frequency**: ~4 times per month **Frequency**: ~4 times per month
**Steps**: **Steps**:
1. Create a new directory under skills/{skill-name}/ 1. Ensure tests pass before refactor
2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) 2. Refactor code structure
3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/ 3. Verify tests still pass
4. Address review feedback and iterate on documentation
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `src/**/*`
- `skills/*/scripts/*.sh`
- `skills/*/scripts/*.js`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under skills/{skill-name}/ refactor: collapse legacy command bodies into skills
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) feat: add connected operator workflow skills
Optionally add scripts or supporting files under skills/{skill-name}/scripts/ feat: expand lead intelligence outreach channels
Address review feedback and iterate on documentation
``` ```
### Add New Agent ### Add Or Update Skill
Adds a new agent to the system for code review, build resolution, or other automated tasks. Adds a new skill or updates an existing skill, including documentation and registration in manifests.
**Frequency**: ~2 times per month
**Steps**:
1. Create a new agent markdown file under agents/{agent-name}.md
2. Register the agent in AGENTS.md
3. Optionally update README.md and docs/COMMAND-AGENT-MAP.md
**Files typically involved**:
- `agents/*.md`
- `AGENTS.md`
- `README.md`
- `docs/COMMAND-AGENT-MAP.md`
**Example commit sequence**:
```
Create a new agent markdown file under agents/{agent-name}.md
Register the agent in AGENTS.md
Optionally update README.md and docs/COMMAND-AGENT-MAP.md
```
### Add New Command
Adds a new command to the system, often paired with a backing skill.
**Frequency**: ~1 times per month
**Steps**:
1. Create a new markdown file under commands/{command-name}.md
2. Optionally add or update a backing skill under skills/{skill-name}/SKILL.md
**Files typically involved**:
- `commands/*.md`
- `skills/*/SKILL.md`
**Example commit sequence**:
```
Create a new markdown file under commands/{command-name}.md
Optionally add or update a backing skill under skills/{skill-name}/SKILL.md
```
### Sync Catalog Counts
Synchronizes the documented counts of agents, skills, and commands in AGENTS.md and README.md with the actual repository state.
**Frequency**: ~3 times per month **Frequency**: ~3 times per month
**Steps**: **Steps**:
1. Update agent, skill, and command counts in AGENTS.md 1. Create or modify SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
2. Update the same counts in README.md (quick-start, comparison table, etc.) 2. Update manifests/install-modules.json and/or manifests/install-components.json to register the skill
3. Optionally update other documentation files 3. Update AGENTS.md, README.md, and docs/zh-CN/AGENTS.md for documentation and agent tables
4. Optionally add or update reference files or assets under the skill directory
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md` - `AGENTS.md`
- `README.md` - `README.md`
- `docs/zh-CN/AGENTS.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Update agent, skill, and command counts in AGENTS.md Create or modify SKILL.md in skills/<skill-name>/ or .agents/skills/<skill-name>/
Update the same counts in README.md (quick-start, comparison table, etc.) Update manifests/install-modules.json and/or manifests/install-components.json to register the skill
Optionally update other documentation files Update AGENTS.md, README.md, and docs/zh-CN/AGENTS.md for documentation and agent tables
Optionally add or update reference files or assets under the skill directory
``` ```
### Add Cross Harness Skill Copies ### Add Or Update Command
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms. Adds or updates a workflow command for the Claude agentic system.
**Frequency**: ~2 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md 1. Create or modify a markdown file in commands/ or .claude/commands/
2. Optionally add harness-specific openai.yaml or config files 2. Document the workflow, arguments, and usage
3. Address review feedback to align with CONTRIBUTING template 3. Optionally update related documentation (README.md, AGENTS.md, etc.)
**Files typically involved**: **Files typically involved**:
- `.agents/skills/*/SKILL.md` - `commands/*.md`
- `.cursor/skills/*/SKILL.md` - `.claude/commands/*.md`
- `.agents/skills/*/agents/openai.yaml`
**Example commit sequence**: **Example commit sequence**:
``` ```
Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md Create or modify a markdown file in commands/ or .claude/commands/
Optionally add harness-specific openai.yaml or config files Document the workflow, arguments, and usage
Address review feedback to align with CONTRIBUTING template Optionally update related documentation (README.md, AGENTS.md, etc.)
``` ```
### Add Or Update Hook ### Refactor Skill Or Agent Logic
Adds or updates git or bash hooks to enforce workflow, quality, or security policies. Refactors core logic or merges/splits skills, updating documentation and manifests accordingly.
**Frequency**: ~1 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Add or update hook scripts in hooks/ or scripts/hooks/ 1. Edit or move SKILL.md files in skills/ or .agents/skills/
2. Register the hook in hooks/hooks.json or similar config 2. Update manifests/install-modules.json and/or manifests/install-components.json
3. Optionally add or update tests in tests/hooks/ 3. Update documentation files (AGENTS.md, README.md, docs/zh-CN/AGENTS.md, etc.)
**Files typically involved**:
- `hooks/*.hook`
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
**Example commit sequence**:
```
Add or update hook scripts in hooks/ or scripts/hooks/
Register the hook in hooks/hooks.json or similar config
Optionally add or update tests in tests/hooks/
```
### Address Review Feedback
Addresses code review feedback by updating documentation, scripts, or configuration for clarity, correctness, or convention alignment.
**Frequency**: ~4 times per month
**Steps**:
1. Edit SKILL.md, agent, or command files to address reviewer comments
2. Update examples, headings, or configuration as requested
3. Iterate until all review feedback is resolved
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `skills/*/SKILL.md`
- `agents/*.md`
- `commands/*.md`
- `.agents/skills/*/SKILL.md` - `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md` - `manifests/install-modules.json`
- `manifests/install-components.json`
- `AGENTS.md`
- `README.md`
- `docs/zh-CN/AGENTS.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Edit SKILL.md, agent, or command files to address reviewer comments Edit or move SKILL.md files in skills/ or .agents/skills/
Update examples, headings, or configuration as requested Update manifests/install-modules.json and/or manifests/install-components.json
Iterate until all review feedback is resolved Update documentation files (AGENTS.md, README.md, docs/zh-CN/AGENTS.md, etc.)
```
### Add Or Update Install Target
Adds or updates an install target (e.g., Gemini, CodeBuddy) including scripts, schemas, and registration.
**Frequency**: ~2 times per month
**Steps**:
1. Add new directory and scripts under .<target>/ (e.g., .gemini/, .codebuddy/)
2. Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
3. Add or update scripts/lib/install-targets/<target>-project.js and registry.js
4. Update or add tests for install targets
**Files typically involved**:
- `.<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**:
```
Add new directory and scripts under .<target>/ (e.g., .gemini/, .codebuddy/)
Update manifests/install-modules.json and schemas/ecc-install-config.schema.json
Add or update scripts/lib/install-targets/<target>-project.js and registry.js
Update or add tests for install targets
```
### Documentation Sync And Update
Synchronizes and updates documentation across multiple files and languages.
**Frequency**: ~3 times per month
**Steps**:
1. Edit AGENTS.md, README.md, README.zh-CN.md, WORKING-CONTEXT.md
2. Edit docs/zh-CN/AGENTS.md, docs/zh-CN/README.md
3. Optionally update .agents/skills/*/SKILL.md and related documentation
**Files typically involved**:
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `WORKING-CONTEXT.md`
- `docs/zh-CN/AGENTS.md`
- `docs/zh-CN/README.md`
**Example commit sequence**:
```
Edit AGENTS.md, README.md, README.zh-CN.md, WORKING-CONTEXT.md
Edit docs/zh-CN/AGENTS.md, docs/zh-CN/README.md
Optionally update .agents/skills/*/SKILL.md and related documentation
```
### Update Or Add Hooks And Ci
Updates or adds new hooks, CI scripts, and related tests for code quality and automation.
**Frequency**: ~2 times per month
**Steps**:
1. Edit hooks/hooks.json and/or scripts/hooks/*.js
2. Update or add tests in tests/hooks/*.test.js or tests/scripts/*.test.js
3. Update CI workflow files in .github/workflows/
**Files typically involved**:
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `tests/scripts/*.test.js`
- `.github/workflows/*.yml`
**Example commit sequence**:
```
Edit hooks/hooks.json and/or scripts/hooks/*.js
Update or add tests in tests/hooks/*.test.js or tests/scripts/*.test.js
Update CI workflow files in .github/workflows/
``` ```

View File

@@ -7,9 +7,9 @@
".agents/skills/everything-claude-code/SKILL.md" ".agents/skills/everything-claude-code/SKILL.md"
], ],
"commandFiles": [ "commandFiles": [
".claude/commands/database-migration.md",
".claude/commands/feature-development.md", ".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md" ".claude/commands/refactoring.md",
".claude/commands/add-or-update-skill.md"
], ],
"updatedAt": "2026-03-20T12:07:36.496Z" "updatedAt": "2026-04-02T17:50:22.851Z"
} }