Compare commits

...

15 Commits

Author SHA1 Message Date
ecc-tools[bot]
179d1e4ca5 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-new-skill.md) 2026-04-01 22:51:20 +00:00
ecc-tools[bot]
db49085cb1 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/refactoring.md) 2026-04-01 22:51:19 +00:00
ecc-tools[bot]
e044007d29 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md) 2026-04-01 22:51:18 +00:00
ecc-tools[bot]
6abc110793 feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md) 2026-04-01 22:51:18 +00:00
ecc-tools[bot]
f0ed07ed82 feat: add everything-claude-code-conventions ECC bundle (.claude/team/everything-claude-code-team-config.json) 2026-04-01 22:51:17 +00:00
ecc-tools[bot]
a90b855d4d feat: add everything-claude-code-conventions ECC bundle (.claude/research/everything-claude-code-research-playbook.md) 2026-04-01 22:51:16 +00:00
ecc-tools[bot]
1c53accde5 feat: add everything-claude-code-conventions ECC bundle (.claude/rules/everything-claude-code-guardrails.md) 2026-04-01 22:51:15 +00:00
ecc-tools[bot]
64684a64e6 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/docs-researcher.toml) 2026-04-01 22:51:14 +00:00
ecc-tools[bot]
fe50d68257 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/reviewer.toml) 2026-04-01 22:51:13 +00:00
ecc-tools[bot]
306b48245f feat: add everything-claude-code-conventions ECC bundle (.codex/agents/explorer.toml) 2026-04-01 22:51:12 +00:00
ecc-tools[bot]
8f058ea0c5 feat: add everything-claude-code-conventions ECC bundle (.claude/identity.json) 2026-04-01 22:51:11 +00:00
ecc-tools[bot]
b781af2d4d feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml) 2026-04-01 22:51:11 +00:00
ecc-tools[bot]
ea96178ac1 feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/SKILL.md) 2026-04-01 22:51:10 +00:00
ecc-tools[bot]
0e63bb37de feat: add everything-claude-code-conventions ECC bundle (.claude/skills/everything-claude-code/SKILL.md) 2026-04-01 22:51:09 +00:00
ecc-tools[bot]
03dfdd2fa0 feat: add everything-claude-code-conventions ECC bundle (.claude/ecc-tools.json) 2026-04-01 22:51:08 +00:00
10 changed files with 310 additions and 316 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-01
## 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-new-skill.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
chore(deps-dev): bump flatted (#675) refactor: collapse legacy command bodies into skills
``` ```
*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: dedupe managed hooks by semantic identity
``` ```
*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,188 @@ 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/**`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer feat: install claude-hud plugin (jarrodwatts/claude-hud) (#1041)
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies feat: add GAN-style generator-evaluator harness (#1029)
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 feat(agents,skills): add opensource-pipeline — 3-agent workflow for safe public releases (#1036)
``` ```
### 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 **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create a new directory under rules/{language}/ 1. Ensure tests pass before refactor
2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content 2. Refactor code structure
3. Optionally reference or link to related skills 3. Verify tests still pass
**Files typically involved**: **Files typically involved**:
- `rules/*/coding-style.md` - `src/**/*`
- `rules/*/hooks.md`
- `rules/*/patterns.md`
- `rules/*/security.md`
- `rules/*/testing.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under rules/{language}/ refactor: collapse legacy command bodies into skills
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content feat: add connected operator workflow skills
Optionally reference or link to related skills feat: expand lead intelligence outreach channels
``` ```
### Add New Skill ### Add New Skill
Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts. Adds a new skill to the repository, enabling new agent capabilities or workflows.
**Frequency**: ~4 times per month **Frequency**: ~4 times per month
**Steps**: **Steps**:
1. Create a new directory under skills/{skill-name}/ 1. Create a new SKILL.md file under skills/ or .agents/skills/ or .claude/skills/
2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) 2. Optionally update documentation (AGENTS.md, README.md, WORKING-CONTEXT.md)
3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/ 3. Optionally add supporting files (e.g., manifests/install-modules.json)
4. Address review feedback and iterate on documentation
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `skills/*/SKILL.md`
- `skills/*/scripts/*.sh` - `.agents/skills/*/SKILL.md`
- `skills/*/scripts/*.js` - `.claude/skills/*/SKILL.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under skills/{skill-name}/ Create a new SKILL.md file under skills/ or .agents/skills/ or .claude/skills/
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) Optionally update documentation (AGENTS.md, README.md, WORKING-CONTEXT.md)
Optionally add scripts or supporting files under skills/{skill-name}/scripts/ Optionally add supporting files (e.g., manifests/install-modules.json)
Address review feedback and iterate on documentation
``` ```
### Add New Agent ### Add Or Update Agent
Adds a new agent to the system for code review, build resolution, or other automated tasks. Adds or updates agent definitions and registers them in configuration files.
**Frequency**: ~2 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create a new agent markdown file under agents/{agent-name}.md 1. Add or update agent definition file (e.g., agents/*.md or .opencode/prompts/agents/*.txt)
2. Register the agent in AGENTS.md 2. Update agent registry/configuration (e.g., .opencode/opencode.json, AGENTS.md)
3. Optionally update README.md and docs/COMMAND-AGENT-MAP.md
**Files typically involved**: **Files typically involved**:
- `agents/*.md` - `agents/*.md`
- `.opencode/prompts/agents/*.txt`
- `.opencode/opencode.json`
- `AGENTS.md` - `AGENTS.md`
- `README.md`
- `docs/COMMAND-AGENT-MAP.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new agent markdown file under agents/{agent-name}.md Add or update agent definition file (e.g., agents/*.md or .opencode/prompts/agents/*.txt)
Register the agent in AGENTS.md Update agent registry/configuration (e.g., .opencode/opencode.json, AGENTS.md)
Optionally update README.md and docs/COMMAND-AGENT-MAP.md
``` ```
### Add New Workflow Surface ### Add Or Update Command
Adds or updates a workflow entrypoint. Default to skills-first; only add a command shim when legacy slash compatibility is still required. Adds or updates command workflow files for agentic operations.
**Frequency**: ~1 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create or update the canonical workflow under skills/{skill-name}/SKILL.md 1. Create or update command markdown file under commands/
2. Only if needed, add or update commands/{command-name}.md as a compatibility shim 2. Optionally update documentation or index files
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `commands/*.md`
- `commands/*.md` (only when a legacy shim is intentionally retained)
**Example commit sequence**: **Example commit sequence**:
``` ```
Create or update the canonical skill under skills/{skill-name}/SKILL.md Create or update command markdown file under commands/
Only if needed, add or update commands/{command-name}.md as a compatibility shim Optionally update documentation or index files
``` ```
### Sync Catalog Counts ### Feature Or Skill Bundle
Synchronizes the documented counts of agents, skills, and commands in AGENTS.md and README.md with the actual repository state. Adds a bundle of related features, skills, and documentation for a new workflow or capability.
**Frequency**: ~2 times per month
**Steps**:
1. Add multiple agent and/or skill files
2. Add supporting commands and scripts
3. Add or update documentation and examples
**Files typically involved**:
- `agents/*.md`
- `skills/*/SKILL.md`
- `commands/*.md`
- `scripts/*.sh`
- `examples/*`
**Example commit sequence**:
```
Add multiple agent and/or skill files
Add supporting commands and scripts
Add or update documentation and examples
```
### Documentation Update
Updates documentation to reflect new features, workflows, or guidance.
**Frequency**: ~3 times per month **Frequency**: ~3 times per month
**Steps**: **Steps**:
1. Update agent, skill, and command counts in AGENTS.md 1. Edit documentation files (README.md, AGENTS.md, WORKING-CONTEXT.md, docs/...)
2. Update the same counts in README.md (quick-start, comparison table, etc.) 2. Optionally update or add new guidance files
3. Optionally update other documentation files
**Files typically involved**: **Files typically involved**:
- `AGENTS.md`
- `README.md` - `README.md`
- `AGENTS.md`
- `WORKING-CONTEXT.md`
- `docs/**/*.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Update agent, skill, and command counts in AGENTS.md Edit documentation files (README.md, AGENTS.md, WORKING-CONTEXT.md, docs/...)
Update the same counts in README.md (quick-start, comparison table, etc.) Optionally update or add new guidance files
Optionally update other documentation files
``` ```
### Add Cross Harness Skill Copies ### Dependency Or Schema Update
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms. Updates dependencies or schema files, often in response to new features or external updates.
**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. Edit package.json, yarn.lock, or other lockfiles
2. Optionally add harness-specific openai.yaml or config files 2. Edit schema files under schemas/
3. Address review feedback to align with CONTRIBUTING template 3. Optionally update related scripts or manifests
**Files typically involved**: **Files typically involved**:
- `.agents/skills/*/SKILL.md` - `package.json`
- `.cursor/skills/*/SKILL.md` - `yarn.lock`
- `.agents/skills/*/agents/openai.yaml` - `schemas/*.json`
**Example commit sequence**: **Example commit sequence**:
``` ```
Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md Edit package.json, yarn.lock, or other lockfiles
Optionally add harness-specific openai.yaml or config files Edit schema files under schemas/
Address review feedback to align with CONTRIBUTING template Optionally update related scripts or manifests
``` ```
### Add Or Update Hook ### Ci Cd Workflow Update
Adds or updates git or bash hooks to enforce workflow, quality, or security policies. Updates CI/CD workflow files, usually for dependency bumps or workflow improvements.
**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 workflow files under .github/workflows/
2. Register the hook in hooks/hooks.json or similar config
3. Optionally add or update tests in tests/hooks/
**Files typically involved**: **Files typically involved**:
- `hooks/*.hook` - `.github/workflows/*.yml`
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
**Example commit sequence**: **Example commit sequence**:
``` ```
Add or update hook scripts in hooks/ or scripts/hooks/ Edit workflow files under .github/workflows/
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**:
- `skills/*/SKILL.md`
- `agents/*.md`
- `commands/*.md`
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
**Example commit sequence**:
```
Edit SKILL.md, agent, or command files to address reviewer comments
Update examples, headings, or configuration as requested
Iterate until all review feedback is resolved
``` ```

View File

@@ -0,0 +1,37 @@
---
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 repository, enabling new agent capabilities or workflows.
## Common Files
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `.claude/skills/*/SKILL.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/ or .agents/skills/ or .claude/skills/
- Optionally update documentation (AGENTS.md, README.md, WORKING-CONTEXT.md)
- Optionally add supporting files (e.g., manifests/install-modules.json)
## Notes
- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.

View File

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

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-01T22:44:14.561Z",
"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-new-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-new-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-new-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-new-skill.md",
"description": "Workflow command scaffold for add-new-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-new-skill",
"path": ".claude/commands/add-new-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-new-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-01T22:51:05.478Z"
} }

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: 9

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-new-skill: Adds a new skill to the repository, enabling new agent capabilities or workflows.
## 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-01
## 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-new-skill.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
chore(deps-dev): bump flatted (#675) refactor: collapse legacy command bodies into skills
``` ```
*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: dedupe managed hooks by semantic identity
``` ```
*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,188 @@ 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/**`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer feat: install claude-hud plugin (jarrodwatts/claude-hud) (#1041)
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies feat: add GAN-style generator-evaluator harness (#1029)
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 feat(agents,skills): add opensource-pipeline — 3-agent workflow for safe public releases (#1036)
``` ```
### 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 **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create a new directory under rules/{language}/ 1. Ensure tests pass before refactor
2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content 2. Refactor code structure
3. Optionally reference or link to related skills 3. Verify tests still pass
**Files typically involved**: **Files typically involved**:
- `rules/*/coding-style.md` - `src/**/*`
- `rules/*/hooks.md`
- `rules/*/patterns.md`
- `rules/*/security.md`
- `rules/*/testing.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under rules/{language}/ refactor: collapse legacy command bodies into skills
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content feat: add connected operator workflow skills
Optionally reference or link to related skills feat: expand lead intelligence outreach channels
``` ```
### Add New Skill ### Add New Skill
Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts. Adds a new skill to the repository, enabling new agent capabilities or workflows.
**Frequency**: ~4 times per month **Frequency**: ~4 times per month
**Steps**: **Steps**:
1. Create a new directory under skills/{skill-name}/ 1. Create a new SKILL.md file under skills/ or .agents/skills/ or .claude/skills/
2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) 2. Optionally update documentation (AGENTS.md, README.md, WORKING-CONTEXT.md)
3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/ 3. Optionally add supporting files (e.g., manifests/install-modules.json)
4. Address review feedback and iterate on documentation
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `skills/*/SKILL.md`
- `skills/*/scripts/*.sh` - `.agents/skills/*/SKILL.md`
- `skills/*/scripts/*.js` - `.claude/skills/*/SKILL.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under skills/{skill-name}/ Create a new SKILL.md file under skills/ or .agents/skills/ or .claude/skills/
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) Optionally update documentation (AGENTS.md, README.md, WORKING-CONTEXT.md)
Optionally add scripts or supporting files under skills/{skill-name}/scripts/ Optionally add supporting files (e.g., manifests/install-modules.json)
Address review feedback and iterate on documentation
``` ```
### Add New Agent ### Add Or Update Agent
Adds a new agent to the system for code review, build resolution, or other automated tasks. Adds or updates agent definitions and registers them in configuration files.
**Frequency**: ~2 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create a new agent markdown file under agents/{agent-name}.md 1. Add or update agent definition file (e.g., agents/*.md or .opencode/prompts/agents/*.txt)
2. Register the agent in AGENTS.md 2. Update agent registry/configuration (e.g., .opencode/opencode.json, AGENTS.md)
3. Optionally update README.md and docs/COMMAND-AGENT-MAP.md
**Files typically involved**: **Files typically involved**:
- `agents/*.md` - `agents/*.md`
- `.opencode/prompts/agents/*.txt`
- `.opencode/opencode.json`
- `AGENTS.md` - `AGENTS.md`
- `README.md`
- `docs/COMMAND-AGENT-MAP.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new agent markdown file under agents/{agent-name}.md Add or update agent definition file (e.g., agents/*.md or .opencode/prompts/agents/*.txt)
Register the agent in AGENTS.md Update agent registry/configuration (e.g., .opencode/opencode.json, AGENTS.md)
Optionally update README.md and docs/COMMAND-AGENT-MAP.md
``` ```
### Add New Command ### Add Or Update Command
Adds a new command to the system, often paired with a backing skill. Adds or updates command workflow files for agentic operations.
**Frequency**: ~1 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create a new markdown file under commands/{command-name}.md 1. Create or update command markdown file under commands/
2. Optionally add or update a backing skill under skills/{skill-name}/SKILL.md 2. Optionally update documentation or index files
**Files typically involved**: **Files typically involved**:
- `commands/*.md` - `commands/*.md`
- `skills/*/SKILL.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new markdown file under commands/{command-name}.md Create or update command markdown file under commands/
Optionally add or update a backing skill under skills/{skill-name}/SKILL.md Optionally update documentation or index files
``` ```
### Sync Catalog Counts ### Feature Or Skill Bundle
Synchronizes the documented counts of agents, skills, and commands in AGENTS.md and README.md with the actual repository state. Adds a bundle of related features, skills, and documentation for a new workflow or capability.
**Frequency**: ~2 times per month
**Steps**:
1. Add multiple agent and/or skill files
2. Add supporting commands and scripts
3. Add or update documentation and examples
**Files typically involved**:
- `agents/*.md`
- `skills/*/SKILL.md`
- `commands/*.md`
- `scripts/*.sh`
- `examples/*`
**Example commit sequence**:
```
Add multiple agent and/or skill files
Add supporting commands and scripts
Add or update documentation and examples
```
### Documentation Update
Updates documentation to reflect new features, workflows, or guidance.
**Frequency**: ~3 times per month **Frequency**: ~3 times per month
**Steps**: **Steps**:
1. Update agent, skill, and command counts in AGENTS.md 1. Edit documentation files (README.md, AGENTS.md, WORKING-CONTEXT.md, docs/...)
2. Update the same counts in README.md (quick-start, comparison table, etc.) 2. Optionally update or add new guidance files
3. Optionally update other documentation files
**Files typically involved**: **Files typically involved**:
- `AGENTS.md`
- `README.md` - `README.md`
- `AGENTS.md`
- `WORKING-CONTEXT.md`
- `docs/**/*.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Update agent, skill, and command counts in AGENTS.md Edit documentation files (README.md, AGENTS.md, WORKING-CONTEXT.md, docs/...)
Update the same counts in README.md (quick-start, comparison table, etc.) Optionally update or add new guidance files
Optionally update other documentation files
``` ```
### Add Cross Harness Skill Copies ### Dependency Or Schema Update
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms. Updates dependencies or schema files, often in response to new features or external updates.
**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. Edit package.json, yarn.lock, or other lockfiles
2. Optionally add harness-specific openai.yaml or config files 2. Edit schema files under schemas/
3. Address review feedback to align with CONTRIBUTING template 3. Optionally update related scripts or manifests
**Files typically involved**: **Files typically involved**:
- `.agents/skills/*/SKILL.md` - `package.json`
- `.cursor/skills/*/SKILL.md` - `yarn.lock`
- `.agents/skills/*/agents/openai.yaml` - `schemas/*.json`
**Example commit sequence**: **Example commit sequence**:
``` ```
Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md Edit package.json, yarn.lock, or other lockfiles
Optionally add harness-specific openai.yaml or config files Edit schema files under schemas/
Address review feedback to align with CONTRIBUTING template Optionally update related scripts or manifests
``` ```
### Add Or Update Hook ### Ci Cd Workflow Update
Adds or updates git or bash hooks to enforce workflow, quality, or security policies. Updates CI/CD workflow files, usually for dependency bumps or workflow improvements.
**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 workflow files under .github/workflows/
2. Register the hook in hooks/hooks.json or similar config
3. Optionally add or update tests in tests/hooks/
**Files typically involved**: **Files typically involved**:
- `hooks/*.hook` - `.github/workflows/*.yml`
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
**Example commit sequence**: **Example commit sequence**:
``` ```
Add or update hook scripts in hooks/ or scripts/hooks/ Edit workflow files under .github/workflows/
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**:
- `skills/*/SKILL.md`
- `agents/*.md`
- `commands/*.md`
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
**Example commit sequence**:
```
Edit SKILL.md, agent, or command files to address reviewer comments
Update examples, headings, or configuration as requested
Iterate until all review feedback is resolved
``` ```

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-new-skill.md"
], ],
"updatedAt": "2026-03-20T12:07:36.496Z" "updatedAt": "2026-04-01T22:44:14.561Z"
} }