cluxion-agentplugin-supercoder 0.2.0

Universal agent coding harness plugin: cursor logic, safe patch, line budget, Rust index, test gates.

cluxion-Agentplugin-supercoder

범용 에이전트 코딩 하네스 플러그인 — Hermes, Claude Code, Codex, Grok Build에서 동일 core로 동작합니다.

Repository: https://github.com/cluxion/cluxion-Agentplugin-supercoder

한 줄 요약

코딩 시 큰 파일 추측·stale patch를 막습니다. 연결된 AI가 supercoder_* 도구로 bounded read·hash 검증 patch·evidence brief를 수행합니다.

범용 에이전트 + Rust-First

계층	구현
Rust (supercoder-index)	file hash, repo scan
Python (core/, runner)	cursor, patch, safety, plugin
Agent adapter	Hermes plugin + supercoder toolset

patch 검증·인덱싱은 Rust, orchestration은 Python 래퍼입니다.

이 플러그인의 역할

• Cursor logic — line window, file/content hash
• Safe patch — hash 검증, stale 차단
• Line budget — 과도한 read/write 차단
• WorkUnit queue — map → edit → verify → brief
• Safety gate — workspace escape·destructive command 차단

모델·OAuth는 host 소유. Supercoder는 plan·검증·evidence 계약만 제공합니다.

연결된 AI가 하는 일

코딩 요청 → supercoder_plan (기본 repo map 포함; repo_map:false로 opt-out)
         → supercoder_repo_map / cursor_map / read_window
         → supercoder_patch (hash 필수; syntax/lint gate)
         → test_gate (host terminal 실행)
         → supercoder_brief (evidence 필수)

비코딩 질문은 bypass로 오버헤드 최소화.

빠른 시작

pip install cluxion-agentplugin-supercoder
cluxion-supercoder check
hermes plugins enable cluxion-agentplugin-supercoder

도구 (supercoder toolset, 9 tools)

Tool	설명
supercoder_plan	WorkUnit 큐 (coding plan에 2000-char repo map 포함; repo_map:false로 opt-out)
supercoder_repo_map	budgeted repo map (files + top-level symbols; files_omitted로 잘림 표시)
supercoder_read_window	line-bounded read
supercoder_patch	hash 검증 patch + L1 syntax gate (lint advisory)
supercoder_cursor_map	repo index
supercoder_syntax_gate	tree-sitter parse-check (python/rust/js/ts/tsx/json; toml stdlib)
supercoder_lint_gate	advisory ruff lint (suggest-only)
supercoder_test_gate	테스트 제안
supercoder_brief	evidence 요약

Adapters

• adapters/hermes/ — Hermes enable 가이드
• adapters/claude/skills/supercoder/ — Claude skill
• adapters/codex/config-snippet.toml — Codex 참고

문서

• Docs/README.md — 처음 읽는 분 + 목차
• Docs/architecture.md
• Docs/design.md
• Docs/installation.md
• Docs/tools.md
• Docs/agent-surfaces.md
• Docs/capabilities.md
• Docs/rust-architecture.md

License

Apache-2.0