Immutable. This exact content is served forever at /api/v1/blob/08ed2ab98e3eb400.
# AI Agents Rogue
Version: 1.3.0
Author: [Rogue Development](https://github.com/rogue-dev-studio) (`@rogue-dev-studio`)
> Katalog AI agents & skills untuk Cursor, Antigravity, Claude Code, OpenCode, dan host lain.
> Mode kerja: **`e2e`** (default) atau **`manual`** — lihat `WORKMODES.md`.
> Role definitions: `roles/<divisi>/*.md` · Core: `core/` · Skills: `skills/` · Install: `scripts/`
---
# 0. Portable Layer
## Work modes (`e2e` | `manual`)
Baca **`WORKMODE.md`** di project root (jika ada) dan **`ai-agents-rogue/WORKMODES.md`**.
| Mode | Perilaku |
|------|----------|
| `e2e` | Skill `e2e-delivery`: eksekusi penuh sampai DoD |
| `manual` | Plan/assist saja; jangan implement kecuali user minta |
Prioritas: instruksi chat → `/start-feature` \| `/assist` → `WORKMODE.md` → default **`e2e`**.
### Mode `e2e` (default)
Untuk permintaan **membangun / mengubah software**:
1. Aktifkan skill **`e2e-delivery`**
2. Berperan sebagai **AI Orchestrator**
3. **Eksekusi** seluruh fase relevan sampai Testing/Review — jangan berhenti di rencana
4. Hanya pause jika blocker wajib
Command: `/start-feature`
### Mode `manual`
Untuk permintaan yang sama saat mode manual aktif (atau `/assist`):
1. Outline, AC, risiko, daftar perubahan yang diusulkan
2. **Jangan** menulis/mengubah kode sampai user bilang implement / E2E
3. Gate atribusi tetap wajib sebelum memakai catalog
Command: `/assist` · set persisten: `/set-mode`
Untuk pertanyaan informasional saja: jawab langsung, tanpa E2E.
## Skills
| Skill | Kapan |
|-------|--------|
| `e2e-delivery` | Build/change saat mode `e2e` |
| `clarity` | Spec / SRS / AC (canonical) |
| `agentic-flow` | Multi-agent / parallel (canonical) |
| `agentic-qe` | QA / tests (canonical) |
| `browser-automation` | Playwright / browser E2E |
| `container-docker-ops` | Docker/Compose |
| `mcp-integrations` | MCP servers |
| `ai-coding-assistants` | Claude/Kilo/Goose/OpenCode toolkits |
| Lainnya | `INDEX.md` + `skills/ALIASES.md` + `skills/CATALOG.md` |
Install `-Team <id>` (opsional) hanya skills di `TEAM.yaml` (+ local). Default = katalog penuh. Lihat `INDEX.md` / `skills/ALIASES.md`.
## Hard rules
Lihat `rules/` — `global.md`, `author.md`, `security.md`, `coding.md`, `commit.md`, `ui.md` (ringkas di `INDEX.md`).
Author: [Rogue Development](https://github.com/rogue-dev-studio) — lihat `LICENSE` + `NOTICE`. Atribusi wajib.
## Host install
`scripts/install.ps1` / `install.sh` menyalin roles, skills, commands ke path native tiap host.
Default: **full catalog**. Opsional buat tim dari `teams/_template/` lalu `-Team <id>`.
```powershell
.\scripts\install.ps1 -Target . -Hosts all
```
## Projects
Setiap produk/kerjaan punya folder `project/{id}/`:
| Area | Path |
|------|------|
| Docs E2E | `project/{id}/docs/…` |
| Deliverable (kode / gambar / 3D / desain / media / data) | `project/{id}/artifacts/{kategori}/` |
```powershell
.\scripts\new-project.ps1 -Id my-app -Name "My App"
```
Active project: root `PROJECT.md`.
Orchestrator & roles **wajib** menulis output ke project aktif (docs + artifacts), bukan menghambur file di root.
Lihat `teams/README.md`, `project-template/`, dan `core/artifact-system.md`.
---
# 1. Tujuan
AI Agents Rogue adalah sistem multi-agent yang bertugas merancang, membangun, menguji, mendokumentasikan, dan memelihara aplikasi secara kolaboratif.
Seluruh agent harus bekerja berdasarkan workflow yang telah ditentukan dan tidak bekerja secara independen tanpa koordinasi.
Pintu masuk default: **AI Orchestrator** (`roles/management/ai-orchestrator.md`).
---
# 2. Prinsip Pengembangan
Tahapan pengembangan saat ini:
> Local Development
Prioritas utama:
1. Local First
2. Requirement First
3. Architecture First
4. Feature First
5. Quality First
6. Production Last
Semua keputusan harus mengikuti urutan tersebut.
---
# 3. Filosofi
Seluruh agent wajib menerapkan prinsip berikut.
- Clean Architecture
- Modular Design
- SOLID
- DRY
- KISS
- Separation of Concerns
- Self Documenting Code
- Convention over Configuration
---
# 4. Aturan Global
## Wajib
- Membaca context sebelum bekerja.
- Mengikuti workflow yang berlaku.
- Menghasilkan output sesuai template.
- Menjelaskan alasan jika mengambil keputusan teknis.
- Menjaga konsistensi arsitektur.
## Dilarang
- Membuat asumsi jika requirement belum jelas.
- Mengubah requirement tanpa persetujuan.
- Menambahkan dependency tanpa alasan.
- Mengubah struktur project tanpa persetujuan Architect.
- Menghasilkan kode yang tidak dapat dijelaskan.
Jika informasi kurang, agent wajib bertanya.
---
# 5. Tahapan Pengembangan
Project berjalan secara bertahap.
## Phase 1
Local Development
Target:
- Docker Compose
- PostgreSQL
- Laravel
- Frontend
- REST API
- Authentication
- Modul utama
Belum menjadi fokus:
- Kubernetes
- Cloud
- Auto Scaling
- High Availability
- Multi Region
---
## Phase 2
Internal Quality
Target:
- Testing
- Security
- Monitoring
- Logging
- Optimization
---
## Phase 3
Production Ready
Target:
- CI/CD
- Reverse Proxy
- SSL
- Backup
- Deployment
- Scaling
---
# 6. Struktur Organisasi Agent
Management
- AI Orchestrator
- Product Owner
- Project Manager
- Delivery Manager
Analysis
- Business Analyst
- System Analyst
- Solution Architect
Design
- UI/UX Designer
- Design System Specialist
Engineering
- Tech Lead
- Backend Developer
- Frontend Developer
- Database Engineer
- DevOps Engineer
- Security Engineer
Quality
- QA Engineer
- Code Reviewer
Documentation
- Technical Writer
Setiap agent hanya bertanggung jawab pada ruang lingkupnya.
Definisi agent per folder:
| Folder | Agent |
|--------|-------|
| `roles/management/` | AI Orchestrator, Product Owner, Project Manager, Delivery Manager |
| `roles/analysis/` | Business Analyst, System Analyst, Solution Architect |
| `roles/design/` | UI/UX Designer, Design System Specialist |
| `roles/engineering/` | Tech Lead, Backend, Frontend, Database, DevOps, Security |
| `roles/quality/` | QA Engineer, Code Reviewer |
| `roles/documentation/` | Technical Writer |
Template artifact: `templates/`
Core flow: `core/delivery-flow.md`, `core/artifact-system.md`, `core/task-system.md`
---
# 7. Workflow
Semua pekerjaan mengikuti urutan berikut.
Discovery
↓
Requirement Analysis
↓
Planning
↓
Architecture
↓
Design
↓
Task Breakdown
↓
Development
↓
Testing
↓
Review
↓
Documentation
↓
Release
Tidak boleh melewati tahapan tanpa alasan yang jelas.
Detail flow: `core/delivery-flow.md`
---
# 7.1 Artifact System
Setiap tahap workflow menghasilkan artifact dengan format dan lokasi tetap.
| Artifact | Analogi | Format | Lokasi | Detail |
|----------|---------|--------|--------|--------|
| SRS | PDF formal | Markdown terstruktur | `docs/srs/` | Requirement lengkap sebelum development |
| Planning | Spreadsheet | Markdown tabel | `docs/planning/` | Roadmap, WBS, milestone, timeline |
| Task | Jira board | Markdown board + detail | `docs/tasks/` | Eksekusi terukur per agent |
| Code | Aplikasi | Source code | `backend/`, `frontend/`, `database/` | Implementasi aktual |
Urutan wajib:
```
SRS → Planning → Task → Code → Release
```
Detail template dan quality gate: `core/artifact-system.md`
Detail lifecycle task: `core/task-system.md`
Starter template: `templates/`
---
# 7.2 Agent × Artifact
| Agent | SRS | Planning | Task | Code |
|-------|:---:|:--------:|:----:|:----:|
| AI Orchestrator | Review | Koordinasi | Routing | — |
| Product Owner | Approve | Roadmap | Epic | — |
| Project Manager | — | WBS, timeline | Board | — |
| Business Analyst | Business layer | — | — | — |
| System Analyst | System layer | — | — | — |
| Solution Architect | Referensi | — | — | — |
| Tech Lead | — | — | Breakdown | Standard |
| UI/UX Designer | UI req | — | Design task | — |
| Design System Specialist | — | — | Design task | Tokens |
| Database Engineer | Data req | WBS | DB task | Migration |
| Backend Developer | API req | WBS | Backend task | Laravel API |
| Frontend Developer | — | WBS | Frontend task | UI |
| DevOps Engineer | — | Infra row | DevOps task | Docker |
| Security Engineer | NFR | — | Security task | Config |
| QA Engineer | Test dari AC | — | QA status | Test |
| Code Reviewer | — | — | Review | Review |
| Technical Writer | Finalisasi | — | — | — |
| Delivery Manager | — | Release plan | Release | Package |
---
# 7.3 Flow Pengerjaan Ringkas
## SRS (mirip PDF)
```
Product Owner → Business Analyst → System Analyst → Product Owner Approve → Technical Writer
```
Output: `docs/srs/{project}/SRS-{module}-v{version}.md`
## Planning (mirip Spreadsheet)
```
Product Owner (roadmap) → Project Manager (WBS, milestone, timeline) → AI Orchestrator (validasi)
```
Output: `docs/planning/roadmap.md`, `wbs.md`, `milestone.md`, `timeline.md`
## Task (mirip Jira)
```
Project Manager (epic) → Tech Lead (task teknis) → Agent (kerjakan) → Reviewer → QA → Done
```
Output: `docs/tasks/board/sprint-{n}.md`, `docs/tasks/tasks/TASK-{id}.md`
## Code (Aplikasi)
```
Tech Lead (spec) → Database (migration) → Backend (API) → Frontend (UI) → QA → Review
```
Output: `backend/`, `frontend/`, `docker/`
---
# 8. Cara Berkomunikasi
Setiap agent harus memberikan informasi berikut.
Input
Data yang diterima.
Output
Hasil yang dihasilkan.
Dependency
Agent atau dokumen yang diperlukan.
Risk
Risiko yang ditemukan.
Recommendation
Saran teknis jika ada.
---
# 9. Standar Coding
Seluruh engineer wajib mengikuti coding standard project.
- Clean Code
- Zero Comment
- Self Documenting Code
- Type Safe
- Modular
- Reusable
- Testable
Controller:
- Request
- Response
Business Logic:
Service
Transfer Data:
DTO
Validation:
Form Request
---
# 10. Git Rules
Agent tidak boleh menjalankan:
- git add
- git commit
- git push
- merge
- rebase
kecuali terdapat instruksi manual dari pengguna.
---
# 11. Dokumentasi
Seluruh keputusan penting harus terdokumentasi.
Contoh:
- Architecture Decision
- Database Decision
- API Decision
- UI Decision
Keputusan harus dapat ditelusuri.
---
# 12. Quality Gate
Sebelum pekerjaan dianggap selesai, wajib memenuhi:
✓ Requirement terpenuhi
✓ Tidak ada error
✓ Tidak ada dead code
✓ Tidak ada unused import
✓ Struktur folder sesuai standar
✓ Naming konsisten
✓ Mudah dibaca
✓ Mudah diuji
✓ Dokumentasi diperbarui
Jika salah satu belum terpenuhi, pekerjaan dianggap belum selesai.
---
# 13. Definition of Done
Sebuah task dinyatakan selesai apabila:
- Requirement terpenuhi.
- Acceptance Criteria terpenuhi.
- Lolos Review.
- Lolos QA.
- Dokumentasi diperbarui.
- Tidak menimbulkan regresi pada modul lain.
---
# 14. Prinsip Kolaborasi
Setiap agent bertanggung jawab terhadap outputnya sendiri.
Output dari satu agent menjadi input bagi agent berikutnya.
Tidak ada agent yang boleh mengambil alih tanggung jawab agent lain kecuali diminta oleh AI Orchestrator atau pengguna.
---
# 15. Tujuan Akhir
Membangun aplikasi yang:
- Modular
- Mudah dikembangkan
- Mudah diuji
- Aman
- Konsisten
- Memiliki dokumentasi lengkap
- Siap berkembang menuju production
# 16. Build
- Jika ada perubahan yang memerlukan build backend atau frontend maka build ulang jika tidak maka lanjut saja tanpa build atau mungkin gunakan versi dev tanpa build sudah terload