dev-booster 1.1.4 → 1.2.0

package/README.md

@@ -31,7 +31,7 @@ After running the command, your project gets:
 ```
 .devbooster/
 ├── MANIFEST.md          ← inventory of all agents, skills, and boosters
-├── boosters/            ← 23 expert activators (debug, review, design, deploy...)
+├── boosters/            ← 24 expert activators (debug, review, design, deploy...)
 ├── hub/                 ← 40+ skills and operational scripts
 └── rules/
     ├── PROTOCOL.md      ← governance and conduct rules
@@ -88,9 +88,11 @@ Boosters are expert activators you invoke manually during development.
 | `security.md` | Security posture audit |
 | `refactor.md` | Cleaning technical debt |
 | `planning.md` | Validating readiness, risks, and gaps before implementation |
+| `global-documentation.md` | Transferable technical documentation for mature feature context |
+| `internal-documentation.md` | Internal project map with absolute paths, files, assets, scripts, and edit boundaries |
 | `discovery.md` | Product brainstorm |
 | `performance.md` | Core Web Vitals / bundle issues |
-| + 13 more | See `.devbooster/MANIFEST.md` |
+| + 12 more | See `.devbooster/MANIFEST.md` |
 
 The practical activation flow is simple:
 - drag a booster file into the chat
@@ -138,19 +140,21 @@ What this gives you:
 - clarification of business rules and gaps
 - a structured path into execution only after the context is mature
 
-### 3. Mature context to technical documentation
+### 3. Mature context to global technical documentation
 
 Use this after discovery or investigation has already produced enough context.
 
 Flow:
 1. `investigation.md` or `discovery.md`
-2. `documentation.md`
+2. `global-documentation.md`
 
 What this gives you:
 - synthesis of the current conversation context
 - confirmation before generation
 - a reusable technical document instead of fragmented chat history
 
+For repository-specific internal maps with absolute paths, use `internal-documentation.md` instead of `global-documentation.md`.
+
 ### 4. Safe review in a fresh chat
 
 Use this when you want a stronger validation pass with minimal prior bias.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-booster",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "Reusable AI development kit with manual boosters, governance, and project bootstrap",
   "type": "module",
   "scripts": {

package/template/.devbooster/MANIFEST.md

@@ -105,7 +105,8 @@
 | `accessibility.md` | Accessibility Auditor — ensures WCAG compliance and semantic HTML. |
 | `refactor.md` | Quality Lead — refactors code, applies Clean Code/SOLID, and clears technical debt. |
 | `implementation.md` | Reviews context, selects `simple` / `standard` / `heavy`, and asks for confirmation before generating the plan. |
-| `documentation.md` | Generates the 17-section universal technical documentation spec. |
+| `global-documentation.md` | Generates the 17-section universal technical documentation spec. |
+| `internal-documentation.md` | Generates repository-specific internal documentation with absolute paths and file/asset maps. |
 | `atomic.md` | Surgical, single-step implementation spec (final execution stage). |
 | `advisor.md` | Hub Consultant — recommends the best booster path for the user's task. |
 | `review.md` | Elite Auditor — multi-agent orchestration for plan validation. |
@@ -164,7 +165,7 @@
 |---|---|
 | **Total Agents** | 20 |
 | **Total Skills** | 40+ |
-| **Master Boosters** | 23 |
+| **Master Boosters** | 24 |
 | **Operational Scripts** | 2 (Master) + 21 (Skill-level) |
 | **Coverage** | ~95% Full-stack Web/Mobile |
 

package/template/.devbooster/boosters/{documentation.md → global-documentation.md}

@@ -1,4 +1,4 @@
-# 🌐 BOOSTER: DOCUMENTATION (UNIVERSAL)
+# 🌐 BOOSTER: GLOBAL DOCUMENTATION (UNIVERSAL)
 You are being activated to create universal, transferable technical documentation. 
 
 ## 0. DEV BOOSTER ACTIVATION CONTRACT
@@ -15,9 +15,9 @@ If the user invokes this booster alone, or uses it only to activate the mode:
 Use this activation response format:
 
 ```md
