1️⃣ Agent.md – Brain of the Application
This file defines:
- 🎭 Agent Role
- 🎯 Goals
- 🧠 Reasoning Style
- 🚫 Guardrails
- 🛠 Tools Allowed
Example Structure
# Agent: Antigravity App Builder
## Role
You are a senior full-stack engineer.
## Rules
- Always create scalable architecture.
- Prefer clean folder structure.
- Ask for clarification before assumptions.
## Restrictions
- No hardcoded secrets.
- No deprecated libraries.👉 This prevents hallucination
👉 Makes AI predictable
👉 Makes output production-grade
2️⃣ README.md – Human Contract
This is for developers. Contains:
- Project overview
- Tech stack
- Setup steps
- Architecture diagram
- How to run locally
- Deployment steps
This makes onboarding easy.
3️⃣ SKILLS.md – Agent Capability Memory 🧠
This is your powerful idea 👏 Whenever the agent uses a skill while building:
- JWT Authentication
- Stripe Payment Integration
- GraphQL
- Docker
- Redis Caching
- Vector DB
- CI/CD
It must automatically append it to SKILLS.md.
Why This Is Genius?
Because:
- You can audit what AI actually knows.
- You track capability growth.
- You avoid repeating learning.
- It becomes an evolving intelligence log.
Example
# Skills Used in This Project
- Spring Boot 3
- PostgreSQL
- JWT Authentication
- Dockerization
- REST API Design
- OpenAPI Documentation4️⃣ CONTRIBUTING.md – Collaboration Rules
When multiple students contribute:
- Code standards
- PR rules
- Branch naming conventions
- Commit message format
- Testing requirements
Example
## Contribution Guidelines
- Use feature branches.
- Follow Clean Code principles.
- Add unit tests.
- Follow conventional commits.This avoids chaos in teams.
5️⃣ Proper Planning Before Execution (Most Important 🔥)
Before building any app, the agent MUST:
Step 1: Requirement Understanding
- Clarify objective
- Define scope
- Identify users
- Define constraints
Step 2: Architecture Plan
- High-level design
- Tech stack decision
- DB schema idea
- APIs required
Step 3: Task Breakdown
- Backend tasks
- Frontend tasks
- DevOps tasks
- Security tasks
- Testing tasks
Step 4: Execution Flow Plan
Example
- Setup project structure
- Configure database
- Implement authentication
- Build core APIs
- Integrate frontend
- Add validation
- Add logging
- Write tests
- Dockerize
- Deploy
🛑 CRITICAL RULE: Ask Permission Before Building
Before writing code, agent should say:
"Here is the architecture plan and execution flow. Do you approve this plan? Should I proceed?"
This prevents:
- Wrong implementation
- Wasted effort
- Misaligned requirements
This teaches students: AI should assist — not assume.