Skip to content

feat: add Claude Code plugin (setup / tune / debug / doctor skills)#86

Draft
tak848 wants to merge 4 commits into
mainfrom
feat/claude-code-plugin
Draft

feat: add Claude Code plugin (setup / tune / debug / doctor skills)#86
tak848 wants to merge 4 commits into
mainfrom
feat/claude-code-plugin

Conversation

@tak848

@tak848 tak848 commented May 12, 2026

Copy link
Copy Markdown
Owner

Why

Hand ccgate setup, rule tuning, deny / 401 debug, and environment audit to an AI through Claude Code. The docs (README.md, docs/configuration.md, docs/rule-tuning.md, docs/api-key-helper.md, docs/claude-code.md, docs/codex-cli.md, docs/providers.md) are mature enough to back AI-driven workflows, and bundling skills alongside those docs keeps them in sync.

What

Bundle a Claude Code plugin in this repo:

  • .claude-plugin/marketplace.json (single-plugin marketplace, name: tak848-ccgate)
  • .claude-plugin/plugin.json (name: ccgate, semver tracking the ccgate binary version)
  • Four skills (follow in next commits on this branch):
    • /ccgate:setup — install + hook registration + bring-up
    • /ccgate:tune — rule refinement from ccgate <target> metrics --details N
    • /ccgate:debug — root cause for deny / fallthrough / 401
    • /ccgate:doctor — read-only environment audit
  • README / docs/ja/README.md get a Claude Code plugin section pointing at install + skills

Install (subject to short-form verification): /plugin marketplace add tak848/ccgate/plugin install ccgate@tak848-ccgate.

Draft until the skills, README sections, and local install verification land on this branch.

tak848 added 4 commits May 13, 2026 07:29
Bootstrap a Claude Code plugin bundled in this repo:
- .claude-plugin/marketplace.json (single-plugin marketplace, name=tak848-ccgate)
- .claude-plugin/plugin.json (semver 0.9.1, tracks the ccgate binary version)

Skills (setup / tune / debug / doctor) and README updates follow.
- /ccgate:setup walks first-time install, hook registration, and
  provider configuration. Stops at diffs in plan mode.
- /ccgate:tune drives append_allow / append_deny edits from
  `ccgate <target> metrics --details N`, with a git-tracked vs
  untracked layer check to avoid silent no-op edits.
- /ccgate:debug starts from `ccgate <target> metrics --json --details N`
  and walks decision (deny / fallthrough / 401 / plan-mode) branches.
  Hands off to /ccgate:tune when an edit is the right fix; never writes
  itself.
- /ccgate:doctor audits binary, version freshness (GitHub API ->
  git ls-remote fallback), hook registration (Claude + Codex feature
  flag + project trust), config layer candidates (existence + tracked
  state + effective for linked vs main worktree), provider sanity per
  layer, and metrics/log presence. Read-only.
Document the bundled plugin install path and the four skills, with a
plan-mode safety note. Same scope on the ja side, keeping engineer
English terms (skill / plugin / install / provider).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant