hypeJunction/ai-assistant-starter

finish

End-of-session routine. Ensures test coverage, performs self-review, runs validation, and commits cleanly. Use when finishing a unit of work.

لغة النص الأصلي: الإنجليزية

implement

Full feature implementation workflow with explore, plan, code, test, validate, and commit phases. Use for new features, enhancements, or significant code changes.

لغة النص الأصلي: الإنجليزية

iterate-pr

Iterate on an open PR until CI passes and all review feedback is addressed. Fetches status, categorizes findings by severity, applies fixes, and loops until clean.

لغة النص الأصلي: الإنجليزية

plan

Create a detailed implementation plan without writing code. Read-only analysis and planning with user approval gate. Use before implementing features or making significant changes.

لغة النص الأصلي: الإنجليزية

security-review

Systematic security audit with confidence-based reporting. Analyzes attack surfaces, checks against OWASP categories, and reports only confirmed or likely vulnerabilities. Use for pre-merge security review or periodic audits.

لغة النص الأصلي: الإنجليزية

validate

Run validation checks to ensure code quality, security, and correctness. Supports quick (scoped), full (CI pipeline), fix (auto-correct), and CI mirror modes.

لغة النص الأصلي: الإنجليزية

accessibility-review

Systematic WCAG 2.1 AA accessibility audit with confidence-based reporting. Scans UI components for keyboard, screen reader, and visual accessibility issues. Use for pre-release audits or after major UI changes.

لغة النص الأصلي: الإنجليزية

commit

Review changes and create a git commit with user confirmation. Use when work is ready to commit, changes need staging, or the user says "commit".

لغة النص الأصلي: الإنجليزية

git-conventions

Git branch naming, commit message conventions (Conventional Commits), workflow patterns, and common operations. Auto-loaded when working with git.

لغة النص الأصلي: الإنجليزية

research

Ethical web research with attribution tracking, license compliance, and citation-based output. Use for technical research, competitive analysis, or content synthesis requiring source transparency.

لغة النص الأصلي: الإنجليزية

add-story

Create comprehensive Storybook stories with test plans, play functions, and validated tests for a component. Use when a component needs Storybook coverage or story files.

لغة النص الأصلي: الإنجليزية

add-todo

Document deferred work, shortcuts, and technical debt for future resolution. Use when taking a shortcut, finding tech debt, or deferring out-of-scope work.

لغة النص الأصلي: الإنجليزية

adr

Capture an Architecture Decision Record documenting context, reasoning, alternatives, and consequences of a significant technical decision.

لغة النص الأصلي: الإنجليزية

api-test

Discover, design, implement, run, and report on API endpoint tests. Ensures every route is tested for status codes, response shapes, auth boundaries, and edge cases.

لغة النص الأصلي: الإنجليزية

debug

Systematic bug investigation and fixing with hypotheses, root cause analysis, regression tests, and verification. Use when encountering bugs, errors, or unexpected behavior.

لغة النص الأصلي: الإنجليزية

deps

Audit, update, and manage project dependencies safely. Use when checking for vulnerabilities, updating outdated packages, or performing routine dependency maintenance.

لغة النص الأصلي: الإنجليزية

docs

Add or improve documentation for code. Use when code needs JSDoc comments, inline explanations, README files, or documentation updates.

لغة النص الأصلي: الإنجليزية

e2e

End-to-end testing workflow for web applications using Playwright or Cypress. Covers user flow discovery, test design, implementation, execution, and flaky test management.

لغة النص الأصلي: الإنجليزية

explore

Understand code without making changes. Read-only exploration of codebase structure, patterns, data flow, and dependencies. Use when asked "how does X work" or to investigate code before planning.

لغة النص الأصلي: الإنجليزية

hotfix

Emergency bug fix with abbreviated validation for production issues. Use when production is broken, a critical security vulnerability is discovered, data corruption is occurring, or a user-blocking bug has no workaround.

لغة النص الأصلي: الإنجليزية

init

Bootstrap AI assistant with project-specific configuration by analyzing the codebase and generating populated template files. Use when setting up a new project or re-initializing after major changes.

