# RULE — SPECs por projecto (Vault + Forgejo)

**Data:** 2026-08-05  
**Para:** Roger  
**Obrigatório:** sim

---

## Regra de ouro

**Cada SPEC vive no projecto respectivo**, em **dois** sítios:

| Camada | Onde |
|--------|------|
| 1. Vault Obsidian (CT130) | `/opt/ligbox-spec-hub/obsidian-vault/<Projecto>/` |
| 2. Git Forgejo | `https://git.spec.ligbox.com.br/ligbox/<projecto>` |

Espelho de trabalho no disco do hub: `/opt/ligbox-spec-hub/repos/<projecto>/`

**Proibido:** deixar SPEC solta na raiz do vault, ou meter SPEC de um projecto dentro de `ligbox-ops-platform` (salvo SPECs nativas desse monorepo).

---

## Mapa projecto → paths

| Projecto | Pasta vault | Repo Forgejo |
|----------|-------------|--------------|
| Ligbox Ops | `ligbox-ops-platform/` | https://git.spec.ligbox.com.br/ligbox/ligbox-ops-platform |
| Obsidian Vault (índice) | (raiz + sidebars) | https://git.spec.ligbox.com.br/ligbox/obsidian-vault |
| **Invest MyVexx** | `Invest-MyVexx/` | https://git.spec.ligbox.com.br/ligbox/invest-myvexx |
| **ERP Odoo** | `ERP-Odoo-Ligit-MyVexx/` | https://git.spec.ligbox.com.br/ligbox/erp-odoo-ligit-myvexx |
| **Infra / Network** | `Infra-Network/` | https://git.spec.ligbox.com.br/ligbox/infra-network |

GitHub público/org (`itecnologys-tech/...`) é **espelho opcional**; a fonte Spec Hub é o **Forgejo**.

---

## Checklist ao criar / gravar uma SPEC

1. Escolher o **projecto** (não “raiz do vault”).  
2. Escrever em `repos/<projecto>/specs/<id>-<slug>/` (e espelho Obsidian na pasta do projecto).  
3. `git add && commit && push` para `git.spec.ligbox.com.br/ligbox/<projecto>`.  
4. Actualizar vault `obsidian-vault/<Projecto>/` + commit `obsidian-vault` se o portal/Obsidian depender disso.  
5. Regenerar menu: `bash /opt/ligbox-spec-hub/portal/generate-sidebars.sh` (+ refresh portal).  
6. Confirmar link no Vault UI e no Forgejo.

---

## Naming

- Pasta Forgejo/repos: `kebab-case` (`invest-myvexx`)  
- Pasta vault: `Title-Case` ou nome estável do projecto (`Invest-MyVexx`)  
- Ficheiro SPEC: `SPEC-NNN-TITLE.md` ou Spec Kit `specs/NNN-slug/spec.md`

---

## Excepções

- SPECs **Ligbox Ops** (001–045…) ficam em `ligbox-ops-platform` (vault copy + repo).  
- Documentos transversais de índice podem estar no README do vault, com **links** para o projecto — não substituem o alojamento no projecto.