docs
Public documentation
Use Codex tools and collaboration; no Claude tool names, runtime substitutions, or Task Framework. Public docs describe the actual product: preserve valid Claude product commands as examples when documenting Claude features. Native Codex instructions, implementation files, rules, reports, and inline comments are exempt from this public-doc workflow. Public README/MDX prose is English.
Resolve this skill directory from the loaded file location. Before work, verify references/{checklist,review-prompt}.md, references/mdx-template.mdx, and scripts/{check-links,verify-deploy}.sh exist. Stop with the missing paths if unavailable.
Resolve mode and scope
Parse the free-form RU/EN request; extract targets from prose, paths, and optional flags. An explicit mode token wins. Otherwise score distinct whole-word keyword/phrase hits below; highest score wins. Prefer REVIEW on a tie containing it; for two mutating modes use the earliest keyword. Ask once before writing only if unresolved ambiguity changes the outcome or implies destructive work. No hits or empty input defaults to ENTITY; REVIEW needs no scoping question and uses the stated scope or all public docs.
| Mode | Signals | Writes |
|---|---|---|
| REVIEW | review, check docs, audit docs; ревью, проверь доки, аудит доков | Nothing; findings report |
| FIX | fix, broken, typo, specific file path; исправ, почини, опечатка | Identified files only |
| PLUGIN | Plugin name + docs; plugin name + доки/документация | Plugin README, overview/skills/agents MDX, navigation |
| REPO | repo, root readme, release notes; репо, корневой readme, релиз-ноуты | Root README and RELEASE-NOTES as applicable |
| ENTITY | Skill/agent name or path; default | Applicable entity surfaces below |
release/deploy are scope hints, not authorization for external actions. Resolve actual source paths rather than assuming plugin counts or inventory totals.