docs(context): issue template + SESSION-STATE base — estrutura de contexto de sessão

2026-05-20 10:39:42 -03:00
parent a80641dba7
commit df6abe5021
2 changed files with 75 additions and 0 deletions
@@ -0,0 +1,45 @@
+# Issue Template — Pulse Agent Tasks
+
+Usado pelo Pulse para representar tarefas pendentes, projetos e ADRs no Gitea.
+
+## Tipos de Issue
+
+| Tipo | Label | Descrição |
+|------|-------|-----------|
+| `bug` | 🐛 bug | Algo que quebrou ou não funciona como esperado |
+| `feature` | ✨ feature | Nova capacidade solicitada pelo usuário |
+| `chore` | 🔧 chore | Manutenção, atualização, cleanup |
+| `docs` | 📚 docs | Mudança em documentação apenas |
+| `learning` | 🧠 learning | Aprendizado capturado durante a sessão |
+| `decision` | ⚡ decision | ADR — Architectural Decision Record |
+
+## Template padrão
+
+```markdown
+### Tarefa
+[descrição curta]
+
+### Contexto
+[por que isso importa, links de issues/PRs relacionados]
+
+### Critérios de aceitação
+- [ ] critério 1
+- [ ] critério 2
+
+### Prioridade
+P-1 (crítico) | P-2 (alta) | P-3 (média) | P-4 (baixa)
+
+### Referências
+- `MEMORY.md` — lrn-XXXX-XXX
+- Skill: `<nome-skill>`
+- Docs: `pulse-docs/<caminho>`
+```
+
+## Convenção de labels do Pulse
+
+```
+prioridade:P1 | prioridade:P2 | prioridade:P3 | prioridade:P4
+area:devops | area:testing | area:frontend | area:backend | area:ai | area:infra
+status:todo | status:in-progress | status:blocked | status:done | status:wontfix
+type:bug | type:feature | type:chore | type:docs | type:learning | type:decision
+```
@@ -0,0 +1,30 @@
+# SESSION-STATE.md — Estado da Sessão Atual
+
+_Arquivo vivo: atualizado a cada heart-beat ou mudança relevante._
+
+## Metadados
+- **Sessão iniciada**: $(date +%Y-%m-%d)
+- **Sessão ativa**: sim
+- **Tarefa atual**: montar sistema de memória Gitea completo
+- **Tarefas pendentes**: []
+
+## Serviços em execução (Docker Swarm)
+| Stack | Serviços | Status |
+|-------|--------- |--------|
+| bot | beebot, office, redis | ✅ 🟢 |
+| code | file (8dcode) | ✅ 🟢 |
+| database | mongos-master, dbadmin | ✅ 🟢 |
+| design | Penpot completo (7) | ✅ 🟢 |
+| dock | portainer, agent | ✅ 🟢 |
+| git | gitea | 🟢 |
+| pro | leantime + mariadb | ✅ 🟢 |
+| proxy | caddy (80/443) | ✅ 🟢 |
+
+## Créditos Gitea (consultar TOOLS.md antes de usar)
+- Token: `pulse-agent-token` — scopes=all
+- Admin: `octal` / senha via `gitea admin user change-password`
+- SSH: `~/.ssh/id_ed25519_gitea`
+
+## Read-only — não Commitar Segredos
+
+Variáveis, senhas, tokens → usar apenas no ambiente, nunca nos arquivos de memória públicos.