Safina

/safina:man

Inline documentation for any Ilmiya command or engineering standard — directly in VS Code or the Claude CLI. No browser required.


Usage

/safina:man [topic]

Examples:

/safina:man test
/safina:man hunt
/safina:man api-design
/safina:man load
/safina:man debug
/safina:man error-design
/safina:man commit-convention
/safina:man observability

Run with no argument to see the full topic index.


What it returns

Documentation formatted inline as a man-page-style entry — NAME, DESCRIPTION, WHEN TO USE, KEY RULES, and SEE ALSO. You get the essential content without leaving your editor.

For commands: what it does, when to run it, what it gates, and how it connects to tickets.

For standards: the core rules, key constraints, and common violations — pulled from the standard embedded in /safina:test.


Topics available

Commands

TopicWhat it documents
backlogPull tickets, set session context
testConformance and correctness check
huntOffensive security and bug analysis
updatePost commit summary and QA handoff
debugTriage production and staging issues
loadk6 load testing against staging
manThis command

Standards

All engineering standards are embedded in /safina:test. Use /safina:man to surface any of them inline:

api-design · resource-naming · standard-methods · custom-methods · standard-fields · error-design · naming-conventions · observability · golden-metrics · prompting · ai-agents · ai-harnesses · versioning · backward-compatibility · scaling-and-performance · proto-file-structure · documentation

Config

commit-convention · pr-template


How it works

/safina:man reads directly from the command files installed at ~/.claude/commands/ilmiya/. Standards topics are embedded in test.md — the command reads the relevant section and reformats it as a man-page entry. The documentation is always current with whatever version of Safina is checked out locally.

To update: git pull in the Safina repo, then ./install.sh.


What it does not do

  • Does not run any command — read-only documentation retrieval
  • Does not open a browser — inline output only
  • Does not modify files