Imported from harikrishna8121999/antigravity-workflows (AGENTS.md). Install upstream with npx skills add harikrishna8121999/antigravity-workflows. Copyright stays with the author.

Agent Instructions

These instructions are for AI agents working with the Antigravity Workflows repository.

🎯 Core Philosophy

All workflows in this repository follow five core principles:

📁 Key Files

🏗️ Workflow Format

All workflows follow this structure:

---
description: [5-10 word description]
---

# Workflow Name

Brief intro explaining the purpose.

## Guardrails
- Boundaries and constraints
- What to avoid

## Steps

### 1. Understand Context
Ask clarifying questions first.

### 2. Analyze Project  
Detect stack, framework, patterns.

### 3. [Implementation Steps]
Describe WHAT to do, not exact code.

### 4. Verify
Confirm success.

## Principles
- Universal best practices

## Reference
- Links to documentation

🔍 When Executing a Workflow

1. Always detect project stack first

   • Check package.json, config files, file patterns
   • Look at existing code for conventions

2. Ask questions when unclear

   • Don't assume the user wants React/Next.js
   • Ask about scope, features, constraints

3. Follow existing patterns

   • Match the project's coding style
   • Use existing utilities and components

4. Use // turbo appropriately

   • Only for safe, non-destructive commands
   • Never for delete operations or global changes

📂 Workflow Categories

➕ Adding a New Workflow

1. Create workflows/<category>/<name>.md following the template
2. Ensure it follows the Stack-Agnostic principle
3. Add entry to workflows/registry.json
4. Test with /<name> in Antigravity

See CONTRIBUTING.md for detailed guidelines.