Compare commits

...

15 Commits

Author SHA1 Message Date
ecc-tools[bot]
f4cd4a0d82 feat: add everything-claude-code ECC bundle (.claude/commands/add-new-skill.md) 2026-04-02 03:27:21 +00:00
ecc-tools[bot]
cda05058ea feat: add everything-claude-code ECC bundle (.claude/commands/refactoring.md) 2026-04-02 03:27:20 +00:00
ecc-tools[bot]
bf512d9b02 feat: add everything-claude-code ECC bundle (.claude/commands/feature-development.md) 2026-04-02 03:27:19 +00:00
ecc-tools[bot]
7d2fddd34c feat: add everything-claude-code ECC bundle (.claude/enterprise/controls.md) 2026-04-02 03:27:18 +00:00
ecc-tools[bot]
552afdf258 feat: add everything-claude-code ECC bundle (.claude/team/everything-claude-code-team-config.json) 2026-04-02 03:27:18 +00:00
ecc-tools[bot]
77f131bd9c feat: add everything-claude-code ECC bundle (.claude/research/everything-claude-code-research-playbook.md) 2026-04-02 03:27:17 +00:00
ecc-tools[bot]
ff498bd224 feat: add everything-claude-code ECC bundle (.claude/rules/everything-claude-code-guardrails.md) 2026-04-02 03:27:16 +00:00
ecc-tools[bot]
85db58afe5 feat: add everything-claude-code ECC bundle (.codex/agents/docs-researcher.toml) 2026-04-02 03:27:15 +00:00
ecc-tools[bot]
fe4e42457e feat: add everything-claude-code ECC bundle (.codex/agents/reviewer.toml) 2026-04-02 03:27:14 +00:00
ecc-tools[bot]
5a2392cf40 feat: add everything-claude-code ECC bundle (.codex/agents/explorer.toml) 2026-04-02 03:27:14 +00:00
ecc-tools[bot]
bb2614dc13 feat: add everything-claude-code ECC bundle (.claude/identity.json) 2026-04-02 03:27:12 +00:00
ecc-tools[bot]
ee376c6926 feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/agents/openai.yaml) 2026-04-02 03:27:11 +00:00
ecc-tools[bot]
6e8e5af539 feat: add everything-claude-code ECC bundle (.agents/skills/everything-claude-code/SKILL.md) 2026-04-02 03:27:11 +00:00
ecc-tools[bot]
f642cb0e31 feat: add everything-claude-code ECC bundle (.claude/skills/everything-claude-code/SKILL.md) 2026-04-02 03:27:10 +00:00
ecc-tools[bot]
ba8fa7484b feat: add everything-claude-code ECC bundle (.claude/ecc-tools.json) 2026-04-02 03:27:09 +00:00
10 changed files with 383 additions and 842 deletions

View File

@@ -1,442 +1,174 @@
---
name: everything-claude-code-conventions
description: Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.
---
```markdown
# everything-claude-code Development Patterns
# Everything Claude Code Conventions
> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-20
> Auto-generated skill from repository analysis
## Overview
This skill teaches Claude the development patterns and conventions used in everything-claude-code.
This skill introduces the core development patterns, coding conventions, and collaborative workflows used in the `everything-claude-code` repository. The project is a JavaScript codebase (no framework detected) focused on modular skills, agent orchestration, automation workflows, and extensible install targets. It emphasizes clear documentation, conventional commits, and a structured approach to adding new capabilities.
## Tech Stack
## Coding Conventions
- **Primary Language**: JavaScript
- **Architecture**: hybrid module organization
- **Test Location**: separate
- **File Naming:**
Use `camelCase` for JavaScript files and directories.
_Example:_
```
installTargetProject.js
agentPipeline.md
```
## When to Use This Skill
- **Import Style:**
Use **relative imports** for modules within the codebase.
_Example:_
```js
const installTarget = require('../lib/install-targets/codeBuddy-project.js');
```
Activate this skill when:
- Making changes to this repository
- Adding new features following established patterns
- Writing tests that match project conventions
- Creating commits with proper message format
- **Export Style:**
Mixed usage of CommonJS (`module.exports`) and ES module (`export`) patterns, depending on context.
_Example (CommonJS):_
```js
module.exports = function installTarget() { ... };
```
_Example (ESM):_
```js
export function installTarget() { ... }
```
## Commit Conventions
- **Commit Messages:**
Use [Conventional Commits](https://www.conventionalcommits.org/) with prefixes: `fix`, `feat`, `docs`, `chore`.
_Example:_
```
feat: add support for new agent pipeline
fix: correct install script path resolution
```
Follow these commit message conventions based on 500 analyzed commits.
## Workflows
### Commit Style: Conventional Commits
### Add New Skill
**Trigger:** When you want to add a new skill (capability, agent, or workflow)
**Command:** `/add-skill`
### Prefixes Used
1. Create a new `SKILL.md` file under `skills/<skill-name>/` or `.agents/skills/<skill-name>/`.
2. Optionally add related reference files (schemas, assets) in the skill directory.
3. Update documentation files to reference the new skill:
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
4. Optionally update install manifests (e.g., `manifests/install-components.json`) if the skill is installable.
- `fix`
- `test`
- `feat`
- `docs`
### Message Guidelines
- Average message length: ~65 characters
- Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature")
*Commit message example*
```text
feat(rules): add C# language support
_Example directory structure:_
```
skills/myNewSkill/SKILL.md
skills/myNewSkill/schema.json
```
*Commit message example*
### Add New Command or Workflow
**Trigger:** When introducing a new command-line workflow or process
**Command:** `/add-command`
```text
chore(deps-dev): bump flatted (#675)
1. Create a new markdown file under `commands/` (e.g., `commands/myWorkflow.md`).
2. Document the workflow with YAML frontmatter, usage, and output sections.
3. Update `AGENTS.md`, `README.md`, or other summary files to reference the new command.
4. Optionally update scripts or examples if automation is included.
_Example:_
```markdown
---
name: santa-loop
description: Automates the Santa workflow
---
# santa-loop
Usage: ...
```
*Commit message example*
### Add New Agent or Agent Pipeline
**Trigger:** When adding a new agent or multi-agent pipeline
**Command:** `/add-agent-pipeline`
```text
fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691)
1. Create agent definition markdown files under `agents/` (e.g., `agents/myAgent.md`).
2. Optionally, create a new orchestrator skill under `skills/<pipeline>/SKILL.md`.
3. Update `AGENTS.md` and `README.md` to reference the new agent(s) or pipeline.
4. Optionally add example or configuration files.
_Example:_
```
agents/opensource-pipeline.md
skills/opensource-pipeline/SKILL.md
```
*Commit message example*
### Add or Update Install Target
**Trigger:** When supporting a new install target (IDE, platform) or updating install logic
**Command:** `/add-install-target`
```text
docs: add Antigravity setup and usage guide (#552)
1. Add or update install scripts and documentation under `.<target>/`.
2. Update `manifests/install-modules.json` and related schemas.
3. Add or update scripts in `scripts/lib/install-targets/<target>-project.js`.
4. Update registry and test files as needed.
5. Update `README.md` or other summary docs.
_Example:_
```
.codeBuddy/install.sh
scripts/lib/install-targets/codeBuddy-project.js
```
*Commit message example*
### Update or Add Hooks and Automation
**Trigger:** When modifying or extending hooks and automation scripts
**Command:** `/update-hooks`
```text
merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
```
1. Edit `hooks/hooks.json` to add or update hook definitions.
2. Modify or create scripts in `scripts/hooks/*.js` for hook logic.
3. Update or add related test files under `tests/hooks/`.
4. Optionally update `.cursor/hooks/` or other adapter-specific files.
*Commit message example*
```text
Revert "Add Kiro IDE support (.kiro/) (#548)"
```
*Commit message example*
```text
Add Kiro IDE support (.kiro/) (#548)
```
*Commit message example*
```text
feat: add block-no-verify hook for Claude Code and Cursor (#649)
```
## Architecture
### Project Structure: Single Package
This project uses **hybrid** module organization.
### Configuration Files
- `.github/workflows/ci.yml`
- `.github/workflows/maintenance.yml`
- `.github/workflows/monthly-metrics.yml`
- `.github/workflows/release.yml`
- `.github/workflows/reusable-release.yml`
- `.github/workflows/reusable-test.yml`
- `.github/workflows/reusable-validate.yml`
- `.opencode/package.json`
- `.opencode/tsconfig.json`
- `.prettierrc`
- `eslint.config.js`
- `package.json`
### Guidelines
- This project uses a hybrid organization
- Follow existing patterns when adding new code
## Code Style
### Language: JavaScript
### Naming Conventions
| Element | Convention |
|---------|------------|
| Files | camelCase |
| Functions | camelCase |
| Classes | PascalCase |
| Constants | SCREAMING_SNAKE_CASE |
### Import Style: Relative Imports
### Export Style: Mixed Style
*Preferred import style*
```typescript
// Use relative imports
import { Button } from '../components/Button'
import { useAuth } from './hooks/useAuth'
```
## Testing
### Test Framework
No specific test framework detected — use the repository's existing test patterns.
### File Pattern: `*.test.js`
### Test Types
- **Unit tests**: Test individual functions and components in isolation
- **Integration tests**: Test interactions between multiple components/services
### Coverage
This project has coverage reporting configured. Aim for 80%+ coverage.
## Error Handling
### Error Handling Style: Try-Catch Blocks
*Standard error handling pattern*
```typescript
try {
const result = await riskyOperation()
return result
} catch (error) {
console.error('Operation failed:', error)
throw new Error('User-friendly message')
_Example:_
```json
// hooks/hooks.json
{
"pre-commit": "node scripts/hooks/format.js"
}
```
## Common Workflows
### Documentation and Guidance Update
**Trigger:** When updating documentation or adding new guidance
**Command:** `/update-docs`
These workflows were detected from analyzing commit patterns.
1. Edit or create markdown files in the repo root or `docs/` directories.
2. Update `WORKING-CONTEXT.md` to reflect current practices.
3. Update or add `README.md`, `README.zh-CN.md`, and `AGENTS.md`.
4. Optionally update `.claude-plugin/` or `.codex-plugin/` README files.
### Database Migration
### Test or CI Fix
**Trigger:** When fixing or improving tests and CI integration
**Command:** `/fix-test`
Database schema changes with migration files
1. Edit test files under `tests/`.
2. Optionally edit scripts or hooks related to the test.
3. Update CI workflow files under `.github/workflows/` if needed.
**Frequency**: ~2 times per month
## Testing Patterns
**Steps**:
1. Create migration file
2. Update schema definitions
3. Generate/update types
- **Test Framework:** Not explicitly specified; test files follow the `*.test.js` pattern.
- **Test File Location:** Place test files under `tests/`, mirroring the structure of the code they test.
- **Example:**
```
tests/lib/install-targets.test.js
tests/hooks/format.test.js
```
- **Running Tests:**
Ensure your tests are named with `.test.js` and can be run via your preferred test runner (e.g., `node`, `jest`, etc.).
**Files typically involved**:
- `**/schema.*`
- `migrations/*`
## Commands
**Example commit sequence**:
| Command | Purpose |
|--------------------|--------------------------------------------------------------|
| /add-skill | Add a new skill (capability, agent, or workflow) |
| /add-command | Add a new command or workflow |
| /add-agent-pipeline| Add a new agent or multi-agent pipeline |
| /add-install-target| Add or update an install target (IDE, platform, plugin host) |
| /update-hooks | Update or add hooks and automation scripts |
| /update-docs | Update documentation and guidance |
| /fix-test | Fix or improve tests and CI integration |
```
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
Standard feature implementation workflow
**Frequency**: ~22 times per month
**Steps**:
1. Add feature implementation
2. Add tests for feature
3. Update documentation
**Files typically involved**:
- `manifests/*`
- `schemas/*`
- `**/*.test.*`
- `**/api/**`
**Example commit sequence**:
```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies
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
```
### Add Language Rules
Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines.
**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
**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 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
**Steps**:
1. Update agent, skill, and command counts in AGENTS.md
2. Update the same counts in README.md (quick-start, comparison table, etc.)
3. Optionally update other documentation files
**Files typically involved**:
- `AGENTS.md`
- `README.md`
**Example commit sequence**:
```
Update agent, skill, and command counts in AGENTS.md
Update the same counts in README.md (quick-start, comparison table, etc.)
Optionally update other documentation files
```
### Add Cross Harness Skill Copies
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms.
**Frequency**: ~2 times per month
**Steps**:
1. Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
2. Optionally add harness-specific openai.yaml or config files
3. Address review feedback to align with CONTRIBUTING template
**Files typically involved**:
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
- `.agents/skills/*/agents/openai.yaml`
**Example commit sequence**:
```
Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
Optionally add harness-specific openai.yaml or config files
Address review feedback to align with CONTRIBUTING template
```
### Add Or Update Hook
Adds or updates git or bash hooks to enforce workflow, quality, or security policies.
**Frequency**: ~1 times per month
**Steps**:
1. Add or update hook scripts in hooks/ or scripts/hooks/
2. Register the hook in hooks/hooks.json or similar config
3. Optionally add or update tests in tests/hooks/
**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**:
- `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
```
## Best Practices
Based on analysis of the codebase, follow these practices:
### Do
- Use conventional commit format (feat:, fix:, etc.)
- Follow *.test.js naming pattern
- Use camelCase for file names
- Prefer mixed exports
### Don't
- Don't write vague commit messages
- Don't skip tests for new features
- Don't deviate from established patterns without discussion
---
*This skill was auto-generated by [ECC Tools](https://ecc.tools). Review and customize as needed for your team.*

View File

@@ -0,0 +1,41 @@
---
name: add-new-skill
description: Workflow command scaffold for add-new-skill in everything-claude-code.
allowed_tools: ["Bash", "Read", "Write", "Grep", "Glob"]
---
# /add-new-skill
Use this workflow when working on **add-new-skill** in `everything-claude-code`.
## Goal
Adds a new skill to the system, including documentation and references in summary/index files.
## Common Files
- `skills/*/SKILL.md`
- `.agents/skills/*/SKILL.md`
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
## Suggested Sequence
1. Understand the current state and failure mode before editing.
2. Make the smallest coherent change that satisfies the workflow goal.
3. Run the most relevant verification for touched files.
4. Summarize what changed and what still needs review.
## Typical Commit Signals
- Create a new SKILL.md file under skills/<skill-name>/ or .agents/skills/<skill-name>/
- Optionally add related reference files (e.g., schemas, assets) under the skill directory
- Update AGENTS.md, README.md, README.zh-CN.md, and docs/zh-CN/AGENTS.md to reference the new skill
- Optionally update manifests/install-*.json if the skill is installable
## Notes
- Treat this as a scaffold, not a hard-coded script.
- Update the command if the workflow evolves materially.

View File

@@ -14,8 +14,9 @@ Standard feature implementation workflow
## Common Files
- `manifests/*`
- `schemas/*`
- `.opencode/*`
- `.opencode/plugins/*`
- `.opencode/plugins/lib/*`
- `**/*.test.*`
- `**/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",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-03-20T12:07:36.496Z",
"generatedAt": "2026-04-02T03:26:25.798Z",
"repo": "https://github.com/affaan-m/everything-claude-code",
"profiles": {
"requested": "full",
@@ -148,9 +148,9 @@
".claude/research/everything-claude-code-research-playbook.md",
".claude/team/everything-claude-code-team-config.json",
".claude/enterprise/controls.md",
".claude/commands/database-migration.md",
".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md"
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
],
"packageFiles": {
"runtime-core": [
@@ -178,9 +178,9 @@
".claude/enterprise/controls.md"
],
"workflow-pack": [
".claude/commands/database-migration.md",
".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md"
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
]
},
"moduleFiles": {
@@ -209,9 +209,9 @@
".claude/enterprise/controls.md"
],
"workflow-pack": [
".claude/commands/database-migration.md",
".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md"
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
]
},
"files": [
@@ -285,11 +285,6 @@
"path": ".claude/enterprise/controls.md",
"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",
"path": ".claude/commands/feature-development.md",
@@ -297,22 +292,27 @@
},
{
"moduleId": "workflow-pack",
"path": ".claude/commands/add-language-rules.md",
"description": "Workflow command scaffold for add-language-rules."
"path": ".claude/commands/refactoring.md",
"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": [
{
"command": "database-migration",
"path": ".claude/commands/database-migration.md"
},
{
"command": "feature-development",
"path": ".claude/commands/feature-development.md"
},
{
"command": "add-language-rules",
"path": ".claude/commands/add-language-rules.md"
"command": "refactoring",
"path": ".claude/commands/refactoring.md"
},
{
"command": "add-new-skill",
"path": ".claude/commands/add-new-skill.md"
}
],
"adapters": {
@@ -320,9 +320,9 @@
"skillPath": ".claude/skills/everything-claude-code/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": [
".claude/commands/database-migration.md",
".claude/commands/feature-development.md",
".claude/commands/add-language-rules.md"
".claude/commands/refactoring.md",
".claude/commands/add-new-skill.md"
]
},
"codex": {

View File

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

View File

@@ -18,4 +18,4 @@ Use this when the task is documentation-heavy, source-sensitive, or requires bro
- Primary language: JavaScript
- 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
- 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.
## Architecture
@@ -24,9 +24,9 @@ Generated by ECC Tools from repository history. Review before treating it as a h
## Detected Workflows
- database-migration: Database schema changes with migration files
- 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 system, including documentation and references in summary/index files.
## Review Reminder

View File

@@ -1,442 +1,174 @@
---
name: everything-claude-code-conventions
description: Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.
---
```markdown
# everything-claude-code Development Patterns
# Everything Claude Code Conventions
> Generated from [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) on 2026-03-20
> Auto-generated skill from repository analysis
## Overview
This skill teaches Claude the development patterns and conventions used in everything-claude-code.
This skill introduces the core development patterns, coding conventions, and collaborative workflows used in the `everything-claude-code` repository. The project is a JavaScript codebase (no framework detected) focused on modular skills, agent orchestration, automation workflows, and extensible install targets. It emphasizes clear documentation, conventional commits, and a structured approach to adding new capabilities.
## Tech Stack
## Coding Conventions
- **Primary Language**: JavaScript
- **Architecture**: hybrid module organization
- **Test Location**: separate
- **File Naming:**
Use `camelCase` for JavaScript files and directories.
_Example:_
```
installTargetProject.js
agentPipeline.md
```
## When to Use This Skill
- **Import Style:**
Use **relative imports** for modules within the codebase.
_Example:_
```js
const installTarget = require('../lib/install-targets/codeBuddy-project.js');
```
Activate this skill when:
- Making changes to this repository
- Adding new features following established patterns
- Writing tests that match project conventions
- Creating commits with proper message format
- **Export Style:**
Mixed usage of CommonJS (`module.exports`) and ES module (`export`) patterns, depending on context.
_Example (CommonJS):_
```js
module.exports = function installTarget() { ... };
```
_Example (ESM):_
```js
export function installTarget() { ... }
```
## Commit Conventions
- **Commit Messages:**
Use [Conventional Commits](https://www.conventionalcommits.org/) with prefixes: `fix`, `feat`, `docs`, `chore`.
_Example:_
```
feat: add support for new agent pipeline
fix: correct install script path resolution
```
Follow these commit message conventions based on 500 analyzed commits.
## Workflows
### Commit Style: Conventional Commits
### Add New Skill
**Trigger:** When you want to add a new skill (capability, agent, or workflow)
**Command:** `/add-skill`
### Prefixes Used
1. Create a new `SKILL.md` file under `skills/<skill-name>/` or `.agents/skills/<skill-name>/`.
2. Optionally add related reference files (schemas, assets) in the skill directory.
3. Update documentation files to reference the new skill:
- `AGENTS.md`
- `README.md`
- `README.zh-CN.md`
- `docs/zh-CN/AGENTS.md`
4. Optionally update install manifests (e.g., `manifests/install-components.json`) if the skill is installable.
- `fix`
- `test`
- `feat`
- `docs`
### Message Guidelines
- Average message length: ~65 characters
- Keep first line concise and descriptive
- Use imperative mood ("Add feature" not "Added feature")
*Commit message example*
```text
feat(rules): add C# language support
_Example directory structure:_
```
skills/myNewSkill/SKILL.md
skills/myNewSkill/schema.json
```
*Commit message example*
### Add New Command or Workflow
**Trigger:** When introducing a new command-line workflow or process
**Command:** `/add-command`
```text
chore(deps-dev): bump flatted (#675)
1. Create a new markdown file under `commands/` (e.g., `commands/myWorkflow.md`).
2. Document the workflow with YAML frontmatter, usage, and output sections.
3. Update `AGENTS.md`, `README.md`, or other summary files to reference the new command.
4. Optionally update scripts or examples if automation is included.
_Example:_
```markdown
---
name: santa-loop
description: Automates the Santa workflow
---
# santa-loop
Usage: ...
```
*Commit message example*
### Add New Agent or Agent Pipeline
**Trigger:** When adding a new agent or multi-agent pipeline
**Command:** `/add-agent-pipeline`
```text
fix: auto-detect ECC root from plugin cache when CLAUDE_PLUGIN_ROOT is unset (#547) (#691)
1. Create agent definition markdown files under `agents/` (e.g., `agents/myAgent.md`).
2. Optionally, create a new orchestrator skill under `skills/<pipeline>/SKILL.md`.
3. Update `AGENTS.md` and `README.md` to reference the new agent(s) or pipeline.
4. Optionally add example or configuration files.
_Example:_
```
agents/opensource-pipeline.md
skills/opensource-pipeline/SKILL.md
```
*Commit message example*
### Add or Update Install Target
**Trigger:** When supporting a new install target (IDE, platform) or updating install logic
**Command:** `/add-install-target`
```text
docs: add Antigravity setup and usage guide (#552)
1. Add or update install scripts and documentation under `.<target>/`.
2. Update `manifests/install-modules.json` and related schemas.
3. Add or update scripts in `scripts/lib/install-targets/<target>-project.js`.
4. Update registry and test files as needed.
5. Update `README.md` or other summary docs.
_Example:_
```
.codeBuddy/install.sh
scripts/lib/install-targets/codeBuddy-project.js
```
*Commit message example*
### Update or Add Hooks and Automation
**Trigger:** When modifying or extending hooks and automation scripts
**Command:** `/update-hooks`
```text
merge: PR #529 — feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
```
1. Edit `hooks/hooks.json` to add or update hook definitions.
2. Modify or create scripts in `scripts/hooks/*.js` for hook logic.
3. Update or add related test files under `tests/hooks/`.
4. Optionally update `.cursor/hooks/` or other adapter-specific files.
*Commit message example*
```text
Revert "Add Kiro IDE support (.kiro/) (#548)"
```
*Commit message example*
```text
Add Kiro IDE support (.kiro/) (#548)
```
*Commit message example*
```text
feat: add block-no-verify hook for Claude Code and Cursor (#649)
```
## Architecture
### Project Structure: Single Package
This project uses **hybrid** module organization.
### Configuration Files
- `.github/workflows/ci.yml`
- `.github/workflows/maintenance.yml`
- `.github/workflows/monthly-metrics.yml`
- `.github/workflows/release.yml`
- `.github/workflows/reusable-release.yml`
- `.github/workflows/reusable-test.yml`
- `.github/workflows/reusable-validate.yml`
- `.opencode/package.json`
- `.opencode/tsconfig.json`
- `.prettierrc`
- `eslint.config.js`
- `package.json`
### Guidelines
- This project uses a hybrid organization
- Follow existing patterns when adding new code
## Code Style
### Language: JavaScript
### Naming Conventions
| Element | Convention |
|---------|------------|
| Files | camelCase |
| Functions | camelCase |
| Classes | PascalCase |
| Constants | SCREAMING_SNAKE_CASE |
### Import Style: Relative Imports
### Export Style: Mixed Style
*Preferred import style*
```typescript
// Use relative imports
import { Button } from '../components/Button'
import { useAuth } from './hooks/useAuth'
```
## Testing
### Test Framework
No specific test framework detected — use the repository's existing test patterns.
### File Pattern: `*.test.js`
### Test Types
- **Unit tests**: Test individual functions and components in isolation
- **Integration tests**: Test interactions between multiple components/services
### Coverage
This project has coverage reporting configured. Aim for 80%+ coverage.
## Error Handling
### Error Handling Style: Try-Catch Blocks
*Standard error handling pattern*
```typescript
try {
const result = await riskyOperation()
return result
} catch (error) {
console.error('Operation failed:', error)
throw new Error('User-friendly message')
_Example:_
```json
// hooks/hooks.json
{
"pre-commit": "node scripts/hooks/format.js"
}
```
## Common Workflows
### Documentation and Guidance Update
**Trigger:** When updating documentation or adding new guidance
**Command:** `/update-docs`
These workflows were detected from analyzing commit patterns.
1. Edit or create markdown files in the repo root or `docs/` directories.
2. Update `WORKING-CONTEXT.md` to reflect current practices.
3. Update or add `README.md`, `README.zh-CN.md`, and `AGENTS.md`.
4. Optionally update `.claude-plugin/` or `.codex-plugin/` README files.
### Database Migration
### Test or CI Fix
**Trigger:** When fixing or improving tests and CI integration
**Command:** `/fix-test`
Database schema changes with migration files
1. Edit test files under `tests/`.
2. Optionally edit scripts or hooks related to the test.
3. Update CI workflow files under `.github/workflows/` if needed.
**Frequency**: ~2 times per month
## Testing Patterns
**Steps**:
1. Create migration file
2. Update schema definitions
3. Generate/update types
- **Test Framework:** Not explicitly specified; test files follow the `*.test.js` pattern.
- **Test File Location:** Place test files under `tests/`, mirroring the structure of the code they test.
- **Example:**
```
tests/lib/install-targets.test.js
tests/hooks/format.test.js
```
- **Running Tests:**
Ensure your tests are named with `.test.js` and can be run via your preferred test runner (e.g., `node`, `jest`, etc.).
**Files typically involved**:
- `**/schema.*`
- `migrations/*`
## Commands
**Example commit sequence**:
| Command | Purpose |
|--------------------|--------------------------------------------------------------|
| /add-skill | Add a new skill (capability, agent, or workflow) |
| /add-command | Add a new command or workflow |
| /add-agent-pipeline| Add a new agent or multi-agent pipeline |
| /add-install-target| Add or update an install target (IDE, platform, plugin host) |
| /update-hooks | Update or add hooks and automation scripts |
| /update-docs | Update documentation and guidance |
| /fix-test | Fix or improve tests and CI integration |
```
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
Standard feature implementation workflow
**Frequency**: ~22 times per month
**Steps**:
1. Add feature implementation
2. Add tests for feature
3. Update documentation
**Files typically involved**:
- `manifests/*`
- `schemas/*`
- `**/*.test.*`
- `**/api/**`
**Example commit sequence**:
```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies
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
```
### Add Language Rules
Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines.
**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
**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
**Steps**:
1. Update agent, skill, and command counts in AGENTS.md
2. Update the same counts in README.md (quick-start, comparison table, etc.)
3. Optionally update other documentation files
**Files typically involved**:
- `AGENTS.md`
- `README.md`
**Example commit sequence**:
```
Update agent, skill, and command counts in AGENTS.md
Update the same counts in README.md (quick-start, comparison table, etc.)
Optionally update other documentation files
```
### Add Cross Harness Skill Copies
Adds skill copies for different agent harnesses (e.g., Codex, Cursor, Antigravity) to ensure compatibility across platforms.
**Frequency**: ~2 times per month
**Steps**:
1. Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
2. Optionally add harness-specific openai.yaml or config files
3. Address review feedback to align with CONTRIBUTING template
**Files typically involved**:
- `.agents/skills/*/SKILL.md`
- `.cursor/skills/*/SKILL.md`
- `.agents/skills/*/agents/openai.yaml`
**Example commit sequence**:
```
Copy or adapt SKILL.md to .agents/skills/{skill}/SKILL.md and/or .cursor/skills/{skill}/SKILL.md
Optionally add harness-specific openai.yaml or config files
Address review feedback to align with CONTRIBUTING template
```
### Add Or Update Hook
Adds or updates git or bash hooks to enforce workflow, quality, or security policies.
**Frequency**: ~1 times per month
**Steps**:
1. Add or update hook scripts in hooks/ or scripts/hooks/
2. Register the hook in hooks/hooks.json or similar config
3. Optionally add or update tests in tests/hooks/
**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**:
- `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
```
## Best Practices
Based on analysis of the codebase, follow these practices:
### Do
- Use conventional commit format (feat:, fix:, etc.)
- Follow *.test.js naming pattern
- Use camelCase for file names
- Prefer mixed exports
### Don't
- Don't write vague commit messages
- Don't skip tests for new features
- Don't deviate from established patterns without discussion
---
*This skill was auto-generated by [ECC Tools](https://ecc.tools). Review and customize as needed for your team.*

View File

@@ -7,9 +7,9 @@
".agents/skills/everything-claude-code/SKILL.md"
],
"commandFiles": [
".claude/commands/database-migration.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-02T03:26:25.798Z"
}