Compare commits

...

15 Commits

Author SHA1 Message Date
ecc-tools[bot]
b16d333404 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-new-skill-or-agent.md) 2026-04-01 00:55:42 +00:00
ecc-tools[bot]
1f2a001383 feat: add everything-claude-code-conventions ECC bundle (.claude/commands/add-new-install-target.md) 2026-04-01 00:55:41 +00:00
ecc-tools[bot]
fda5ae523c feat: add everything-claude-code-conventions ECC bundle (.claude/commands/feature-development.md) 2026-04-01 00:55:40 +00:00
ecc-tools[bot]
9e5d3cfa12 feat: add everything-claude-code-conventions ECC bundle (.claude/enterprise/controls.md) 2026-04-01 00:55:40 +00:00
ecc-tools[bot]
72b8190859 feat: add everything-claude-code-conventions ECC bundle (.claude/team/everything-claude-code-team-config.json) 2026-04-01 00:55:39 +00:00
ecc-tools[bot]
0f3884a831 feat: add everything-claude-code-conventions ECC bundle (.claude/research/everything-claude-code-research-playbook.md) 2026-04-01 00:55:38 +00:00
ecc-tools[bot]
e7c8f122b9 feat: add everything-claude-code-conventions ECC bundle (.claude/rules/everything-claude-code-guardrails.md) 2026-04-01 00:55:37 +00:00
ecc-tools[bot]
cd07221cc4 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/docs-researcher.toml) 2026-04-01 00:55:36 +00:00
ecc-tools[bot]
eb24fb75f8 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/reviewer.toml) 2026-04-01 00:55:36 +00:00
ecc-tools[bot]
749d83f2a3 feat: add everything-claude-code-conventions ECC bundle (.codex/agents/explorer.toml) 2026-04-01 00:55:35 +00:00
ecc-tools[bot]
cbe9d1b75f feat: add everything-claude-code-conventions ECC bundle (.claude/identity.json) 2026-04-01 00:55:34 +00:00
ecc-tools[bot]
37df119fb5 feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml) 2026-04-01 00:55:33 +00:00
ecc-tools[bot]
d6bd0a87aa feat: add everything-claude-code-conventions ECC bundle (.agents/skills/everything-claude-code/SKILL.md) 2026-04-01 00:55:32 +00:00
ecc-tools[bot]
199c519a16 feat: add everything-claude-code-conventions ECC bundle (.claude/skills/everything-claude-code/SKILL.md) 2026-04-01 00:55:32 +00:00
ecc-tools[bot]
96fd580ea6 feat: add everything-claude-code-conventions ECC bundle (.claude/ecc-tools.json) 2026-04-01 00:55:31 +00:00
10 changed files with 370 additions and 371 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-agent-or-skill.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
chore(deps-dev): bump flatted (#675) docs: add Claude Code troubleshooting workarounds
``` ```
*Commit message example* *Commit message example*
```text ```text
fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691) refactor: fold social graph ranking into lead intelligence
``` ```
*Commit message example* *Commit message example*
```text ```text
docs: add Antigravity setup and usage guide (#552) chore: ignore local orchestration artifacts
``` ```
*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 fix(security): remove evalview-agent-testing skill — external dependency
``` ```
*Commit message example* *Commit message example*
```text ```text
Revert "Add Kiro IDE support (.kiro/) (#548)" feat: add everything-claude-code ECC bundle (.claude/commands/add-new-install-target.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**: ~20 times per month
**Steps**: **Steps**:
1. Add feature implementation 1. Add feature implementation
@@ -218,205 +196,185 @@ Standard feature implementation workflow
3. Update documentation 3. Update documentation
**Files typically involved**: **Files typically involved**:
- `manifests/*` - `skills/remotion-video-creation/rules/assets/*`
- `schemas/*` - `.opencode/*`
- `.opencode/plugins/*`
- `**/*.test.*` - `**/*.test.*`
- `**/api/**`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer fix: CI fixes, security audit, remotion skill, lead-intelligence, npm audit (#1039)
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies chore(deps-dev): bump globals in the minor-and-patch group (#1062)
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/github-script from 7.1.0 to 8.0.0 (#1059)
``` ```
### Add Language Rules ### Add New Install Target
Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines. Adds support for a new install target (e.g., CodeBuddy, Gemini) to the system, including scripts, manifests, schemas, and tests.
**Frequency**: ~2 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create a new directory under rules/{language}/ 1. Create new install scripts (install.js, install.sh, uninstall.js, uninstall.sh) in a dedicated directory (e.g., .codebuddy/ or .gemini/).
2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content 2. Add or update a README or documentation file for the new target.
3. Optionally reference or link to related skills 3. Update manifests/install-modules.json to register the new target.
4. Update schemas/ecc-install-config.schema.json and schemas/install-modules.schema.json as needed.
5. Update scripts/lib/install-manifests.js and scripts/lib/install-targets/<target>-project.js.
6. Update or add tests in tests/lib/install-targets.test.js.
7. Update registry or related files if necessary.
**Files typically involved**: **Files typically involved**:
- `rules/*/coding-style.md` - `manifests/install-modules.json`
- `rules/*/hooks.md` - `schemas/ecc-install-config.schema.json`
- `rules/*/patterns.md` - `schemas/install-modules.schema.json`
- `rules/*/security.md` - `scripts/lib/install-manifests.js`
- `rules/*/testing.md` - `scripts/lib/install-targets/*.js`
- `tests/lib/install-targets.test.js`
- `.*/README.md`
- `.*/install.js`
- `.*/install.sh`
- `.*/uninstall.js`
- `.*/uninstall.sh`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under rules/{language}/ Create new install scripts (install.js, install.sh, uninstall.js, uninstall.sh) in a dedicated directory (e.g., .codebuddy/ or .gemini/).
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content Add or update a README or documentation file for the new target.
Optionally reference or link to related skills Update manifests/install-modules.json to register the new target.
Update schemas/ecc-install-config.schema.json and schemas/install-modules.schema.json as needed.
Update scripts/lib/install-manifests.js and scripts/lib/install-targets/<target>-project.js.
Update or add tests in tests/lib/install-targets.test.js.
Update registry or related files if necessary.
``` ```
### Add New Skill ### Add New Skill Or Agent
Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts. Adds a new skill or agent to the system, including documentation and registration in manifests.
**Frequency**: ~4 times per month
**Steps**:
1. Create a new directory under skills/{skill-name}/
2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/
4. Address review feedback and iterate on documentation
**Files typically involved**:
- `skills/*/SKILL.md`
- `skills/*/scripts/*.sh`
- `skills/*/scripts/*.js`
**Example commit sequence**:
```
Create a new directory under skills/{skill-name}/
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
Optionally add scripts or supporting files under skills/{skill-name}/scripts/
Address review feedback and iterate on documentation
```
### Add New Agent
Adds a new agent to the system for code review, build resolution, or other automated tasks.
**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 SKILL.md in skills/<skill-name>/ or .claude/skills/<skill-name>/ or .agents/skills/<skill-name>/.
2. Update the same counts in README.md (quick-start, comparison table, etc.) 2. Create agent definition(s) in agents/<agent-name>.md if needed.
3. Optionally update other documentation files 3. Update manifests/install-modules.json or other relevant manifest files.
4. Add or update documentation (README.md, AGENTS.md, etc.).
**Files typically involved**: **Files typically involved**:
- `AGENTS.md` - `skills/*/SKILL.md`
- `.claude/skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `agents/*.md`
- `manifests/install-modules.json`
- `README.md` - `README.md`
- `AGENTS.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Update agent, skill, and command counts in AGENTS.md Create SKILL.md in skills/<skill-name>/ or .claude/skills/<skill-name>/ or .agents/skills/<skill-name>/.
Update the same counts in README.md (quick-start, comparison table, etc.) Create agent definition(s) in agents/<agent-name>.md if needed.
Optionally update other documentation files Update manifests/install-modules.json or other relevant manifest files.
Add or update documentation (README.md, AGENTS.md, etc.).
``` ```
### Add Cross Harness Skill Copies ### Add Or Update Command Workflow
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms. Adds or extends user-facing commands (e.g., PRP, santa-loop, GAN harness), often with review/feedback cycles.
**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 update command markdown files in commands/ or .claude/commands/.
2. Optionally add harness-specific openai.yaml or config files 2. Add YAML frontmatter, usage, and output sections as per convention.
3. Address review feedback to align with CONTRIBUTING template 3. Address review feedback with follow-up fixes (e.g., parameter quoting, API usage, documentation).
4. If needed, update related files (e.g., hooks, tests, AGENTS.md).
**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 update command markdown files in commands/ or .claude/commands/.
Optionally add harness-specific openai.yaml or config files Add YAML frontmatter, usage, and output sections as per convention.
Address review feedback to align with CONTRIBUTING template Address review feedback with follow-up fixes (e.g., parameter quoting, API usage, documentation).
If needed, update related files (e.g., hooks, tests, AGENTS.md).
``` ```
### Add Or Update Hook ### Add Or Update Opencode Agent
Adds or updates git or bash hooks to enforce workflow, quality, or security policies. Adds new OpenCode agent prompt files and updates agent registration in opencode.json.
**Frequency**: ~1 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Add or update hook scripts in hooks/ or scripts/hooks/ 1. Add new prompt files in .opencode/prompts/agents/*.txt.
2. Register the hook in hooks/hooks.json or similar config 2. Update .opencode/opencode.json to register new agents.
3. Optionally add or update tests in tests/hooks/ 3. Update AGENTS.md to reflect new agent count or details.
4. Address review feedback (e.g., remove agents, update documentation).
**Files typically involved**: **Files typically involved**:
- `hooks/*.hook` - `.opencode/prompts/agents/*.txt`
- `hooks/hooks.json` - `.opencode/opencode.json`
- `scripts/hooks/*.js` - `AGENTS.md`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
**Example commit sequence**: **Example commit sequence**:
``` ```
Add or update hook scripts in hooks/ or scripts/hooks/ Add new prompt files in .opencode/prompts/agents/*.txt.
Register the hook in hooks/hooks.json or similar config Update .opencode/opencode.json to register new agents.
Optionally add or update tests in tests/hooks/ Update AGENTS.md to reflect new agent count or details.
Address review feedback (e.g., remove agents, update documentation).
``` ```
### Address Review Feedback ### Add Or Update Hook Orci Script
Addresses code review feedback by updating documentation, scripts, or configuration for clarity, correctness, or convention alignment. Implements or fixes hooks and related scripts for formatting, typechecking, session management, or CI integration.
**Frequency**: ~2 times per month
**Steps**:
1. Edit or add scripts in scripts/hooks/ or hooks/hooks.json.
2. Update or add tests in tests/hooks/.
3. Address review feedback (e.g., race conditions, timeouts, path normalization, security).
4. If needed, update related files (e.g., .cursor/hooks/after-file-edit.js, .github/workflows/*).
**Files typically involved**:
- `scripts/hooks/*.js`
- `scripts/hooks/*.sh`
- `hooks/hooks.json`
- `tests/hooks/*.js`
- `.cursor/hooks/*.js`
- `.github/workflows/*.yml`
**Example commit sequence**:
```
Edit or add scripts in scripts/hooks/ or hooks/hooks.json.
Update or add tests in tests/hooks/.
Address review feedback (e.g., race conditions, timeouts, path normalization, security).
If needed, update related files (e.g., .cursor/hooks/after-file-edit.js, .github/workflows/*).
```
### Dependency Update Via Dependabot
Automated or manual update of dependencies (npm packages or GitHub Actions) across multiple workflow files.
**Frequency**: ~4 times per month **Frequency**: ~4 times per month
**Steps**: **Steps**:
1. Edit SKILL.md, agent, or command files to address reviewer comments 1. Update dependency version in package.json, yarn.lock, or relevant workflow YAML.
2. Update examples, headings, or configuration as requested 2. Update .github/workflows/*.yml to use new action versions.
3. Iterate until all review feedback is resolved 3. Commit with standardized message referencing the dependency and version bump.
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `package.json`
- `agents/*.md` - `yarn.lock`
- `commands/*.md` - `package-lock.json`
- `.agents/skills/*/SKILL.md` - `.github/workflows/*.yml`
- `.cursor/skills/*/SKILL.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Edit SKILL.md, agent, or command files to address reviewer comments Update dependency version in package.json, yarn.lock, or relevant workflow YAML.
Update examples, headings, or configuration as requested Update .github/workflows/*.yml to use new action versions.
Iterate until all review feedback is resolved Commit with standardized message referencing the dependency and version bump.
``` ```

View File

@@ -0,0 +1,42 @@
---
name: add-new-install-target
description: Workflow command scaffold for add-new-install-target in everything-claude-code.
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
---
# /add-new-install-target
Use this workflow when working on **add-new-install-target** in `everything-claude-code`.
## Goal
Adds support for a new install target (e.g., CodeBuddy, Gemini) to the system, including scripts, manifests, schemas, and tests.
## Common Files
- `manifests/install-modules.json`
- `schemas/ecc-install-config.schema.json`
- `schemas/install-modules.schema.json`
- `scripts/lib/install-manifests.js`
- `scripts/lib/install-targets/*.js`
- `tests/lib/install-targets.test.js`
## 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 new install scripts (install.js, install.sh, uninstall.js, uninstall.sh) in a dedicated directory (e.g., .codebuddy/ or .gemini/).
- Add or update a README or documentation file for the new target.
- Update manifests/install-modules.json to register the new target.
- Update schemas/ecc-install-config.schema.json and schemas/install-modules.schema.json as needed.
- Update scripts/lib/install-manifests.js and scripts/lib/install-targets/<target>-project.js.
## Notes
- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.

View File

@@ -0,0 +1,41 @@
---
name: add-new-skill-or-agent
description: Workflow command scaffold for add-new-skill-or-agent in everything-claude-code.
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
---
# /add-new-skill-or-agent
Use this workflow when working on **add-new-skill-or-agent** in `everything-claude-code`.
## Goal
Adds a new skill or agent to the system, including documentation and registration in manifests.
## Common Files
- `skills/*/SKILL.md`
- `.claude/skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `agents/*.md`
- `manifests/install-modules.json`
- `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 SKILL.md in skills/<skill-name>/ or .claude/skills/<skill-name>/ or .agents/skills/<skill-name>/.
- Create agent definition(s) in agents/<agent-name>.md if needed.
- Update manifests/install-modules.json or other relevant manifest files.
- Add or update documentation (README.md, AGENTS.md, etc.).
## 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/*` - `skills/remotion-video-creation/rules/assets/*`
- `schemas/*` - `.opencode/*`
- `.opencode/plugins/*`
- `**/*.test.*` - `**/*.test.*`
- `**/api/**`
## Suggested Sequence ## Suggested Sequence

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-03-31T23:03:58.867Z",
"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/add-new-install-target.md",
".claude/commands/add-new-skill-or-agent.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/add-new-install-target.md",
".claude/commands/add-new-skill-or-agent.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/add-new-install-target.md",
".claude/commands/add-new-skill-or-agent.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/add-new-install-target.md",
"description": "Workflow command scaffold for add-language-rules." "description": "Workflow command scaffold for add-new-install-target."
},
{
"moduleId": "workflow-pack",
"path": ".claude/commands/add-new-skill-or-agent.md",
"description": "Workflow command scaffold for add-new-skill-or-agent."
} }
], ],
"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": "add-new-install-target",
"path": ".claude/commands/add-language-rules.md" "path": ".claude/commands/add-new-install-target.md"
},
{
"command": "add-new-skill-or-agent",
"path": ".claude/commands/add-new-skill-or-agent.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/add-new-install-target.md",
".claude/commands/add-new-skill-or-agent.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-01T00:55:29.418Z"
} }

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

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. - add-new-install-target: Adds support for a new install target (e.g., CodeBuddy, Gemini) to the system, including scripts, manifests, schemas, and tests.
- add-new-skill-or-agent: Adds a new skill or agent to the system, 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-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-agent-or-skill.md)
``` ```
*Commit message example* *Commit message example*
```text ```text
chore(deps-dev): bump flatted (#675) docs: add Claude Code troubleshooting workarounds
``` ```
*Commit message example* *Commit message example*
```text ```text
fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691) refactor: fold social graph ranking into lead intelligence
``` ```
*Commit message example* *Commit message example*
```text ```text
docs: add Antigravity setup and usage guide (#552) chore: ignore local orchestration artifacts
``` ```
*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 fix(security): remove evalview-agent-testing skill — external dependency
``` ```
*Commit message example* *Commit message example*
```text ```text
Revert "Add Kiro IDE support (.kiro/) (#548)" feat: add everything-claude-code ECC bundle (.claude/commands/add-new-install-target.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**: ~20 times per month
**Steps**: **Steps**:
1. Add feature implementation 1. Add feature implementation
@@ -218,205 +196,185 @@ Standard feature implementation workflow
3. Update documentation 3. Update documentation
**Files typically involved**: **Files typically involved**:
- `manifests/*` - `skills/remotion-video-creation/rules/assets/*`
- `schemas/*` - `.opencode/*`
- `.opencode/plugins/*`
- `**/*.test.*` - `**/*.test.*`
- `**/api/**`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer fix: CI fixes, security audit, remotion skill, lead-intelligence, npm audit (#1039)
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies chore(deps-dev): bump globals in the minor-and-patch group (#1062)
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/github-script from 7.1.0 to 8.0.0 (#1059)
``` ```
### Add Language Rules ### Add New Install Target
Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines. Adds support for a new install target (e.g., CodeBuddy, Gemini) to the system, including scripts, manifests, schemas, and tests.
**Frequency**: ~2 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Create a new directory under rules/{language}/ 1. Create new install scripts (install.js, install.sh, uninstall.js, uninstall.sh) in a dedicated directory (e.g., .codebuddy/ or .gemini/).
2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content 2. Add or update a README or documentation file for the new target.
3. Optionally reference or link to related skills 3. Update manifests/install-modules.json to register the new target.
4. Update schemas/ecc-install-config.schema.json and schemas/install-modules.schema.json as needed.
5. Update scripts/lib/install-manifests.js and scripts/lib/install-targets/<target>-project.js.
6. Update or add tests in tests/lib/install-targets.test.js.
7. Update registry or related files if necessary.
**Files typically involved**: **Files typically involved**:
- `rules/*/coding-style.md` - `manifests/install-modules.json`
- `rules/*/hooks.md` - `schemas/ecc-install-config.schema.json`
- `rules/*/patterns.md` - `schemas/install-modules.schema.json`
- `rules/*/security.md` - `scripts/lib/install-manifests.js`
- `rules/*/testing.md` - `scripts/lib/install-targets/*.js`
- `tests/lib/install-targets.test.js`
- `.*/README.md`
- `.*/install.js`
- `.*/install.sh`
- `.*/uninstall.js`
- `.*/uninstall.sh`
**Example commit sequence**: **Example commit sequence**:
``` ```
Create a new directory under rules/{language}/ Create new install scripts (install.js, install.sh, uninstall.js, uninstall.sh) in a dedicated directory (e.g., .codebuddy/ or .gemini/).
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content Add or update a README or documentation file for the new target.
Optionally reference or link to related skills Update manifests/install-modules.json to register the new target.
Update schemas/ecc-install-config.schema.json and schemas/install-modules.schema.json as needed.
Update scripts/lib/install-manifests.js and scripts/lib/install-targets/<target>-project.js.
Update or add tests in tests/lib/install-targets.test.js.
Update registry or related files if necessary.
``` ```
### Add New Skill ### Add New Skill Or Agent
Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts. Adds a new skill or agent to the system, including documentation and registration in manifests.
**Frequency**: ~4 times per month
**Steps**:
1. Create a new directory under skills/{skill-name}/
2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/
4. Address review feedback and iterate on documentation
**Files typically involved**:
- `skills/*/SKILL.md`
- `skills/*/scripts/*.sh`
- `skills/*/scripts/*.js`
**Example commit sequence**:
```
Create a new directory under skills/{skill-name}/
Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.)
Optionally add scripts or supporting files under skills/{skill-name}/scripts/
Address review feedback and iterate on documentation
```
### Add New Agent
Adds a new agent to the system for code review, build resolution, or other automated tasks.
**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 SKILL.md in skills/<skill-name>/ or .claude/skills/<skill-name>/ or .agents/skills/<skill-name>/.
2. Update the same counts in README.md (quick-start, comparison table, etc.) 2. Create agent definition(s) in agents/<agent-name>.md if needed.
3. Optionally update other documentation files 3. Update manifests/install-modules.json or other relevant manifest files.
4. Add or update documentation (README.md, AGENTS.md, etc.).
**Files typically involved**: **Files typically involved**:
- `AGENTS.md` - `skills/*/SKILL.md`
- `.claude/skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `agents/*.md`
- `manifests/install-modules.json`
- `README.md` - `README.md`
- `AGENTS.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Update agent, skill, and command counts in AGENTS.md Create SKILL.md in skills/<skill-name>/ or .claude/skills/<skill-name>/ or .agents/skills/<skill-name>/.
Update the same counts in README.md (quick-start, comparison table, etc.) Create agent definition(s) in agents/<agent-name>.md if needed.
Optionally update other documentation files Update manifests/install-modules.json or other relevant manifest files.
Add or update documentation (README.md, AGENTS.md, etc.).
``` ```
### Add Cross Harness Skill Copies ### Add Or Update Command Workflow
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms. Adds or extends user-facing commands (e.g., PRP, santa-loop, GAN harness), often with review/feedback cycles.
**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 update command markdown files in commands/ or .claude/commands/.
2. Optionally add harness-specific openai.yaml or config files 2. Add YAML frontmatter, usage, and output sections as per convention.
3. Address review feedback to align with CONTRIBUTING template 3. Address review feedback with follow-up fixes (e.g., parameter quoting, API usage, documentation).
4. If needed, update related files (e.g., hooks, tests, AGENTS.md).
**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 update command markdown files in commands/ or .claude/commands/.
Optionally add harness-specific openai.yaml or config files Add YAML frontmatter, usage, and output sections as per convention.
Address review feedback to align with CONTRIBUTING template Address review feedback with follow-up fixes (e.g., parameter quoting, API usage, documentation).
If needed, update related files (e.g., hooks, tests, AGENTS.md).
``` ```
### Add Or Update Hook ### Add Or Update Opencode Agent
Adds or updates git or bash hooks to enforce workflow, quality, or security policies. Adds new OpenCode agent prompt files and updates agent registration in opencode.json.
**Frequency**: ~1 times per month **Frequency**: ~2 times per month
**Steps**: **Steps**:
1. Add or update hook scripts in hooks/ or scripts/hooks/ 1. Add new prompt files in .opencode/prompts/agents/*.txt.
2. Register the hook in hooks/hooks.json or similar config 2. Update .opencode/opencode.json to register new agents.
3. Optionally add or update tests in tests/hooks/ 3. Update AGENTS.md to reflect new agent count or details.
4. Address review feedback (e.g., remove agents, update documentation).
**Files typically involved**: **Files typically involved**:
- `hooks/*.hook` - `.opencode/prompts/agents/*.txt`
- `hooks/hooks.json` - `.opencode/opencode.json`
- `scripts/hooks/*.js` - `AGENTS.md`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
**Example commit sequence**: **Example commit sequence**:
``` ```
Add or update hook scripts in hooks/ or scripts/hooks/ Add new prompt files in .opencode/prompts/agents/*.txt.
Register the hook in hooks/hooks.json or similar config Update .opencode/opencode.json to register new agents.
Optionally add or update tests in tests/hooks/ Update AGENTS.md to reflect new agent count or details.
Address review feedback (e.g., remove agents, update documentation).
``` ```
### Address Review Feedback ### Add Or Update Hook Orci Script
Addresses code review feedback by updating documentation, scripts, or configuration for clarity, correctness, or convention alignment. Implements or fixes hooks and related scripts for formatting, typechecking, session management, or CI integration.
**Frequency**: ~2 times per month
**Steps**:
1. Edit or add scripts in scripts/hooks/ or hooks/hooks.json.
2. Update or add tests in tests/hooks/.
3. Address review feedback (e.g., race conditions, timeouts, path normalization, security).
4. If needed, update related files (e.g., .cursor/hooks/after-file-edit.js, .github/workflows/*).
**Files typically involved**:
- `scripts/hooks/*.js`
- `scripts/hooks/*.sh`
- `hooks/hooks.json`
- `tests/hooks/*.js`
- `.cursor/hooks/*.js`
- `.github/workflows/*.yml`
**Example commit sequence**:
```
Edit or add scripts in scripts/hooks/ or hooks/hooks.json.
Update or add tests in tests/hooks/.
Address review feedback (e.g., race conditions, timeouts, path normalization, security).
If needed, update related files (e.g., .cursor/hooks/after-file-edit.js, .github/workflows/*).
```
### Dependency Update Via Dependabot
Automated or manual update of dependencies (npm packages or GitHub Actions) across multiple workflow files.
**Frequency**: ~4 times per month **Frequency**: ~4 times per month
**Steps**: **Steps**:
1. Edit SKILL.md, agent, or command files to address reviewer comments 1. Update dependency version in package.json, yarn.lock, or relevant workflow YAML.
2. Update examples, headings, or configuration as requested 2. Update .github/workflows/*.yml to use new action versions.
3. Iterate until all review feedback is resolved 3. Commit with standardized message referencing the dependency and version bump.
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `package.json`
- `agents/*.md` - `yarn.lock`
- `commands/*.md` - `package-lock.json`
- `.agents/skills/*/SKILL.md` - `.github/workflows/*.yml`
- `.cursor/skills/*/SKILL.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Edit SKILL.md, agent, or command files to address reviewer comments Update dependency version in package.json, yarn.lock, or relevant workflow YAML.
Update examples, headings, or configuration as requested Update .github/workflows/*.yml to use new action versions.
Iterate until all review feedback is resolved Commit with standardized message referencing the dependency and version bump.
``` ```

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/add-new-install-target.md",
".claude/commands/add-new-skill-or-agent.md"
], ],
"updatedAt": "2026-03-20T12:07:36.496Z" "updatedAt": "2026-03-31T23:03:58.867Z"
} }