rwyn

Rwyn

rwyn means "run what you need". Use this skill when the user wants to understand or operate the rwyn workflow in a repo.

Workflow

1. Run from the target repo root when possible.
2. Check for .rwyn/config.yaml or .rwyn/config.yml. If present, prefer config-backed commands without repeating --catalog, --graph, or --policy.
3. Start with rwyn doctor if the repo setup is unclear.
4. Use the smallest command that answers the question:
   • use $setup when the repo needs initial config or transform scaffolding
   • rwyn select for what would run
   • rwyn explain <file> for why a file selects certain checks
   • rwyn run --plan for the layered execution plan
   • rwyn run --dry-run for the exact commands
   • rwyn compare and rwyn ingest learn for run-record analysis
5. When a result feels wrong, inspect it with rwyn explain before changing policy or engine code.

Command Guide

• Health check:
  • rwyn doctor
• Build or refresh the graph:
  • rwyn build
• Select checks for the current branch diff:
  • rwyn select --base origin/main
• Select checks for local edits:
  • rwyn select --uncommitted
• Explain one file:
  • rwyn explain path/to/file.sol
• Show the execution plan:
  • rwyn run --uncommitted --plan
• Show the concrete commands without running them:
  • rwyn run --uncommitted --dry-run

See references/commands.md for a fuller command cookbook and interpretation notes.

Interpretation

• signal is a planner score, not a bug severity score.
• Coverage is strong evidence for test scoping, but not the whole selection model.
• Import reachability is a fallback signal. Treat it as heuristic, not truth.
• Declarative plugins: transforms are the right place for repo quirks like interface/source links or generated bindings.
• Text-only changes should usually suppress semantic checks except for checks intentionally marked as text-sensitive.

Output Expectations

• Prefer concise summaries over pasting massive JSON unless the user asked for raw output.
• For large scoped items, summarize the count and a short preview of scopes.
• If rwyn selects something surprising, name the exact check and the exact evidence path that caused it.