Quick start
git clone git@github.com:ilmiya/safina.git
cd safina
./install.sh
This installs 4 Claude commands to ~/.claude/commands/ilmiya/ and creates your developer config. Commands work in any Claude Code surface: CLI, VS Code extension, desktop app, iOS.
Make sure your Claude account has Slack connected at claude.ai/settings. If you’re on Tier 2 (no Linear access), also connect GitHub.
Workflow commands
Four commands, visible as the “ilmiya” section in VS Code. They sit alongside Claude’s built-in commands, not in place of them.
| Command | When | What it does |
|---|---|---|
/ilmiya:backlog | Start of session | Pull assigned tickets, pick focus, create or update issues |
/ilmiya:update | After committing work | Read recent commits, tie them to an issue, post a smart comment + Slack; flags non-standard commits as advisory |
/ilmiya:test | Before merging | Conformance and correctness: Ilmiya standards, test coverage, QA readiness |
/ilmiya:hunt | Before merging / any time | Offensive analysis: security vulnerabilities, CVEs, bugs, regressions, flaky tests |
Standards and reference
| Section | What’s in it |
|---|---|
| Skills | Engineering standards: API design, observability, QA, naming, error design, AI agents |
| MCP | Live system access: Linear, GitHub, databases, Cloudflare, Stripe, and more |
| Config | Commit convention, PR template, developer config template |
| Harness | How the whole system fits together |
| Security | Weekly Trivy scan dashboard: dependency vulnerabilities, IaC misconfig, and secrets across every repo |
Developer tiers
| Tier | Who | Ticket source |
|---|---|---|
| Tier 1 | Taha, Adnan | Linear (MCP connected) |
| Tier 2 | All other developers | GitHub issues in this repo (synced bidirectionally with Linear) |
install.sh asks which tier you’re in and configures your commands accordingly.