affaan-m--everything-claude-code/commands/ecc-guide.md

description

description
Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository surface.

/ecc-guide

Use this command as a conversational map of Everything Claude Code. It should help the user discover the right ECC surface for their task without dumping the entire README or stale catalog counts.

Usage

/ecc-guide
/ecc-guide setup
/ecc-guide skills
/ecc-guide commands
/ecc-guide hooks
/ecc-guide install
/ecc-guide find: <query>
/ecc-guide <feature-or-file-name>

Operating Rules

1. Read current repository files before answering when the checkout is available.
2. Prefer current filesystem/catalog data over hard-coded counts.
3. Keep the first answer short, then offer specific drill-down paths.
4. Link users to canonical files instead of copying long sections.
5. Do not invent commands, skills, agents, or install profiles that are not present.

What To Inspect

Use these files as the canonical map:

• README.md for install paths, reset/uninstall guidance, and high-level positioning
• AGENTS.md for contributor and project-structure guidance
• agent.yaml for exported agent and command surface
• commands/ for maintained slash-command shims
• skills/*/SKILL.md for reusable skill workflows
• agents/*.md for delegated agent roles
• hooks/README.md and hooks/hooks.json for hook behavior
• manifests/install-*.json for selective install modules, components, and profiles
• scripts/ci/catalog.js --json for live catalog counts when running inside ECC

Response Patterns

No Arguments

Give a compact menu:

• setup and install
• choosing skills
• command compatibility shims
• agents and delegation
• hooks and safety
• troubleshooting an install
• finding a specific feature

Then ask what they want to do next.

Topic Lookup

For topics like skills, commands, hooks, install, or agents:

1. Summarize the current surface in 3-6 bullets.
2. Point to the canonical directories/files.
3. Suggest one or two commands that can verify the state.
4. Avoid exhaustive lists unless the user asks for one.

Search Mode

For find: <query>:

1. Search the relevant files with rg.
2. Group results by surface: skills, commands, agents, rules, docs, hooks.
3. Return the strongest matches first with file paths.
4. Recommend the next action for each match.

Feature Lookup

For a specific feature name:

1. Check exact paths first, such as skills/<name>/SKILL.md, commands/<name>.md, and agents/<name>.md.
2. If exact lookup fails, search with rg.
3. Explain what the feature does, when to use it, and what file is canonical.
4. Mention adjacent features only when they reduce confusion.

Related Commands

• /project-init for stack-aware ECC onboarding of a target project
• /harness-audit for deterministic repo readiness scoring
• /skill-health for skill quality checks
• /skill-create for extracting a new skill from local git history
• /security-scan for Claude/OpenCode configuration security review