Workspace alignment, dependency configuration, and general optimization updates as of June 7, 2026.

🧠 Rilis Perdana: Universal AI Agent Rules v1.0.0

Sistem basis pengetahuan (knowledge base) dan aturan asisten AI universal pertama yang membuat asisten AI coding Anda (Cursor, Windsurf, GitHub Copilot, Antigravity) menjadi jauh lebih cerdas dan memahami konteks proyek secara mendalam.

✨ Fitur Utama:

• Universal Ruleset: Aturan .cursorrules / .windsurfrules yang kompatibel dengan multi-OS.
• Kerangka Memori Otomatis: Panduan memori jangka pendek dan jangka panjang yang rapi.
• Integrasi Penuh: Dilengkapi dengan petunjuk penataan folder kerja asisten AI Anda.

☕ Dukung Kami

Dukung kami via Ko-Fi atau Trakteer. Temukan panduan premium lengkapnya di kuncimu.com .

What's Changed

• improve documentation and sytem quick installer by @andiupn in #1
• Feature/add workflows by @andiupn in #2

New Contributors

• @andiupn made their first contribution in #1

Full Changelog: https://github.com/andiupn/andy-universal-agent-rules/commits/v1.2.0

Contributors

• @andiupn

v1.1.0 - Workflows as Core Feature + Enhanced Documentation

🎉 What's New

Workflows Now Core Feature

All 6 AI workflows are now installed by default, making knowledge management effortless:

• /maintenance - Keep knowledge base healthy (validates index, creates backups, updates environment)
• /save-from-chat - Save learnings from current chat session
• /search - Quick knowledge search before starting work
• /simpan-pengetahuan-dari-chat 🇮🇩 - Indonesian version of save-from-chat
• /simpan-pengetahuan-dari-folder 🇮🇩 - Save knowledge from folder
• /maintenance-agent-rules - Agent rules specific maintenance

Just tell your AI: "Run the maintenance workflow" or "Save learnings from this chat"

Enhanced Documentation

Quick Start Section:

• 3-step installation guide
• Video tutorial placeholder for future

Using Workflows Guide:

• Detailed explanation of each workflow
• Usage examples
• Editor compatibility tips

FAQ Section (5 questions):

• How is this different from .cursorrules?
• Can I use this with multiple projects?
• How do I uninstall?
• Does this work offline?
• Will this slow down my editor?

Troubleshooting Section (5 solutions):

• Python not found
• Permission errors
• Git conflicts
• Workflows not working
• ModuleNotFoundError

Better Repository Visibility:

• 5 new badges (version, issues, PRs, platform, Python requirement)
• GitHub Sponsor button enabled

Improved Contributor Experience:

• 4 GitHub issue templates (Bug Report, Feature Request, Question, Workflow Contribution)
• Enhanced CONTRIBUTING.md with dev setup, testing guide, PR workflow, code style guidelines

📥 Installation

Quick Install (Recommended)

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/andiupn/andy-universal-agent-rules/v1.1.0/install.ps1 | iex

Linux/Mac (Bash):

curl -sL https://raw.githubusercontent.com/andiupn/andy-universal-agent-rules/v1.1.0/install.sh | bash

What Gets Installed

your-project/
├── AGENTS.md # AI reads this first
└── .agent/
 ├── scripts/ # 6 Python automation scripts
 ├── workflows/ # 6 AI workflows (🆕 CORE FEATURE)
 ├── memory/ # Your knowledge base
 │ ├── index.json
 │ └── entries/
 │ ├── gotchas/
 │ ├── patterns/
 │ ├── decisions/
 │ └── context/
 └── context/ # Environment detection
 └── environment.json

🔄 Upgrading from v1.0.0

If you installed v1.0.0, your workflows folder may be empty or incomplete.

To upgrade:

# 1. Backup your knowledge (recommended)
python .agent/scripts/backup-memory.py
# 2. Re-run installer to get all workflows
cd your-project
iwr -useb https://raw.githubusercontent.com/andiupn/andy-universal-agent-rules/main/install.ps1 | iex
# 3. Choose 'y' when asked to overwrite
# Your knowledge in .agent/memory/ will be preserved

What gets updated:

• ✅ All 6 workflows installed in .agent/workflows/
• ✅ Scripts updated (if any changes)
• ✅ AGENTS.md template refreshed

What stays safe:

• ✅ Your knowledge entries in .agent/memory/entries/
• ✅ Your index.json
• ✅ Your custom modifications to AGENTS.md (if you don't overwrite)

📝 Full Changelog

Added

• Quick Start Section in README.md with 3-step installation guide
• Using Workflows Section in README.md explaining /maintenance, /save-from-chat, /search
• FAQ Section in README.md with 5 common questions
• Troubleshooting Section in README.md with 5 solutions
• 5 New Badges to README.md (version, issues, PRs, platform, Python)
• 4 Issue Templates in .github/ISSUE_TEMPLATE/
• Workflows as Core Feature: All 6 workflows now installed by default

Changed

• Enhanced CONTRIBUTING.md with development setup, testing guide, PR workflow, code style guidelines
• Updated CHANGELOG.md with semantic versioning adherence
• install.ps1: Now downloads all 6 workflows automatically
• install.sh: Now downloads all 6 workflows automatically

Fixed

• Installation consistency across Windows and Linux/Mac platforms
• Workflow installation completeness - users now get full feature set
• AGENTS.md table header language consistency

🎯 Supported Editors

• ✅ Antigravity (Gemini/Claude) - Full workflow support
• ✅ Cursor AI (Agent Mode) - Full workflow support
• ✅ Kiro AI - Full workflow support
• ✅ VSCode + GitHub Copilot - Use Python scripts directly
• ✅ Windsurf Editor - Compatible

💖 Support This Project

If this saves you hours of debugging, consider supporting:

📚 Resources

• README
• CHANGELOG
• CONTRIBUTING
• Issues

Thank you for using andy-universal-agent-rules! 🙏

Made with ❤️ by Andi UPN

What's Changed

• improve documentation and sytem quick installer by @andiupn in #1
• Feature/add workflows by @andiupn in #2

New Contributors

• @andiupn made their first contribution in #1

Full Changelog: https://github.com/andiupn/andy-universal-agent-rules/commits/v1.1.0

Contributors

• @andiupn