@eltonssouza/development-utility-kit 0.10.0

package/.claude/skills/brain-keeper/obsidian/graph.json

@@ -0,0 +1,32 @@
+{
+  "collapse-filter": true,
+  "search": "",
+  "showTags": false,
+  "showAttachments": false,
+  "hideUnresolved": false,
+  "showOrphans": true,
+  "collapse-color-groups": false,
+  "colorGroups": [
+    { "query": "path:_templates",   "color": { "a": 1, "rgb": 9741240 } },
+    { "query": "path:api",          "color": { "a": 1, "rgb": 3900150 } },
+    { "query": "path:architecture", "color": { "a": 1, "rgb": 11032055 } },
+    { "query": "path:bugs",         "color": { "a": 1, "rgb": 15680580 } },
+    { "query": "path:daily",        "color": { "a": 1, "rgb": 2278750 } },
+    { "query": "path:database",     "color": { "a": 1, "rgb": 16347926 } },
+    { "query": "path:decisions",    "color": { "a": 1, "rgb": 15381256 } },
+    { "query": "path:features",     "color": { "a": 1, "rgb": 440020 } },
+    { "query": "path:meetings",     "color": { "a": 1, "rgb": 15485081 } }
+  ],
+  "collapse-display": true,
+  "showArrow": false,
+  "textFadeMultiplier": 0,
+  "nodeSizeMultiplier": 1,
+  "lineSizeMultiplier": 1,
+  "collapse-forces": true,
+  "centerStrength": 0.518713248970312,
+  "repelStrength": 10,
+  "linkStrength": 1,
+  "linkDistance": 250,
+  "scale": 1,
+  "close": true
+}

package/.claude/skills/brain-keeper/obsidian/snippets/folder-colors.css

@@ -0,0 +1,90 @@
+/*
+ * folder-colors.css
+ * Cores por pasta no file explorer do Obsidian.
+ * Aplicado a:
+ *   - Título da pasta no nav lateral
+ *   - Arquivos dentro da pasta (cor mais clara/diluída)
+ *
+ * Editar paleta? Troque os valores hex abaixo.
+ */
+
+/* _templates — slate */
+.nav-folder-title[data-path="_templates"] .nav-folder-title-content,
+.nav-file-title[data-path^="_templates/"] .nav-file-title-content {
+  color: #94a3b8;
+}
+.nav-folder-title[data-path="_templates"]::before {
+  content: "🩶 ";
+}
+
+/* api — azul */
+.nav-folder-title[data-path="api"] .nav-folder-title-content,
+.nav-file-title[data-path^="api/"] .nav-file-title-content {
+  color: #3b82f6;
+}
+.nav-folder-title[data-path="api"]::before {
+  content: "🔵 ";
+}
+
+/* architecture — roxo */
+.nav-folder-title[data-path="architecture"] .nav-folder-title-content,
+.nav-file-title[data-path^="architecture/"] .nav-file-title-content {
+  color: #a855f7;
+}
+.nav-folder-title[data-path="architecture"]::before {
+  content: "🟣 ";
+}
+
+/* bugs — vermelho */
+.nav-folder-title[data-path="bugs"] .nav-folder-title-content,
+.nav-file-title[data-path^="bugs/"] .nav-file-title-content {
+  color: #ef4444;
+}
+.nav-folder-title[data-path="bugs"]::before {
+  content: "🔴 ";
+}
+
+/* daily — verde */
+.nav-folder-title[data-path="daily"] .nav-folder-title-content,
+.nav-file-title[data-path^="daily/"] .nav-file-title-content {
+  color: #22c55e;
+}
+.nav-folder-title[data-path="daily"]::before {
+  content: "🟢 ";
+}
+
+/* database — laranja */
+.nav-folder-title[data-path="database"] .nav-folder-title-content,
+.nav-file-title[data-path^="database/"] .nav-file-title-content {
+  color: #f97316;
+}
+.nav-folder-title[data-path="database"]::before {
+  content: "🟠 ";
+}
+
+/* decisions — amarelo */
+.nav-folder-title[data-path="decisions"] .nav-folder-title-content,
+.nav-file-title[data-path^="decisions/"] .nav-file-title-content {
+  color: #eab308;
+}
+.nav-folder-title[data-path="decisions"]::before {
+  content: "🟡 ";
+}
+
+/* features — ciano */
+.nav-folder-title[data-path="features"] .nav-folder-title-content,
+.nav-file-title[data-path^="features/"] .nav-file-title-content {
+  color: #06b6d4;
+}
+.nav-folder-title[data-path="features"]::before {
+  content: "🔷 ";
+}
+
+/* meetings — rosa */
+.nav-folder-title[data-path="meetings"] .nav-folder-title-content,
+.nav-file-title[data-path^="meetings/"] .nav-file-title-content {
+  color: #ec4899;
+}
+.nav-folder-title[data-path="meetings"]::before {
+  content: "🩷 ";
+}