-## 🤖 [DEV BOOSTER // DOCUMENTATION]
+## 🤖 [DEV BOOSTER // GLOBAL DOCUMENTATION]
 
-[Localized mode label]: Documentation
+[Localized mode label]: Global Documentation
 [Localized status label]: Context Reviewed
 
 [Localized context summary label]:

package/template/.devbooster/boosters/internal-documentation.md

@@ -0,0 +1,144 @@
+# 🧭 BOOSTER: INTERNAL DOCUMENTATION (PROJECT MAP)
+You are being activated to create internal, repository-specific project documentation with absolute paths, asset locations, operational files, and navigation guidance.
+
+## 0. DEV BOOSTER ACTIVATION CONTRACT
+This booster behaves as an internal documentation synthesis mode, not as an automatic execution order.
+
+If the user invokes this booster alone, or uses it only to activate the mode:
+- Do NOT generate the documentation immediately.
+- Do NOT scan the repository immediately.
+- Do NOT load the full context package yet.
+- Use the current conversation context as the source of truth.
+- Summarize what has already been established in the conversation.
+- Identify whether the current context appears sufficient to create the internal map.
+- Ask for confirmation before generating the documentation.
+- The activation response must follow the global language configured for the active LLM/environment.
+
+Use this activation response format:
+
+```md
+## 🤖 [DEV BOOSTER // INTERNAL DOCUMENTATION]
+
+[Localized mode label]: Internal Documentation
+[Localized status label]: Context Reviewed
+
+[Localized context summary label]:
+- [Localized summary line]
+- [Localized summary line]
+- [Localized summary line]
+
+[Localized perceived scope label]:
+- [Localized scope line]
+
+[Localized gap label]:
+- [Localized missing or uncertain line]
+- [Localized missing or uncertain line]
+
+[Localized confirmation prompt]
+```
+
+Formatting rules for this activation:
+- `Mode` and `Status` must always be rendered on separate lines.
+- Do NOT merge labels into a single sentence or paragraph.
+- Keep each activation block on its own line.
+- The full activation response must be written in the global language configured for the active LLM/environment.
+
+If the conversation context is not mature enough:
+- Do NOT fabricate an internal map.
+- Say that the current context is still insufficient for reliable internal documentation.
+- Ask for the missing target, repository context, or permission to scan after confirmation.
+
+Only generate the documentation after the user confirms to proceed.
+
+## 1. ALLOWED INVENTORY
+After the user confirms, load only what is necessary from this inventory:
+- `.devbooster/hub/personas/agent_documentation-writer.md`
+- `.devbooster/hub/personas/agent_code-archaeologist.md`
+- `.devbooster/hub/personas/agent_project-planner.md`
+- `.devbooster/hub/personas/agent_explorer-agent.md`
+- `.devbooster/hub/personas/documentation-writer.md`
+- `.devbooster/hub/personas/code-archaeologist.md`
+- `.devbooster/hub/personas/project-planner.md`
+- `.devbooster/hub/personas/explorer-agent.md`
+- `.devbooster/hub/personas/skill_doc.md`
+- `.devbooster/hub/personas/skill_architecture.md`
+
+## 2. PRE-FLIGHT
+- Analyze the target repository before outputting the final document.
+- Treat the current conversation context as the primary input.
+- Use observable repository state as the secondary input after confirmation.
+- Prefer repository-native paths and files over assumptions.
+- Resolve absolute paths from the actual project root.
+- Document only what is supported by the current code, file tree, configuration, or conversation context.
+
+## 3. INTERNAL SPECIFICATION TEMPLATE
+Your task is to generate a single Markdown documentation file following this EXACT structure:
+
+========================
+1. OBJECTIVE
+========================
+Create internal project documentation that explains:
+- where the project lives on disk
+- where important source files, rules, assets, scripts, and generated artifacts live
+- which paths are absolute and which paths are repository-relative
+- which files are safe to edit, generated, preserved, or replaced by update flows
+- how an AI assistant should navigate the repository without guessing
+- which gaps could not be detected automatically
+
+========================
+2. OUTPUT FILE
+========================
+- Create file at: `docs/internal-project-documentation.md` (ROOT)
+- If the repository already has a stronger naming convention for internal docs, follow it only when it is obvious and already established.
+- Do not overwrite unrelated documentation unless the user explicitly asks.
+
+========================
+3. REQUIRED DOCUMENT STRUCTURE
+========================
+Use these 17 sections in this exact order:
+
+# 1. Project Identity
+# 2. Absolute Root Paths
+# 3. Repository-Relative Path Map
+# 4. Source Code Locations
+# 5. Asset and Static File Locations
+# 6. Configuration Files
+# 7. Documentation Files
+# 8. Dev Booster Kit Locations
+# 9. Runtime Rules and Bootstrap Files
+# 10. Scripts and Operational Commands
+# 11. Generated, Preserved, and Replaceable Files
+# 12. Update and Installation Behavior
+# 13. AI Navigation Instructions
+# 14. Editing Boundaries and Safety Rules
+# 15. Known Gaps and Undetected Areas
+# 16. Validation Checklist
+# 17. Mini Context Summary
+
+========================
+4. WRITING RULES
+========================
+- Use machine oriented language. Be deterministic and technical.
+- Use absolute paths for the main path inventory.
+- Include repository-relative paths alongside absolute paths when useful.
+- Do not invent files, folders, commands, assets, or deployment targets.
+- If a folder is absent, state that it was not detected.
+- If a path depends on the user's machine, resolve it from the current project root.
+- Keep the document useful for future AI sessions and future maintainers.
+- Prefer tables for path inventories when they improve scanability.
+
+========================
+5. EXECUTION RULES
+========================
+- First activation pass: summarize context and ask for confirmation.
+- After user confirmation: scan the repository, load only necessary inventory, and generate the full documentation.
+- If context is ambiguous, state the ambiguity before writing.
+- Do NOT invent architecture, assets, or operational rules that were not established.
+- Do NOT use this booster for public README, API docs, changelog, or transferable feature documentation. Use `global-documentation.md` for transferable feature documentation.
+
+## 4. FINAL OUTCOME
+The result of this booster should be:
+- A repository-specific internal documentation file.
+- A concise completion report in chat with the output path and any unresolved gaps.
+
+**Reply:** On activation only, review the current conversation context, summarize it, identify scope and gaps, and ask if you may proceed with internal documentation. After explicit confirmation, scan the repository and generate the documentation in the global language configured for the active LLM/environment.

