feat: add Claude Code project skills — clean-code, hub-rules, commit-convention, event-driven, deploy-workflow

2026-07-21 18:21:29 +07:00
parent bc153b7491
commit 3299759dae
7 changed files with 487 additions and 2 deletions
@@ -0,0 +1,96 @@
+---
+name: hub-rules
+description: Aturan repository, arsitektur hub, submodule, dan workflow Asepharyana Hub
+---
+
+# Asepharyana Hub — Repository Rules
+
+## Struktur Repository
+
+```
+asepharyana-hub/
+├── apps/              # Git submodules — source code aplikasi
+├── docs/              # Dokumentasi, ADR, deployment guide
+├── infra/             # Infrastructure as code
+│   ├── compose/       # Satu compose file per service
+│   ├── dapr/          # Dapr component configs
+│   ├── docker/        # Dockerfiles per service
+│   └── traefik/       # Static & dynamic Traefik config
+├── scripts/           # Utility scripts (cleanup, update-deps)
+└── .github/workflows/ # CI/CD pipelines
+```
+
+### Aturan Submodule
+- Setiap aplikasi di `apps/` adalah **submodule** ke repo terpisah.
+- Perubahan kode aplikasi dilakukan di **repo masing-masing**, bukan di sini.
+- Submodule pointer diupdate oleh CI/CD (bukan manual).
+
+## Infrastructure Patterns
+
+### Networking
+- Semua service join **`app-shared-net`** (external Docker bridge)
+- Service discovery via Docker DNS (container alias)
+- Traefik sebagai ingress untuk HTTP/S eksternal
+- Tailscale untuk cross-VPS (PostgreSQL, Redis, browserless di `imrnes`)
+
+### Compose File Pattern
+```yaml
+services:
+  <service>:
+    container_name: <service>
+    image: ghcr.io/asepharyana/asepharyana-hub/<service>:sha-<sha>
+    restart: always
+    networks:
+      app-shared-net:
+        aliases:
+          - <service>
+    env_file:
+      - ../../.env
+
+networks:
+  app-shared-net:
+    name: app-shared-net
+    external: true
+```
+
+### Dapr Sidecar Pattern
+```yaml
+  <service>-dapr:
+    container_name: <service>-dapr
+    image: daprio/daprd:latest
+    restart: always
+    depends_on:
+      nats:
+        condition: service_started
+      dapr-placement:
+        condition: service_started
+    networks:
+      - app-shared-net
+    command:
+      - './daprd'
+      - '--app-id=<service>'
+      - '--app-port=<port>'
+      - '--dapr-http-port=3500'
+      - '--dapr-grpc-port=50001'
+      - '--placement-host-address=dapr-placement:50005'
+      - '--resources-path=/components'
+    volumes:
+      - ../../infra/dapr/components:/components
+```
+
+### Traefik Routing
+- Router + service definition di `infra/traefik/dynamic/apps.yaml`
+- Subdomain pattern: `<service>.asepharyana.my.id` + `<service>.asepharyana.web.id`
+- TLS cert dari volume mount (bukan auto-acme)
+
+### CI/CD
+- `docker-build-push.yml` — build per service, push ke GHCR, update compose manifest
+- `deploy-docker.yml` — SSH ke orangevps, pull images, restart
+- Selective deploy: hanya compose file yg berubah
+
+## Deployment Order
+1. `shared.yml` (Redis)
+2. `nats.yml` (NATS message bus)
+3. `dapr.yml` (Dapr placement)
+4. `traefik.yml` (Reverse proxy)
+5. Service compose files (apps + Dapr sidecar)