package/.claude/skills/brain-keeper/obsidian/templates.json

@@ -0,0 +1,5 @@
+{
+  "folder": "_templates",
+  "dateFormat": "YYYY-MM-DD",
+  "timeFormat": "HH:mm"
+}

package/.claude/skills/brain-keeper/templates/README.md

@@ -0,0 +1,51 @@
+---
+title: Project Brain — MOC
+type: moc
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+tags: [moc]
+---
+
+# 🧠 Project Brain
+
+Map of Content (MOC) — main index of the Obsidian vault. Updated automatically by `brain-keeper` upon completing each PLAN_*.
+
+## Structure
+
+```
+docs/brain/
+├── _templates/    🩶 templates (adr, feature, bug, daily, meeting)
+├── api/           🔵 REST contracts, endpoint changelog
+├── architecture/  🟣 system view, diagrams, tech-debt.md
+├── bugs/          🔴 postmortems
+├── daily/         🟢 daily log
+├── database/      🟠 model, migrations, schema
+├── decisions/     🟡 ADRs
+├── features/      🔷 notes per feature
+└── meetings/      🩷 minutes
+```
+
+## Recent decisions
+
+_Added by brain-keeper._
+
+## Active features
+
+_Added by brain-keeper._
+
+## Open / recent bugs
+
+_Added by brain-keeper._
+
+## Technical debt
+
+→ [[architecture/tech-debt]]
+
+## How to navigate
+
+- **Why did we decide X?** → [[decisions/]]
+- **How does Y work?** → [[features/]]
+- **What was done yesterday?** → [[daily/]]
+- **Did we have a bug with Z?** → [[bugs/]]
+- **What's the contract for endpoint E?** → [[api/]]
+- **How is table T modeled?** → [[database/]]

package/.claude/skills/brain-keeper/templates/adr.md

@@ -0,0 +1,40 @@
+---
+title: ADR-NNN — <short title>
+type: ADR
+status: Accepted
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+tags: [decision]
+---
+
+# ADR-NNN: <short title>
+
+- **Status**: Proposed | Accepted | Superseded by ADR-XXX | Deprecated
+- **Date**: YYYY-MM-DD
+
+## Context
+
+_Why is this decision necessary? What problem or force is pushing toward a decision?_
+
+## Decision
+
+_What was decided, clearly and affirmatively._
+
+## Consequences
+
+**Gains:**
+- ...
+
+**Losses / costs:**
+- ...
+
+## Alternatives discarded
+
+- **Alternative A**: why it was rejected
+- **Alternative B**: why it was rejected
+
+## References
+
+- [[../daily/YYYY-MM-DD|Daily]]
+- [[../features/slug|Feature]]
+- Related commits / PRs

package/.claude/skills/brain-keeper/templates/bug.md

@@ -0,0 +1,35 @@
+---
+title: <short description>
+type: bug
+status: fixed
+severity: P0|P1|P2|P3
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+tags: [bug]
+---
+
+# 🐛 <short description>
+
+## Symptom
+
+_How did the bug manifest? Error message, observed behavior, impact._
+
+## Root cause
+
+_Technical analysis. Don't confuse symptom with cause._
+
+## Fix applied
+
+_What was changed to resolve. Cite files/lines._
+
+## Prevention
+
+- New test: ...
+- Lint rule / review rule: ...
+- ADR: [[../decisions/ADR-NNN-slug|ADR-NNN]] (if applicable)
+
+## References
+
+- [[../daily/YYYY-MM-DD|Daily]]
+- [[../features/slug|Related feature]]
+- Commit / PR

