# Gate Ide

> Shift-left quality gate triggered on file-save events. Runs lint, format, typecheck, spellcheck, and lightweight secret scan. Blocks on failure and reports results to agent context.

- Skill: `quantumquirkxyz/gate-ide` (Agent Skill)
- Install (CLI): `npx get-skill add quantumquirkxyz/gate-ide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quantumquirkxyz/gate-ide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: quantumquirkxyz (https://skillmd.com/u/quantumquirkxyz)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/quantumquirkxyz/gate-ide

---


## Contract

- Input: file-save event, changed file paths, project tooling config.
- Output: `GateIdeArtifact` with per-check results and terminal state.
- Scope: IDE-level checks only — lint, format, typecheck, spellcheck, secret scan.
- Rule: run checks in parallel where possible to stay under sub-second budget.
- Rule: lightweight secret scan only — do not run full dependency audit here.
- Rule: report results to agent context immediately; do not block the save operation itself.

## Provenance

| Question | Answer |
|---|---|
| What is the source of truth? | The file-save event and project tooling config (eslint, prettier, typescript, cspell, gitleaks) |
| What is in scope? | Changed files since last save; IDE-level checks only |
| What is explicitly out of scope? | Full test suite, dependency audit, security scan, performance tests |
| Who or what consumes this artifact afterward? | `gate-pre-commit` or agent context for immediate feedback |
| What evidence proves it is done? | All checks completed, results reported, structured result returned |
| What risk remains? | False positives from spellchecker; secret scan is lightweight and may miss obfuscated secrets |

## Artifact

Return `GateIdeArtifact` as structured output in the current response. Do not write local artifact files unless the user explicitly asks for an export.

## Process

### 1. Detect changed files
Receive the file-save event payload. Extract the list of changed file paths. If no files changed, skip checks and report idle.

### 2. Run lint
Execute the project's linter (eslint, pylint, rubocop, etc.) against changed files only. Capture exit code, stdout, and stderr.

### 3. Run format check
Execute the formatter in check mode (prettier --check, black --check, etc.). Do not modify files.

### 4. Run typecheck
Execute the type checker (tsc --noEmit, mypy, etc.) against changed files and their dependents.

### 5. Run spellcheck
Execute spellchecker (cspell, codespell) against changed files. Flag unknown words but do not block on them unless configured as errors.

### 6. Run lightweight secret scan
Scan changed files for common secret patterns (API keys, tokens, passwords). Use regex-based detection only — do not run full gitleaks or truffleHog here.

### 7. Aggregate results
Compile all check results into `GateIdeArtifact`. Determine terminal state:
- If any check failed and `blockOnFailure` is true → `blocked`
- If all checks passed → `completed`
- If checks errored → `failed`

### 8. Report to agent context
Publish a concise summary to agent context so the user sees results immediately.

## Completion

- all 5 checks have run or been explicitly skipped with reason
- structured result returned
- results reported to agent context
- terminal state correctly reflects `blockOnFailure` policy

