mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-30 22:13:28 +08:00
Compare commits
67 Commits
dependabot
...
feat/loop-
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9971e7550b | ||
|
|
5aff158511 | ||
|
|
6decc41121 | ||
|
|
99177e81ea | ||
|
|
b6a7f8ab0c | ||
|
|
c9962bf83e | ||
|
|
38f4265a1c | ||
|
|
b1456bd954 | ||
|
|
95bef977c1 | ||
|
|
e381c8d8a8 | ||
|
|
08d6c82989 | ||
|
|
9a3f72712b | ||
|
|
708a8fd715 | ||
|
|
9aace2e6fe | ||
|
|
fb6cc8548b | ||
|
|
b8452dc108 | ||
|
|
2fd8dfc7e1 | ||
|
|
158cbd8979 | ||
|
|
3e18127a3d | ||
|
|
63c97b4c26 | ||
|
|
70cc2bb247 | ||
|
|
01d3743a8c | ||
|
|
a374eaf49d | ||
|
|
d05855be5f | ||
|
|
803abe52a5 | ||
|
|
e1d6d853f7 | ||
|
|
5881554a1c | ||
|
|
d26d66fd3b | ||
|
|
0c61710c43 | ||
|
|
d49f0329a9 | ||
|
|
95ce9eaaeb | ||
|
|
06f9eca8e2 | ||
|
|
affbd33485 | ||
|
|
9627c201c7 | ||
|
|
1188aeafc4 | ||
|
|
17aafc4506 | ||
|
|
0dcde13384 | ||
|
|
3fadc37802 | ||
|
|
2006d2ee77 | ||
|
|
149fae7008 | ||
|
|
a7a56fa2a2 | ||
|
|
84ac76fa2b | ||
|
|
69b8ec4e0b | ||
|
|
4b67c3cac6 | ||
|
|
c3ea7a1e5e | ||
|
|
468c755abd | ||
|
|
fc96be4924 | ||
|
|
7ca48f376f | ||
|
|
8c7e6611e0 | ||
|
|
b5bdd9352f | ||
|
|
ae02b26cf9 | ||
|
|
cc89c40751 | ||
|
|
880c487c0f | ||
|
|
45a9bcf295 | ||
|
|
ebf0d4322b | ||
|
|
015b00b8fc | ||
|
|
51511461f6 | ||
|
|
aaaf52fb1e | ||
|
|
33edfd3bb3 | ||
|
|
f92dc544c4 | ||
|
|
1c2d5dd389 | ||
|
|
b40de37ccb | ||
|
|
63485a26bf | ||
|
|
fe40a3d27b | ||
|
|
2c56c9c69f | ||
|
|
d9d52d8b77 | ||
|
|
2eaafc38f6 |
@@ -1,336 +0,0 @@
|
||||
---
|
||||
name: claude-api
|
||||
description: Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.
|
||||
---
|
||||
|
||||
# Claude API
|
||||
|
||||
Build applications with the Anthropic Claude API and SDKs.
|
||||
|
||||
## When to Activate
|
||||
|
||||
- Building applications that call the Claude API
|
||||
- Code imports `anthropic` (Python) or `@anthropic-ai/sdk` (TypeScript)
|
||||
- User asks about Claude API patterns, tool use, streaming, or vision
|
||||
- Implementing agent workflows with Claude Agent SDK
|
||||
- Optimizing API costs, token usage, or latency
|
||||
|
||||
## Model Selection
|
||||
|
||||
| Model | ID | Best For |
|
||||
|-------|-----|----------|
|
||||
| Opus 4.6 | `claude-opus-4-6` | Complex reasoning, architecture, research |
|
||||
| Sonnet 4.6 | `claude-sonnet-4-6` | Balanced coding, most development tasks |
|
||||
| Haiku 4.5 | `claude-haiku-4-5-20251001` | Fast responses, high-volume, cost-sensitive |
|
||||
|
||||
Default to Sonnet 4.6 unless the task requires deep reasoning (Opus) or speed/cost optimization (Haiku).
|
||||
|
||||
## Python SDK
|
||||
|
||||
### Installation
|
||||
|
||||
```bash
|
||||
pip install anthropic
|
||||
```
|
||||
|
||||
### Basic Message
|
||||
|
||||
```python
|
||||
import anthropic
|
||||
|
||||
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from env
|
||||
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=1024,
|
||||
messages=[
|
||||
{"role": "user", "content": "Explain async/await in Python"}
|
||||
]
|
||||
)
|
||||
print(message.content[0].text)
|
||||
```
|
||||
|
||||
### Streaming
|
||||
|
||||
```python
|
||||
with client.messages.stream(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=1024,
|
||||
messages=[{"role": "user", "content": "Write a haiku about coding"}]
|
||||
) as stream:
|
||||
for text in stream.text_stream:
|
||||
print(text, end="", flush=True)
|
||||
```
|
||||
|
||||
### System Prompt
|
||||
|
||||
```python
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=1024,
|
||||
system="You are a senior Python developer. Be concise.",
|
||||
messages=[{"role": "user", "content": "Review this function"}]
|
||||
)
|
||||
```
|
||||
|
||||
## TypeScript SDK
|
||||
|
||||
### Installation
|
||||
|
||||
```bash
|
||||
npm install @anthropic-ai/sdk
|
||||
```
|
||||
|
||||
### Basic Message
|
||||
|
||||
```typescript
|
||||
import Anthropic from "@anthropic-ai/sdk";
|
||||
|
||||
const client = new Anthropic(); // reads ANTHROPIC_API_KEY from env
|
||||
|
||||
const message = await client.messages.create({
|
||||
model: "claude-sonnet-4-6",
|
||||
max_tokens: 1024,
|
||||
messages: [
|
||||
{ role: "user", content: "Explain async/await in TypeScript" }
|
||||
],
|
||||
});
|
||||
console.log(message.content[0].text);
|
||||
```
|
||||
|
||||
### Streaming
|
||||
|
||||
```typescript
|
||||
const stream = client.messages.stream({
|
||||
model: "claude-sonnet-4-6",
|
||||
max_tokens: 1024,
|
||||
messages: [{ role: "user", content: "Write a haiku" }],
|
||||
});
|
||||
|
||||
for await (const event of stream) {
|
||||
if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
|
||||
process.stdout.write(event.delta.text);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Tool Use
|
||||
|
||||
Define tools and let Claude call them:
|
||||
|
||||
```python
|
||||
tools = [
|
||||
{
|
||||
"name": "get_weather",
|
||||
"description": "Get current weather for a location",
|
||||
"input_schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"location": {"type": "string", "description": "City name"},
|
||||
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
|
||||
},
|
||||
"required": ["location"]
|
||||
}
|
||||
}
|
||||
]
|
||||
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=1024,
|
||||
tools=tools,
|
||||
messages=[{"role": "user", "content": "What's the weather in SF?"}]
|
||||
)
|
||||
|
||||
# Handle tool use response
|
||||
for block in message.content:
|
||||
if block.type == "tool_use":
|
||||
# Execute the tool with block.input
|
||||
result = get_weather(**block.input)
|
||||
# Send result back
|
||||
follow_up = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=1024,
|
||||
tools=tools,
|
||||
messages=[
|
||||
{"role": "user", "content": "What's the weather in SF?"},
|
||||
{"role": "assistant", "content": message.content},
|
||||
{"role": "user", "content": [
|
||||
{"type": "tool_result", "tool_use_id": block.id, "content": str(result)}
|
||||
]}
|
||||
]
|
||||
)
|
||||
```
|
||||
|
||||
## Vision
|
||||
|
||||
Send images for analysis:
|
||||
|
||||
```python
|
||||
import base64
|
||||
|
||||
with open("diagram.png", "rb") as f:
|
||||
image_data = base64.standard_b64encode(f.read()).decode("utf-8")
|
||||
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=1024,
|
||||
messages=[{
|
||||
"role": "user",
|
||||
"content": [
|
||||
{"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": image_data}},
|
||||
{"type": "text", "text": "Describe this diagram"}
|
||||
]
|
||||
}]
|
||||
)
|
||||
```
|
||||
|
||||
## Extended Thinking
|
||||
|
||||
For complex reasoning tasks:
|
||||
|
||||
```python
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=16000,
|
||||
thinking={
|
||||
"type": "enabled",
|
||||
"budget_tokens": 10000
|
||||
},
|
||||
messages=[{"role": "user", "content": "Solve this math problem step by step..."}]
|
||||
)
|
||||
|
||||
for block in message.content:
|
||||
if block.type == "thinking":
|
||||
print(f"Thinking: {block.thinking}")
|
||||
elif block.type == "text":
|
||||
print(f"Answer: {block.text}")
|
||||
```
|
||||
|
||||
## Prompt Caching
|
||||
|
||||
Cache large system prompts or context to reduce costs:
|
||||
|
||||
```python
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=1024,
|
||||
system=[
|
||||
{"type": "text", "text": large_system_prompt, "cache_control": {"type": "ephemeral"}}
|
||||
],
|
||||
messages=[{"role": "user", "content": "Question about the cached context"}]
|
||||
)
|
||||
# Check cache usage
|
||||
print(f"Cache read: {message.usage.cache_read_input_tokens}")
|
||||
print(f"Cache creation: {message.usage.cache_creation_input_tokens}")
|
||||
```
|
||||
|
||||
## Batches API
|
||||
|
||||
Process large volumes asynchronously at 50% cost reduction:
|
||||
|
||||
```python
|
||||
import time
|
||||
|
||||
batch = client.messages.batches.create(
|
||||
requests=[
|
||||
{
|
||||
"custom_id": f"request-{i}",
|
||||
"params": {
|
||||
"model": "claude-sonnet-4-6",
|
||||
"max_tokens": 1024,
|
||||
"messages": [{"role": "user", "content": prompt}]
|
||||
}
|
||||
}
|
||||
for i, prompt in enumerate(prompts)
|
||||
]
|
||||
)
|
||||
|
||||
# Poll for completion
|
||||
while True:
|
||||
status = client.messages.batches.retrieve(batch.id)
|
||||
if status.processing_status == "ended":
|
||||
break
|
||||
time.sleep(30)
|
||||
|
||||
# Get results
|
||||
for result in client.messages.batches.results(batch.id):
|
||||
print(result.result.message.content[0].text)
|
||||
```
|
||||
|
||||
## Claude Agent SDK
|
||||
|
||||
Build multi-step agents:
|
||||
|
||||
```python
|
||||
# Note: Agent SDK API surface may change — check official docs
|
||||
import anthropic
|
||||
|
||||
# Define tools as functions
|
||||
tools = [{
|
||||
"name": "search_codebase",
|
||||
"description": "Search the codebase for relevant code",
|
||||
"input_schema": {
|
||||
"type": "object",
|
||||
"properties": {"query": {"type": "string"}},
|
||||
"required": ["query"]
|
||||
}
|
||||
}]
|
||||
|
||||
# Run an agentic loop with tool use
|
||||
client = anthropic.Anthropic()
|
||||
messages = [{"role": "user", "content": "Review the auth module for security issues"}]
|
||||
|
||||
while True:
|
||||
response = client.messages.create(
|
||||
model="claude-sonnet-4-6",
|
||||
max_tokens=4096,
|
||||
tools=tools,
|
||||
messages=messages,
|
||||
)
|
||||
if response.stop_reason == "end_turn":
|
||||
break
|
||||
# Handle tool calls and continue the loop
|
||||
messages.append({"role": "assistant", "content": response.content})
|
||||
# ... execute tools and append tool_result messages
|
||||
```
|
||||
|
||||
## Cost Optimization
|
||||
|
||||
| Strategy | Savings | When to Use |
|
||||
|----------|---------|-------------|
|
||||
| Prompt caching | Up to 90% on cached tokens | Repeated system prompts or context |
|
||||
| Batches API | 50% | Non-time-sensitive bulk processing |
|
||||
| Haiku instead of Sonnet | ~75% | Simple tasks, classification, extraction |
|
||||
| Shorter max_tokens | Variable | When you know output will be short |
|
||||
| Streaming | None (same cost) | Better UX, same price |
|
||||
|
||||
## Error Handling
|
||||
|
||||
```python
|
||||
import time
|
||||
|
||||
from anthropic import APIError, RateLimitError, APIConnectionError
|
||||
|
||||
try:
|
||||
message = client.messages.create(...)
|
||||
except RateLimitError:
|
||||
# Back off and retry
|
||||
time.sleep(60)
|
||||
except APIConnectionError:
|
||||
# Network issue, retry with backoff
|
||||
pass
|
||||
except APIError as e:
|
||||
print(f"API error {e.status_code}: {e.message}")
|
||||
```
|
||||
|
||||
## Environment Setup
|
||||
|
||||
```bash
|
||||
# Required
|
||||
export ANTHROPIC_API_KEY="your-api-key-here"
|
||||
|
||||
# Optional: set default model
|
||||
export ANTHROPIC_MODEL="claude-sonnet-4-6"
|
||||
```
|
||||
|
||||
Never hardcode API keys. Always use environment variables.
|
||||
@@ -1,7 +0,0 @@
|
||||
interface:
|
||||
display_name: "Claude API"
|
||||
short_description: "Claude API patterns for Python and TypeScript"
|
||||
brand_color: "#D97706"
|
||||
default_prompt: "Use $claude-api to build with Claude API and Anthropic SDK patterns."
|
||||
policy:
|
||||
allow_implicit_invocation: true
|
||||
@@ -1,144 +0,0 @@
|
||||
---
|
||||
name: frontend-design
|
||||
description: Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.
|
||||
---
|
||||
|
||||
# Frontend Design
|
||||
|
||||
Use this when the task is not just "make it work" but "make it look designed."
|
||||
|
||||
This skill is for product pages, dashboards, app shells, components, or visual systems that need a clear point of view instead of generic AI-looking UI.
|
||||
|
||||
## When To Use
|
||||
|
||||
- building a landing page, dashboard, or app surface from scratch
|
||||
- upgrading a bland interface into something intentional and memorable
|
||||
- translating a product concept into a concrete visual direction
|
||||
- implementing a frontend where typography, composition, and motion matter
|
||||
|
||||
## Core Principle
|
||||
|
||||
Pick a direction and commit to it.
|
||||
|
||||
Safe-average UI is usually worse than a strong, coherent aesthetic with a few bold choices.
|
||||
|
||||
## Design Workflow
|
||||
|
||||
### 1. Frame the interface first
|
||||
|
||||
Before coding, settle:
|
||||
|
||||
- purpose
|
||||
- audience
|
||||
- emotional tone
|
||||
- visual direction
|
||||
- one thing the user should remember
|
||||
|
||||
Possible directions:
|
||||
|
||||
- brutally minimal
|
||||
- editorial
|
||||
- industrial
|
||||
- luxury
|
||||
- playful
|
||||
- geometric
|
||||
- retro-futurist
|
||||
- soft and organic
|
||||
- maximalist
|
||||
|
||||
Do not mix directions casually. Choose one and execute it cleanly.
|
||||
|
||||
### 2. Build the visual system
|
||||
|
||||
Define:
|
||||
|
||||
- type hierarchy
|
||||
- color variables
|
||||
- spacing rhythm
|
||||
- layout logic
|
||||
- motion rules
|
||||
- surface / border / shadow treatment
|
||||
|
||||
Use CSS variables or the project's token system so the interface stays coherent as it grows.
|
||||
|
||||
### 3. Compose with intention
|
||||
|
||||
Prefer:
|
||||
|
||||
- asymmetry when it sharpens hierarchy
|
||||
- overlap when it creates depth
|
||||
- strong whitespace when it clarifies focus
|
||||
- dense layouts only when the product benefits from density
|
||||
|
||||
Avoid defaulting to a symmetrical card grid unless it is clearly the right fit.
|
||||
|
||||
### 4. Make motion meaningful
|
||||
|
||||
Use animation to:
|
||||
|
||||
- reveal hierarchy
|
||||
- stage information
|
||||
- reinforce user action
|
||||
- create one or two memorable moments
|
||||
|
||||
Do not scatter generic micro-interactions everywhere. One well-directed load sequence is usually stronger than twenty random hover effects.
|
||||
|
||||
## Strong Defaults
|
||||
|
||||
### Typography
|
||||
|
||||
- pick fonts with character
|
||||
- pair a distinctive display face with a readable body face when appropriate
|
||||
- avoid generic defaults when the page is design-led
|
||||
|
||||
### Color
|
||||
|
||||
- commit to a clear palette
|
||||
- one dominant field with selective accents usually works better than evenly weighted rainbow palettes
|
||||
- avoid cliché purple-gradient-on-white unless the product genuinely calls for it
|
||||
|
||||
### Background
|
||||
|
||||
Use atmosphere:
|
||||
|
||||
- gradients
|
||||
- meshes
|
||||
- textures
|
||||
- subtle noise
|
||||
- patterns
|
||||
- layered transparency
|
||||
|
||||
Flat empty backgrounds are rarely the best answer for a product-facing page.
|
||||
|
||||
### Layout
|
||||
|
||||
- break the grid when the composition benefits from it
|
||||
- use diagonals, offsets, and grouping intentionally
|
||||
- keep reading flow obvious even when the layout is unconventional
|
||||
|
||||
## Anti-Patterns
|
||||
|
||||
Never default to:
|
||||
|
||||
- interchangeable SaaS hero sections
|
||||
- generic card piles with no hierarchy
|
||||
- random accent colors without a system
|
||||
- placeholder-feeling typography
|
||||
- motion that exists only because animation was easy to add
|
||||
|
||||
## Execution Rules
|
||||
|
||||
- preserve the established design system when working inside an existing product
|
||||
- match technical complexity to the visual idea
|
||||
- keep accessibility and responsiveness intact
|
||||
- frontends should feel deliberate on desktop and mobile
|
||||
|
||||
## Quality Gate
|
||||
|
||||
Before delivering:
|
||||
|
||||
- the interface has a clear visual point of view
|
||||
- typography and spacing feel intentional
|
||||
- color and motion support the product instead of decorating it randomly
|
||||
- the result does not read like generic AI UI
|
||||
- the implementation is production-grade, not just visually interesting
|
||||
@@ -1,7 +0,0 @@
|
||||
interface:
|
||||
display_name: "Frontend Design"
|
||||
short_description: "Production-grade frontend interface design"
|
||||
brand_color: "#0EA5E9"
|
||||
default_prompt: "Use $frontend-design to build a distinctive production-grade interface."
|
||||
policy:
|
||||
allow_implicit_invocation: true
|
||||
@@ -17,6 +17,12 @@ Modern frontend patterns for React, Next.js, and performant user interfaces.
|
||||
- Handling client-side routing and navigation
|
||||
- Building accessible, responsive UI patterns
|
||||
|
||||
## Privacy and Data Boundaries
|
||||
|
||||
Frontend examples should use synthetic or domain-generic data. Do not collect, log, persist, or display credentials, access tokens, SSNs, health data, payment details, private emails, phone numbers, or other sensitive personal data unless the user explicitly requests a scoped implementation with appropriate validation, redaction, and access controls.
|
||||
|
||||
Avoid adding analytics, tracking pixels, third-party scripts, or external data sinks without explicit approval. When handling user data, prefer least-privilege APIs, client-side redaction before logging, and server-side validation for every boundary.
|
||||
|
||||
## Component Patterns
|
||||
|
||||
### Composition Over Inheritance
|
||||
|
||||
@@ -132,6 +132,26 @@ The test `plugin.json does NOT have explicit hooks declaration` in `tests/hooks/
|
||||
|
||||
---
|
||||
|
||||
## The `mcpServers` Field: Keep the Empty Opt-Out
|
||||
|
||||
ECC keeps `.mcp.json` at the repository root for Codex plugin installs and manual MCP setup.
|
||||
Claude Code also auto-discovers plugin-root `.mcp.json` files by convention, which would bundle the same MCP servers into Claude plugin installs.
|
||||
|
||||
Keep this field in `.claude-plugin/plugin.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {}
|
||||
}
|
||||
```
|
||||
|
||||
This explicit empty object prevents Claude plugin installs from auto-loading ECC's root MCP definitions.
|
||||
Without the opt-out, strict OpenAI-compatible gateways can reject plugin MCP tool names such as `mcp__plugin_everything-claude-code_github__create_pull_request_review` because they exceed 64 characters.
|
||||
|
||||
Users who want the bundled MCP servers should configure them manually from `.mcp.json` or `mcp-configs/mcp-servers.json`.
|
||||
|
||||
---
|
||||
|
||||
## Known Anti-Patterns
|
||||
|
||||
These look correct but are rejected:
|
||||
@@ -142,6 +162,7 @@ These look correct but are rejected:
|
||||
* Relying on inferred paths
|
||||
* Assuming marketplace behavior matches local validation
|
||||
* **Adding `"hooks": "./hooks/hooks.json"`** - auto-loaded by convention, causes duplicate error
|
||||
* Removing `"mcpServers": {}` - re-enables root `.mcp.json` auto-discovery for Claude plugin installs and can produce overlong MCP tool names
|
||||
|
||||
Avoid cleverness. Be explicit.
|
||||
|
||||
@@ -170,7 +191,8 @@ Before submitting changes that touch `plugin.json`:
|
||||
1. Ensure all component fields are arrays
|
||||
2. Include a `version`
|
||||
3. Do NOT add `agents` or `hooks` fields (both are auto-loaded by convention)
|
||||
4. Run:
|
||||
4. Preserve `"mcpServers": {}` unless you are intentionally changing Claude plugin MCP bundling behavior
|
||||
5. Run:
|
||||
|
||||
```bash
|
||||
claude plugin validate .claude-plugin/plugin.json
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
{
|
||||
"name": "everything-claude-code",
|
||||
"source": "./",
|
||||
"description": "The most comprehensive Claude Code plugin — 48 agents, 184 skills, 79 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning",
|
||||
"description": "The most comprehensive Claude Code plugin — 48 agents, 182 skills, 68 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning",
|
||||
"version": "2.0.0-rc.1",
|
||||
"author": {
|
||||
"name": "Affaan Mustafa",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "everything-claude-code",
|
||||
"version": "2.0.0-rc.1",
|
||||
"description": "Battle-tested Claude Code plugin for engineering teams — 48 agents, 184 skills, 79 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use",
|
||||
"description": "Battle-tested Claude Code plugin for engineering teams — 48 agents, 182 skills, 68 legacy command shims, production-ready hooks, and selective install workflows evolved through continuous real-world use",
|
||||
"author": {
|
||||
"name": "Affaan Mustafa",
|
||||
"url": "https://x.com/affaanmustafa"
|
||||
@@ -22,6 +22,7 @@
|
||||
"automation",
|
||||
"best-practices"
|
||||
],
|
||||
"mcpServers": {},
|
||||
"skills": ["./skills/"],
|
||||
"commands": ["./commands/"]
|
||||
}
|
||||
|
||||
@@ -12,7 +12,7 @@ This directory contains the **Codex plugin manifest** for Everything Claude Code
|
||||
|
||||
## What This Provides
|
||||
|
||||
- **156 skills** from `./skills/` — reusable Codex workflows for TDD, security,
|
||||
- **182 skills** from `./skills/` — reusable Codex workflows for TDD, security,
|
||||
code review, architecture, and more
|
||||
- **6 MCP servers** — GitHub, Context7, Exa, Memory, Playwright, Sequential Thinking
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "ecc",
|
||||
"version": "2.0.0-rc.1",
|
||||
"description": "Battle-tested Codex workflows — 156 shared ECC skills, production-ready MCP configs, and selective-install-aligned conventions for TDD, security scanning, code review, and autonomous development.",
|
||||
"description": "Battle-tested Codex workflows — 182 shared ECC skills, production-ready MCP configs, and selective-install-aligned conventions for TDD, security scanning, code review, and autonomous development.",
|
||||
"author": {
|
||||
"name": "Affaan Mustafa",
|
||||
"email": "me@affaanmustafa.com",
|
||||
@@ -15,7 +15,7 @@
|
||||
"mcpServers": "./.mcp.json",
|
||||
"interface": {
|
||||
"displayName": "Everything Claude Code",
|
||||
"shortDescription": "156 battle-tested ECC skills plus MCP configs for TDD, security, code review, and autonomous development.",
|
||||
"shortDescription": "182 battle-tested ECC skills plus MCP configs for TDD, security, code review, and autonomous development.",
|
||||
"longDescription": "Everything Claude Code (ECC) is a community-maintained collection of Codex-ready skills and MCP configs evolved over 10+ months of intensive daily use. It covers TDD workflows, security scanning, code review, architecture decisions, operator workflows, and more — all in one installable plugin.",
|
||||
"developerName": "Affaan Mustafa",
|
||||
"category": "Productivity",
|
||||
|
||||
@@ -60,6 +60,12 @@ The sync script (`scripts/sync-ecc-to-codex.sh`) uses a Node-based TOML parser t
|
||||
- **`--update-mcp`** — explicitly replaces all ECC-managed servers with the latest recommended config (safely removes subtables like `[mcp_servers.supabase.env]`).
|
||||
- **User config is always preserved** — custom servers, args, env vars, and credentials outside ECC-managed sections are never touched.
|
||||
|
||||
## External Action Boundaries
|
||||
|
||||
Treat networked tools as read-only by default. Search, inspect, and draft freely within the user's requested scope, but require explicit user approval before posting, publishing, pushing, merging, opening paid jobs, dispatching remote agents, changing third-party resources, or modifying credentials.
|
||||
|
||||
When approval is ambiguous, produce a local plan or draft artifact instead of taking the external action. Preserve user config and private state unless the user specifically asks for a scoped change.
|
||||
|
||||
## Multi-Agent Support
|
||||
|
||||
Codex now supports multi-agent workflows behind the experimental `features.multi_agent` flag.
|
||||
|
||||
@@ -21,6 +21,12 @@ Use this skill when:
|
||||
- The user asks "add X functionality" and you're about to write code
|
||||
- Before creating a new utility, helper, or abstraction
|
||||
|
||||
## Scope and Approval Rules
|
||||
|
||||
Default to read-only research: inspect the repo, package metadata, docs, and public examples before recommending a dependency or integration. Do not install packages, configure MCP servers, publish artifacts, open PRs, or make external write actions from this skill unless the user has explicitly approved that action in the current task.
|
||||
|
||||
When a candidate requires credentials, paid services, network writes, or project-wide config changes, return a recommendation and approval checkpoint instead of applying it directly.
|
||||
|
||||
## Workflow
|
||||
|
||||
```
|
||||
@@ -45,9 +51,9 @@ Use this skill when:
|
||||
│ │ as-is │ │ /Wrap │ │ Custom │ │
|
||||
│ └─────────┘ └──────────┘ └─────────┘ │
|
||||
├─────────────────────────────────────────────┤
|
||||
│ 5. IMPLEMENT │
|
||||
│ Install package / Configure MCP / │
|
||||
│ Write minimal custom code │
|
||||
│ 5. APPROVAL CHECKPOINT / IMPLEMENT │
|
||||
│ Recommend package / MCP / custom code │
|
||||
│ Apply only after explicit approval │
|
||||
└─────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
@@ -55,10 +61,10 @@ Use this skill when:
|
||||
|
||||
| Signal | Action |
|
||||
|--------|--------|
|
||||
| Exact match, well-maintained, MIT/Apache | **Adopt** — install and use directly |
|
||||
| Partial match, good foundation | **Extend** — install + write thin wrapper |
|
||||
| Multiple weak matches | **Compose** — combine 2-3 small packages |
|
||||
| Nothing suitable found | **Build** — write custom, but informed by research |
|
||||
| Exact match, well-maintained, MIT/Apache | **Adopt** — recommend the package and request approval before install or config changes |
|
||||
| Partial match, good foundation | **Extend** — recommend the package plus a thin wrapper, then wait for approval before applying |
|
||||
| Multiple weak matches | **Compose** — propose 2-3 small packages and the integration plan before installing anything |
|
||||
| Nothing suitable found | **Build** — explain why custom code is warranted, then implement only within the approved task scope |
|
||||
|
||||
## How to Use
|
||||
|
||||
@@ -135,8 +141,8 @@ Combine for progressive discovery:
|
||||
Need: Check markdown files for broken links
|
||||
Search: npm "markdown dead link checker"
|
||||
Found: textlint-rule-no-dead-link (score: 9/10)
|
||||
Action: ADOPT — npm install textlint-rule-no-dead-link
|
||||
Result: Zero custom code, battle-tested solution
|
||||
Action: ADOPT — recommend `textlint-rule-no-dead-link` and ask before installing it
|
||||
Result: Zero custom code if approved, battle-tested solution
|
||||
```
|
||||
|
||||
### Example 2: "Add HTTP client wrapper"
|
||||
@@ -144,8 +150,8 @@ Result: Zero custom code, battle-tested solution
|
||||
Need: Resilient HTTP client with retries and timeout handling
|
||||
Search: npm "http client retry", PyPI "httpx retry"
|
||||
Found: got (Node) with retry plugin, httpx (Python) with built-in retry
|
||||
Action: ADOPT — use got/httpx directly with retry config
|
||||
Result: Zero custom code, production-proven libraries
|
||||
Action: ADOPT — recommend `got`/`httpx` directly with retry config and ask before changing dependencies
|
||||
Result: Zero custom code if approved, production-proven libraries
|
||||
```
|
||||
|
||||
### Example 3: "Add config file linter"
|
||||
@@ -153,8 +159,8 @@ Result: Zero custom code, production-proven libraries
|
||||
Need: Validate project config files against a schema
|
||||
Search: npm "config linter schema", "json schema validator cli"
|
||||
Found: ajv-cli (score: 8/10)
|
||||
Action: ADOPT + EXTEND — install ajv-cli, write project-specific schema
|
||||
Result: 1 package + 1 schema file, no custom validation logic
|
||||
Action: ADOPT + EXTEND — recommend `ajv-cli` plus a project-specific schema, then wait for approval before install/write
|
||||
Result: 1 package + 1 schema file if approved, no custom validation logic
|
||||
```
|
||||
|
||||
## Anti-Patterns
|
||||
|
||||
@@ -43,6 +43,14 @@ export const ECCHooksPlugin: ECCHooksPluginFn = async ({
|
||||
return path.join(worktreePath, p)
|
||||
}
|
||||
|
||||
function hasProjectFile(relativePath: string): boolean {
|
||||
try {
|
||||
return fs.existsSync(resolvePath(relativePath))
|
||||
} catch {
|
||||
return false
|
||||
}
|
||||
}
|
||||
|
||||
const pendingToolChanges = new Map<string, { path: string; type: "added" | "modified" }>()
|
||||
let writeCounter = 0
|
||||
|
||||
@@ -275,13 +283,8 @@ export const ECCHooksPlugin: ECCHooksPluginFn = async ({
|
||||
log("info", `[ECC] Session started - profile=${currentProfile}`)
|
||||
|
||||
// Check for project-specific context files
|
||||
try {
|
||||
const hasClaudeMd = await $`test -f ${worktree}/CLAUDE.md && echo "yes"`.text()
|
||||
if (hasClaudeMd.trim() === "yes") {
|
||||
log("info", "[ECC] Found CLAUDE.md - loading project context")
|
||||
}
|
||||
} catch {
|
||||
// No CLAUDE.md found
|
||||
if (hasProjectFile("CLAUDE.md")) {
|
||||
log("info", "[ECC] Found CLAUDE.md - loading project context")
|
||||
}
|
||||
},
|
||||
|
||||
@@ -400,7 +403,7 @@ export const ECCHooksPlugin: ECCHooksPluginFn = async ({
|
||||
ECC_PLUGIN: "true",
|
||||
ECC_HOOK_PROFILE: currentProfile,
|
||||
ECC_DISABLED_HOOKS: process.env.ECC_DISABLED_HOOKS || "",
|
||||
PROJECT_ROOT: worktree || directory,
|
||||
PROJECT_ROOT: worktreePath,
|
||||
}
|
||||
|
||||
// Detect package manager
|
||||
@@ -411,12 +414,9 @@ export const ECCHooksPlugin: ECCHooksPluginFn = async ({
|
||||
"package-lock.json": "npm",
|
||||
}
|
||||
for (const [lockfile, pm] of Object.entries(lockfiles)) {
|
||||
try {
|
||||
await $`test -f ${worktree}/${lockfile}`
|
||||
if (hasProjectFile(lockfile)) {
|
||||
env.PACKAGE_MANAGER = pm
|
||||
break
|
||||
} catch {
|
||||
// Not found, try next
|
||||
}
|
||||
}
|
||||
|
||||
@@ -430,11 +430,8 @@ export const ECCHooksPlugin: ECCHooksPluginFn = async ({
|
||||
}
|
||||
const detected: string[] = []
|
||||
for (const [file, lang] of Object.entries(langDetectors)) {
|
||||
try {
|
||||
await $`test -f ${worktree}/${file}`
|
||||
if (hasProjectFile(file)) {
|
||||
detected.push(lang)
|
||||
} catch {
|
||||
// Not found
|
||||
}
|
||||
}
|
||||
if (detected.length > 0) {
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Everything Claude Code (ECC) — Agent Instructions
|
||||
|
||||
This is a **production-ready AI coding plugin** providing 48 specialized agents, 184 skills, 79 commands, and automated hook workflows for software development.
|
||||
This is a **production-ready AI coding plugin** providing 48 specialized agents, 182 skills, 68 commands, and automated hook workflows for software development.
|
||||
|
||||
**Version:** 2.0.0-rc.1
|
||||
|
||||
@@ -146,8 +146,8 @@ Troubleshoot failures: check test isolation → verify mocks → fix implementat
|
||||
|
||||
```
|
||||
agents/ — 48 specialized subagents
|
||||
skills/ — 184 workflow skills and domain knowledge
|
||||
commands/ — 79 slash commands
|
||||
skills/ — 182 workflow skills and domain knowledge
|
||||
commands/ — 68 slash commands
|
||||
hooks/ — Trigger-based automations
|
||||
rules/ — Always-follow guidelines (common + per-language)
|
||||
scripts/ — Cross-platform Node.js utilities
|
||||
|
||||
215
README.md
215
README.md
@@ -89,7 +89,7 @@ This repo is the raw code only. The guides explain everything.
|
||||
### v2.0.0-rc.1 — Surface Refresh, Operator Workflows, and ECC 2.0 Alpha (Apr 2026)
|
||||
|
||||
- **Dashboard GUI** — New Tkinter-based desktop application (`ecc_dashboard.py` or `npm run dashboard`) with dark/light theme toggle, font customization, and project logo in header and taskbar.
|
||||
- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 38 agents, 156 skills, and 72 legacy command shims.
|
||||
- **Public surface synced to the live repo** — metadata, catalog counts, plugin manifests, and install-facing docs now match the actual OSS surface: 48 agents, 182 skills, and 68 legacy command shims.
|
||||
- **Operator and outbound workflow expansion** — `brand-voice`, `social-graph-ranker`, `connections-optimizer`, `customer-billing-ops`, `ecc-tools-cost-audit`, `google-workspace-ops`, `project-flow-ops`, and `workspace-surface-audit` round out the operator lane.
|
||||
- **Media and launch tooling** — `manim-video`, `remotion-video-creation`, and upgraded social publishing surfaces make technical explainers and launch content part of the same system.
|
||||
- **Framework and product surface growth** — `nestjs-patterns`, richer Codex/OpenCode install surfaces, and expanded cross-harness packaging keep the repo usable beyond Claude Code alone.
|
||||
@@ -179,6 +179,44 @@ Most Claude Code users should use exactly one install path:
|
||||
|
||||
If you already layered multiple installs and things look duplicated, skip straight to [Reset / Uninstall ECC](#reset--uninstall-ecc).
|
||||
|
||||
### Low-context / no-hooks path
|
||||
|
||||
If hooks feel too global or you only want ECC's rules, agents, commands, and core workflow skills, skip the plugin and use the minimal manual profile:
|
||||
|
||||
```bash
|
||||
./install.sh --profile minimal --target claude
|
||||
```
|
||||
|
||||
```powershell
|
||||
.\install.ps1 --profile minimal --target claude
|
||||
# or
|
||||
npx ecc-install --profile minimal --target claude
|
||||
```
|
||||
|
||||
This profile intentionally excludes `hooks-runtime`.
|
||||
|
||||
If you want the normal core profile but need hooks off, use:
|
||||
|
||||
```bash
|
||||
./install.sh --profile core --without baseline:hooks --target claude
|
||||
```
|
||||
|
||||
Add hooks later only if you want runtime enforcement:
|
||||
|
||||
```bash
|
||||
./install.sh --target claude --modules hooks-runtime
|
||||
```
|
||||
|
||||
### Find the right components first
|
||||
|
||||
If you are not sure which ECC profile or component to install, ask the packaged advisor from any project:
|
||||
|
||||
```bash
|
||||
npx ecc consult "security reviews" --target claude
|
||||
```
|
||||
|
||||
It returns matching components, related profiles, and preview/install commands. Use the preview command before installing if you want to inspect the exact file plan.
|
||||
|
||||
### Step 1: Install the Plugin (Recommended)
|
||||
|
||||
> NOTE: The plugin is convenient, but the OSS installer below is still the most reliable path if your Claude Code build has trouble resolving self-hosted marketplace entries.
|
||||
@@ -207,7 +245,7 @@ This is intentional. Anthropic marketplace/plugin installs are keyed by a canoni
|
||||
>
|
||||
> If you already installed ECC via `/plugin install`, **do not run `./install.sh --profile full`, `.\install.ps1 --profile full`, or `npx ecc-install --profile full` afterward**. The plugin already loads ECC skills, commands, and hooks. Running the full installer after a plugin install copies those same surfaces into your user directories and can create duplicate skills plus duplicate runtime behavior.
|
||||
>
|
||||
> For plugin installs, manually copy only the `rules/` directories you want. Start with `rules/common` plus one language or framework pack you actually use. Do not copy every rules directory unless you explicitly want all of that context in Claude.
|
||||
> For plugin installs, manually copy only the `rules/` directories you want under `~/.claude/rules/ecc/`. Start with `rules/common` plus one language or framework pack you actually use. Do not copy every rules directory unless you explicitly want all of that context in Claude.
|
||||
>
|
||||
> Use the full installer only when you are doing a fully manual ECC install instead of the plugin path.
|
||||
>
|
||||
@@ -221,10 +259,10 @@ cd everything-claude-code
|
||||
# Install dependencies (pick your package manager)
|
||||
npm install # or: pnpm install | yarn install | bun install
|
||||
|
||||
# Plugin install path: copy only rules
|
||||
mkdir -p ~/.claude/rules
|
||||
cp -R rules/common ~/.claude/rules/
|
||||
cp -R rules/typescript ~/.claude/rules/
|
||||
# Plugin install path: copy only ECC rules into an ECC-owned namespace
|
||||
mkdir -p ~/.claude/rules/ecc
|
||||
cp -R rules/common ~/.claude/rules/ecc/
|
||||
cp -R rules/typescript ~/.claude/rules/ecc/
|
||||
|
||||
# Fully manual ECC install path (use this instead of /plugin install)
|
||||
# ./install.sh --profile full
|
||||
@@ -233,10 +271,10 @@ cp -R rules/typescript ~/.claude/rules/
|
||||
```powershell
|
||||
# Windows PowerShell
|
||||
|
||||
# Plugin install path: copy only rules
|
||||
New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules" | Out-Null
|
||||
Copy-Item -Recurse rules/common "$HOME/.claude/rules/"
|
||||
Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"
|
||||
# Plugin install path: copy only ECC rules into an ECC-owned namespace
|
||||
New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules/ecc" | Out-Null
|
||||
Copy-Item -Recurse rules/common "$HOME/.claude/rules/ecc/"
|
||||
Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/ecc/"
|
||||
|
||||
# Fully manual ECC install path (use this instead of /plugin install)
|
||||
# .\install.ps1 --profile full
|
||||
@@ -265,7 +303,7 @@ If you choose this path, stop there. Do not also run `/plugin install`.
|
||||
|
||||
If ECC feels duplicated, intrusive, or broken, do not keep reinstalling it on top of itself.
|
||||
|
||||
- **Plugin path:** remove the plugin from Claude Code, then delete the specific rule folders you manually copied under `~/.claude/rules/`.
|
||||
- **Plugin path:** remove the plugin from Claude Code, then delete the specific rule folders you manually copied under `~/.claude/rules/ecc/`.
|
||||
- **Manual installer / CLI path:** from the repo root, preview removal first:
|
||||
|
||||
```bash
|
||||
@@ -302,8 +340,8 @@ If you stacked methods, clean up in this order:
|
||||
# Skills are the primary workflow surface.
|
||||
# Existing slash-style command names still work while ECC migrates off commands/.
|
||||
|
||||
# Plugin install uses the namespaced form
|
||||
/ecc:plan "Add user authentication"
|
||||
# Plugin install uses the canonical namespaced form
|
||||
/everything-claude-code:plan "Add user authentication"
|
||||
|
||||
# Manual install keeps the shorter slash form:
|
||||
# /plan "Add user authentication"
|
||||
@@ -312,7 +350,7 @@ If you stacked methods, clean up in this order:
|
||||
/plugin list everything-claude-code@everything-claude-code
|
||||
```
|
||||
|
||||
**That's it!** You now have access to 48 agents, 184 skills, and 79 legacy command shims.
|
||||
**That's it!** You now have access to 48 agents, 182 skills, and 68 legacy command shims.
|
||||
|
||||
### Dashboard GUI
|
||||
|
||||
@@ -390,6 +428,12 @@ export ECC_HOOK_PROFILE=standard
|
||||
|
||||
# Comma-separated hook IDs to disable
|
||||
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
|
||||
|
||||
# Cap SessionStart additional context (default: 8000 chars)
|
||||
export ECC_SESSION_START_MAX_CHARS=4000
|
||||
|
||||
# Disable SessionStart additional context entirely for low-context/local-model setups
|
||||
export ECC_SESSION_START_CONTEXT=off
|
||||
```
|
||||
|
||||
---
|
||||
@@ -499,17 +543,15 @@ everything-claude-code/
|
||||
| |-- autonomous-loops/ # Autonomous loop patterns: sequential pipelines, PR loops, DAG orchestration (NEW)
|
||||
| |-- plankton-code-quality/ # Write-time code quality enforcement with Plankton hooks (NEW)
|
||||
|
|
||||
|-- commands/ # Legacy slash-entry shims; prefer skills/
|
||||
| |-- tdd.md # /tdd - Test-driven development
|
||||
|-- commands/ # Maintained slash-entry compatibility; prefer skills/
|
||||
| |-- plan.md # /plan - Implementation planning
|
||||
| |-- e2e.md # /e2e - E2E test generation
|
||||
| |-- code-review.md # /code-review - Quality review
|
||||
| |-- build-fix.md # /build-fix - Fix build errors
|
||||
| |-- refactor-clean.md # /refactor-clean - Dead code removal
|
||||
| |-- quality-gate.md # /quality-gate - Verification gate
|
||||
| |-- learn.md # /learn - Extract patterns mid-session (Longform Guide)
|
||||
| |-- learn-eval.md # /learn-eval - Extract, evaluate, and save patterns (NEW)
|
||||
| |-- checkpoint.md # /checkpoint - Save verification state (Longform Guide)
|
||||
| |-- verify.md # /verify - Run verification loop (Longform Guide)
|
||||
| |-- setup-pm.md # /setup-pm - Configure package manager
|
||||
| |-- go-review.md # /go-review - Go code review (NEW)
|
||||
| |-- go-test.md # /go-test - Go TDD workflow (NEW)
|
||||
@@ -526,15 +568,19 @@ everything-claude-code/
|
||||
| |-- multi-backend.md # /multi-backend - Backend multi-service orchestration (NEW)
|
||||
| |-- multi-frontend.md # /multi-frontend - Frontend multi-service orchestration (NEW)
|
||||
| |-- multi-workflow.md # /multi-workflow - General multi-service workflows (NEW)
|
||||
| |-- orchestrate.md # /orchestrate - Multi-agent coordination
|
||||
| |-- sessions.md # /sessions - Session history management
|
||||
| |-- eval.md # /eval - Evaluate against criteria
|
||||
| |-- test-coverage.md # /test-coverage - Test coverage analysis
|
||||
| |-- update-docs.md # /update-docs - Update documentation
|
||||
| |-- update-codemaps.md # /update-codemaps - Update codemaps
|
||||
| |-- python-review.md # /python-review - Python code review (NEW)
|
||||
|-- legacy-command-shims/ # Opt-in archive for retired shims such as /tdd and /eval
|
||||
| |-- tdd.md # /tdd - Prefer the tdd-workflow skill
|
||||
| |-- e2e.md # /e2e - Prefer the e2e-testing skill
|
||||
| |-- eval.md # /eval - Prefer the eval-harness skill
|
||||
| |-- verify.md # /verify - Prefer the verification-loop skill
|
||||
| |-- orchestrate.md # /orchestrate - Prefer dmux-workflows or multi-workflow
|
||||
|
|
||||
|-- rules/ # Always-follow guidelines (copy to ~/.claude/rules/)
|
||||
|-- rules/ # Always-follow guidelines (copy to ~/.claude/rules/ecc/)
|
||||
| |-- README.md # Structure overview and installation guide
|
||||
| |-- common/ # Language-agnostic principles
|
||||
| | |-- coding-style.md # Immutability, file organization
|
||||
@@ -751,17 +797,17 @@ This gives you instant access to all commands, agents, skills, and hooks.
|
||||
> git clone https://github.com/affaan-m/everything-claude-code.git
|
||||
>
|
||||
> # Option A: User-level rules (applies to all projects)
|
||||
> mkdir -p ~/.claude/rules
|
||||
> cp -r everything-claude-code/rules/common ~/.claude/rules/
|
||||
> cp -r everything-claude-code/rules/typescript ~/.claude/rules/ # pick your stack
|
||||
> cp -r everything-claude-code/rules/python ~/.claude/rules/
|
||||
> cp -r everything-claude-code/rules/golang ~/.claude/rules/
|
||||
> cp -r everything-claude-code/rules/php ~/.claude/rules/
|
||||
> mkdir -p ~/.claude/rules/ecc
|
||||
> cp -r everything-claude-code/rules/common ~/.claude/rules/ecc/
|
||||
> cp -r everything-claude-code/rules/typescript ~/.claude/rules/ecc/ # pick your stack
|
||||
> cp -r everything-claude-code/rules/python ~/.claude/rules/ecc/
|
||||
> cp -r everything-claude-code/rules/golang ~/.claude/rules/ecc/
|
||||
> cp -r everything-claude-code/rules/php ~/.claude/rules/ecc/
|
||||
>
|
||||
> # Option B: Project-level rules (applies to current project only)
|
||||
> mkdir -p .claude/rules
|
||||
> cp -r everything-claude-code/rules/common .claude/rules/
|
||||
> cp -r everything-claude-code/rules/typescript .claude/rules/ # pick your stack
|
||||
> mkdir -p .claude/rules/ecc
|
||||
> cp -r everything-claude-code/rules/common .claude/rules/ecc/
|
||||
> cp -r everything-claude-code/rules/typescript .claude/rules/ecc/ # pick your stack
|
||||
> ```
|
||||
|
||||
---
|
||||
@@ -778,26 +824,30 @@ git clone https://github.com/affaan-m/everything-claude-code.git
|
||||
cp everything-claude-code/agents/*.md ~/.claude/agents/
|
||||
|
||||
# Copy rules directories (common + language-specific)
|
||||
mkdir -p ~/.claude/rules
|
||||
cp -r everything-claude-code/rules/common ~/.claude/rules/
|
||||
cp -r everything-claude-code/rules/typescript ~/.claude/rules/ # pick your stack
|
||||
cp -r everything-claude-code/rules/python ~/.claude/rules/
|
||||
cp -r everything-claude-code/rules/golang ~/.claude/rules/
|
||||
cp -r everything-claude-code/rules/php ~/.claude/rules/
|
||||
mkdir -p ~/.claude/rules/ecc
|
||||
cp -r everything-claude-code/rules/common ~/.claude/rules/ecc/
|
||||
cp -r everything-claude-code/rules/typescript ~/.claude/rules/ecc/ # pick your stack
|
||||
cp -r everything-claude-code/rules/python ~/.claude/rules/ecc/
|
||||
cp -r everything-claude-code/rules/golang ~/.claude/rules/ecc/
|
||||
cp -r everything-claude-code/rules/php ~/.claude/rules/ecc/
|
||||
|
||||
# Copy skills first (primary workflow surface)
|
||||
# Recommended (new users): core/general skills only
|
||||
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
|
||||
cp -r everything-claude-code/skills/search-first ~/.claude/skills/
|
||||
mkdir -p ~/.claude/skills/ecc
|
||||
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/ecc/
|
||||
cp -r everything-claude-code/skills/search-first ~/.claude/skills/ecc/
|
||||
|
||||
# Optional: add niche/framework-specific skills only when needed
|
||||
# for s in django-patterns django-tdd laravel-patterns springboot-patterns; do
|
||||
# cp -r everything-claude-code/skills/$s ~/.claude/skills/
|
||||
# cp -r everything-claude-code/skills/$s ~/.claude/skills/ecc/
|
||||
# done
|
||||
|
||||
# Optional: keep legacy slash-command compatibility during migration
|
||||
# Optional: keep maintained slash-command compatibility during migration
|
||||
mkdir -p ~/.claude/commands
|
||||
cp everything-claude-code/commands/*.md ~/.claude/commands/
|
||||
|
||||
# Retired shims live in legacy-command-shims/commands/.
|
||||
# Copy individual files from there only if you still need old names such as /tdd.
|
||||
```
|
||||
|
||||
#### Install hooks
|
||||
@@ -824,7 +874,11 @@ Windows note: the Claude config directory is `%USERPROFILE%\\.claude`, not `~/cl
|
||||
|
||||
#### Configure MCPs
|
||||
|
||||
Copy desired MCP server definitions from `mcp-configs/mcp-servers.json` into your official Claude Code config in `~/.claude/settings.json`, or into a project-scoped `.mcp.json` if you want repo-local MCP access.
|
||||
Claude plugin installs intentionally do not auto-enable ECC's bundled MCP server definitions. This avoids overlong plugin MCP tool names on strict third-party gateways while keeping manual MCP setup available.
|
||||
|
||||
Use Claude Code's `/mcp` command or CLI-managed MCP setup for live Claude Code server changes. Use `/mcp` for Claude Code runtime disables; Claude Code persists those choices in `~/.claude.json`.
|
||||
|
||||
For repo-local MCP access, copy desired MCP server definitions from `mcp-configs/mcp-servers.json` into a project-scoped `.mcp.json`.
|
||||
|
||||
If you already run your own copies of ECC-bundled MCPs, set:
|
||||
|
||||
@@ -832,7 +886,7 @@ If you already run your own copies of ECC-bundled MCPs, set:
|
||||
export ECC_DISABLED_MCPS="github,context7,exa,playwright,sequential-thinking,memory"
|
||||
```
|
||||
|
||||
ECC-managed install and Codex sync flows will skip or remove those bundled servers instead of re-adding duplicates.
|
||||
ECC-managed install and Codex sync flows will skip or remove those bundled servers instead of re-adding duplicates. `ECC_DISABLED_MCPS` is an ECC install/sync filter, not a live Claude Code toggle.
|
||||
|
||||
**Important:** Replace `YOUR_*_HERE` placeholders with your actual API keys.
|
||||
|
||||
@@ -857,7 +911,7 @@ You are a senior code reviewer...
|
||||
|
||||
### Skills
|
||||
|
||||
Skills are the primary workflow surface. They can be invoked directly, suggested automatically, and reused by agents. ECC still ships `commands/` during migration, but new workflow development should land in `skills/` first.
|
||||
Skills are the primary workflow surface. They can be invoked directly, suggested automatically, and reused by agents. ECC still ships maintained `commands/` during migration, while retired short-name shims live under `legacy-command-shims/` for explicit opt-in only. New workflow development should land in `skills/` first.
|
||||
|
||||
```markdown
|
||||
# TDD Workflow
|
||||
@@ -903,16 +957,16 @@ See [`rules/README.md`](rules/README.md) for installation and structure details.
|
||||
|
||||
## Which Agent Should I Use?
|
||||
|
||||
Not sure where to start? Use this quick reference. Skills are the canonical workflow surface; slash entries below are the compatibility form most users already know.
|
||||
Not sure where to start? Use this quick reference. Skills are the canonical workflow surface; maintained slash entries stay available for command-first workflows.
|
||||
|
||||
| I want to... | Use this command | Agent used |
|
||||
| I want to... | Use this surface | Agent used |
|
||||
|--------------|-----------------|------------|
|
||||
| Plan a new feature | `/ecc:plan "Add auth"` | planner |
|
||||
| Design system architecture | `/ecc:plan` + architect agent | architect |
|
||||
| Write code with tests first | `/tdd` | tdd-guide |
|
||||
| Plan a new feature | `/everything-claude-code:plan "Add auth"` | planner |
|
||||
| Design system architecture | `/everything-claude-code:plan` + architect agent | architect |
|
||||
| Write code with tests first | `tdd-workflow` skill | tdd-guide |
|
||||
| Review code I just wrote | `/code-review` | code-reviewer |
|
||||
| Fix a failing build | `/build-fix` | build-error-resolver |
|
||||
| Run end-to-end tests | `/e2e` | e2e-runner |
|
||||
| Run end-to-end tests | `e2e-testing` skill | e2e-runner |
|
||||
| Find security vulnerabilities | `/security-scan` | security-reviewer |
|
||||
| Remove dead code | `/refactor-clean` | refactor-cleaner |
|
||||
| Update documentation | `/update-docs` | doc-updater |
|
||||
@@ -923,19 +977,19 @@ Not sure where to start? Use this quick reference. Skills are the canonical work
|
||||
|
||||
### Common Workflows
|
||||
|
||||
Slash forms below are shown because they are still the fastest familiar entrypoint. Under the hood, ECC is shifting these workflows toward skills-first definitions.
|
||||
Slash forms below are shown where they remain part of the maintained command surface. Retired short-name shims such as `/tdd` and `/eval` live in `legacy-command-shims/` for explicit opt-in only.
|
||||
|
||||
**Starting a new feature:**
|
||||
```
|
||||
/ecc:plan "Add user authentication with OAuth"
|
||||
/everything-claude-code:plan "Add user authentication with OAuth"
|
||||
→ planner creates implementation blueprint
|
||||
/tdd → tdd-guide enforces write-tests-first
|
||||
tdd-workflow skill → tdd-guide enforces write-tests-first
|
||||
/code-review → code-reviewer checks your work
|
||||
```
|
||||
|
||||
**Fixing a bug:**
|
||||
```
|
||||
/tdd → tdd-guide: write a failing test that reproduces it
|
||||
tdd-workflow skill → tdd-guide: write a failing test that reproduces it
|
||||
→ implement the fix, verify test passes
|
||||
/code-review → code-reviewer: catch regressions
|
||||
```
|
||||
@@ -943,7 +997,7 @@ Slash forms below are shown because they are still the fastest familiar entrypoi
|
||||
**Preparing for production:**
|
||||
```
|
||||
/security-scan → security-reviewer: OWASP Top 10 audit
|
||||
/e2e → e2e-runner: critical user flow tests
|
||||
e2e-testing skill → e2e-runner: critical user flow tests
|
||||
/test-coverage → verify 80%+ coverage
|
||||
```
|
||||
|
||||
@@ -995,15 +1049,9 @@ Official references:
|
||||
<details>
|
||||
<summary><b>My context window is shrinking / Claude is running out of context</b></summary>
|
||||
|
||||
Too many MCP servers eat your context. Each MCP tool description consumes tokens from your 200k window, potentially reducing it to ~70k.
|
||||
Too many MCP servers eat your context. Each MCP tool description consumes tokens from your 200k window, potentially reducing it to ~70k. SessionStart context is capped at 8000 characters by default; lower it with `ECC_SESSION_START_MAX_CHARS=4000` or disable it with `ECC_SESSION_START_CONTEXT=off` for local-model or low-context setups.
|
||||
|
||||
**Fix:** Disable unused MCPs per project:
|
||||
```json
|
||||
// In your project's .claude/settings.json
|
||||
{
|
||||
"disabledMcpServers": ["supabase", "railway", "vercel"]
|
||||
}
|
||||
```
|
||||
**Fix:** Disable unused MCPs from Claude Code with `/mcp`. Claude Code writes those runtime choices to `~/.claude.json`; `.claude/settings.json` and `.claude/settings.local.json` are not reliable toggles for already-loaded MCP servers.
|
||||
|
||||
Keep under 10 MCPs enabled and under 80 tools active.
|
||||
</details>
|
||||
@@ -1018,8 +1066,8 @@ Yes. Use Option 2 (manual installation) and copy only what you need:
|
||||
cp everything-claude-code/agents/*.md ~/.claude/agents/
|
||||
|
||||
# Just rules
|
||||
mkdir -p ~/.claude/rules/
|
||||
cp -r everything-claude-code/rules/common ~/.claude/rules/
|
||||
mkdir -p ~/.claude/rules/ecc/
|
||||
cp -r everything-claude-code/rules/common ~/.claude/rules/ecc/
|
||||
```
|
||||
|
||||
Each component is fully independent.
|
||||
@@ -1098,7 +1146,7 @@ These are not bundled with ECC and are not audited by this repo, but they are wo
|
||||
|
||||
## Cursor IDE Support
|
||||
|
||||
ECC provides **full Cursor IDE support** with hooks, rules, agents, skills, commands, and MCP configs adapted for Cursor's native format.
|
||||
ECC provides Cursor IDE support with hooks, rules, agents, skills, commands, and MCP configs adapted for Cursor's project layout.
|
||||
|
||||
### Quick Start (Cursor)
|
||||
|
||||
@@ -1121,11 +1169,17 @@ ECC provides **full Cursor IDE support** with hooks, rules, agents, skills, comm
|
||||
| Hook Events | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt, and 10 more |
|
||||
| Hook Scripts | 16 | Thin Node.js scripts delegating to `scripts/hooks/` via shared adapter |
|
||||
| Rules | 34 | 9 common (alwaysApply) + 25 language-specific (TypeScript, Python, Go, Swift, PHP) |
|
||||
| Agents | Shared | Via AGENTS.md at root (read by Cursor natively) |
|
||||
| Skills | Shared + Bundled | Via AGENTS.md at root and `.cursor/skills/` for translated additions |
|
||||
| Agents | 48 | `.cursor/agents/ecc-*.md` when installed; prefixed to avoid collisions with user or marketplace agents |
|
||||
| Skills | Shared + Bundled | `.cursor/skills/` for translated additions |
|
||||
| Commands | Shared | `.cursor/commands/` if installed |
|
||||
| MCP Config | Shared | `.cursor/mcp.json` if installed |
|
||||
|
||||
### Cursor Loading Notes
|
||||
|
||||
ECC does not install root `AGENTS.md` into `.cursor/`. Cursor treats nested `AGENTS.md` files as directory context, so copying ECC's repo identity into a host project would pollute that project.
|
||||
|
||||
Cursor-native loading behavior can vary by Cursor build. ECC installs agents as `.cursor/agents/ecc-*.md`; if your Cursor build does not expose project agents, those files still work as explicit reference definitions instead of hidden global prompt context.
|
||||
|
||||
### Hook Architecture (DRY Adapter Pattern)
|
||||
|
||||
Cursor has **more hook events than Claude Code** (20 vs 8). The `.cursor/hooks/adapter.js` module transforms Cursor's stdin JSON to Claude Code's format, allowing existing `scripts/hooks/*.js` to be reused without duplication.
|
||||
@@ -1193,7 +1247,7 @@ Codex macOS app:
|
||||
|-----------|-------|---------|
|
||||
| Config | 1 | `.codex/config.toml` — top-level approvals/sandbox/web_search, MCP servers, notifications, profiles |
|
||||
| AGENTS.md | 2 | Root (universal) + `.codex/AGENTS.md` (Codex-specific supplement) |
|
||||
| Skills | 30 | `.agents/skills/` — SKILL.md + agents/openai.yaml per skill |
|
||||
| Skills | 32 | `.agents/skills/` — SKILL.md + agents/openai.yaml per skill |
|
||||
| MCP Servers | 6 | GitHub, Context7, Exa, Memory, Playwright, Sequential Thinking (7 with Supabase via `--update-mcp` sync) |
|
||||
| Profiles | 2 | `strict` (read-only sandbox) and `yolo` (full auto-approve) |
|
||||
| Agent Roles | 3 | `.codex/agents/` — explorer, reviewer, docs-researcher |
|
||||
@@ -1202,14 +1256,17 @@ Codex macOS app:
|
||||
|
||||
Skills at `.agents/skills/` are auto-loaded by Codex:
|
||||
|
||||
Canonical Anthropic skills such as `claude-api`, `frontend-design`, and `skill-creator` are intentionally not re-bundled here. Install those from [`anthropics/skills`](https://github.com/anthropics/skills) when you want the official versions.
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| agent-introspection-debugging | Debug agent behavior, routing, and prompt boundaries |
|
||||
| agent-sort | Sort agent catalogs and assignment surfaces |
|
||||
| api-design | REST API design patterns |
|
||||
| article-writing | Long-form writing from notes and voice references |
|
||||
| backend-patterns | API design, database, caching |
|
||||
| brand-voice | Source-derived writing style profiles from real content |
|
||||
| bun-runtime | Bun as runtime, package manager, bundler, and test runner |
|
||||
| claude-api | Anthropic Claude API patterns for Python and TypeScript |
|
||||
| coding-standards | Universal coding standards |
|
||||
| content-engine | Platform-native social content and repurposing |
|
||||
| crosspost | Multi-platform content distribution across X, LinkedIn, Threads |
|
||||
@@ -1228,6 +1285,7 @@ Skills at `.agents/skills/` are auto-loaded by Codex:
|
||||
| market-research | Source-attributed market and competitor research |
|
||||
| mcp-server-patterns | Build MCP servers with Node/TypeScript SDK |
|
||||
| nextjs-turbopack | Next.js 16+ and Turbopack incremental bundling |
|
||||
| product-capability | Translate product goals into scoped capability maps |
|
||||
| security-review | Comprehensive security checklist |
|
||||
| strategic-compact | Context management |
|
||||
| tdd-workflow | Test-driven development with 80%+ coverage |
|
||||
@@ -1279,8 +1337,8 @@ The configuration is automatically detected from `.opencode/opencode.json`.
|
||||
| Feature | Claude Code | OpenCode | Status |
|
||||
|---------|-------------|----------|--------|
|
||||
| Agents | PASS: 48 agents | PASS: 12 agents | **Claude Code leads** |
|
||||
| Commands | PASS: 79 commands | PASS: 31 commands | **Claude Code leads** |
|
||||
| Skills | PASS: 184 skills | PASS: 37 skills | **Claude Code leads** |
|
||||
| Commands | PASS: 68 commands | PASS: 31 commands | **Claude Code leads** |
|
||||
| Skills | PASS: 182 skills | PASS: 37 skills | **Claude Code leads** |
|
||||
| Hooks | PASS: 8 event types | PASS: 11 events | **OpenCode has more!** |
|
||||
| Rules | PASS: 29 rules | PASS: 13 instructions | **Claude Code leads** |
|
||||
| MCP Servers | PASS: 14 servers | PASS: Full | **Full parity** |
|
||||
@@ -1300,21 +1358,17 @@ OpenCode's plugin system is MORE sophisticated than Claude Code with 20+ event t
|
||||
|
||||
**Additional OpenCode events**: `file.edited`, `file.watcher.updated`, `message.updated`, `lsp.client.diagnostics`, `tui.toast.show`, and more.
|
||||
|
||||
### Available Slash Entry Shims (31+)
|
||||
### Maintained Slash Entries
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/plan` | Create implementation plan |
|
||||
| `/tdd` | Enforce TDD workflow |
|
||||
| `/code-review` | Review code changes |
|
||||
| `/build-fix` | Fix build errors |
|
||||
| `/e2e` | Generate E2E tests |
|
||||
| `/refactor-clean` | Remove dead code |
|
||||
| `/orchestrate` | Multi-agent workflow |
|
||||
| `/learn` | Extract patterns from session |
|
||||
| `/checkpoint` | Save verification state |
|
||||
| `/verify` | Run verification loop |
|
||||
| `/eval` | Evaluate against criteria |
|
||||
| `/quality-gate` | Run the maintained verification gate |
|
||||
| `/update-docs` | Update documentation |
|
||||
| `/update-codemaps` | Update codemaps |
|
||||
| `/test-coverage` | Analyze coverage |
|
||||
@@ -1388,8 +1442,8 @@ ECC is the **first plugin to maximize every major AI coding tool**. Here's how e
|
||||
| Feature | Claude Code | Cursor IDE | Codex CLI | OpenCode |
|
||||
|---------|------------|------------|-----------|----------|
|
||||
| **Agents** | 48 | Shared (AGENTS.md) | Shared (AGENTS.md) | 12 |
|
||||
| **Commands** | 79 | Shared | Instruction-based | 31 |
|
||||
| **Skills** | 184 | Shared | 10 (native format) | 37 |
|
||||
| **Commands** | 68 | Shared | Instruction-based | 31 |
|
||||
| **Skills** | 182 | Shared | 10 (native format) | 37 |
|
||||
| **Hook Events** | 8 types | 15 types | None yet | 11 types |
|
||||
| **Hook Scripts** | 20+ scripts | 16 scripts (DRY adapter) | N/A | Plugin hooks |
|
||||
| **Rules** | 34 (common + lang) | 34 (YAML frontmatter) | Instruction-based | 13 instructions |
|
||||
@@ -1475,7 +1529,8 @@ The `strategic-compact` skill (included in this plugin) suggests `/compact` at l
|
||||
|
||||
- Keep under 10 MCPs enabled per project
|
||||
- Keep under 80 tools active
|
||||
- Use `disabledMcpServers` in project config to disable unused ones
|
||||
- Use `/mcp` to disable unused Claude Code MCP servers; those runtime choices persist in `~/.claude.json`
|
||||
- Use `ECC_DISABLED_MCPS` only to filter ECC-generated MCP configs during install/sync flows
|
||||
|
||||
### Agent Teams Cost Warning
|
||||
|
||||
|
||||
@@ -151,7 +151,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"
|
||||
|
||||
```bash
|
||||
# 尝试一个命令(插件安装使用命名空间形式)
|
||||
/ecc:plan "添加用户认证"
|
||||
/everything-claude-code:plan "添加用户认证"
|
||||
|
||||
# 手动安装(选项2)使用简短形式:
|
||||
# /plan "添加用户认证"
|
||||
@@ -160,7 +160,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"
|
||||
/plugin list everything-claude-code@everything-claude-code
|
||||
```
|
||||
|
||||
**完成!** 你现在可以使用 48 个代理、184 个技能和 79 个命令。
|
||||
**完成!** 你现在可以使用 48 个代理、182 个技能和 68 个命令。
|
||||
|
||||
### multi-* 命令需要额外配置
|
||||
|
||||
@@ -330,17 +330,15 @@ everything-claude-code/
|
||||
| |-- autonomous-loops/ # 自主循环模式:顺序流水线、PR 循环、DAG 编排(新增)
|
||||
| |-- plankton-code-quality/ # 基于 Plankton 钩子的实时代码质量管控(新增)
|
||||
|
|
||||
|-- commands/ # 传统斜杠命令兼容层;优先使用 skills/
|
||||
| |-- tdd.md # /tdd - 测试驱动开发
|
||||
|-- commands/ # 维护中的斜杠命令兼容层;优先使用 skills/
|
||||
| |-- plan.md # /plan - 实现规划
|
||||
| |-- e2e.md # /e2e - 生成端到端测试
|
||||
| |-- code-review.md # /code-review - 代码质量审查
|
||||
| |-- build-fix.md # /build-fix - 修复构建错误
|
||||
| |-- quality-gate.md # /quality-gate - 验证门禁
|
||||
| |-- refactor-clean.md # /refactor-clean - 清理无效代码
|
||||
| |-- learn.md # /learn - 会话中提取模式(长文本指南)
|
||||
| |-- learn-eval.md # /learn-eval - 提取、评估并保存模式(新增)
|
||||
| |-- checkpoint.md # /checkpoint - 保存验证状态(长文本指南)
|
||||
| |-- verify.md # /verify - 运行验证循环(长文本指南)
|
||||
| |-- setup-pm.md # /setup-pm - 配置包管理器
|
||||
| |-- go-review.md # /go-review - Go 代码审查(新增)
|
||||
| |-- go-test.md # /go-test - Go TDD 工作流(新增)
|
||||
@@ -357,13 +355,17 @@ everything-claude-code/
|
||||
| |-- multi-backend.md # /multi-backend - 后端多服务编排(新增)
|
||||
| |-- multi-frontend.md # /multi-frontend - 前端多服务编排(新增)
|
||||
| |-- multi-workflow.md # /multi-workflow - 通用多服务工作流(新增)
|
||||
| |-- orchestrate.md # /orchestrate - 多智能体协同调度
|
||||
| |-- sessions.md # /sessions - 会话历史管理
|
||||
| |-- eval.md # /eval - 按标准评估
|
||||
| |-- test-coverage.md # /test-coverage - 测试覆盖率分析
|
||||
| |-- update-docs.md # /update-docs - 更新文档
|
||||
| |-- update-codemaps.md # /update-codemaps - 更新代码映射
|
||||
| |-- python-review.md # /python-review - Python 代码审查(新增)
|
||||
|-- legacy-command-shims/ # 已退役短命令的按需归档,例如 /tdd 和 /eval
|
||||
| |-- tdd.md # /tdd - 优先使用 tdd-workflow 技能
|
||||
| |-- e2e.md # /e2e - 优先使用 e2e-testing 技能
|
||||
| |-- eval.md # /eval - 优先使用 eval-harness 技能
|
||||
| |-- verify.md # /verify - 优先使用 verification-loop 技能
|
||||
| |-- orchestrate.md # /orchestrate - 优先使用 dmux-workflows 或 multi-workflow
|
||||
|
|
||||
|-- rules/ # 必须遵守的规范(复制到 ~/.claude/rules/)
|
||||
| |-- README.md # 结构概览与安装指南
|
||||
@@ -618,9 +620,12 @@ cp -r everything-claude-code/skills/search-first ~/.claude/skills/
|
||||
# cp -r everything-claude-code/skills/$s ~/.claude/skills/
|
||||
# done
|
||||
|
||||
# 可选:迁移期间保留传统斜杠命令兼容
|
||||
# 可选:迁移期间保留维护中的斜杠命令兼容
|
||||
mkdir -p ~/.claude/commands
|
||||
cp everything-claude-code/commands/*.md ~/.claude/commands/
|
||||
|
||||
# 已退役短命令位于 legacy-command-shims/commands/。
|
||||
# 仅在仍需要 /tdd 等旧名称时,单独复制对应文件。
|
||||
```
|
||||
|
||||
#### 将钩子配置添加到 settings.json
|
||||
|
||||
14
agent.yaml
14
agent.yaml
@@ -28,7 +28,6 @@ skills:
|
||||
- canary-watch
|
||||
- carrier-relationship-management
|
||||
- ck
|
||||
- claude-api
|
||||
- claude-devfleet
|
||||
- click-path-audit
|
||||
- clickhouse-io
|
||||
@@ -144,20 +143,14 @@ skills:
|
||||
- visa-doc-translate
|
||||
- x-api
|
||||
commands:
|
||||
- agent-sort
|
||||
- aside
|
||||
- auto-update
|
||||
- build-fix
|
||||
- checkpoint
|
||||
- claw
|
||||
- code-review
|
||||
- context-budget
|
||||
- cpp-build
|
||||
- cpp-review
|
||||
- cpp-test
|
||||
- devfleet
|
||||
- docs
|
||||
- e2e
|
||||
- eval
|
||||
- evolve
|
||||
- feature-dev
|
||||
- flutter-build
|
||||
@@ -191,12 +184,10 @@ commands:
|
||||
- multi-frontend
|
||||
- multi-plan
|
||||
- multi-workflow
|
||||
- orchestrate
|
||||
- plan
|
||||
- pm2
|
||||
- projects
|
||||
- promote
|
||||
- prompt-optimize
|
||||
- prp-commit
|
||||
- prp-implement
|
||||
- prp-plan
|
||||
@@ -208,7 +199,6 @@ commands:
|
||||
- refactor-clean
|
||||
- resume-session
|
||||
- review-pr
|
||||
- rules-distill
|
||||
- rust-build
|
||||
- rust-review
|
||||
- rust-test
|
||||
@@ -218,11 +208,9 @@ commands:
|
||||
- setup-pm
|
||||
- skill-create
|
||||
- skill-health
|
||||
- tdd
|
||||
- test-coverage
|
||||
- update-codemaps
|
||||
- update-docs
|
||||
- verify
|
||||
tags:
|
||||
- agent-harness
|
||||
- developer-tools
|
||||
|
||||
28
commands/auto-update.md
Normal file
28
commands/auto-update.md
Normal file
@@ -0,0 +1,28 @@
|
||||
---
|
||||
description: Pull the latest ECC repo changes and reinstall the current managed targets.
|
||||
disable-model-invocation: true
|
||||
---
|
||||
|
||||
# Auto Update
|
||||
|
||||
Update ECC from its upstream repo and regenerate the current context's managed install using the original install-state request.
|
||||
|
||||
## Usage
|
||||
|
||||
```bash
|
||||
# Preview the update without mutating anything
|
||||
ECC_ROOT="${CLAUDE_PLUGIN_ROOT:-$(node -e "var r=(()=>{var e=process.env.CLAUDE_PLUGIN_ROOT;if(e&&e.trim())return e.trim();var p=require('path'),f=require('fs'),h=require('os').homedir(),d=p.join(h,'.claude'),q=p.join('scripts','lib','utils.js');if(f.existsSync(p.join(d,q)))return d;for(var s of [['ecc'],['ecc@ecc'],['marketplace','ecc'],['everything-claude-code'],['everything-claude-code@everything-claude-code'],['marketplace','everything-claude-code']]){var l=p.join(d,'plugins',...s);if(f.existsSync(p.join(l,q)))return l}try{for(var g of ['ecc','everything-claude-code']){var b=p.join(d,'plugins','cache',g);for(var o of f.readdirSync(b,{withFileTypes:true})){if(!o.isDirectory())continue;for(var v of f.readdirSync(p.join(b,o.name),{withFileTypes:true})){if(!v.isDirectory())continue;var c=p.join(b,o.name,v.name);if(f.existsSync(p.join(c,q)))return c}}}}catch(x){}return d})();console.log(r)")}"
|
||||
node "$ECC_ROOT/scripts/auto-update.js" --dry-run
|
||||
|
||||
# Update only Cursor-managed files in the current project
|
||||
node "$ECC_ROOT/scripts/auto-update.js" --target cursor
|
||||
|
||||
# Override the ECC repo root explicitly
|
||||
node "$ECC_ROOT/scripts/auto-update.js" --repo-root /path/to/everything-claude-code
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- This command uses the recorded install-state request and reruns `install-apply.js` after pulling the latest repo changes.
|
||||
- Reinstall is intentional: it handles upstream renames and deletions that `repair.js` cannot safely reconstruct from stale operations alone.
|
||||
- Use `--dry-run` first if you want to see the reconstructed reinstall plan before mutating anything.
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Detect the project build system and incrementally fix build/type errors with minimal safe changes.
|
||||
---
|
||||
|
||||
# Build and Fix
|
||||
|
||||
Incrementally fix build and type errors with minimal, safe changes.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Create, verify, or list workflow checkpoints after running verification checks.
|
||||
---
|
||||
|
||||
# Checkpoint Command
|
||||
|
||||
Create or verify a checkpoint in your workflow.
|
||||
|
||||
@@ -165,7 +165,7 @@ The agent will stop and report if:
|
||||
|
||||
- `/cpp-test` - Run tests after build succeeds
|
||||
- `/cpp-review` - Review code quality
|
||||
- `/verify` - Full verification loop
|
||||
- `verification-loop` skill - Full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -243,7 +243,7 @@ genhtml coverage.info --output-directory coverage_html
|
||||
|
||||
- `/cpp-build` - Fix build errors
|
||||
- `/cpp-review` - Review code after implementation
|
||||
- `/verify` - Run full verification loop
|
||||
- `verification-loop` skill - Run full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -156,7 +156,7 @@ The agent will stop and report if:
|
||||
|
||||
- `/flutter-test` — Run tests after build succeeds
|
||||
- `/flutter-review` — Review code quality
|
||||
- `/verify` — Full verification loop
|
||||
- `verification-loop` skill — Full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -134,7 +134,7 @@ Test Status: PASS ✓
|
||||
|
||||
- `/flutter-build` — Fix build errors before running tests
|
||||
- `/flutter-review` — Review code after tests pass
|
||||
- `/tdd` — Test-driven development workflow
|
||||
- `tdd-workflow` skill — Test-driven development workflow
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Run a generator/evaluator build loop for implementation tasks with bounded iterations and scoring.
|
||||
---
|
||||
|
||||
Parse the following from $ARGUMENTS:
|
||||
1. `brief` — the user's one-line description of what to build
|
||||
2. `--max-iterations N` — (optional, default 15) maximum generator-evaluator cycles
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Run a generator/evaluator design loop for frontend or visual work with bounded iterations and scoring.
|
||||
---
|
||||
|
||||
Parse the following from $ARGUMENTS:
|
||||
1. `brief` — the user's description of the design to create
|
||||
2. `--max-iterations N` — (optional, default 10) maximum design-evaluate cycles
|
||||
|
||||
@@ -175,7 +175,7 @@ The agent will stop and report if:
|
||||
|
||||
- `/go-test` - Run tests after build succeeds
|
||||
- `/go-review` - Review code quality
|
||||
- `/verify` - Full verification loop
|
||||
- `verification-loop` skill - Full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -260,7 +260,7 @@ go test -race -cover ./...
|
||||
|
||||
- `/go-build` - Fix build errors
|
||||
- `/go-review` - Review code after implementation
|
||||
- `/verify` - Run full verification loop
|
||||
- `verification-loop` skill - Run full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Run a deterministic repository harness audit and return a prioritized scorecard.
|
||||
---
|
||||
|
||||
# Harness Audit Command
|
||||
|
||||
Run a deterministic repository harness audit and return a prioritized scorecard.
|
||||
|
||||
@@ -55,7 +55,7 @@ Dependencies:
|
||||
|
||||
Recommended Next Steps:
|
||||
- /plan to create implementation plan
|
||||
- /tdd to implement with tests first
|
||||
- `tdd-workflow` skill to implement with tests first
|
||||
```
|
||||
|
||||
### `/jira comment <TICKET-KEY>`
|
||||
@@ -95,7 +95,7 @@ If credentials are missing, stop and direct the user to set them up.
|
||||
|
||||
After analyzing a ticket:
|
||||
- Use `/plan` to create an implementation plan from the requirements
|
||||
- Use `/tdd` to implement with test-driven development
|
||||
- Use the `tdd-workflow` skill to implement with test-driven development
|
||||
- Use `/code-review` after implementation
|
||||
- Use `/jira comment` to post progress back to the ticket
|
||||
- Use `/jira transition` to move the ticket when work is complete
|
||||
|
||||
@@ -166,7 +166,7 @@ The agent will stop and report if:
|
||||
|
||||
- `/kotlin-test` - Run tests after build succeeds
|
||||
- `/kotlin-review` - Review code quality
|
||||
- `/verify` - Full verification loop
|
||||
- `verification-loop` skill - Full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -304,7 +304,7 @@ open build/reports/kover/html/index.html
|
||||
|
||||
- `/kotlin-build` - Fix build errors
|
||||
- `/kotlin-review` - Review code after implementation
|
||||
- `/verify` - Run full verification loop
|
||||
- `verification-loop` skill - Run full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Extract reusable patterns from the current session and save them as candidate skills or guidance.
|
||||
---
|
||||
|
||||
# /learn - Extract Reusable Patterns
|
||||
|
||||
Analyze the current session and extract any patterns worth saving as skills.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Start a managed autonomous loop pattern with safety defaults and explicit stop conditions.
|
||||
---
|
||||
|
||||
# Loop Start Command
|
||||
|
||||
Start a managed autonomous loop pattern with safety defaults.
|
||||
|
||||
@@ -1,7 +1,23 @@
|
||||
---
|
||||
description: Inspect active loop state, progress, failure signals, and recommended intervention.
|
||||
---
|
||||
|
||||
# Loop Status Command
|
||||
|
||||
Inspect active loop state, progress, and failure signals.
|
||||
|
||||
This slash command can only run after the current session dequeues it. If you
|
||||
need to inspect a wedged or sibling session, run the packaged CLI from another
|
||||
terminal:
|
||||
|
||||
```bash
|
||||
npx --package ecc-universal ecc loop-status --json
|
||||
```
|
||||
|
||||
The CLI scans local Claude transcript JSONL files under
|
||||
`~/.claude/projects/**` and reports stale `ScheduleWakeup` calls or `Bash`
|
||||
tool calls that have no matching `tool_result`.
|
||||
|
||||
## Usage
|
||||
|
||||
`/loop-status [--watch]`
|
||||
@@ -14,9 +30,29 @@ Inspect active loop state, progress, and failure signals.
|
||||
- estimated time/cost drift
|
||||
- recommended intervention (continue/pause/stop)
|
||||
|
||||
## Cross-Session CLI
|
||||
|
||||
- `ecc loop-status --json` emits machine-readable status for recent local
|
||||
Claude transcripts.
|
||||
- `ecc loop-status --home <dir>` scans a different home directory when
|
||||
inspecting another local profile or mounted workspace.
|
||||
- `ecc loop-status --transcript <session.jsonl>` inspects one transcript
|
||||
directly.
|
||||
- `ecc loop-status --bash-timeout-seconds 1800` adjusts the stale Bash
|
||||
threshold.
|
||||
- `ecc loop-status --exit-code` exits `2` when stale loop or tool signals are
|
||||
found, or `1` when transcripts cannot be scanned.
|
||||
- `ecc loop-status --watch` refreshes status until interrupted.
|
||||
- `ecc loop-status --watch --watch-count 3 --exit-code` refreshes a bounded
|
||||
number of times, then exits with the highest status seen.
|
||||
- `ecc loop-status --watch --watch-count 3` emits a bounded watch stream for
|
||||
scripts and handoffs.
|
||||
|
||||
## Watch Mode
|
||||
|
||||
When `--watch` is present, refresh status periodically and surface state changes.
|
||||
When `--watch` is present, refresh status periodically. With `--json`, each
|
||||
refresh is emitted as one JSON object per line so another terminal or script can
|
||||
consume the stream.
|
||||
|
||||
## Arguments
|
||||
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Recommend the best model tier for the current task based on complexity, risk, and budget.
|
||||
---
|
||||
|
||||
# Model Route Command
|
||||
|
||||
Recommend the best model tier for the current task by complexity and budget.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Run a backend-focused multi-model workflow for APIs, algorithms, data, and business logic.
|
||||
---
|
||||
|
||||
# Backend - Backend-Focused Development
|
||||
|
||||
Backend-focused workflow (Research → Ideation → Plan → Execute → Optimize → Review), Codex-led.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Execute a multi-model implementation plan while preserving Claude as the only filesystem writer.
|
||||
---
|
||||
|
||||
# Execute - Multi-Model Collaborative Execution
|
||||
|
||||
Multi-model collaborative execution - Get prototype from plan → Claude refactors and implements → Multi-model audit and delivery.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Run a frontend-focused multi-model workflow for components, layouts, animation, and UI polish.
|
||||
---
|
||||
|
||||
# Frontend - Frontend-Focused Development
|
||||
|
||||
Frontend-focused workflow (Research → Ideation → Plan → Execute → Optimize → Review), Gemini-led.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Create a multi-model implementation plan without modifying production code.
|
||||
---
|
||||
|
||||
# Plan - Multi-Model Collaborative Planning
|
||||
|
||||
Multi-model collaborative planning - Context retrieval + Dual-model analysis → Generate step-by-step implementation plan.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Run a full multi-model development workflow with research, planning, execution, optimization, and review.
|
||||
---
|
||||
|
||||
# Workflow - Multi-Model Collaborative Development
|
||||
|
||||
Multi-model collaborative development workflow (Research → Ideation → Plan → Execute → Optimize → Review), with intelligent routing: Frontend → Gemini, Backend → Codex.
|
||||
|
||||
@@ -4,7 +4,9 @@ description: Restate requirements, assess risks, and create step-by-step impleme
|
||||
|
||||
# Plan Command
|
||||
|
||||
This command invokes the **planner** agent to create a comprehensive implementation plan before writing any code.
|
||||
This command creates a comprehensive implementation plan before writing any code.
|
||||
|
||||
Run inline by default. Do not call the Task tool or any subagent by default. This keeps `/plan` usable from plugin installs that ship commands without agent files.
|
||||
|
||||
## What This Command Does
|
||||
|
||||
@@ -24,7 +26,7 @@ Use `/plan` when:
|
||||
|
||||
## How It Works
|
||||
|
||||
The planner agent will:
|
||||
The assistant will:
|
||||
|
||||
1. **Analyze the request** and restate requirements in clear terms
|
||||
2. **Break down into phases** with specific, actionable steps
|
||||
@@ -38,7 +40,7 @@ The planner agent will:
|
||||
```
|
||||
User: /plan I need to add real-time notifications when markets resolve
|
||||
|
||||
Agent (planner):
|
||||
Assistant:
|
||||
# Implementation Plan: Real-Time Market Resolution Notifications
|
||||
|
||||
## Requirements Restatement
|
||||
@@ -93,7 +95,7 @@ Agent (planner):
|
||||
|
||||
## Important Notes
|
||||
|
||||
**CRITICAL**: The planner agent will **NOT** write any code until you explicitly confirm the plan with "yes" or "proceed" or similar affirmative response.
|
||||
**CRITICAL**: This command will **NOT** write any code until you explicitly confirm the plan with "yes" or "proceed" or similar affirmative response.
|
||||
|
||||
If you want changes, respond with:
|
||||
- "modify: [your changes]"
|
||||
@@ -103,15 +105,17 @@ If you want changes, respond with:
|
||||
## Integration with Other Commands
|
||||
|
||||
After planning:
|
||||
- Use `/tdd` to implement with test-driven development
|
||||
- Use the `tdd-workflow` skill to implement with test-driven development
|
||||
- Use `/build-fix` if build errors occur
|
||||
- Use `/code-review` to review completed implementation
|
||||
|
||||
> **Need deeper planning?** Use `/prp-plan` for artifact-producing planning with PRD integration, codebase analysis, and pattern extraction. Use `/prp-implement` to execute those plans with rigorous validation loops.
|
||||
|
||||
## Related Agents
|
||||
## Optional Planner Agent
|
||||
|
||||
This command invokes the `planner` agent provided by ECC.
|
||||
ECC also provides a `planner` agent for manual installs that include agent files. Use it only when the local runtime already exposes that subagent and the user explicitly asks you to delegate planning.
|
||||
|
||||
If the `planner` subagent is unavailable, continue planning inline instead of surfacing an "Agent type 'planner' not found" error.
|
||||
|
||||
For manual installs, the source file lives at:
|
||||
`agents/planner.md`
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Analyze a project and generate PM2 service commands for detected frontend, backend, or database services.
|
||||
---
|
||||
|
||||
# PM2 Init
|
||||
|
||||
Auto-analyze project and generate PM2 service commands.
|
||||
|
||||
@@ -171,7 +171,7 @@ Run: `black app/routes/user.py app/services/auth.py`
|
||||
|
||||
## Integration with Other Commands
|
||||
|
||||
- Use `/tdd` first to ensure tests pass
|
||||
- Use the `tdd-workflow` skill first to ensure tests pass
|
||||
- Use `/code-review` for non-Python specific concerns
|
||||
- Use `/python-review` before committing
|
||||
- Use `/build-fix` if static analysis tools fail
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Run the ECC quality pipeline for a file or project scope and report remediation steps.
|
||||
---
|
||||
|
||||
# Quality Gate Command
|
||||
|
||||
Run the ECC quality pipeline on demand for a file or project scope.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Safely identify and remove dead code with verification after each change.
|
||||
---
|
||||
|
||||
# Refactor Clean
|
||||
|
||||
Safely identify and remove dead code with test verification at every step.
|
||||
|
||||
@@ -179,7 +179,7 @@ The agent will stop and report if:
|
||||
|
||||
- `/rust-test` - Run tests after build succeeds
|
||||
- `/rust-review` - Review code quality
|
||||
- `/verify` - Full verification loop
|
||||
- `verification-loop` skill - Full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -300,7 +300,7 @@ cargo test --no-fail-fast
|
||||
|
||||
- `/rust-build` - Fix build errors
|
||||
- `/rust-review` - Review code after implementation
|
||||
- `/verify` - Run full verification loop
|
||||
- `verification-loop` skill - Run full verification loop
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Analyze coverage, identify gaps, and generate missing tests toward the target threshold.
|
||||
---
|
||||
|
||||
# Test Coverage
|
||||
|
||||
Analyze test coverage, identify gaps, and generate missing tests to reach 80%+ coverage.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Scan project structure and generate token-lean architecture codemaps.
|
||||
---
|
||||
|
||||
# Update Codemaps
|
||||
|
||||
Analyze the codebase structure and generate token-lean architecture documentation.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
description: Sync documentation from source-of-truth files such as scripts, schemas, routes, and exports.
|
||||
---
|
||||
|
||||
# Update Documentation
|
||||
|
||||
Sync documentation with the codebase, generating from source-of-truth files.
|
||||
|
||||
@@ -110,7 +110,7 @@ This document captures architect-level improvements for the Everything Claude Co
|
||||
|
||||
### 5.1 Hook Runtime Consistency
|
||||
|
||||
**Issue:** Most hooks invoke Node scripts via `run-with-flags.js`; one path uses `run-with-flags-shell.sh` + `observe.sh`. The mixed runtime is documented but could be simplified over time.
|
||||
**Issue:** Hooks should keep a consistent Node-mode dispatch surface. Continuous-learning observation now dispatches through `run-with-flags.js` and `observe-runner.js`, which delegates to the existing `observe.sh` implementation without exposing a shell-mode hook entry.
|
||||
|
||||
**Recommendation:**
|
||||
|
||||
|
||||
@@ -83,14 +83,27 @@ These stay local and should be configured per operator:
|
||||
## Suggested Bring-Up Order
|
||||
|
||||
0. Run `ecc migrate audit --source ~/.hermes` first to inventory the legacy workspace and see which parts already map onto ECC2.
|
||||
0.5. Generate and review artifacts with `ecc migrate plan` / `ecc migrate scaffold`, scaffold reusable legacy skills with `ecc migrate import-skills --output-dir migration-artifacts/skills`, scaffold legacy tool translation templates with `ecc migrate import-tools --output-dir migration-artifacts/tools`, scaffold legacy bridge plugins with `ecc migrate import-plugins --output-dir migration-artifacts/plugins`, preview recurring jobs with `ecc migrate import-schedules --dry-run`, preview gateway dispatch with `ecc migrate import-remote --dry-run`, preview safe env/service context with `ecc migrate import-env --dry-run`, then import sanitized workspace memory with `ecc migrate import-memory`.
|
||||
1. Install ECC and verify the baseline harness setup.
|
||||
0.5. Plan and scaffold migration artifacts before importing anything:
|
||||
- generate reviewable plans with `ecc migrate plan` and `ecc migrate scaffold`
|
||||
- scaffold reusable legacy skills with `ecc migrate import-skills --output-dir migration-artifacts/skills`
|
||||
- scaffold tool translation templates with `ecc migrate import-tools --output-dir migration-artifacts/tools`
|
||||
- scaffold bridge plugin templates with `ecc migrate import-plugins --output-dir migration-artifacts/plugins`
|
||||
- preview recurring jobs with `ecc migrate import-schedules --dry-run`
|
||||
- preview gateway dispatch with `ecc migrate import-remote --dry-run`
|
||||
- preview safe env/service context with `ecc migrate import-env --dry-run`
|
||||
- import sanitized workspace memory with `ecc migrate import-memory`
|
||||
1. Install ECC and verify the baseline harness setup with `node tests/run-all.js`; the expected result is a zero-failure test summary.
|
||||
2. Install Hermes and point it at ECC-imported skills.
|
||||
3. Register the MCP servers you actually use every day.
|
||||
4. Authenticate Google Drive first, then GitHub, then distribution channels.
|
||||
5. Start with a small cron surface: readiness check, content accountability, inbox triage, revenue monitor.
|
||||
6. Only then add heavier personal workflows like health, relationship graphing, or outbound sequencing.
|
||||
|
||||
## Related Docs
|
||||
|
||||
- [Hermes/OpenClaw migration guide](HERMES-OPENCLAW-MIGRATION.md)
|
||||
- [Cross-harness architecture](architecture/cross-harness.md)
|
||||
|
||||
## Why Hermes x ECC
|
||||
|
||||
This stack is useful when you want:
|
||||
|
||||
@@ -640,7 +640,7 @@ Suggested operation shape:
|
||||
"kind": "copy",
|
||||
"moduleId": "rules-core",
|
||||
"source": "rules/common/coding-style.md",
|
||||
"destination": "/Users/example/.claude/rules/common/coding-style.md",
|
||||
"destination": "/Users/example/.claude/rules/ecc/common/coding-style.md",
|
||||
"ownership": "managed",
|
||||
"overwritePolicy": "replace"
|
||||
}
|
||||
@@ -711,7 +711,7 @@ Suggested payload:
|
||||
{
|
||||
"kind": "copy",
|
||||
"moduleId": "rules-core",
|
||||
"destination": "/Users/example/.claude/rules/common/coding-style.md",
|
||||
"destination": "/Users/example/.claude/rules/ecc/common/coding-style.md",
|
||||
"digest": "sha256:..."
|
||||
}
|
||||
]
|
||||
|
||||
@@ -78,6 +78,25 @@ Do not ship:
|
||||
- private datasets
|
||||
- local-only automation packs that have not been reviewed
|
||||
|
||||
## Worked Example
|
||||
|
||||
Use `skills/hermes-imports/SKILL.md` as the same skill source across harnesses.
|
||||
|
||||
The workflow is:
|
||||
|
||||
1. Author the durable behavior once in `skills/hermes-imports/SKILL.md`.
|
||||
2. Keep secrets, local paths, and raw operator memory out of the skill.
|
||||
3. Let each harness adapt how the skill is loaded.
|
||||
4. Test the source skill and the harness-facing metadata separately.
|
||||
|
||||
Claude Code gets the skill through the Claude plugin surface and can enforce related hooks natively.
|
||||
|
||||
Codex reads the repo instructions, `.codex-plugin/plugin.json`, and the MCP reference config. The same skill source still describes the workflow, but hook parity is instruction-backed unless Codex adds a native hook surface.
|
||||
|
||||
OpenCode gets the skill through the OpenCode package/plugin surface. Event handling can reuse ECC hook logic through the adapter layer, while the skill text stays unchanged.
|
||||
|
||||
If a change requires editing three harness copies of the same workflow, the shared source is in the wrong place. Put the workflow back in `skills/`, then adapt only loading, event shape, or command routing at the harness edge.
|
||||
|
||||
## Today vs Later
|
||||
|
||||
Supported today:
|
||||
|
||||
@@ -1,29 +1,34 @@
|
||||
# Social Launch Copy (X + LinkedIn)
|
||||
|
||||
Use these templates as launch-ready starting points. Replace placeholders before posting.
|
||||
Use these templates as launch-ready starting points. Review channel tone before posting.
|
||||
|
||||
## X Post: Release Announcement
|
||||
|
||||
```text
|
||||
ECC v1.8.0 is live.
|
||||
ECC v2.0.0-rc.1 is live.
|
||||
|
||||
We moved from “config pack” to an agent harness performance system:
|
||||
- hook reliability fixes
|
||||
- new harness commands
|
||||
- cross-tool parity (Claude Code, Cursor, OpenCode, Codex)
|
||||
The repo is moving from a Claude Code config pack into a cross-harness operating system for agentic work.
|
||||
|
||||
Start here: <repo-link>
|
||||
What ships:
|
||||
- Hermes setup guide
|
||||
- release notes and launch collateral
|
||||
- cross-harness architecture docs
|
||||
- Hermes import guidance for turning local operator workflows into public ECC skills
|
||||
|
||||
Start here: https://github.com/affaan-m/everything-claude-code
|
||||
Release notes: https://github.com/affaan-m/everything-claude-code/blob/main/docs/releases/2.0.0-rc.1/release-notes.md
|
||||
```
|
||||
|
||||
## X Post: Proof + Metrics
|
||||
|
||||
```text
|
||||
If you evaluate agent tooling, use blended distribution metrics:
|
||||
- npm installs (`ecc-universal`, `ecc-agentshield`)
|
||||
- GitHub App installs
|
||||
- repo adoption (stars/forks/contributors)
|
||||
ECC v2.0.0-rc.1 keeps the public surface honest:
|
||||
- reusable ECC substrate in repo
|
||||
- Hermes documented as the operator shell
|
||||
- private workspace state left out
|
||||
- release metadata and docs covered by tests
|
||||
|
||||
We now track this monthly in-repo for sponsor transparency.
|
||||
This is the release-candidate line: public system shape now, deeper local integrations only after sanitization.
|
||||
```
|
||||
|
||||
## X Quote Tweet: Eval Skills Article
|
||||
@@ -36,7 +41,7 @@ In ECC we turned this into production checks via:
|
||||
- /quality-gate
|
||||
- Stop-phase session summaries
|
||||
|
||||
This is where harness performance compounds over time.
|
||||
In v2.0.0-rc.1, that discipline extends to the release surface: docs, manifests, launch copy, and public/private boundaries are test-backed.
|
||||
```
|
||||
|
||||
## X Quote Tweet: Plankton / deslop workflow
|
||||
@@ -44,19 +49,24 @@ This is where harness performance compounds over time.
|
||||
```text
|
||||
This workflow direction is right: optimize the harness, not just prompts.
|
||||
|
||||
Our v1.8.0 focus was reliability + parity + measurable quality gates across toolchains.
|
||||
ECC v2.0.0-rc.1 pushes that further: reusable skills, thin harness adapters, and Hermes as the operator shell on top.
|
||||
```
|
||||
|
||||
## LinkedIn Post: Partner-Friendly Summary
|
||||
|
||||
```text
|
||||
We shipped ECC v1.8.0 with one objective: improve agent harness performance in production.
|
||||
ECC v2.0.0-rc.1 is live.
|
||||
|
||||
Highlights:
|
||||
- more reliable hook lifecycle behavior
|
||||
- new harness-level quality commands
|
||||
- parity across Claude Code, Cursor, OpenCode, and Codex
|
||||
- stronger sponsor-facing metrics tracking
|
||||
The practical shift: ECC is no longer just a Claude Code config pack. It is becoming a cross-harness operating system for agentic work.
|
||||
|
||||
If your team runs AI coding agents daily, this is designed for operational use.
|
||||
This release-candidate surface includes:
|
||||
- sanitized Hermes setup documentation
|
||||
- release notes and launch collateral
|
||||
- cross-harness architecture notes
|
||||
- Hermes import guidance for turning local operator patterns into public ECC skills
|
||||
|
||||
It does not include private workspace state, credentials, raw local exports, or personal datasets.
|
||||
|
||||
Repo: https://github.com/affaan-m/everything-claude-code
|
||||
Release notes: https://github.com/affaan-m/everything-claude-code/blob/main/docs/releases/2.0.0-rc.1/release-notes.md
|
||||
```
|
||||
|
||||
@@ -134,7 +134,7 @@ cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
|
||||
|
||||
```bash
|
||||
# コマンドを試す(プラグインはネームスペース形式)
|
||||
/ecc:plan "ユーザー認証を追加"
|
||||
/everything-claude-code:plan "ユーザー認証を追加"
|
||||
|
||||
# 手動インストール(オプション2)は短縮形式:
|
||||
# /plan "ユーザー認証を追加"
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Sessionsコマンド
|
||||
|
||||
Claude Codeセッション履歴を管理 - `~/.claude/sessions/` に保存されたセッションのリスト表示、読み込み、エイリアス設定、編集を行います。
|
||||
Claude Codeセッション履歴を管理 - `~/.claude/session-data/` に保存されたセッションのリスト表示、読み込み、エイリアス設定、編集を行います。旧 `~/.claude/sessions/` のファイルも後方互換のために読み取ります。
|
||||
|
||||
## 使用方法
|
||||
|
||||
@@ -81,7 +81,7 @@ const size = sm.getSessionSize(session.sessionPath);
|
||||
const aliases = aa.getAliasesForSession(session.filename);
|
||||
|
||||
console.log('Session: ' + session.filename);
|
||||
console.log('Path: ~/.claude/sessions/' + session.filename);
|
||||
console.log('Path: ' + session.sessionPath);
|
||||
console.log('');
|
||||
console.log('Statistics:');
|
||||
console.log(' Lines: ' + stats.lineCount);
|
||||
@@ -299,7 +299,7 @@ $ARGUMENTS:
|
||||
|
||||
## 備考
|
||||
|
||||
- セッションは `~/.claude/sessions/` にMarkdownファイルとして保存されます
|
||||
- セッションは `~/.claude/session-data/` にMarkdownファイルとして保存され、旧 `~/.claude/sessions/` のファイルも引き続き読み取られます
|
||||
- エイリアスは `~/.claude/session-aliases.json` に保存されます
|
||||
- セッションIDは短縮できます(通常、最初の4〜8文字で一意になります)
|
||||
- 頻繁に参照するセッションにはエイリアスを使用してください
|
||||
|
||||
@@ -58,7 +58,7 @@ claude plugin install typescript-lsp@claude-plugins-official
|
||||
|
||||
**ワークフロー:**
|
||||
- `commit-commands` - Gitワークフロー
|
||||
- `frontend-design` - UIパターン
|
||||
- `frontend-patterns` - UIパターン
|
||||
- `feature-dev` - 機能開発
|
||||
|
||||
---
|
||||
|
||||
@@ -130,9 +130,20 @@ Options:
|
||||
|
||||
### 2c: インストールの実行
|
||||
|
||||
選択された各スキルについて、スキルディレクトリ全体をコピーします:
|
||||
選択された各スキルについて、正しいソースルートからスキルディレクトリ全体をコピーします:
|
||||
|
||||
```bash
|
||||
cp -r $ECC_ROOT/skills/<skill-name> $TARGET/skills/
|
||||
# コアスキルは .agents/skills/ 配下にあります
|
||||
cp -R "$ECC_ROOT/.agents/skills/<skill-name>" "$TARGET/skills/"
|
||||
|
||||
# ニッチスキルは skills/ 配下にあります
|
||||
cp -R "$ECC_ROOT/skills/<skill-name>" "$TARGET/skills/"
|
||||
```
|
||||
|
||||
glob で取得したソースディレクトリを処理するときは、trailing slash 付きのソースをそのまま `cp` に渡さないでください。宛先名にディレクトリ名を明示します:
|
||||
|
||||
```bash
|
||||
cp -R "${src%/}" "$TARGET/skills/$(basename "${src%/}")"
|
||||
```
|
||||
|
||||
注: `continuous-learning` と `continuous-learning-v2` には追加ファイル(config.json、フック、スクリプト)があります — SKILL.md だけでなく、ディレクトリ全体がコピーされることを確認してください。
|
||||
|
||||
@@ -141,7 +141,7 @@ cd everything-claude-code
|
||||
|
||||
```bash
|
||||
# 커맨드 실행 (플러그인 설치 시 네임스페이스 형태 사용)
|
||||
/ecc:plan "사용자 인증 추가"
|
||||
/everything-claude-code:plan "사용자 인증 추가"
|
||||
|
||||
# 수동 설치(옵션 2) 시에는 짧은 형태를 사용:
|
||||
# /plan "사용자 인증 추가"
|
||||
@@ -489,8 +489,8 @@ rules/
|
||||
|
||||
| 하고 싶은 것 | 사용할 커맨드 | 사용되는 에이전트 |
|
||||
|-------------|-------------|-----------------|
|
||||
| 새 기능 계획하기 | `/ecc:plan "인증 추가"` | planner |
|
||||
| 시스템 아키텍처 설계 | `/ecc:plan` + architect 에이전트 | architect |
|
||||
| 새 기능 계획하기 | `/everything-claude-code:plan "인증 추가"` | planner |
|
||||
| 시스템 아키텍처 설계 | `/everything-claude-code:plan` + architect 에이전트 | architect |
|
||||
| 테스트를 먼저 작성하며 코딩 | `/tdd` | tdd-guide |
|
||||
| 방금 작성한 코드 리뷰 | `/code-review` | code-reviewer |
|
||||
| 빌드 실패 수정 | `/build-fix` | build-error-resolver |
|
||||
@@ -507,7 +507,7 @@ rules/
|
||||
|
||||
**새로운 기능 시작:**
|
||||
```
|
||||
/ecc:plan "OAuth를 사용한 사용자 인증 추가"
|
||||
/everything-claude-code:plan "OAuth를 사용한 사용자 인증 추가"
|
||||
→ planner가 구현 청사진 작성
|
||||
/tdd → tdd-guide가 테스트 먼저 작성 강제
|
||||
/code-review → code-reviewer가 코드 검토
|
||||
|
||||
@@ -161,7 +161,7 @@ npx ecc-install typescript
|
||||
|
||||
```bash
|
||||
# Experimente um comando (a instalação do plugin usa forma com namespace)
|
||||
/ecc:plan "Adicionar autenticação de usuário"
|
||||
/everything-claude-code:plan "Adicionar autenticação de usuário"
|
||||
|
||||
# Instalação manual (Opção 2) usa a forma mais curta:
|
||||
# /plan "Adicionar autenticação de usuário"
|
||||
@@ -408,8 +408,8 @@ Regras são diretrizes sempre seguidas, organizadas em `common/` (agnóstico à
|
||||
|
||||
| Quero... | Use este comando | Agente usado |
|
||||
|----------|-----------------|--------------|
|
||||
| Planejar um novo recurso | `/ecc:plan "Adicionar auth"` | planner |
|
||||
| Projetar arquitetura de sistema | `/ecc:plan` + agente architect | architect |
|
||||
| Planejar um novo recurso | `/everything-claude-code:plan "Adicionar auth"` | planner |
|
||||
| Projetar arquitetura de sistema | `/everything-claude-code:plan` + agente architect | architect |
|
||||
| Escrever código com testes primeiro | `/tdd` | tdd-guide |
|
||||
| Revisar código que acabei de escrever | `/code-review` | code-reviewer |
|
||||
| Corrigir build com falha | `/build-fix` | build-error-resolver |
|
||||
@@ -424,7 +424,7 @@ Regras são diretrizes sempre seguidas, organizadas em `common/` (agnóstico à
|
||||
|
||||
**Começando um novo recurso:**
|
||||
```
|
||||
/ecc:plan "Adicionar autenticação de usuário com OAuth"
|
||||
/everything-claude-code:plan "Adicionar autenticação de usuário com OAuth"
|
||||
→ planner cria blueprint de implementação
|
||||
/tdd → tdd-guide aplica escrita de testes primeiro
|
||||
/code-review → code-reviewer verifica seu trabalho
|
||||
|
||||
@@ -10,8 +10,8 @@
|
||||
|
||||
## Release Surface
|
||||
|
||||
- confirm package and plugin version policy for `2.0.0-rc.1` (drafted in manifest bump prep)
|
||||
- confirm whether `ecc2/Cargo.toml` moves from `0.1.0` to `2.0.0-rc.1`
|
||||
- verify package, plugin, marketplace, OpenCode, and agent metadata stays at `2.0.0-rc.1`
|
||||
- verify `ecc2/Cargo.toml` stays at `0.1.0` for rc.1; `ecc2/` remains an alpha control-plane scaffold
|
||||
- update release metadata in one dedicated release-version PR
|
||||
- run the root test suite
|
||||
- run `cd ecc2 && cargo test`
|
||||
|
||||
61
docs/releases/2.0.0-rc.1/quickstart.md
Normal file
61
docs/releases/2.0.0-rc.1/quickstart.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# ECC v2.0.0-rc.1 Quickstart
|
||||
|
||||
This path is for a new contributor who wants to verify the release surface before touching feature work.
|
||||
|
||||
## Clone
|
||||
|
||||
```bash
|
||||
git clone https://github.com/affaan-m/everything-claude-code.git
|
||||
cd everything-claude-code
|
||||
```
|
||||
|
||||
Start from a clean checkout. Do not copy private operator state, raw workspace exports, tokens, or local Hermes files into the repo.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
npm ci
|
||||
```
|
||||
|
||||
This installs the Node-based validation and packaging toolchain used by the public release surface.
|
||||
|
||||
## Verify
|
||||
|
||||
```bash
|
||||
node tests/run-all.js
|
||||
```
|
||||
|
||||
Expected result: every test passes with zero failures. For release-specific drift, run the focused check:
|
||||
|
||||
```bash
|
||||
node tests/docs/ecc2-release-surface.test.js
|
||||
```
|
||||
|
||||
## First Skill
|
||||
|
||||
Read `skills/hermes-imports/SKILL.md` first.
|
||||
|
||||
It shows the intended ECC 2.0 pattern:
|
||||
|
||||
- take a repeated operator workflow
|
||||
- remove credentials, private paths, raw workspace exports, and personal memory
|
||||
- keep the durable workflow shape
|
||||
- publish the sanitized result as a reusable `SKILL.md`
|
||||
|
||||
Do not start by importing a private Hermes workflow wholesale. Start by distilling one reusable skill.
|
||||
|
||||
## Switch Harness
|
||||
|
||||
Use the same skill source across harnesses:
|
||||
|
||||
- Claude Code consumes ECC through the Claude plugin and native hooks.
|
||||
- Codex consumes ECC through `AGENTS.md`, `.codex-plugin/plugin.json`, and MCP reference config.
|
||||
- OpenCode consumes ECC through the OpenCode package/plugin surface.
|
||||
|
||||
The portable unit is still `skills/*/SKILL.md`. Harness-specific files should load or adapt that source, not redefine the workflow.
|
||||
|
||||
## Next Docs
|
||||
|
||||
- [Hermes setup](../../HERMES-SETUP.md)
|
||||
- [Cross-harness architecture](../../architecture/cross-harness.md)
|
||||
- [Release notes](release-notes.md)
|
||||
@@ -26,7 +26,7 @@ The system now has a clearer shape:
|
||||
- cross-harness install surfaces for Claude Code, Codex, OpenCode, Cursor, and related tools
|
||||
- Hermes as an optional operator shell for chat, cron, handoffs, and daily work routing
|
||||
|
||||
## Preview Boundaries
|
||||
## Release Candidate Boundaries
|
||||
|
||||
This is a release candidate, not the final GA claim.
|
||||
|
||||
@@ -47,8 +47,9 @@ What stays local:
|
||||
|
||||
## Upgrade Motion
|
||||
|
||||
1. Read the [Hermes setup guide](../../HERMES-SETUP.md).
|
||||
2. Review the [cross-harness architecture](../../architecture/cross-harness.md).
|
||||
3. Start with one workflow lane: engineering, research, content, or outreach.
|
||||
4. Import only sanitized operator patterns into ECC skills.
|
||||
5. Treat `ecc2/` as an alpha control plane until release packaging and installer behavior are finalized.
|
||||
1. Follow the [rc.1 quickstart](quickstart.md).
|
||||
2. Read the [Hermes setup guide](../../HERMES-SETUP.md).
|
||||
3. Review the [cross-harness architecture](../../architecture/cross-harness.md).
|
||||
4. Start with one workflow lane: engineering, research, content, or outreach.
|
||||
5. Import only sanitized operator patterns into ECC skills.
|
||||
6. Treat `ecc2/` as an alpha control plane until release packaging and installer behavior are finalized.
|
||||
|
||||
@@ -98,8 +98,10 @@ Each enabled MCP server adds tool definitions to your context window. The README
|
||||
|
||||
Tips:
|
||||
- Run `/mcp` to see active servers and their context cost
|
||||
- Use `/mcp` to disable Claude Code MCP servers when you want a live runtime change. Claude Code persists those runtime disables in `~/.claude.json`.
|
||||
- Prefer CLI tools when available (`gh` instead of GitHub MCP, `aws` instead of AWS MCP)
|
||||
- Use `disabledMcpServers` in project config to disable servers per-project
|
||||
- Do not rely on `.claude/settings.json` or `.claude/settings.local.json` to disable already-loaded Claude Code MCP servers; use `/mcp` for that.
|
||||
- `ECC_DISABLED_MCPS` only affects ECC-generated MCP config output during install/sync flows, such as `install.sh`, `npx ecc-install`, and Codex MCP merging. It is not a live Claude Code toggle.
|
||||
- The `memory` MCP server is configured by default but not used by any skill, agent, or hook — consider disabling it
|
||||
|
||||
---
|
||||
|
||||
@@ -1,5 +1,45 @@
|
||||
# Değişiklik Günlüğü
|
||||
|
||||
## 2.0.0-rc.1 - 2026-04-28
|
||||
|
||||
### Öne Çıkanlar
|
||||
|
||||
- Hermes operatör hikayesi için genel ECC 2.0 sürüm adayı yüzeyi eklendi.
|
||||
- ECC, Claude Code, Codex, Cursor, OpenCode ve Gemini genelinde yeniden kullanılabilir cross-harness altyapı olarak belgelendi.
|
||||
- Özel operatör state'i yayımlamak yerine sanitize edilmiş Hermes import becerisi eklendi.
|
||||
|
||||
### Sürüm Yüzeyi
|
||||
|
||||
- Paket, plugin, marketplace, OpenCode, ajan ve README metadataları `2.0.0-rc.1` olarak güncellendi.
|
||||
- Sürüm notları, sosyal taslaklar, launch checklist, handoff notları ve demo prompt'ları `docs/releases/2.0.0-rc.1/` altında toplandı.
|
||||
- ECC/Hermes sınırı için `docs/architecture/cross-harness.md` ve regresyon kapsamı eklendi.
|
||||
- `ecc2/` sürümlemesi bağımsız tutuldu; release engineering aksi karar vermedikçe alpha control-plane scaffold olarak kalır.
|
||||
|
||||
### Notlar
|
||||
|
||||
- Bu bir sürüm adayıdır; tam ECC 2.0 control-plane yol haritası için GA iddiası değildir.
|
||||
- Ön sürüm npm yayımları, release engineering aksi karar vermedikçe `next` dist-tag kullanmalıdır.
|
||||
|
||||
## 1.10.0 - 2026-04-05
|
||||
|
||||
### Öne Çıkanlar
|
||||
|
||||
- Genel repo yüzeyi birkaç haftalık OSS büyümesi ve backlog merge'lerinden sonra canlı repo ile senkronize edildi.
|
||||
- Operatör iş akışı hattı voice, graph-ranking, billing, workspace ve outbound becerileriyle genişletildi.
|
||||
- Medya üretim hattı Manim ve Remotion odaklı launch araçlarıyla genişletildi.
|
||||
- ECC 2.0 alpha control-plane binary artık `ecc2/` üzerinden yerelde build ediliyor ve ilk kullanılabilir CLI/TUI yüzeyini sunuyor.
|
||||
|
||||
### Sürüm Yüzeyi
|
||||
|
||||
- Plugin, marketplace, Codex, OpenCode ve ajan metadataları `1.10.0` olarak güncellendi.
|
||||
- Yayınlanan sayımlar canlı OSS yüzeyine eşitlendi: 38 ajan, 156 beceri, 72 komut.
|
||||
- Üst seviye install dokümanları ve marketplace açıklamaları mevcut repo durumuyla eşitlendi.
|
||||
|
||||
### Notlar
|
||||
|
||||
- Claude plugin'i platform seviyesindeki rules dağıtım kısıtlarıyla sınırlı kalır; selective install / OSS yolu hâlâ en güvenilir tam kurulum yoludur.
|
||||
- Bu sürüm bir repo-yüzeyi düzeltmesi ve ekosistem senkronizasyonudur; tam ECC 2.0 yol haritasının tamamlandığı iddiası değildir.
|
||||
|
||||
## 1.9.0 - 2026-03-20
|
||||
|
||||
### Öne Çıkanlar
|
||||
|
||||
@@ -164,7 +164,7 @@ Manuel kurulum talimatları için `rules/` klasöründeki README'ye bakın.
|
||||
|
||||
```bash
|
||||
# Bir command deneyin (plugin kurulumu namespace'li form kullanır)
|
||||
/ecc:plan "Kullanıcı kimlik doğrulaması ekle"
|
||||
/everything-claude-code:plan "Kullanıcı kimlik doğrulaması ekle"
|
||||
|
||||
# Manuel kurulum (Seçenek 2) daha kısa formu kullanır:
|
||||
# /plan "Kullanıcı kimlik doğrulaması ekle"
|
||||
@@ -308,8 +308,8 @@ Nereden başlayacağınızdan emin değil misiniz? Bu hızlı referansı kullan
|
||||
|
||||
| Yapmak istediğim... | Bu command'ı kullan | Kullanılan agent |
|
||||
|---------------------|---------------------|------------------|
|
||||
| Yeni bir feature planla | `/ecc:plan "Auth ekle"` | planner |
|
||||
| Sistem mimarisi tasarla | `/ecc:plan` + architect agent | architect |
|
||||
| Yeni bir feature planla | `/everything-claude-code:plan "Auth ekle"` | planner |
|
||||
| Sistem mimarisi tasarla | `/everything-claude-code:plan` + architect agent | architect |
|
||||
| Önce testlerle kod yaz | `/tdd` | tdd-guide |
|
||||
| Yazdığım kodu incele | `/code-review` | code-reviewer |
|
||||
| Başarısız bir build'i düzelt | `/build-fix` | build-error-resolver |
|
||||
@@ -324,7 +324,7 @@ Nereden başlayacağınızdan emin değil misiniz? Bu hızlı referansı kullan
|
||||
|
||||
**Yeni bir feature başlatma:**
|
||||
```
|
||||
/ecc:plan "OAuth ile kullanıcı kimlik doğrulaması ekle"
|
||||
/everything-claude-code:plan "OAuth ile kullanıcı kimlik doğrulaması ekle"
|
||||
→ planner implementasyon planı oluşturur
|
||||
/tdd → tdd-guide önce-test-yaz'ı zorunlu kılar
|
||||
/code-review → code-reviewer çalışmanızı kontrol eder
|
||||
|
||||
@@ -4,7 +4,7 @@ description: Claude Code session geçmişini, aliasları ve session metadata'sı
|
||||
|
||||
# Sessions Komutu
|
||||
|
||||
Claude Code session geçmişini yönet - `~/.claude/sessions/` dizininde saklanan session'ları listele, yükle, alias ata ve düzenle.
|
||||
Claude Code session geçmişini yönet - `~/.claude/session-data/` dizininde saklanan session'ları listele, yükle, alias ata ve düzenle; eski `~/.claude/sessions/` dosyalarını da geriye dönük uyumluluk için okuyun.
|
||||
|
||||
## Kullanım
|
||||
|
||||
@@ -89,7 +89,7 @@ const size = sm.getSessionSize(session.sessionPath);
|
||||
const aliases = aa.getAliasesForSession(session.filename);
|
||||
|
||||
console.log('Session: ' + session.filename);
|
||||
console.log('Path: ~/.claude/sessions/' + session.filename);
|
||||
console.log('Path: ' + session.sessionPath);
|
||||
console.log('');
|
||||
console.log('Statistics:');
|
||||
console.log(' Lines: ' + stats.lineCount);
|
||||
@@ -287,7 +287,7 @@ $ARGUMENTS:
|
||||
|
||||
## Notlar
|
||||
|
||||
- Session'lar `~/.claude/sessions/` dizininde markdown dosyaları olarak saklanır
|
||||
- Session'lar `~/.claude/session-data/` dizininde markdown dosyaları olarak saklanır; eski `~/.claude/sessions/` dosyaları da okunmaya devam eder
|
||||
- Aliaslar `~/.claude/session-aliases.json` dosyasında saklanır
|
||||
- Session ID'leri kısaltılabilir (ilk 4-8 karakter genellikle yeterince benzersizdir)
|
||||
- Sık referans verilen session'lar için aliasları kullanın
|
||||
|
||||
@@ -292,7 +292,7 @@ Bu da geçerli bir seçimdir ve Claude Code ile iyi çalışır. LSP işlevselli
|
||||
|
||||
```markdown
|
||||
ralph-wiggum@claude-code-plugins # Loop otomasyonu
|
||||
frontend-design@claude-code-plugins # UI/UX desenleri
|
||||
frontend-patterns@claude-code-plugins # UI/UX desenleri
|
||||
commit-commands@claude-code-plugins # Git iş akışı
|
||||
security-guidance@claude-code-plugins # Güvenlik kontrolleri
|
||||
pr-review-toolkit@claude-code-plugins # PR otomasyonu
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Everything Claude Code (ECC) — 智能体指令
|
||||
|
||||
这是一个**生产就绪的 AI 编码插件**,提供 48 个专业代理、184 项技能、79 条命令以及自动化钩子工作流,用于软件开发。
|
||||
这是一个**生产就绪的 AI 编码插件**,提供 48 个专业代理、182 项技能、68 条命令以及自动化钩子工作流,用于软件开发。
|
||||
|
||||
**版本:** 2.0.0-rc.1
|
||||
|
||||
@@ -147,8 +147,8 @@
|
||||
|
||||
```
|
||||
agents/ — 48 个专业子代理
|
||||
skills/ — 184 个工作流技能和领域知识
|
||||
commands/ — 79 个斜杠命令
|
||||
skills/ — 182 个工作流技能和领域知识
|
||||
commands/ — 68 个斜杠命令
|
||||
hooks/ — 基于触发的自动化
|
||||
rules/ — 始终遵循的指导方针(通用 + 每种语言)
|
||||
scripts/ — 跨平台 Node.js 实用工具
|
||||
|
||||
@@ -1,5 +1,45 @@
|
||||
# 更新日志
|
||||
|
||||
## 2.0.0-rc.1 - 2026-04-28
|
||||
|
||||
### 亮点
|
||||
|
||||
* 为 Hermes 操作员叙事新增公开的 ECC 2.0 release candidate 表面。
|
||||
* 将 ECC 明确记录为跨 Claude Code、Codex、Cursor、OpenCode 和 Gemini 的可复用 cross-harness 基础层。
|
||||
* 新增经过清理的 Hermes import 技能表面,而不是发布私有操作员状态。
|
||||
|
||||
### 发布表面
|
||||
|
||||
* 将 package、plugin、marketplace、OpenCode、agent 和 README 元数据更新为 `2.0.0-rc.1`。
|
||||
* 在 `docs/releases/2.0.0-rc.1/` 下集中发布说明、社交草稿、发布清单、交接说明和演示提示词。
|
||||
* 新增 `docs/architecture/cross-harness.md`,并补充 ECC/Hermes 边界的回归覆盖。
|
||||
* `ecc2/` 版本保持独立;除非 release engineering 另有决定,它仍是 alpha control-plane scaffold。
|
||||
|
||||
### 备注
|
||||
|
||||
* 这是 release candidate,不是完整 ECC 2.0 control-plane 路线图的 GA 声明。
|
||||
* 预发布 npm 发布应使用 `next` dist-tag,除非 release engineering 明确选择其他策略。
|
||||
|
||||
## 1.10.0 - 2026-04-05
|
||||
|
||||
### 亮点
|
||||
|
||||
* 在数周 OSS 增长和 backlog 合并后,公开发布表面已同步到当前仓库状态。
|
||||
* 操作员工作流扩展了 voice、graph-ranking、billing、workspace 和 outbound 技能。
|
||||
* 媒体生成工作流扩展了 Manim 和 Remotion 优先的发布工具。
|
||||
* ECC 2.0 alpha control-plane binary 现在可从 `ecc2/` 本地构建,并提供首个可用的 CLI/TUI 表面。
|
||||
|
||||
### 发布表面
|
||||
|
||||
* 将 plugin、marketplace、Codex、OpenCode 和 agent 元数据更新为 `1.10.0`。
|
||||
* 将公开计数同步到当前 OSS 表面:38 个代理、156 个技能、72 个命令。
|
||||
* 刷新顶层安装文档和 marketplace 描述,使其匹配当前仓库状态。
|
||||
|
||||
### 备注
|
||||
|
||||
* Claude plugin 仍受平台级 rules 分发限制影响;selective install / OSS 路径仍是最可靠的完整安装方式。
|
||||
* 这是仓库表面校正和生态同步版本,不表示完整 ECC 2.0 路线图已经完成。
|
||||
|
||||
## 1.9.0 - 2026-03-20
|
||||
|
||||
### 亮点
|
||||
|
||||
@@ -81,6 +81,15 @@
|
||||
|
||||
## 最新动态
|
||||
|
||||
### v2.0.0-rc.1 — 表面同步、运营工作流与 ECC 2.0 Alpha(2026年4月)
|
||||
|
||||
* **公共表面已与真实仓库同步** —— 元数据、目录数量、插件清单以及安装文档现在都与实际开源表面保持一致。
|
||||
* **运营与外向型工作流扩展** —— `brand-voice`、`social-graph-ranker`、`customer-billing-ops`、`google-workspace-ops` 等运营型 skill 已纳入同一系统。
|
||||
* **媒体与发布工具补齐** —— `manim-video`、`remotion-video-creation` 以及社媒发布能力让技术讲解和发布流程直接在同一仓库内完成。
|
||||
* **框架与产品表面继续扩展** —— `nestjs-patterns`、更完整的 Codex/OpenCode 安装表面,以及跨 harness 打包改进,让仓库不再局限于 Claude Code。
|
||||
* **ECC 2.0 alpha 已进入仓库** —— `ecc2/` 下的 Rust 控制层现已可在本地构建,并提供 `dashboard`、`start`、`sessions`、`status`、`stop`、`resume` 与 `daemon` 命令。
|
||||
* **生态加固持续推进** —— AgentShield、ECC Tools 成本控制、计费门户工作与网站刷新仍围绕核心插件持续交付。
|
||||
|
||||
### v1.9.0 — 选择性安装与语言扩展 (2026年3月)
|
||||
|
||||
* **选择性安装架构** — 基于清单的安装流程,使用 `install-plan.js` 和 `install-apply.js` 进行针对性组件安装。状态存储跟踪已安装内容并支持增量更新。
|
||||
@@ -206,7 +215,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"
|
||||
|
||||
```bash
|
||||
# Try a command (plugin install uses namespaced form)
|
||||
/ecc:plan "Add user authentication"
|
||||
/everything-claude-code:plan "Add user authentication"
|
||||
|
||||
# Manual install (Option 2) uses the shorter form:
|
||||
# /plan "Add user authentication"
|
||||
@@ -215,7 +224,7 @@ Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/"
|
||||
/plugin list everything-claude-code@everything-claude-code
|
||||
```
|
||||
|
||||
**搞定!** 你现在可以使用 48 个智能体、184 项技能和 79 个命令了。
|
||||
**搞定!** 你现在可以使用 48 个智能体、182 项技能和 68 个命令了。
|
||||
|
||||
***
|
||||
|
||||
@@ -371,17 +380,15 @@ everything-claude-code/
|
||||
| |-- autonomous-loops/ # 自主循环模式:顺序流水线、PR 循环与 DAG 编排(新增)
|
||||
| |-- plankton-code-quality/ # 使用 Plankton hooks 的编写期代码质量控制(新增)
|
||||
|
|
||||
|-- commands/ # 快速执行的斜杠命令
|
||||
| |-- tdd.md # /tdd - 测试驱动开发
|
||||
|-- commands/ # 维护中的斜杠命令兼容层;优先使用 skills/
|
||||
| |-- plan.md # /plan - 实现规划
|
||||
| |-- e2e.md # /e2e - 端到端测试生成
|
||||
| |-- code-review.md # /code-review - 质量审查
|
||||
| |-- build-fix.md # /build-fix - 修复构建错误
|
||||
| |-- refactor-clean.md # /refactor-clean - 无用代码清理
|
||||
| |-- quality-gate.md # /quality-gate - 验证门禁
|
||||
| |-- learn.md # /learn - 会话中提取模式(长文指南)
|
||||
| |-- learn-eval.md # /learn-eval - 提取、评估并保存模式(新增)
|
||||
| |-- checkpoint.md # /checkpoint - 保存验证状态(长文指南)
|
||||
| |-- verify.md # /verify - 运行验证循环(长文指南)
|
||||
| |-- setup-pm.md # /setup-pm - 配置包管理器
|
||||
| |-- go-review.md # /go-review - Go 代码审查(新增)
|
||||
| |-- go-test.md # /go-test - Go TDD 工作流(新增)
|
||||
@@ -397,13 +404,17 @@ everything-claude-code/
|
||||
| |-- multi-backend.md # /multi-backend - 后端多服务编排(新增)
|
||||
| |-- multi-frontend.md # /multi-frontend - 前端多服务编排(新增)
|
||||
| |-- multi-workflow.md # /multi-workflow - 通用多服务工作流(新增)
|
||||
| |-- orchestrate.md # /orchestrate - 多代理协调
|
||||
| |-- sessions.md # /sessions - 会话历史管理
|
||||
| |-- eval.md # /eval - 按标准评估
|
||||
| |-- test-coverage.md # /test-coverage - 测试覆盖率分析
|
||||
| |-- update-docs.md # /update-docs - 更新文档
|
||||
| |-- update-codemaps.md # /update-codemaps - 更新代码映射
|
||||
| |-- python-review.md # /python-review - Python 代码审查(新增)
|
||||
|-- legacy-command-shims/ # 已退役短命令的按需归档,例如 /tdd 和 /eval
|
||||
| |-- tdd.md # /tdd - 优先使用 tdd-workflow 技能
|
||||
| |-- e2e.md # /e2e - 优先使用 e2e-testing 技能
|
||||
| |-- eval.md # /eval - 优先使用 eval-harness 技能
|
||||
| |-- verify.md # /verify - 优先使用 verification-loop 技能
|
||||
| |-- orchestrate.md # /orchestrate - 优先使用 dmux-workflows 或 multi-workflow
|
||||
|
|
||||
|-- rules/ # 必须遵循的规则(复制到 ~/.claude/rules/)
|
||||
| |-- README.md # 结构说明与安装指南
|
||||
@@ -654,9 +665,12 @@ cp -r everything-claude-code/rules/python/* ~/.claude/rules/
|
||||
cp -r everything-claude-code/rules/golang/* ~/.claude/rules/
|
||||
cp -r everything-claude-code/rules/php/* ~/.claude/rules/
|
||||
|
||||
# Copy commands
|
||||
# Copy maintained commands
|
||||
cp everything-claude-code/commands/*.md ~/.claude/commands/
|
||||
|
||||
# Retired shims live in legacy-command-shims/commands/.
|
||||
# Copy individual files from there only if you still need old names such as /tdd.
|
||||
|
||||
# Copy skills (core vs niche)
|
||||
# Recommended (new users): core/general skills only
|
||||
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
|
||||
@@ -746,16 +760,16 @@ rules/
|
||||
|
||||
## 我应该使用哪个代理?
|
||||
|
||||
不确定从哪里开始?使用这个快速参考:
|
||||
不确定从哪里开始?使用这个快速参考。技能是规范工作流表面,维护中的斜杠命令保留给偏命令式工作流。
|
||||
|
||||
| 我想要... | 使用此命令 | 使用的智能体 |
|
||||
| 我想要... | 使用此表面 | 使用的智能体 |
|
||||
|--------------|-----------------|------------|
|
||||
| 规划新功能 | `/ecc:plan "Add auth"` | planner |
|
||||
| 设计系统架构 | `/ecc:plan` + architect agent | architect |
|
||||
| 先写测试再写代码 | `/tdd` | tdd-guide |
|
||||
| 规划新功能 | `/everything-claude-code:plan "Add auth"` | planner |
|
||||
| 设计系统架构 | `/everything-claude-code:plan` + architect agent | architect |
|
||||
| 先写测试再写代码 | `tdd-workflow` 技能 | tdd-guide |
|
||||
| 评审我刚写的代码 | `/code-review` | code-reviewer |
|
||||
| 修复失败的构建 | `/build-fix` | build-error-resolver |
|
||||
| 运行端到端测试 | `/e2e` | e2e-runner |
|
||||
| 运行端到端测试 | `e2e-testing` 技能 | e2e-runner |
|
||||
| 查找安全漏洞 | `/security-scan` | security-reviewer |
|
||||
| 移除死代码 | `/refactor-clean` | refactor-cleaner |
|
||||
| 更新文档 | `/update-docs` | doc-updater |
|
||||
@@ -769,16 +783,16 @@ rules/
|
||||
**开始新功能:**
|
||||
|
||||
```
|
||||
/ecc:plan "使用 OAuth 添加用户身份验证"
|
||||
/everything-claude-code:plan "使用 OAuth 添加用户身份验证"
|
||||
→ 规划器创建实现蓝图
|
||||
/tdd → tdd-guide 强制执行先写测试
|
||||
tdd-workflow 技能 → tdd-guide 强制执行先写测试
|
||||
/code-review → 代码审查员检查你的工作
|
||||
```
|
||||
|
||||
**修复错误:**
|
||||
|
||||
```
|
||||
/tdd → tdd-guide:编写一个能复现问题的失败测试
|
||||
tdd-workflow 技能 → tdd-guide:编写一个能复现问题的失败测试
|
||||
→ 实现修复,验证测试通过
|
||||
/code-review → code-reviewer:捕捉回归问题
|
||||
```
|
||||
@@ -787,7 +801,7 @@ rules/
|
||||
|
||||
```
|
||||
/security-scan → security-reviewer: OWASP Top 10 审计
|
||||
/e2e → e2e-runner: 关键用户流程测试
|
||||
e2e-testing 技能 → e2e-runner: 关键用户流程测试
|
||||
/test-coverage → verify 80%+ 覆盖率
|
||||
```
|
||||
|
||||
@@ -1029,7 +1043,7 @@ Codex macOS 应用:
|
||||
|-----------|-------|---------|
|
||||
| 配置 | 1 | `.codex/config.toml` —— 顶级 approvals/sandbox/web\_search, MCP 服务器,通知,配置文件 |
|
||||
| AGENTS.md | 2 | 根目录(通用)+ `.codex/AGENTS.md`(Codex 特定补充) |
|
||||
| 技能 | 16 | `.agents/skills/` —— SKILL.md + agents/openai.yaml 每个技能 |
|
||||
| 技能 | 32 | `.agents/skills/` —— SKILL.md + agents/openai.yaml 每个技能 |
|
||||
| MCP 服务器 | 4 | GitHub, Context7, Memory, Sequential Thinking(基于命令) |
|
||||
| 配置文件 | 2 | `strict`(只读沙箱)和 `yolo`(完全自动批准) |
|
||||
| 代理角色 | 3 | `.codex/agents/` —— explorer, reviewer, docs-researcher |
|
||||
@@ -1038,24 +1052,42 @@ Codex macOS 应用:
|
||||
|
||||
位于 `.agents/skills/` 的技能会被 Codex 自动加载:
|
||||
|
||||
`claude-api`、`frontend-design` 和 `skill-creator` 等 Anthropic 官方技能不会在此重复打包。需要这些官方版本时,请从 [`anthropics/skills`](https://github.com/anthropics/skills) 安装。
|
||||
|
||||
| 技能 | 描述 |
|
||||
|-------|-------------|
|
||||
| tdd-workflow | 测试驱动开发,覆盖率 80%+ |
|
||||
| security-review | 全面的安全检查清单 |
|
||||
| coding-standards | 通用编码标准 |
|
||||
| frontend-patterns | React/Next.js 模式 |
|
||||
| frontend-slides | HTML 演示文稿、PPTX 转换、视觉风格探索 |
|
||||
| agent-introspection-debugging | 调试智能体行为、路由和提示边界 |
|
||||
| agent-sort | 整理智能体目录和分配表面 |
|
||||
| api-design | REST API 设计模式 |
|
||||
| article-writing | 根据笔记和语音参考进行长文写作 |
|
||||
| content-engine | 平台原生的社交内容和再利用 |
|
||||
| market-research | 带来源归属的市场和竞争对手研究 |
|
||||
| investor-materials | 幻灯片、备忘录、模型和一页纸文档 |
|
||||
| investor-outreach | 个性化外联、跟进和介绍摘要 |
|
||||
| backend-patterns | API 设计、数据库、缓存 |
|
||||
| brand-voice | 从真实内容中提取来源驱动的写作风格 |
|
||||
| bun-runtime | Bun 运行时、包管理器、打包器和测试运行器 |
|
||||
| coding-standards | 通用编码标准 |
|
||||
| content-engine | 平台原生的社交内容和再利用 |
|
||||
| crosspost | X、LinkedIn、Threads 等多平台内容分发 |
|
||||
| deep-research | 多源研究、综合和来源归属 |
|
||||
| dmux-workflows | 使用 tmux pane manager 进行多智能体编排 |
|
||||
| documentation-lookup | 通过 Context7 MCP 获取最新库和框架文档 |
|
||||
| e2e-testing | Playwright 端到端测试 |
|
||||
| eval-harness | 评估驱动的开发 |
|
||||
| everything-claude-code | ECC 项目的开发约定和模式 |
|
||||
| exa-search | 通过 Exa MCP 进行网络、代码和公司研究 |
|
||||
| fal-ai-media | 图像、视频和音频的统一媒体生成 |
|
||||
| frontend-patterns | React/Next.js 模式 |
|
||||
| frontend-slides | HTML 演示文稿、PPTX 转换、视觉风格探索 |
|
||||
| investor-materials | 幻灯片、备忘录、模型和一页纸文档 |
|
||||
| investor-outreach | 个性化外联、跟进和介绍摘要 |
|
||||
| market-research | 带来源归属的市场和竞争对手研究 |
|
||||
| mcp-server-patterns | 使用 Node/TypeScript SDK 构建 MCP 服务器 |
|
||||
| nextjs-turbopack | Next.js 16+ 和 Turbopack 增量打包 |
|
||||
| product-capability | 将产品目标转化为有范围的能力图 |
|
||||
| security-review | 全面的安全检查清单 |
|
||||
| strategic-compact | 上下文管理 |
|
||||
| api-design | REST API 设计模式 |
|
||||
| tdd-workflow | 测试驱动开发,覆盖率 80%+ |
|
||||
| verification-loop | 构建、测试、代码检查、类型检查、安全 |
|
||||
| video-editing | 使用 FFmpeg 和 Remotion 的 AI 辅助视频编辑工作流 |
|
||||
| x-api | X/Twitter 发帖和分析 API 集成 |
|
||||
|
||||
### 关键限制
|
||||
|
||||
@@ -1101,8 +1133,8 @@ opencode
|
||||
| 功能特性 | Claude Code | OpenCode | 状态 |
|
||||
|---------|-------------|----------|--------|
|
||||
| 智能体 | PASS: 48 个 | PASS: 12 个 | **Claude Code 领先** |
|
||||
| 命令 | PASS: 79 个 | PASS: 31 个 | **Claude Code 领先** |
|
||||
| 技能 | PASS: 184 项 | PASS: 37 项 | **Claude Code 领先** |
|
||||
| 命令 | PASS: 68 个 | PASS: 31 个 | **Claude Code 领先** |
|
||||
| 技能 | PASS: 182 项 | PASS: 37 项 | **Claude Code 领先** |
|
||||
| 钩子 | PASS: 8 种事件类型 | PASS: 11 种事件 | **OpenCode 更多!** |
|
||||
| 规则 | PASS: 29 条 | PASS: 13 条指令 | **Claude Code 领先** |
|
||||
| MCP 服务器 | PASS: 14 个 | PASS: 完整 | **完全对等** |
|
||||
@@ -1122,21 +1154,17 @@ OpenCode 的插件系统比 Claude Code 更复杂,有 20 多种事件类型:
|
||||
|
||||
**额外的 OpenCode 事件**:`file.edited`、`file.watcher.updated`、`message.updated`、`lsp.client.diagnostics`、`tui.toast.show` 等等。
|
||||
|
||||
### 可用命令(31+)
|
||||
### 维护中的斜杠命令
|
||||
|
||||
| 命令 | 描述 |
|
||||
|---------|-------------|
|
||||
| `/plan` | 创建实施计划 |
|
||||
| `/tdd` | 强制执行 TDD 工作流 |
|
||||
| `/code-review` | 审查代码变更 |
|
||||
| `/build-fix` | 修复构建错误 |
|
||||
| `/e2e` | 生成端到端测试 |
|
||||
| `/refactor-clean` | 移除死代码 |
|
||||
| `/orchestrate` | 多智能体工作流 |
|
||||
| `/learn` | 从会话中提取模式 |
|
||||
| `/checkpoint` | 保存验证状态 |
|
||||
| `/verify` | 运行验证循环 |
|
||||
| `/eval` | 根据标准进行评估 |
|
||||
| `/quality-gate` | 运行维护中的验证门禁 |
|
||||
| `/update-docs` | 更新文档 |
|
||||
| `/update-codemaps` | 更新代码地图 |
|
||||
| `/test-coverage` | 分析覆盖率 |
|
||||
@@ -1213,8 +1241,8 @@ ECC 是**第一个最大化利用每个主要 AI 编码工具的插件**。以
|
||||
| 功能特性 | Claude Code | Cursor IDE | Codex CLI | OpenCode |
|
||||
|---------|------------|------------|-----------|----------|
|
||||
| **智能体** | 48 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |
|
||||
| **命令** | 79 | 共享 | 基于指令 | 31 |
|
||||
| **技能** | 184 | 共享 | 10 (原生格式) | 37 |
|
||||
| **命令** | 68 | 共享 | 基于指令 | 31 |
|
||||
| **技能** | 182 | 共享 | 10 (原生格式) | 37 |
|
||||
| **钩子事件** | 8 种类型 | 15 种类型 | 暂无 | 11 种类型 |
|
||||
| **钩子脚本** | 20+ 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 |
|
||||
| **规则** | 34 (通用 + 语言) | 34 (YAML 前页) | 基于指令 | 13 条指令 |
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
description: 从 ~/.claude/sessions/ 加载最新的会话文件,并从上次会话结束的地方恢复工作,保留完整上下文。
|
||||
description: 从 ~/.claude/session-data/ 加载最新的会话文件,并从上次会话结束的地方恢复工作,保留完整上下文。
|
||||
---
|
||||
|
||||
# 恢复会话命令
|
||||
@@ -17,10 +17,10 @@ description: 从 ~/.claude/sessions/ 加载最新的会话文件,并从上次
|
||||
## 用法
|
||||
|
||||
```
|
||||
/resume-session # 加载 ~/.claude/sessions/ 目录下最新的文件
|
||||
/resume-session # 加载 ~/.claude/session-data/ 目录下最新的文件
|
||||
/resume-session 2024-01-15 # 加载该日期最新的会话
|
||||
/resume-session ~/.claude/sessions/2024-01-15-session.tmp # 加载特定的旧格式文件
|
||||
/resume-session ~/.claude/sessions/2024-01-15-abc123de-session.tmp # 加载当前短ID格式的会话文件
|
||||
/resume-session ~/.claude/session-data/2024-01-15-abc123de-session.tmp # 加载当前短ID格式的会话文件
|
||||
```
|
||||
|
||||
## 流程
|
||||
@@ -29,18 +29,18 @@ description: 从 ~/.claude/sessions/ 加载最新的会话文件,并从上次
|
||||
|
||||
如果未提供参数:
|
||||
|
||||
1. 检查 `~/.claude/sessions/`
|
||||
1. 检查 `~/.claude/session-data/`
|
||||
2. 选择最近修改的 `*-session.tmp` 文件
|
||||
3. 如果文件夹不存在或没有匹配的文件,告知用户:
|
||||
```
|
||||
在 ~/.claude/sessions/ 中未找到会话文件。
|
||||
在 ~/.claude/session-data/ 中未找到会话文件。
|
||||
请在会话结束时运行 /save-session 来创建一个。
|
||||
```
|
||||
然后停止。
|
||||
|
||||
如果提供了参数:
|
||||
|
||||
* 如果看起来像日期 (`YYYY-MM-DD`),则在 `~/.claude/sessions/` 中搜索匹配
|
||||
* 如果看起来像日期 (`YYYY-MM-DD`),则先在 `~/.claude/session-data/` 中搜索,再回退到旧的 `~/.claude/sessions/`,匹配
|
||||
`YYYY-MM-DD-session.tmp`(旧格式)或 `YYYY-MM-DD-<shortid>-session.tmp`(当前格式)的文件,
|
||||
并加载该日期最近修改的版本
|
||||
* 如果看起来像文件路径,则直接读取该文件
|
||||
@@ -114,7 +114,7 @@ PASS: 已完成:[数量] 项已确认
|
||||
## 示例输出
|
||||
|
||||
```
|
||||
SESSION LOADED: /Users/you/.claude/sessions/2024-01-15-abc123de-session.tmp
|
||||
SESSION LOADED: /Users/you/.claude/session-data/2024-01-15-abc123de-session.tmp
|
||||
════════════════════════════════════════════════
|
||||
|
||||
项目:my-app — JWT 认证
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
description: 将当前会话状态保存到 ~/.claude/sessions/ 目录下带日期的文件中,以便在未来的会话中恢复完整上下文并继续工作。
|
||||
description: 将当前会话状态保存到 ~/.claude/session-data/ 目录下带日期的文件中,以便在未来的会话中恢复完整上下文并继续工作。
|
||||
---
|
||||
|
||||
# 保存会话命令
|
||||
@@ -29,12 +29,12 @@ description: 将当前会话状态保存到 ~/.claude/sessions/ 目录下带日
|
||||
在用户的 Claude 主目录中创建规范的会话文件夹:
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.claude/sessions
|
||||
mkdir -p ~/.claude/session-data
|
||||
```
|
||||
|
||||
### 步骤 3:写入会话文件
|
||||
|
||||
创建 `~/.claude/sessions/YYYY-MM-DD-<short-id>-session.tmp`,使用今天的实际日期和一个满足 `session-manager.js` 中 `SESSION_FILENAME_REGEX` 强制规则的短 ID:
|
||||
创建 `~/.claude/session-data/YYYY-MM-DD-<short-id>-session.tmp`,使用今天的实际日期和一个满足 `session-manager.js` 中 `SESSION_FILENAME_REGEX` 强制规则的短 ID:
|
||||
|
||||
* 允许的字符:小写 `a-z`,数字 `0-9`,连字符 `-`
|
||||
* 最小长度:8 个字符
|
||||
@@ -248,5 +248,5 @@ mkdir -p ~/.claude/sessions
|
||||
* “什么没有成功”部分是最关键的——没有它,未来的会话将盲目地重试失败的方法
|
||||
* 如果用户要求中途保存会话(而不仅仅是在结束时),则保存目前已知的内容,并清楚地标记进行中的项目
|
||||
* 该文件旨在通过 `/resume-session` 在下次会话开始时由 Claude 读取
|
||||
* 使用规范的全局会话存储:`~/.claude/sessions/`
|
||||
* 使用规范的全局会话存储:`~/.claude/session-data/`
|
||||
* 对于任何新的会话文件,首选短 ID 文件名形式(`YYYY-MM-DD-<short-id>-session.tmp`)
|
||||
|
||||
@@ -4,7 +4,7 @@ description: 管理Claude Code会话历史、别名和会话元数据。
|
||||
|
||||
# Sessions 命令
|
||||
|
||||
管理 Claude Code 会话历史 - 列出、加载、设置别名和编辑存储在 `~/.claude/sessions/` 中的会话。
|
||||
管理 Claude Code 会话历史 - 列出、加载、设置别名和编辑存储在 `~/.claude/session-data/` 中的会话,同时兼容读取旧的 `~/.claude/sessions/` 文件。
|
||||
|
||||
## 用法
|
||||
|
||||
@@ -91,7 +91,7 @@ const size = sm.getSessionSize(session.sessionPath);
|
||||
const aliases = aa.getAliasesForSession(session.filename);
|
||||
|
||||
console.log('Session: ' + session.filename);
|
||||
console.log('Path: ~/.claude/sessions/' + session.filename);
|
||||
console.log('Path: ' + session.sessionPath);
|
||||
console.log('');
|
||||
console.log('Statistics:');
|
||||
console.log(' Lines: ' + stats.lineCount);
|
||||
@@ -334,7 +334,7 @@ $ARGUMENTS:
|
||||
|
||||
## 备注
|
||||
|
||||
* 会话以 Markdown 文件形式存储在 `~/.claude/sessions/`
|
||||
* 会话以 Markdown 文件形式存储在 `~/.claude/session-data/`,并继续兼容读取旧的 `~/.claude/sessions/`
|
||||
* 别名存储在 `~/.claude/session-aliases.json`
|
||||
* 会话 ID 可以缩短(通常前 4-8 个字符就足够唯一)
|
||||
* 为经常引用的会话使用别名
|
||||
|
||||
@@ -61,7 +61,7 @@ claude plugin install typescript-lsp@claude-plugins-official
|
||||
**工作流:**
|
||||
|
||||
* `commit-commands` - Git 工作流
|
||||
* `frontend-design` - UI 模式
|
||||
* `frontend-patterns` - UI 模式
|
||||
* `feature-dev` - 功能开发
|
||||
|
||||
***
|
||||
|
||||
@@ -1,337 +0,0 @@
|
||||
---
|
||||
name: claude-api
|
||||
description: Anthropic Claude API 的 Python 和 TypeScript 使用模式。涵盖 Messages API、流式处理、工具使用、视觉功能、扩展思维、批量处理、提示缓存和 Claude Agent SDK。适用于使用 Claude API 或 Anthropic SDK 构建应用程序的场景。
|
||||
origin: ECC
|
||||
---
|
||||
|
||||
# Claude API
|
||||
|
||||
使用 Anthropic Claude API 和 SDK 构建应用程序。
|
||||
|
||||
## 何时激活
|
||||
|
||||
* 构建调用 Claude API 的应用程序
|
||||
* 代码导入 `anthropic` (Python) 或 `@anthropic-ai/sdk` (TypeScript)
|
||||
* 用户询问 Claude API 模式、工具使用、流式传输或视觉功能
|
||||
* 使用 Claude Agent SDK 实现智能体工作流
|
||||
* 优化 API 成本、令牌使用或延迟
|
||||
|
||||
## 模型选择
|
||||
|
||||
| 模型 | ID | 最适合 |
|
||||
|-------|-----|----------|
|
||||
| Opus 4.1 | `claude-opus-4-1` | 复杂推理、架构设计、研究 |
|
||||
| Sonnet 4 | `claude-sonnet-4-0` | 平衡的编码任务,大多数开发工作 |
|
||||
| Haiku 3.5 | `claude-3-5-haiku-latest` | 快速响应、高吞吐量、成本敏感型 |
|
||||
|
||||
默认使用 Sonnet 4,除非任务需要深度推理(Opus)或速度/成本优化(Haiku)。对于生产环境,优先使用固定的快照 ID 而非别名。
|
||||
|
||||
## Python SDK
|
||||
|
||||
### 安装
|
||||
|
||||
```bash
|
||||
pip install anthropic
|
||||
```
|
||||
|
||||
### 基本消息
|
||||
|
||||
```python
|
||||
import anthropic
|
||||
|
||||
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from env
|
||||
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=1024,
|
||||
messages=[
|
||||
{"role": "user", "content": "Explain async/await in Python"}
|
||||
]
|
||||
)
|
||||
print(message.content[0].text)
|
||||
```
|
||||
|
||||
### 流式传输
|
||||
|
||||
```python
|
||||
with client.messages.stream(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=1024,
|
||||
messages=[{"role": "user", "content": "Write a haiku about coding"}]
|
||||
) as stream:
|
||||
for text in stream.text_stream:
|
||||
print(text, end="", flush=True)
|
||||
```
|
||||
|
||||
### 系统提示词
|
||||
|
||||
```python
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=1024,
|
||||
system="You are a senior Python developer. Be concise.",
|
||||
messages=[{"role": "user", "content": "Review this function"}]
|
||||
)
|
||||
```
|
||||
|
||||
## TypeScript SDK
|
||||
|
||||
### 安装
|
||||
|
||||
```bash
|
||||
npm install @anthropic-ai/sdk
|
||||
```
|
||||
|
||||
### 基本消息
|
||||
|
||||
```typescript
|
||||
import Anthropic from "@anthropic-ai/sdk";
|
||||
|
||||
const client = new Anthropic(); // reads ANTHROPIC_API_KEY from env
|
||||
|
||||
const message = await client.messages.create({
|
||||
model: "claude-sonnet-4-0",
|
||||
max_tokens: 1024,
|
||||
messages: [
|
||||
{ role: "user", content: "Explain async/await in TypeScript" }
|
||||
],
|
||||
});
|
||||
console.log(message.content[0].text);
|
||||
```
|
||||
|
||||
### 流式传输
|
||||
|
||||
```typescript
|
||||
const stream = client.messages.stream({
|
||||
model: "claude-sonnet-4-0",
|
||||
max_tokens: 1024,
|
||||
messages: [{ role: "user", content: "Write a haiku" }],
|
||||
});
|
||||
|
||||
for await (const event of stream) {
|
||||
if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
|
||||
process.stdout.write(event.delta.text);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 工具使用
|
||||
|
||||
定义工具并让 Claude 调用它们:
|
||||
|
||||
```python
|
||||
tools = [
|
||||
{
|
||||
"name": "get_weather",
|
||||
"description": "Get current weather for a location",
|
||||
"input_schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"location": {"type": "string", "description": "City name"},
|
||||
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
|
||||
},
|
||||
"required": ["location"]
|
||||
}
|
||||
}
|
||||
]
|
||||
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=1024,
|
||||
tools=tools,
|
||||
messages=[{"role": "user", "content": "What's the weather in SF?"}]
|
||||
)
|
||||
|
||||
# Handle tool use response
|
||||
for block in message.content:
|
||||
if block.type == "tool_use":
|
||||
# Execute the tool with block.input
|
||||
result = get_weather(**block.input)
|
||||
# Send result back
|
||||
follow_up = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=1024,
|
||||
tools=tools,
|
||||
messages=[
|
||||
{"role": "user", "content": "What's the weather in SF?"},
|
||||
{"role": "assistant", "content": message.content},
|
||||
{"role": "user", "content": [
|
||||
{"type": "tool_result", "tool_use_id": block.id, "content": str(result)}
|
||||
]}
|
||||
]
|
||||
)
|
||||
```
|
||||
|
||||
## 视觉功能
|
||||
|
||||
发送图像进行分析:
|
||||
|
||||
```python
|
||||
import base64
|
||||
|
||||
with open("diagram.png", "rb") as f:
|
||||
image_data = base64.standard_b64encode(f.read()).decode("utf-8")
|
||||
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=1024,
|
||||
messages=[{
|
||||
"role": "user",
|
||||
"content": [
|
||||
{"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": image_data}},
|
||||
{"type": "text", "text": "Describe this diagram"}
|
||||
]
|
||||
}]
|
||||
)
|
||||
```
|
||||
|
||||
## 扩展思考
|
||||
|
||||
针对复杂推理任务:
|
||||
|
||||
```python
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=16000,
|
||||
thinking={
|
||||
"type": "enabled",
|
||||
"budget_tokens": 10000
|
||||
},
|
||||
messages=[{"role": "user", "content": "Solve this math problem step by step..."}]
|
||||
)
|
||||
|
||||
for block in message.content:
|
||||
if block.type == "thinking":
|
||||
print(f"Thinking: {block.thinking}")
|
||||
elif block.type == "text":
|
||||
print(f"Answer: {block.text}")
|
||||
```
|
||||
|
||||
## 提示词缓存
|
||||
|
||||
缓存大型系统提示词或上下文以降低成本:
|
||||
|
||||
```python
|
||||
message = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=1024,
|
||||
system=[
|
||||
{"type": "text", "text": large_system_prompt, "cache_control": {"type": "ephemeral"}}
|
||||
],
|
||||
messages=[{"role": "user", "content": "Question about the cached context"}]
|
||||
)
|
||||
# Check cache usage
|
||||
print(f"Cache read: {message.usage.cache_read_input_tokens}")
|
||||
print(f"Cache creation: {message.usage.cache_creation_input_tokens}")
|
||||
```
|
||||
|
||||
## 批量 API
|
||||
|
||||
以 50% 的成本降低异步处理大量数据:
|
||||
|
||||
```python
|
||||
import time
|
||||
|
||||
batch = client.messages.batches.create(
|
||||
requests=[
|
||||
{
|
||||
"custom_id": f"request-{i}",
|
||||
"params": {
|
||||
"model": "claude-sonnet-4-0",
|
||||
"max_tokens": 1024,
|
||||
"messages": [{"role": "user", "content": prompt}]
|
||||
}
|
||||
}
|
||||
for i, prompt in enumerate(prompts)
|
||||
]
|
||||
)
|
||||
|
||||
# Poll for completion
|
||||
while True:
|
||||
status = client.messages.batches.retrieve(batch.id)
|
||||
if status.processing_status == "ended":
|
||||
break
|
||||
time.sleep(30)
|
||||
|
||||
# Get results
|
||||
for result in client.messages.batches.results(batch.id):
|
||||
print(result.result.message.content[0].text)
|
||||
```
|
||||
|
||||
## Claude Agent SDK
|
||||
|
||||
构建多步骤智能体:
|
||||
|
||||
```python
|
||||
# Note: Agent SDK API surface may change — check official docs
|
||||
import anthropic
|
||||
|
||||
# Define tools as functions
|
||||
tools = [{
|
||||
"name": "search_codebase",
|
||||
"description": "Search the codebase for relevant code",
|
||||
"input_schema": {
|
||||
"type": "object",
|
||||
"properties": {"query": {"type": "string"}},
|
||||
"required": ["query"]
|
||||
}
|
||||
}]
|
||||
|
||||
# Run an agentic loop with tool use
|
||||
client = anthropic.Anthropic()
|
||||
messages = [{"role": "user", "content": "Review the auth module for security issues"}]
|
||||
|
||||
while True:
|
||||
response = client.messages.create(
|
||||
model="claude-sonnet-4-0",
|
||||
max_tokens=4096,
|
||||
tools=tools,
|
||||
messages=messages,
|
||||
)
|
||||
if response.stop_reason == "end_turn":
|
||||
break
|
||||
# Handle tool calls and continue the loop
|
||||
messages.append({"role": "assistant", "content": response.content})
|
||||
# ... execute tools and append tool_result messages
|
||||
```
|
||||
|
||||
## 成本优化
|
||||
|
||||
| 策略 | 节省幅度 | 使用时机 |
|
||||
|----------|---------|-------------|
|
||||
| 提示词缓存 | 缓存令牌成本降低高达 90% | 重复的系统提示词或上下文 |
|
||||
| 批量 API | 50% | 非时间敏感的批量处理 |
|
||||
| 使用 Haiku 而非 Sonnet | ~75% | 简单任务、分类、提取 |
|
||||
| 缩短 max\_tokens | 可变 | 已知输出较短时 |
|
||||
| 流式传输 | 无(成本相同) | 更好的用户体验,价格相同 |
|
||||
|
||||
## 错误处理
|
||||
|
||||
```python
|
||||
import time
|
||||
|
||||
from anthropic import APIError, RateLimitError, APIConnectionError
|
||||
|
||||
try:
|
||||
message = client.messages.create(...)
|
||||
except RateLimitError:
|
||||
# Back off and retry
|
||||
time.sleep(60)
|
||||
except APIConnectionError:
|
||||
# Network issue, retry with backoff
|
||||
pass
|
||||
except APIError as e:
|
||||
print(f"API error {e.status_code}: {e.message}")
|
||||
```
|
||||
|
||||
## 环境设置
|
||||
|
||||
```bash
|
||||
# Required
|
||||
export ANTHROPIC_API_KEY="your-api-key-here"
|
||||
|
||||
# Optional: set default model
|
||||
export ANTHROPIC_MODEL="claude-sonnet-4-0"
|
||||
```
|
||||
|
||||
切勿硬编码 API 密钥。始终使用环境变量。
|
||||
@@ -162,13 +162,14 @@ mkdir -p $TARGET/skills $TARGET/rules
|
||||
| `investor-materials` | 宣传文稿、一页简介、投资者备忘录和财务模型 |
|
||||
| `investor-outreach` | 个性化的投资者冷邮件、熟人介绍和后续跟进 |
|
||||
|
||||
**类别:研究与API(3项技能)**
|
||||
**类别:研究与API(2项技能)**
|
||||
|
||||
| 技能 | 描述 |
|
||||
|-------|-------------|
|
||||
| `deep-research` | 使用 firecrawl 和 exa MCP 进行多源深度研究,并生成带引用的报告 |
|
||||
| `exa-search` | 通过 Exa MCP 进行网络、代码、公司和人员的神经搜索 |
|
||||
| `claude-api` | Anthropic Claude API 模式:消息、流式处理、工具使用、视觉、批处理、Agent SDK |
|
||||
|
||||
`claude-api` 是 Anthropic 官方技能;需要时请从 [`anthropics/skills`](https://github.com/anthropics/skills) 安装官方版本,而不是通过 ECC 重复打包。
|
||||
|
||||
**类别:社交与内容分发(2项技能)**
|
||||
|
||||
@@ -198,10 +199,20 @@ mkdir -p $TARGET/skills $TARGET/rules
|
||||
|
||||
### 2d: 执行安装
|
||||
|
||||
对于每个选定的技能,复制整个技能目录:
|
||||
对于每个选定的技能,请从正确的源目录复制整个技能目录:
|
||||
|
||||
```bash
|
||||
cp -r $ECC_ROOT/skills/<skill-name> $TARGET/skills/
|
||||
# 核心技能位于 .agents/skills/
|
||||
cp -R "$ECC_ROOT/.agents/skills/<skill-name>" "$TARGET/skills/"
|
||||
|
||||
# 细分技能位于 skills/
|
||||
cp -R "$ECC_ROOT/skills/<skill-name>" "$TARGET/skills/"
|
||||
```
|
||||
|
||||
遍历 glob 得到的源目录时,不要把带 trailing slash 的源路径直接传给 `cp`。显式使用目录名作为目标名:
|
||||
|
||||
```bash
|
||||
cp -R "${src%/}" "$TARGET/skills/$(basename "${src%/}")"
|
||||
```
|
||||
|
||||
注意:`continuous-learning` 和 `continuous-learning-v2` 有额外的文件(config.json、钩子、脚本)——确保复制整个目录,而不仅仅是 SKILL.md。
|
||||
|
||||
@@ -292,7 +292,7 @@ mgrep --web "Next.js 15 app router changes" # Web search
|
||||
|
||||
```markdown
|
||||
ralph-wiggum@claude-code-plugins # 循环自动化
|
||||
frontend-design@claude-code-plugins # UI/UX 模式
|
||||
frontend-patterns@claude-code-plugins # UI/UX 模式
|
||||
commit-commands@claude-code-plugins # Git 工作流
|
||||
security-guidance@claude-code-plugins # 安全检查
|
||||
pr-review-toolkit@claude-code-plugins # PR 自动化
|
||||
|
||||
@@ -89,7 +89,7 @@ cp -r everything-claude-code/rules/* ~/.claude/rules/
|
||||
|
||||
```bash
|
||||
# 嘗試一個指令(外掛安裝使用命名空間形式)
|
||||
/ecc:plan "新增使用者認證"
|
||||
/everything-claude-code:plan "新增使用者認證"
|
||||
|
||||
# 手動安裝(選項2)使用簡短形式:
|
||||
# /plan "新增使用者認證"
|
||||
|
||||
@@ -98,6 +98,12 @@ export ECC_HOOK_PROFILE=standard
|
||||
|
||||
# Disable specific hook IDs (comma-separated)
|
||||
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
|
||||
|
||||
# Cap SessionStart additional context (default: 8000 chars)
|
||||
export ECC_SESSION_START_MAX_CHARS=4000
|
||||
|
||||
# Disable SessionStart additional context entirely
|
||||
export ECC_SESSION_START_CONTEXT=off
|
||||
```
|
||||
|
||||
Profiles:
|
||||
@@ -228,7 +234,7 @@ Async hooks run in the background. They cannot block tool execution.
|
||||
|
||||
## Cross-Platform Notes
|
||||
|
||||
Hook logic is implemented in Node.js scripts for cross-platform behavior on Windows, macOS, and Linux. A small number of shell wrappers are retained for continuous-learning observer hooks; those wrappers are profile-gated and have Windows-safe fallback behavior.
|
||||
Hook logic is implemented in Node.js scripts for cross-platform behavior on Windows, macOS, and Linux. The continuous-learning observer is exposed as a Node-mode hook and delegates to its existing `observe.sh` implementation through a profile-gated runner with Windows-safe fallback behavior.
|
||||
|
||||
## Related
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "node -e \"const p=require('path');const r=(()=>{var e=process.env.CLAUDE_PLUGIN_ROOT;if(e&&e.trim())return e.trim();var p=require('path'),f=require('fs'),h=require('os').homedir(),d=p.join(h,'.claude'),q=p.join('scripts','lib','utils.js');if(f.existsSync(p.join(d,q)))return d;for(var s of [[\\\"ecc\\\"],[\\\"ecc@ecc\\\"],[\\\"marketplace\\\",\\\"ecc\\\"],[\\\"everything-claude-code\\\"],[\\\"everything-claude-code@everything-claude-code\\\"],[\\\"marketplace\\\",\\\"everything-claude-code\\\"]]){var l=p.join(d,'plugins',...s);if(f.existsSync(p.join(l,q)))return l}try{for(var g of [\\\"ecc\\\",\\\"everything-claude-code\\\"]){var b=p.join(d,'plugins','cache',g);for(var o of f.readdirSync(b,{withFileTypes:true})){if(!o.isDirectory())continue;for(var v of f.readdirSync(p.join(b,o.name),{withFileTypes:true})){if(!v.isDirectory())continue;var c=p.join(b,o.name,v.name);if(f.existsSync(p.join(c,q)))return c}}}}catch(x){}return d})();const s=p.join(r,'scripts/hooks/plugin-hook-bootstrap.js');process.env.CLAUDE_PLUGIN_ROOT=r;process.argv.splice(1,0,s);require(s)\" shell scripts/hooks/run-with-flags-shell.sh pre:observe skills/continuous-learning-v2/hooks/observe.sh standard,strict",
|
||||
"command": "node -e \"const p=require('path');const r=(()=>{var e=process.env.CLAUDE_PLUGIN_ROOT;if(e&&e.trim())return e.trim();var p=require('path'),f=require('fs'),h=require('os').homedir(),d=p.join(h,'.claude'),q=p.join('scripts','lib','utils.js');if(f.existsSync(p.join(d,q)))return d;for(var s of [[\\\"ecc\\\"],[\\\"ecc@ecc\\\"],[\\\"marketplace\\\",\\\"ecc\\\"],[\\\"everything-claude-code\\\"],[\\\"everything-claude-code@everything-claude-code\\\"],[\\\"marketplace\\\",\\\"everything-claude-code\\\"]]){var l=p.join(d,'plugins',...s);if(f.existsSync(p.join(l,q)))return l}try{for(var g of [\\\"ecc\\\",\\\"everything-claude-code\\\"]){var b=p.join(d,'plugins','cache',g);for(var o of f.readdirSync(b,{withFileTypes:true})){if(!o.isDirectory())continue;for(var v of f.readdirSync(p.join(b,o.name),{withFileTypes:true})){if(!v.isDirectory())continue;var c=p.join(b,o.name,v.name);if(f.existsSync(p.join(c,q)))return c}}}}catch(x){}return d})();const s=p.join(r,'scripts/hooks/plugin-hook-bootstrap.js');process.env.CLAUDE_PLUGIN_ROOT=r;process.argv.splice(1,0,s);require(s)\" node scripts/hooks/run-with-flags.js pre:observe scripts/hooks/observe-runner.js standard,strict",
|
||||
"async": true,
|
||||
"timeout": 10
|
||||
}
|
||||
@@ -212,7 +212,7 @@
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "node -e \"const p=require('path');const r=(()=>{var e=process.env.CLAUDE_PLUGIN_ROOT;if(e&&e.trim())return e.trim();var p=require('path'),f=require('fs'),h=require('os').homedir(),d=p.join(h,'.claude'),q=p.join('scripts','lib','utils.js');if(f.existsSync(p.join(d,q)))return d;for(var s of [[\\\"ecc\\\"],[\\\"ecc@ecc\\\"],[\\\"marketplace\\\",\\\"ecc\\\"],[\\\"everything-claude-code\\\"],[\\\"everything-claude-code@everything-claude-code\\\"],[\\\"marketplace\\\",\\\"everything-claude-code\\\"]]){var l=p.join(d,'plugins',...s);if(f.existsSync(p.join(l,q)))return l}try{for(var g of [\\\"ecc\\\",\\\"everything-claude-code\\\"]){var b=p.join(d,'plugins','cache',g);for(var o of f.readdirSync(b,{withFileTypes:true})){if(!o.isDirectory())continue;for(var v of f.readdirSync(p.join(b,o.name),{withFileTypes:true})){if(!v.isDirectory())continue;var c=p.join(b,o.name,v.name);if(f.existsSync(p.join(c,q)))return c}}}}catch(x){}return d})();const s=p.join(r,'scripts/hooks/plugin-hook-bootstrap.js');process.env.CLAUDE_PLUGIN_ROOT=r;process.argv.splice(1,0,s);require(s)\" shell scripts/hooks/run-with-flags-shell.sh post:observe skills/continuous-learning-v2/hooks/observe.sh standard,strict",
|
||||
"command": "node -e \"const p=require('path');const r=(()=>{var e=process.env.CLAUDE_PLUGIN_ROOT;if(e&&e.trim())return e.trim();var p=require('path'),f=require('fs'),h=require('os').homedir(),d=p.join(h,'.claude'),q=p.join('scripts','lib','utils.js');if(f.existsSync(p.join(d,q)))return d;for(var s of [[\\\"ecc\\\"],[\\\"ecc@ecc\\\"],[\\\"marketplace\\\",\\\"ecc\\\"],[\\\"everything-claude-code\\\"],[\\\"everything-claude-code@everything-claude-code\\\"],[\\\"marketplace\\\",\\\"everything-claude-code\\\"]]){var l=p.join(d,'plugins',...s);if(f.existsSync(p.join(l,q)))return l}try{for(var g of [\\\"ecc\\\",\\\"everything-claude-code\\\"]){var b=p.join(d,'plugins','cache',g);for(var o of f.readdirSync(b,{withFileTypes:true})){if(!o.isDirectory())continue;for(var v of f.readdirSync(p.join(b,o.name),{withFileTypes:true})){if(!v.isDirectory())continue;var c=p.join(b,o.name,v.name);if(f.existsSync(p.join(c,q)))return c}}}}catch(x){}return d})();const s=p.join(r,'scripts/hooks/plugin-hook-bootstrap.js');process.env.CLAUDE_PLUGIN_ROOT=r;process.argv.splice(1,0,s);require(s)\" node scripts/hooks/run-with-flags.js post:observe scripts/hooks/observe-runner.js standard,strict",
|
||||
"async": true,
|
||||
"timeout": 10
|
||||
}
|
||||
|
||||
7
legacy-command-shims/README.md
Normal file
7
legacy-command-shims/README.md
Normal file
@@ -0,0 +1,7 @@
|
||||
# Legacy Command Shims
|
||||
|
||||
These slash-entry shims are no longer loaded by the default plugin command surface.
|
||||
|
||||
They remain here for users who still need short-term migration compatibility with old muscle-memory commands such as `/tdd`, `/eval`, or `/verify`.
|
||||
|
||||
Prefer the canonical skills or maintained commands referenced inside each shim. If you need one of these shims locally, copy the individual Markdown file into your project-level or user-level Claude commands directory instead of enabling the full archive by default.
|
||||
@@ -90,6 +90,7 @@
|
||||
".gemini",
|
||||
".opencode",
|
||||
"mcp-configs",
|
||||
"scripts/auto-update.js",
|
||||
"scripts/setup-package-manager.js"
|
||||
],
|
||||
"targets": [
|
||||
@@ -124,7 +125,6 @@
|
||||
"skills/django-tdd",
|
||||
"skills/django-verification",
|
||||
"skills/dotnet-patterns",
|
||||
"skills/frontend-design",
|
||||
"skills/frontend-patterns",
|
||||
"skills/frontend-slides",
|
||||
"skills/golang-patterns",
|
||||
@@ -272,7 +272,6 @@
|
||||
"kind": "skills",
|
||||
"description": "Research and API integration skills for deep investigations and model integrations.",
|
||||
"paths": [
|
||||
"skills/claude-api",
|
||||
"skills/deep-research",
|
||||
"skills/exa-search",
|
||||
"skills/research-ops"
|
||||
@@ -416,7 +415,6 @@
|
||||
"description": "Worktree/tmux orchestration runtime and workflow docs.",
|
||||
"paths": [
|
||||
"commands/multi-workflow.md",
|
||||
"commands/orchestrate.md",
|
||||
"commands/sessions.md",
|
||||
"scripts/lib/orchestration-session.js",
|
||||
"scripts/lib/tmux-worktree-orchestrator.js",
|
||||
|
||||
@@ -1,6 +1,16 @@
|
||||
{
|
||||
"version": 1,
|
||||
"profiles": {
|
||||
"minimal": {
|
||||
"description": "Low-context Claude Code setup with rules, agents, commands, platform configs, and quality workflow support, but no hook runtime.",
|
||||
"modules": [
|
||||
"rules-core",
|
||||
"agents-core",
|
||||
"commands-core",
|
||||
"platform-configs",
|
||||
"workflow-quality"
|
||||
]
|
||||
},
|
||||
"core": {
|
||||
"description": "Minimal harness baseline with commands, hooks, platform configs, and quality workflow support.",
|
||||
"modules": [
|
||||
|
||||
@@ -62,6 +62,8 @@
|
||||
"rules/",
|
||||
"schemas/",
|
||||
"scripts/catalog.js",
|
||||
"scripts/consult.js",
|
||||
"scripts/auto-update.js",
|
||||
"scripts/claw.js",
|
||||
"scripts/codex/merge-codex-config.js",
|
||||
"scripts/codex/merge-mcp-config.js",
|
||||
@@ -74,6 +76,7 @@
|
||||
"scripts/install-plan.js",
|
||||
"scripts/lib/",
|
||||
"scripts/list-installed.js",
|
||||
"scripts/loop-status.js",
|
||||
"scripts/orchestration-status.js",
|
||||
"scripts/orchestrate-codex-worker.sh",
|
||||
"scripts/orchestrate-worktrees.js",
|
||||
@@ -100,7 +103,6 @@
|
||||
"skills/blueprint/",
|
||||
"skills/brand-voice/",
|
||||
"skills/carrier-relationship-management/",
|
||||
"skills/claude-api/",
|
||||
"skills/claude-devfleet/",
|
||||
"skills/clickhouse-io/",
|
||||
"skills/code-tour/",
|
||||
@@ -146,7 +148,6 @@
|
||||
"skills/fal-ai-media/",
|
||||
"skills/finance-billing-ops/",
|
||||
"skills/foundation-models-on-device/",
|
||||
"skills/frontend-design/",
|
||||
"skills/frontend-patterns/",
|
||||
"skills/frontend-slides/",
|
||||
"skills/github-ops/",
|
||||
|
||||
@@ -57,7 +57,7 @@ claude plugin install typescript-lsp@claude-plugins-official
|
||||
|
||||
**Workflow:**
|
||||
- `commit-commands` - Git workflow
|
||||
- `frontend-design` - UI patterns
|
||||
- `frontend-patterns` - UI patterns
|
||||
- `feature-dev` - Feature development
|
||||
|
||||
---
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user