package/.claude/skills/brain-keeper/templates/daily.md

@@ -0,0 +1,38 @@
+---
+title: YYYY-MM-DD — <day summary>
+type: daily
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+tags: [daily]
+---
+
+# 📅 YYYY-MM-DD
+
+## Summary
+
+_1-2 lines about the main goal of the day._
+
+## Done
+
+- Feature: [[../features/slug|name]]
+- Fix: [[../bugs/slug|description]]
+- Refactor: ...
+
+## Decisions
+
+- [[../decisions/ADR-NNN-slug|ADR-NNN]] — title
+
+## Files
+
+**Created:** ...
+**Changed:** ...
+**Deleted:** ...
+
+## Blockers
+
+_What stalled progress? Waiting on whose decision? External dependency?_
+
+## Tomorrow
+
+- Next step 1
+- Next step 2

package/.claude/skills/brain-keeper/templates/feature.md

@@ -0,0 +1,62 @@
+---
+title: <feature name>
+type: feature
+status: in-progress
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+plan: docs/plans/PLAN_<NAME>.md
+tags: [feature]
+---
+
+# ✨ <feature name>
+
+## Goal
+
+_What business problem does this feature solve? What value is delivered?_
+
+## Requirements
+
+- [ ] FR: ...
+- [ ] NFR: ...
+- [ ] BR: ...
+- [ ] IR: ...
+
+## Decisions made
+
+- [[../decisions/ADR-NNN-slug|ADR-NNN]] — decision title
+- Minor decisions (without ADR) recorded here
+
+## Implementation
+
+### Backend
+
+- Endpoints: `GET /api/v1/...`, `POST /api/v1/...`
+- Entities: ...
+- Use cases: ...
+- Migrations: `V202X__description.sql`
+
+### Frontend
+
+- Routes: `/path`
+- Components: `FeatureListComponent`, `FeatureFormComponent`
+- Services: `FeatureService`
+
+## Tests
+
+- Backend (JUnit + Mockito + Testcontainers): N
+- Frontend (Jest + Testing Library): N
+- E2E (Playwright): N
+- Coverage: backend X% / frontend Y%
+
+## References
+
+- Plan: [[../../plans/PLAN_<NAME>|PLAN_<NAME>]]
+- Start daily: [[../daily/YYYY-MM-DD]]
+- Commits: ...
+- PR: ...
+
+## History
+
+| Date | Change |
+|------|--------|
+| YYYY-MM-DD | Created |

package/.claude/skills/brain-keeper/templates/meeting.md

@@ -0,0 +1,34 @@
+---
+title: YYYY-MM-DD — <title>
+type: meeting
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+tags: [meeting]
+---
+
+# 🗓️ <title>
+
+- **Date**: YYYY-MM-DD
+- **Attendees**: ...
+
+## Agenda
+
+1. ...
+2. ...
+
+## Discussion
+
+_Relevant points._
+
+## Decisions
+
+- [[../decisions/ADR-NNN-slug|ADR-NNN]] — title (if it became an ADR)
+- Minor decision: ...
+
+## Actions
+
+- [ ] @person — action — deadline
+
+## References
+
+- [[../daily/YYYY-MM-DD|Daily]]

package/.claude/skills/brain-keeper/templates/tech-debt.md

@@ -0,0 +1,21 @@
+---
+title: Technical debt
+type: tech-debt
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+tags: [tech-debt, architecture]
+---
+
+# 🔧 Technical debt
+
+Items accepted as debt during development. Append by `brain-keeper` at the end of each PLAN_*.
+
+Severity:
+- **P0**: blocks production. Resolve before next release.
+- **P1**: high risk / impact. Next sprint.
+- **P2**: relevant but not urgent. Backlog next quarter.
+- **P3**: cosmetic / improvement. Long backlog.
+
+---
+
+## Items

package/.claude/skills/caveman/SKILL.md

