Sweepi

Required orchestrater for linting using a dedicated sub-agent. Trigger when asked to run sweepi/linting + fixes, and before proposing commits.

jjenzz 92d6f26 29 files · 56.8 KB Updated

File contents

Sweepi Orchestrator

Parent orchestrates only. Parent does not run Sweepi directly.

Trigger

  • User asks for sweepi or linting
  • Parent is preparing to propose a commit
  • Changed files may violate lint rules

Flow

COLLECT_FILES -> LINT -> RESULT

  • COLLECT_FILES: determine lint scope (changed files or --all)
  • LINT: invoke lint sub-agent
  • RESULT:
    • BLOCKED: retry with clarified scope or escalate to user with blocker details
    • CLEAN: report success

Sub-Agent Invocation Contract

Parent prompt to lint sub-agent MUST include:

Load and obey role instructions in <SKILL-ROOT-DIR>/AGENTS.md

And must specify lint scope:

  • sweepi . --file "<path>" ... for changed files
  • sweepi . --all when linting everything

Parent MUST NOT load lint instruction files into parent context.

Guardrails

  • Do not suppress rules or disable linting
  • Do not make speculative fixes without rule guidance/docs
  • Return only: CLEAN or BLOCKED with structured blockers

jjenzz/sweepi/tree/main/skills/sweepi commit 92d6f265e5

Frequently asked questions

npx skillmds@latest add jjenzz/sweepi