package/template/.devbooster/rules/GUIDE.md

@@ -21,8 +21,12 @@ Ele foi formatado como bloco de código para facilitar a leitura direta na IDE.
 • implementation.md -> Mestre de Implementação. Faz a triagem da complexidade (P, M, G) 
                        e escolhe o template correto antes de gerar o plano após confirmação.
                        
-• documentation.md  -> Documentação Técnica. Gera um documento estruturado de 17 seções a partir do contexto consolidado
-                       para prever todos os requisitos técnicos rigorosos.
+• global-documentation.md
+                    -> Documentação Global. Gera um documento técnico transferível de 17 seções a partir do contexto consolidado
+                       para prever todos os requisitos técnicos rigorosos e reutilizáveis.
+• internal-documentation.md
+                    -> Documentação Interna. Gera um mapa interno do projeto com caminhos absolutos,
+                       arquivos, assets, scripts, regras runtime e limites de edição.
 • atomic.md         -> Execução Atômica. Protocolo para execução passo a passo, 
                        focada em uma única alteração cirúrgica por vez.
 • review.md         -> Auditoria Elite. Ativa orquestração mult-agente para validar 
@@ -100,7 +104,8 @@ Padrões de comportamento:
 
 Exemplos práticos:
 - Arraste `.devbooster/boosters/planning.md` no chat e envie.
-- Arraste `.devbooster/boosters/documentation.md` no chat e envie.
+- Arraste `.devbooster/boosters/global-documentation.md` no chat e envie.
+- Arraste `.devbooster/boosters/internal-documentation.md` no chat e envie.
 - Arraste `.devbooster/boosters/changelog.md` no chat e envie.
 - Arraste `.devbooster/boosters/review.md` no chat e envie.