@@ -0,0 +1,189 @@
+---
+name: caveman
+description: Caveman style — telegraphic output, no articles/fillers/flourishes, ~65–75% token savings. Triggers automatically in this project (always on) and via "caveman", "caveman mode", "caveman lite|full|ultra", "stop caveman", "back to normal". Fixed default rule — ULTRA for code/files .java .ts .py .sh .yml .json etc., LITE/FULL for .md. Does not change technical semantics, just removes fluff. Preserves YAML frontmatter, symbol names, paths, exact commands. Do NOT use to suppress error messages, schema details, ADR semantics, or any non-cosmetic content — caveman only removes filler words, never technical substance. PT triggers: 'modo caveman', 'caveman lite', 'caveman full', 'caveman ultra', 'stop caveman', 'volta normal'.
+tools: Read, Write, Edit
+model: sonnet
+---
+
+# Caveman — Telegraphic Style
+
+Always reply in American English. Code and short text. No fluff.
+
+---
+
+## 1. Master rule (non-negotiable)
+
+| Context | Level | Example |
+|---|---|---|
+| Code (`.java`, `.ts`, `.py`, `.sh`, `.yml`, `.json`, `.html`, `.css`) | **ULTRA** | Comment only if critical. 1 line. No narrative. |
+| Chat / spoken explanation | **FULL** | Direct. No preamble. |
+
+When in doubt → **FULL**.
+
+User asked `stop caveman` / `back to normal` → off. User asked `caveman ultra` → ultra everywhere in that response.
+
+### 1.1 Context override — high-stakes documents auto-promote to FULL
+
+When the task is producing one of these artifacts, **temporarily promote to FULL** (or normal prose) even if a code file is involved — compression here loses substance that matters:
+
+| Trigger context | Why FULL | What stays uncompressed |
+|---|---|---|
+| **ADR draft** ("write ADR", "registra decisão", `docs/decisions/ADR-*`) | Justification + trade-offs need full reasoning | Considered options, decision framework scoring, consequences |
+| **Security audit** ("security audit", "OWASP", "LGPD", "audita vulnerabilidade") | Legal/compliance text must be faithful | Vuln descriptions, CVSS reasoning, remediation steps |
+| **PRD / requirements doc** ("PRD document", "documento de requisitos", "user stories") | Acceptance criteria must be unambiguous | BR/FR/NFR statements, BDD Given/When/Then |
+| **Incident / post-mortem report** ("incident report", "post-mortem", "RCA") | Timeline + root cause must be precise | Event timeline, root cause chain, action items |
+| **Contract / API spec** ("OpenAPI", "API contract", "schema") | Already covered by §3 rule 5 — never compress | DTO shapes, schema fields, examples |
+
+Promotion is **scoped to that artifact only** — code files in the same task still follow ULTRA. After the artifact is done, revert to the §1 master rule. This is automatic; the user does not need to ask.
+
+---
+
+## 2. Levels
+
+### LITE — soft
+- Removes: "basically", "it's worth noting", "it's important to note", "in other words", hedge.
+- Keeps: grammar, articles, normal punctuation.
+
+**Example**
+> Before: "It's important to note that basically the JWT token expires after 15 minutes."
+> After: "JWT token expires in 15 min."
+
+### ULTRA — telegraphic
+- Removes: everything FULL removes + redundant conjunctions.
+- Style: command/bullet, arrows (`→`), standard abbreviations (`w/`, `for`, `w/o`).
+- Code: 1-line docstring or absent if name is self-explanatory.
+
+**Java example**
+```java
+// FULL
+/** Returns the product by ID. Throws ProductNotFoundException if not found. */
+public Product findById(UUID id) { ... }
+
+// ULTRA
+/** Find product. Throws ProductNotFoundException if missing. */
+public Product findById(UUID id) { ... }
+```
+
+**Commit example**
+```
+# FULL
+fix(auth): fix premature token expiration on refresh
+
+# ULTRA
+fix(auth): token expires early on refresh
+```
+
+### WENYAN — optional, never default
+Classical Chinese. Only if the user explicitly requests.
+
+---
+
+## 3. Non-negotiable rules (DO NOT compress)
+
+Never compress:
+
+1. **Symbol names, files, paths, commands, URLs** — exact.
+2. **YAML frontmatter** — preserve `name`, `description`, fields.
+3. **Executable code** — no removing imports, types, annotations.
+4. **Error/log messages** — faithful copy.
+5. **Contract snippets (DTO, schema, migration)** — full semantics.
+6. **Legal/LGPD/security terms** — legal text preserved.
+7. **Project `CLAUDE.md` rules** — thresholds, paths, ADRs.
+8. **Literal translations** when the user asked.
+
+When in doubt → preserve.
+
+---
+
+## 4. Compression dictionary (English)
+
+| Before | After |
+|---|---|
+| "in order to" | "to" |
+| "with" | "w/" (informal) |
+| "without" | "w/o" (informal) |
+| "it's important that / you must / it's necessary" | direct imperative |
+| "basically / essentially / in short" | (remove) |
+| "in case of / if there is" | "if" |
+| "so as to / in order that" | "to" |
+| "by means of" | "via" / "by" |
+| "around / about / approximately" | "~" |
+| "and / also / besides" | "+" or (remove) |
+| "on the other hand / however" | "but" |
+| "therefore / thus" | "so" / "→" |
+| "instead of" | "vs" |
+| "since / because" | "because" |
+
+Ultra abbreviations: `req`, `res`, `cfg`, `env`, `db`, `pk`, `fk`, `impl`, `intf`, `pkg`, `fn`, `arg`, `ret`, `err`, `ctx`, `auth`, `val`, `max`, `min`.
+
+---
+
+## 5. Operation in the project
+
+- This skill activates **automatically** in every session of this template.
+- Default: code = ULTRA, `.md` = FULL.
+- Runtime switch:
+ - "caveman lite" → all in LITE
+ - "caveman full" → all in FULL
+ - "caveman ultra" → all in ULTRA
+ - "stop caveman" / "back to normal" → off
+- Per-file override: if user says "write this ADR formally" → LITE even if ULTRA is active.
+
+---
+
+## 6. Anti-examples (DO NOT do)
+
+1. Compress code to the point of breaking compilation.
+2. Remove class/method names.
+3. Translate established technical terms (`SecurityFilterChain`, `ProblemDetail`, `Signal`).
+4. Use caveman jargon in messages to the end user / PRD / public contract.
+5. Remove `TODO`/`FIXME` left by the user.
+6. Erase API usage examples — only compress narrative around them.
+
+---
+
+## 7. Quick checklist before answering
+
+1. Code? → ULTRA, 1-line docstring, no narrative.
+2. `.md`? → FULL (LITE if ADR/contract).
+3. Frontmatter intact?
+4. Names/paths/commands exact?
+5. Technical semantics preserved?
+6. Fluff removed (basically, it's important, essentially, it's worth noting)?
+
+All OK → reply.
+
+---
+
+## 8. Ready examples
+
+### Code review ultra
+```
+## Review order.service.ts
+
+L42 — null check missing on `order.items`. NPE risk.
+L58 — `forEach` + `await` breaks sequence. Use `for…of`.
+L77 — magic number `3600`. Extract const `TOKEN_TTL_S`.
+```
+
+```markdown
+# Bug: session expires before TTL
+
+**Symptom**: user logged out after ~5 min (TTL configured 15 min).
+**Root**: cookie `Max-Age` in seconds, code sending in min → 300s vs 900s.
+**Fix**: multiply by 60 before setting.
+**Prevention**: test `sessionCookieExpiresIn(15, MINUTES)`.
+```
+```markdown
+# 2026-04-23
+
+**Done**: endpoint `POST /api/v1/products` + Testcontainers test + `ProductForm` component.
+**Decisions**: [[decisions/ADR-012-cursor-pagination]] (cursor > offset for listings >10k).
+**Next**: integrate fulltext search (pg_trgm).
+**Blocker**: none.
+```
+## 9. Final rule
+
+Caveman serves precision + economy. Does not serve rudeness. Tone direct, not rude. User's question is answered with fact, not softening.
+
+Preserve meaning. Cut words. End.