لغة النص الأصلي: الإنجليزية

migrate

Safe database/schema migration workflow with risk assessment, rollback planning, and ORM-aware generation. Use for schema changes, adding/removing columns, creating tables, adding indexes, or data backfills.

لغة النص الأصلي: الإنجليزية

pr

Create a well-documented GitHub pull request with quality checks, proper description, and test plan. Use when pushing a branch, creating a merge request, or preparing code for review.

لغة النص الأصلي: الإنجليزية

refactor

Systematic multi-file refactoring with pattern analysis, scope detection, batched execution, and progress tracking. Use for renames, pattern changes, API migrations, or any change affecting 6+ files.

لغة النص الأصلي: الإنجليزية

release

Prepare and publish a release with version bump, changelog, and tagging. Use when shipping a new version, creating a release candidate, or tagging a production build.

لغة النص الأصلي: الإنجليزية

revert

Safely rollback changes using git revert with impact assessment and validation. Use when a commit needs to be undone, a PR introduced a bug, or changes need to be rolled back without rewriting history.

لغة النص الأصلي: الإنجليزية

review

Comprehensive code review of the current branch against base. Read-only analysis with P0-P3 severity-rated findings and actionable feedback. Use before merging or to check code quality.

لغة النص الأصلي: الإنجليزية

sync

Audit and align AI documentation with the actual state of the codebase. Use when documentation feels stale, after significant refactoring, periodically at sprint boundaries, or when AI assistance seems to follow outdated patterns.

لغة النص الأصلي: الإنجليزية

tdd

Strict Test-Driven Development workflow enforcing the RED-GREEN-REFACTOR cycle. Ensures every line of production code is justified by a failing test. Use when building new features, fixing bugs, or adding behavior.

لغة النص الأصلي: الإنجليزية

test-coverage

Analyze branch changes and ensure adequate test coverage. Creates missing tests with test plans, runs them, and reports results. Use after implementing changes to add tests.

لغة النص الأصلي: الإنجليزية

track-files

Track batches of files that need similar changes for large-scale work. Use when refactoring affects many files, migrating patterns, or coordinating batch operations across sessions.

لغة النص الأصلي: الإنجليزية

branch-protection

Runtime enforcement hook that blocks dangerous git operations on protected branches. Prevents force-push, hard reset, and branch deletion on main/master. Auto-loaded for all git operations.

لغة النص الأصلي: الإنجليزية

communication-guidelines

Communication templates and response formatting for AI coding assistants. Defines structured message formats with semantic indicators for status, errors, actions, and progress. Auto-loaded for all interactions.

لغة النص الأصلي: الإنجليزية

destructive-command-protection

Runtime enforcement hook that blocks destructive system and database commands. Prevents accidental rm -rf, database drops, and other irreversible operations. Auto-loaded for all command execution.

لغة النص الأصلي: الإنجليزية

github-actions-guidelines

CI/CD guidelines for GitHub Actions including pipeline structure, caching, secrets management, deployment strategies, and quality gates. Auto-loaded when working with workflow files.

لغة النص الأصلي: الإنجليزية

ai-assistant-protocol

Core execution protocol governing code quality, testing, scope management, and approval gates for AI coding assistants.

لغة النص الأصلي: الإنجليزية

code-review-guidelines

Code review best practices including review checklist, comment types, severity levels, feedback patterns, and PR size guidelines. Auto-loaded during code review.

لغة النص الأصلي: الإنجليزية

docker-node-guidelines

Docker guidelines for Node.js including Dockerfile best practices, multi-stage builds, Docker Compose, security, and health checks. Auto-loaded when working with Docker configurations.

لغة النص الأصلي: الإنجليزية

documentation-guidelines

Documentation best practices for code comments, JSDoc, READMEs, and API docs. Explains when to comment and when not to. Auto-loaded when writing documentation.

لغة النص الأصلي: الإنجليزية

env-config-guidelines

Environment configuration guidelines for Node.js including variable naming, type-safe loading with Zod, secrets management, and feature flags. Auto-loaded when working with environment config.

لغة النص الأصلي: الإنجليزية