everything-claude-code

# everything-claude-code Development Patterns

> Auto-generated skill from repository analysis

## Overview

This skill teaches you the core development patterns, coding conventions, and collaborative workflows used in the `everything-claude-code` JavaScript repository. You'll learn how to add or update skills, agents, commands, install targets, and documentation, as well as how to maintain code quality and consistency across the project. The guide is based on real repository analysis and is designed to help contributors onboard quickly and work effectively.

---

## Coding Conventions

**File Naming**
- Use `camelCase` for JavaScript files and directories.
  - Example: `installManifests.js`, `installTargets/registry.js`

**Import Style**
- Use relative imports for modules within the project.
  ```js
  // Example
  const registry = require('./registry');

Export Style

• Mixed: both CommonJS (module.exports) and ES6 (export) styles may be present.

  // CommonJS
  module.exports = function install() { ... };
  
  // ES6 (if present)
  export function install() { ... }
  

Commit Messages

• Use Conventional Commits with prefixes:
  • fix, feat, docs, chore
• Keep commit messages concise (average ~56 characters).
  • Example: feat: add support for new install target

---

Workflows

Add or Update Skill

Trigger: When introducing or updating a skill for agents
Command: /add-skill

1. Create or update SKILL.md in skills/<skill-name>/
2. Optionally add or update related agent or command files
3. Update manifests/install-modules.json to register the skill
4. Update AGENTS.md and/or README.md to reflect the new skill
5. If documentation is multilingual, update docs/zh-CN/ and README.zh-CN.md

Example:

# Add a new skill
mkdir -p skills/myNewSkill
nano skills/myNewSkill/SKILL.md

# Register the skill
nano manifests/install-modules.json

# Update documentation
nano AGENTS.md
nano README.md

---

Add or Update Agent

Trigger: When introducing or updating an agent definition
Command: /add-agent

1. Create or update agent definition in agents/<agent-name>.md or .opencode/prompts/agents/
2. Update .opencode/opencode.json or similar registry/config
3. Update AGENTS.md to reflect new/changed agents
4. Optionally update orchestration or skills that reference the agent

---

Add or Update Command

Trigger: When introducing or improving a workflow command
Command: /add-command

1. Create or update command markdown file in commands/<command-name>.md
2. If related, update AGENTS.md or README.md to document the new command
3. If command is part of a workflow, update or add related agent/skill files

---

Add New Install Target or Adapter

Trigger: When supporting a new install environment or integration
Command: /add-install-target

1. Create new install scripts and documentation under a dedicated directory (e.g., .codebuddy/, .gemini/)
2. Add or update install target file in scripts/lib/install-targets/
3. Update manifests/install-modules.json and schemas/*.schema.json as needed
4. Update scripts/lib/install-manifests.js and scripts/lib/install-targets/registry.js
5. Add or update related tests in tests/lib/install-targets.test.js

---

Dependency Update via Dependabot

Trigger: When Dependabot detects an outdated dependency
Command: /update-dependency

1. Update dependency version in package.json, yarn.lock, or workflow YAML
2. Regenerate lockfiles if needed
3. Commit with a standardized message referencing dependency and version
4. Optionally update .github/dependabot.yml

---

Hook or CI Script Refactor or Fix

Trigger: When fixing, optimizing, or refactoring hooks or CI scripts
Command: /fix-hook

1. Edit hooks/hooks.json and/or scripts/hooks/*.js or shell scripts
2. Update or add related test files in tests/hooks/ or tests/scripts/
3. If needed, update configuration or schema files
4. Optionally update documentation (WORKING-CONTEXT.md, README.md)

---

Documentation Update or Sync

Trigger: When updating, clarifying, or synchronizing documentation
Command: /update-docs

1. Edit or add markdown files in docs/, AGENTS.md, README.md, WORKING-CONTEXT.md, etc.
2. If multilingual, update docs/zh-CN/ and README.zh-CN.md
3. Optionally update related skill or agent documentation

---

Testing Patterns

• Test Files: Use the pattern *.test.js for test files.
• Framework: No specific testing framework detected; use standard Node.js or your preferred test runner.
• Location: Tests are typically placed alongside the code they test or in tests/ subdirectories.
• Example:

  // tests/lib/install-targets.test.js
  const assert = require('assert');
  const installTarget = require('../../scripts/lib/install-targets/myTarget');