ligbox/obsidian-vault
3
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
obsidian-vault/Invest-MyVexx/RULE-SPECS-POR-PROJECTO-VAULT-FORGEJO.md

2.3 KiB
Raw Blame History

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.