feat: add everything-claude-code ECC bundle (.claude/skills/everything-claude-code/SKILL.md)

This commit is contained in:
ecc-tools[bot]
2026-03-24 10:42:36 +00:00
committed by GitHub
parent f59a9ebcea
commit 24c0aac4df

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-03-24
## 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`
- `test`
### Message Guidelines ### Message Guidelines
- Average message length: ~65 characters - Average message length: ~62 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(ecc2): add split-pane dashboard resizing
``` ```
*Commit message example* *Commit message example*
```text ```text
chore(deps-dev): bump flatted (#675) perf(hooks): move post-edit-format and post-edit-typecheck to strict-only (#757)
``` ```
*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: safe Codex config sync — merge AGENTS.md + add-only MCP servers (#723)
``` ```
*Commit message example* *Commit message example*
```text ```text
docs: add Antigravity setup and usage guide (#552) docs(zh-CN): translate code block(plain text) (#753)
``` ```
*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 security: remove supply chain risks, external promotions, and unauthorized credits
``` ```
*Commit message example* *Commit message example*
```text ```text
Revert "Add Kiro IDE support (.kiro/) (#548)" feat: scaffold ECC 2.0 Rust TUI — agentic IDE control plane
``` ```
*Commit message example* *Commit message example*
```text ```text
Add Kiro IDE support (.kiro/) (#548) feat(skills): add santa-method - multi-agent adversarial verification (#760)
``` ```
*Commit message example* *Commit message example*
```text ```text
feat: add block-no-verify hook for Claude Code and Cursor (#649) feat: pending instinct TTL pruning and /prune command (#725)
``` ```
## Architecture ## Architecture
@@ -196,21 +196,20 @@ Database schema changes with migration files
3. Generate/update types 3. Generate/update types
**Files typically involved**: **Files typically involved**:
- `**/schema.*`
- `migrations/*` - `migrations/*`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat: implement --with/--without selective install flags (#679) feat(rules): add C# language support (#704)
fix: sync catalog counts with filesystem (27 agents, 113 skills, 58 commands) (#693) fix: sanitize SessionStart session summaries (#710)
feat(rules): add Rust language rules (rebased #660) (#686) feat: add MCP health-check hook (#711)
``` ```
### Feature Development ### Feature Development
Standard feature implementation workflow Standard feature implementation workflow
**Frequency**: ~22 times per month **Frequency**: ~16 times per month
**Steps**: **Steps**:
1. Add feature implementation 1. Add feature implementation
@@ -219,204 +218,163 @@ Standard feature implementation workflow
**Files typically involved**: **Files typically involved**:
- `manifests/*` - `manifests/*`
- `schemas/*`
- `**/*.test.*` - `**/*.test.*`
- `**/api/**` - `**/api/**`
**Example commit sequence**: **Example commit sequence**:
``` ```
feat(skills): add documentation-lookup, bun-runtime, nextjs-turbopack; feat(agents): add rust-reviewer feat: agent description compression with lazy loading (#696)
docs(skills): align documentation-lookup with CONTRIBUTING template; add cross-harness (Codex/Cursor) skill copies feat: add nuxt 4 patterns skill (#702)
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(rules): add C# language support (#704)
``` ```
### Add Language Rules ### Add Or Update Skill Documentation
Adds a new programming language to the rules system, including coding style, hooks, patterns, security, and testing guidelines. Adds a new skill or updates documentation for an existing skill. Typically involves creating or modifying SKILL.md files under skills/ or docs/xx/skills/ directories.
**Frequency**: ~2 times per month
**Steps**:
1. Create a new directory under rules/{language}/
2. Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
3. Optionally reference or link to related skills
**Files typically involved**:
- `rules/*/coding-style.md`
- `rules/*/hooks.md`
- `rules/*/patterns.md`
- `rules/*/security.md`
- `rules/*/testing.md`
**Example commit sequence**:
```
Create a new directory under rules/{language}/
Add coding-style.md, hooks.md, patterns.md, security.md, and testing.md files with language-specific content
Optionally reference or link to related skills
```
### Add New Skill
Adds a new skill to the system, documenting its workflow, triggers, and usage, often with supporting scripts.
**Frequency**: ~4 times per month **Frequency**: ~4 times per month
**Steps**: **Steps**:
1. Create a new directory under skills/{skill-name}/ 1. Create or update SKILL.md under skills/<skill-name>/ or docs/<lang>/skills/<skill-name>/
2. Add SKILL.md with documentation (When to Use, How It Works, Examples, etc.) 2. Optionally update AGENTS.md or README.md to reflect new skill count or catalog
3. Optionally add scripts or supporting files under skills/{skill-name}/scripts/ 3. Commit with message referencing the skill and a summary of changes
4. Address review feedback and iterate on documentation
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `skills/*/SKILL.md`
- `skills/*/scripts/*.sh` - `docs/*/skills/*/SKILL.md`
- `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` - `AGENTS.md`
- `README.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 Create or update SKILL.md under skills/<skill-name>/ or docs/<lang>/skills/<skill-name>/
Register the agent in AGENTS.md Optionally update AGENTS.md or README.md to reflect new skill count or catalog
Optionally update README.md and docs/COMMAND-AGENT-MAP.md Commit with message referencing the skill and a summary of changes
``` ```
### Add New Command ### Add Or Update Localization
Adds a new command to the system, often paired with a backing skill. Adds or updates documentation translations for a new or existing language. Involves creating or modifying multiple files under docs/<lang>/, often in bulk.
**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. Add or update markdown files under docs/<lang>/ for agents, commands, skills, rules, etc.
2. Update the same counts in README.md (quick-start, comparison table, etc.) 2. Update README.md to include the new language or increment language count
3. Optionally update other documentation files 3. Commit with message referencing the language and scope (e.g., pt-BR, zh-CN, tr)
**Files typically involved**: **Files typically involved**:
- `AGENTS.md` - `docs/*/README.md`
- `docs/*/agents/*.md`
- `docs/*/commands/*.md`
- `docs/*/skills/*/SKILL.md`
- `docs/*/rules/**/*.md`
- `README.md` - `README.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Update agent, skill, and command counts in AGENTS.md Add or update markdown files under docs/<lang>/ for agents, commands, skills, rules, etc.
Update the same counts in README.md (quick-start, comparison table, etc.) Update README.md to include the new language or increment language count
Optionally update other documentation files Commit with message referencing the language and scope (e.g., pt-BR, zh-CN, tr)
```
### 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 ### Add Or Update Hook
Adds or updates git or bash hooks to enforce workflow, quality, or security policies. Adds a new hook or updates an existing one for agentic workflows. Involves changes to hooks.json and corresponding scripts.
**Frequency**: ~2 times per month
**Steps**:
1. Add or update entry in hooks/hooks.json
2. Create or modify corresponding script in scripts/hooks/
3. Optionally add or update tests in tests/hooks/ or tests/integration/
4. Commit with message referencing the hook and its purpose
**Files typically involved**:
- `hooks/hooks.json`
- `scripts/hooks/*.js`
- `tests/hooks/*.test.js`
- `tests/integration/*.test.js`
**Example commit sequence**:
```
Add or update entry in hooks/hooks.json
Create or modify corresponding script in scripts/hooks/
Optionally add or update tests in tests/hooks/ or tests/integration/
Commit with message referencing the hook and its purpose
```
### Add Or Update Session Adapter Feature
Adds or updates features in the session adapter, typically involving implementation, contract documentation, and tests.
**Frequency**: ~1 times per month **Frequency**: ~1 times per month
**Steps**: **Steps**:
1. Add or update hook scripts in hooks/ or scripts/hooks/ 1. Update implementation in scripts/lib/session-adapters/canonical-session.js
2. Register the hook in hooks/hooks.json or similar config 2. Update contract documentation in docs/SESSION-ADAPTER-CONTRACT.md
3. Optionally add or update tests in tests/hooks/ 3. Add or update corresponding tests in tests/lib/session-adapters.test.js
**Files typically involved**: **Files typically involved**:
- `hooks/*.hook` - `scripts/lib/session-adapters/canonical-session.js`
- `hooks/hooks.json` - `docs/SESSION-ADAPTER-CONTRACT.md`
- `scripts/hooks/*.js` - `tests/lib/session-adapters.test.js`
- `tests/hooks/*.test.js`
- `.cursor/hooks.json`
**Example commit sequence**: **Example commit sequence**:
``` ```
Add or update hook scripts in hooks/ or scripts/hooks/ Update implementation in scripts/lib/session-adapters/canonical-session.js
Register the hook in hooks/hooks.json or similar config Update contract documentation in docs/SESSION-ADAPTER-CONTRACT.md
Optionally add or update tests in tests/hooks/ Add or update corresponding tests in tests/lib/session-adapters.test.js
``` ```
### Address Review Feedback ### Add Or Update Language Support
Addresses code review feedback by updating documentation, scripts, or configuration for clarity, correctness, or convention alignment. Adds or updates support for a programming language, including rules, patterns, and install scripts/tests.
**Frequency**: ~4 times per month **Frequency**: ~1 times per month
**Steps**: **Steps**:
1. Edit SKILL.md, agent, or command files to address reviewer comments 1. Add or update rules under rules/<language>/ (coding-style.md, hooks.md, patterns.md, security.md, testing.md)
2. Update examples, headings, or configuration as requested 2. Update scripts/lib/install-manifests.js and manifests/install-components.json for install support
3. Iterate until all review feedback is resolved 3. Add or update tests in tests/lib/install-manifests.test.js
**Files typically involved**: **Files typically involved**:
- `skills/*/SKILL.md` - `rules/*/*.md`
- `agents/*.md` - `scripts/lib/install-manifests.js`
- `commands/*.md` - `manifests/install-components.json`
- `.agents/skills/*/SKILL.md` - `tests/lib/install-manifests.test.js`
- `.cursor/skills/*/SKILL.md`
**Example commit sequence**: **Example commit sequence**:
``` ```
Edit SKILL.md, agent, or command files to address reviewer comments Add or update rules under rules/<language>/ (coding-style.md, hooks.md, patterns.md, security.md, testing.md)
Update examples, headings, or configuration as requested Update scripts/lib/install-manifests.js and manifests/install-components.json for install support
Iterate until all review feedback is resolved Add or update tests in tests/lib/install-manifests.test.js
```
### Codex Config Sync And Merge
Synchronizes and merges Codex configuration files, ensuring user content is preserved and ECC-managed sections are updated.
**Frequency**: ~1 times per month
**Steps**:
1. Update or create scripts/codex/merge-mcp-config.js or scripts/sync-ecc-to-codex.sh
2. Update AGENTS.md or .codex/AGENTS.md as needed
3. Update README.md to reflect server/catalog changes
4. Commit with message referencing sync/merge and affected files
**Files typically involved**:
- `scripts/codex/merge-mcp-config.js`
- `scripts/sync-ecc-to-codex.sh`
- `.codex/AGENTS.md`
- `README.md`
**Example commit sequence**:
```
Update or create scripts/codex/merge-mcp-config.js or scripts/sync-ecc-to-codex.sh
Update AGENTS.md or .codex/AGENTS.md as needed
Update README.md to reflect server/catalog changes
Commit with message referencing sync/merge and affected files
``` ```