Idiomas y guardas

Idiomas soportados por langspec, verbos de orch guard, adaptadores de notificacion y hooks instalados.

Idiomas, guardas, notificaciones, hooks

Generado por go run ./cmd/orch-docs. Cada seccion nombra su fuente de verdad en el codigo.

Idiomas de langspec#

Fuente: orchemax-orch publico langs/ (vendored en client/internal/langspec/). 29 idiomas hoy — PRs agregan mas: c, cpp, csharp, dart, delphi, elixir, go, groovy, haskell, java, javascript, julia, kotlin, lua, objc, perl, php, powershell, python, r, ruby, rust, scala, shell, solidity, swift, typescript, vb, zig.

orch guard * verbos#

Fuente: la referencia de la CLI (cli.md) — la descripcion corta de cada verbo ES lo que revisa, tomada directamente de client/internal/cli/cli_guard.go.

  • orch guard add-all — Deny blanket git add (-A/.) when cwd is a shared repo
  • orch guard allow — Deny an `orch:allow` override marker that silences nothing (unwaivable gate, or no reason)
  • orch guard artifacts — Deny disposable build junk (.o, .pyc, .exe, …) beside source
  • orch guard banned-stack — Deny an import or manifest dependency the owner declared banned
  • orch guard code-lang — Check code identifiers/strings against workspace.code_lang
  • orch guard comment — Deny if exported shared symbols lack a one-line purpose comment
  • orch guard comment-prose — Note long/narrative comment blocks (advisory, never denies)
  • orch guard conflict-markers — Deny git merge-conflict markers left in a file
  • orch guard control-bytes — Deny invisible control bytes in source (except tab/LF/CR)
  • orch guard cross-project — Deny a file inside one registered project importing another registered project
  • orch guard ddl — Require seeder/repository companion for migration/CREATE TABLE changes
  • orch guard docs — Deny an unreferenced new doc, or a header count that does not match the file
  • orch guard dup — Deny if file duplicates a shared symbol; report copied function bodies (clones)
  • orch guard encoding — Deny missing UTF-8 charset / mojibake in HTML, email, and source a compiler reads in a legacy code page
  • orch guard env-drift — Deny keys lost or emptied between an .env example and its instance
  • orch guard explain — Say what every rule would answer about one file, and whether a commit carrying it would be denied
  • orch guard gofmt — Deny a Go file whose content is not what gofmt would write
  • orch guard hooks — ``Install git pre-commit/pre-push hooks that run `orch guard```
  • orch guard hooks install — Write .git/hooks/pre-commit + pre-push (`orch`-marked)
  • orch guard hooks run — Run pre-commit checks on staged files (used by git hooks)
  • orch guard hooks status — Show whether `orch` git hooks are installed
  • orch guard hooks uninstall — Remove `orch`-marked pre-commit/pre-push hooks only
  • orch guard ide-hook — Internal: Claude/Cursor wire entry (soft-skip outside workshop)
  • orch guard json-dup — Deny a key declared twice inside one JSON object
  • orch guard lang — Check workshop docs against workspace.docs_lang
  • orch guard litter — Deny new agent-scratch files/dot-directories outside .sandbox/<seat>/ or docs
  • orch guard lock — Deny if shared/** path has no valid lock for --holder
  • orch guard machine-path — Deny one machine's absolute home path (Users/<name>, /home/<name>) in a versioned file
  • orch guard minimal-code — Report a single-implementation interface, an unread field or a single-use wrapper (advisory)
  • orch guard principles — Show which elemental principles `orch` enforces and which are guidance
  • orch guard profile — ``Show or set guard.profile in `orch.yaml```
  • orch guard race-test — Report concurrency added to a package whose tests only run sequentially (advisory)
  • orch guard reproduce — Deny a change whose own new tests pass against the pre-change source
  • orch guard rules — List and validate the workshop's own gates (`.orch/gates/user/manifest.json`)
  • orch guard rules run — Dry-run the user gates over an explicit file list
  • orch guard schema-bump — Deny a column added to a table definition with no schema version bump
  • orch guard scope-growth — Report a change set that outgrew its ledger item with no ask raised (advisory)
  • orch guard secrets — Deny a credential (provider key, PEM block, high-entropy assignment) in source
  • orch guard shared-brand — Deny registered project id / path references inside shared layers
  • orch guard shared-root — Deny loose source files at shared-layer roots (must live in a subfolder)
  • orch guard shared-shadow — Deny a project file whose path mirrors one already under a shared root
  • orch guard shell-check — Internal: pi-extension sibling of ide-hook; reads a shell command on stdin
  • orch guard signature — Deny non-constant-time comparisons on a signature/HMAC/token
  • orch guard template-drift — Deny a key-set mismatch between a *.template.json/*.example.json and its instance
  • orch guard test-dup — Report a test whose body repeats another test's, literals included (advisory)
  • orch guard test-residue — Deny paths a test run creates under a source root, gitignored included
  • orch guard tracker — Validate TRACKER state table (T1–T5: status · SPEC · evidence · no prose · row shape)
  • orch guard unproven-gate — Deny new gate source added with no test touched in the same change set
  • orch guard unwire — Remove what Orchemax wrote to disk: IDE hook entries, .mcp.json Orchemax servers, git hooks — workshop and every registered project
  • orch guard upsert — Deny ON CONFLICT/ON DUPLICATE KEY/MERGE upserts with no matching UNIQUE/PK
  • orch guard weakened — Report a test that survived a change and now verifies less (advisory)
  • orch guard wire — Install marked git/Claude/OpenClaude/Cursor/Copilot/agy adapters for this workshop

Adaptadores de notificacion#

Fuente: client/internal/config.AgentNotify (referencia completa de campos en config.md) y sus valores por defecto, config.DefaultAgentNotifyConfigs(). Modos: http (una solicitud o una cadena steps), shell (plantilla cmd), file (escribe un archivo renderizado en path), none.

preset modo
agy file
claude file
codex file
commandcode file
copilot file
cursor file
grok file
kimi file
mimo file
openclaude file
opencode http
zcode file

Eventos de hook que orch instala#

Fuente: grep de client/internal/harness/wire.go en busca de los nombres de eventos de hook de Claude Code que escribe en .claude/settings.local.json (alcance de proyecto) o ~/.claude/settings.json (alcance de usuario).

  • PreToolUse
  • PostToolUse
  • PreCompact
  • SessionStart
  • SessionEnd
  • UserPromptSubmit
  • Stop
  • Notification

PostToolUse y PreCompact son consentimientos opcionales separados (context.hooks.post_tool / context.hooks.pre_compact — ver config.md); PreCompact es lo que hace que orch memory condense corra automaticamente.