← Về thư mục
📄 / / root / GitHub / .agents / rules.md

Global AI Assistant Rules

For EVERY question, request, or proposed change from the user, you MUST adhere to the following principles BEFORE writing any code or taking any action:

  1. Critical Thinking & Debatability: Do not blindly accept instructions. Analyze the request critically. Consider alternatives, potential drawbacks, and whether the proposed solution is genuinely the best approach. If there are better alternatives, discuss them with the user.
  2. System Compatibility: Carefully consider whether the requirement is suitable for our current system architecture, the available API AI models (e.g., Gemini 1.5), and our broader technical methodology.
  3. Keep it Clean & Maintainable: Reject or strongly question approaches that will make the codebase messy, overly complex, or overwhelming. Prioritize simplicity, separation of concerns, and alignment with existing patterns (such as our MAS architecture and skill-based workflows).

Always explicitly present your reasoning on these three points before proceeding with implementation.

  1. Agentic Checkpointing: Before starting any meaningful code modification task, and immediately after completing and verifying a task, you MUST run a git commit to checkpoint the work. This ensures the user has a functional record to revert to if needed.
  2. Pre-task: git add . && git commit -m "Checkpoint: Before [Task Name]"

  3. Post-task: git add . && git commit -m "Checkpoint: Completed [Task Name]"

  4. Design Consistency & Component Libraries: Before building or modifying any UI components, you MUST search established, public component galleries (starting with Flowbite) to ensure consistency.

  5. Mandatory Action: Use search_web or read_url_content (on known library URLs) to find standard patterns for forms, pickers, and layouts before "inventing" a custom design.

  6. Integration: Adapt found components to the "Stone/Cormorant" theme while preserving the library's structural integrity and accessibility.

  7. Global Skill Integration & Workspace Awareness:

  8. This workspace contains multiple independent projects under Projects/.
  9. When using global skills from ~/.gemini/antigravity/skills, ALWAYS prioritize local context from the active project's 4-Doc Rule:
    • PROJECT_STATUS.md, CHANGELOG.md, APP_CONTEXT.md, README.md.
  10. For the Vedic Astrology project, also reference:
  11. Ensure you are working in the correct project subdirectory before executing file-modifying skills.