viru-air-context

Rebuilds working context for the Viru Air repo using canonical documentation references.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/javiruu/viru-air --skill viru-air-context-javiruu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: viru-air-context
Source: https://github.com/javiruu/viru-air/tree/main/skills/viru-air-context
Command: npx skills add https://github.com/javiruu/viru-air --skill viru-air-context-javiruu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When working in the Viru Air monorepo, re-onboarding after a break means re-reading a large documentation tree and risking confusion between live docs and archived history. This Skill provides a compact, reusable operating context so you can quickly identify which documents are canonical, which are historical, and what the current working rules are before editing, verifying, or publishing changes. ## Core Features & Use Cases - Fast Re-onboarding: A prioritized reading path through AGENTS.md, README.md, docs/overview, and the Codex operating contract so you regain context without scanning the full docs tree. - Source-of-Truth Discipline: Clear rules distinguishing live documentation (docs/overview, docs/reference, docs/specs, docs/runbooks, docs/qa) from historical material (docs/plans, docs/archive). - Operating Rules Reference: Bundled references summarize the project map, stack (FastAPI, Next.js, Postgres, Redis), main routes, and the adapted review-and-publication workflow. - Use Case: You return to the Viru Air repo after two weeks and need to modify a backend contract. Use this Skill to reload the canonical doc map, confirm the operating rules, and know exactly which reference files to open before editing. ## Quick Start Use the viru-air-context skill to reload the project context and tell me which docs are canonical before I start editing the backend.

Frequently Asked Questions about viru-air-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I quickly re-onboard to the Viru Air repository?▼

Start with AGENTS.md, then read README.md, docs/README.md, docs/overview/current-state.md, and docs/overview/repo-map.md. This Skill provides that reading path plus compact reference summaries so you avoid re-reading the entire documentation tree.

Which Viru Air docs are canonical versus historical?▼

Live sources are DESIGN.md, docs/overview, docs/reference, docs/specs, docs/runbooks, and docs/qa. The docs/plans folder is nearby historical reference, and docs/archive is deep history only and never a source of truth for active work.

What is the tech stack of the Viru Air project?▼

The backend uses Python 3.12 with FastAPI, SQLAlchemy, and Alembic. The frontend uses Next.js 15.1, React 19, and TypeScript. Local infrastructure runs via docker-compose with Postgres and Redis.

When should I trust archived documentation over live docs?▼

Only when the task is explicitly historical. If repo docs and archived material disagree, the live docs win. Archived content preserves intent and traceability but is not an active source of truth.

What is the publication workflow for changes in this repo?▼

Verify changes locally, prepare a review packet with summary, key files, risks, rollback, and manual validation notes, then commit directly to main and push only when the user requests a completed change. Pull requests are used only if explicitly asked.