bigpowers 2.87.1 → 2.87.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/.pi/package.json +1 -1
  2. package/ANALISE_CONSOLIDACAO.md +192 -0
  3. package/CHANGELOG.md +8 -0
  4. package/GSD_WORKFLOW_ANALYSIS_VS_BIGPOWERS.md +1015 -0
  5. package/VALIDACAO_CONTRA_GSD.md +321 -0
  6. package/package.json +1 -1
  7. package/scripts/lib/__pycache__/link_utils.cpython-312.pyc +0 -0
  8. package/scripts/lib/__pycache__/srp_engine_links.cpython-312.pyc +0 -0
  9. package/scripts/lib/git-hours.sh +1 -1
  10. package/scripts/record-cycle-time.sh +3 -1
  11. package/scripts/validate-agentic-ste.sh +22 -1
package/.pi/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bigpowers",
3
- "version": "2.87.1",
3
+ "version": "2.87.2",
4
4
  "description": "81 skills — 73 agent skills synthesizing 17 years of software engineering discipline into a prescriptive methodology for solo developers",
5
5
  "keywords": [
6
6
  "pi-package"
package/ANALISE_CONSOLIDACAO.md ADDED
@@ -0,0 +1,192 @@
1
+ # Análise de Consolidação: GSD → Nomes Simples + Ciclo BMAD
2
+
3
+ **Data:** 2026-05-18
4
+ **Status:** Proposta de ação para eliminar redundância entre STATE.md, RELEASE-PLAN.md, PLAN.md e README.md
5
+
6
+ ---
7
+
8
+ ## 1. Diagnóstico: Redundância Atual
9
+
10
+ ### 1.1 O Problema
11
+
12
+ Você tem **4 artefatos que se sobrepõem**:
13
+
14
+ | Artefato | Propósito Declarado | Realidade | Problema |
15
+ |---|---|---|---|
16
+ | `README.md` | Documentação pública (install, skill index) | Lista 36 skills em tabela de fase | Fase da skill é *descrição* visual, não *governança* |
17
+ | `PLAN.md` (raiz) | Plano de implementação (27 KB) | Cópia literal do que foi aprovado; nunca atualizado pós-v1.0 | Stale; duplica RELEASE-PLAN.md |
18
+ | `specs/RELEASE-PLAN.md` | Roadmap vivo (v1.11 → v1.21) | Sequência com WSJF, status, detalhes de cada release | Fonte viva de verdade ✓ |
19
+ | `specs/STATE.md` | Estado da sessão + audit score | Milestone atual, hash git, status de releases completadas | Resumido; não governa o dia-a-dia |
20
+ | `specs/PLAN-v1.*.md` (×16 arquivos) | Plano por release (por ex: v1.14.0) | Detalhe tático: tarefas, checkboxes, learnings | Útil per-release, mas nunca consolidado |
21
+
22
+ **Resultado:** Um desenvolvedor olha 3 lugares diferentes e não sabe qual é a verdade.
23
+
24
+ ---
25
+
26
+ ### 1.2 Redundâncias Específicas
27
+
28
+ #### 1. README.md vs. RELEASE-PLAN.md
29
+
30
+ - **README.md linha 19-59:** Lista todas as 36 skills com fase
31
+ - **RELEASE-PLAN.md linhas 11-25:** Mesmo índice, mas com WSJF e status
32
+ - **Quem ganha?** RELEASE-PLAN.md tem mais contexto (WSJF, status, pré-requisitos)
33
+
34
+ #### 2. PLAN.md vs. RELEASE-PLAN.md
35
+
36
+ - **PLAN.md é literalmente o documento anterior** — uma "cópia de aprovação"
37
+ - **RELEASE-PLAN.md é o mesmo documento, mas agora atualizado com v1.14–v1.21**
38
+ - **Solução:** Delete PLAN.md. RELEASE-PLAN.md é o canônico.
39
+
40
+ #### 3. README.md vs. PLAN.md (estrutura)
41
+
42
+ - Ambos definem "Naming Convention" e "Workflow Arc"
43
+ - README tem diagramas ASCII; PLAN tem tabelas detalhadas
44
+ - **Solução:** README fica minimalista (instalar, quickstart). Detalhe vai para CONVENTIONS.md ou docs/ separados.
45
+
46
+ #### 4. Múltiplos PLAN-v*.md vs. RELEASE-PLAN.md
47
+
48
+ - 16 arquivos históricos (v1.2.0 → v1.16.0) nunca consolidas
49
+ - Serve para auditoria? Sim. Serve para planejamento? Não — é tudo passado.
50
+ - **Solução:** Arquivar em `specs/archive/` e manter histórico, mas não no caminho crítico.
51
+
52
+ ---
53
+
54
+ ## 2. O que GSD Faz Bem (O que Manter)
55
+
56
+ ### 2.1 Nomes de Skills — Simples & Compreensíveis
57
+
58
+ Seus skill names **são excelentes** — verb-noun pairs, buscáveis, sem ruído:
59
+
60
+ ✅ `develop-tdd` (entendível)
61
+ ✅ `validate-fix` (ação clara)
62
+ ✅ `challenge-design` (inteligível)
63
+ ✅ `define-success` (didático)
64
+
65
+ ### 2.2 O Ciclo BMAD — Estrutura Clara
66
+
67
+ BMAD divide o ciclo em **fases bem definidas**:
68
+
69
+ ```
70
+ Discover (investigar)
71
+ → Elaborate (refinar)
72
+ → Plan (planejar)
73
+ → Build (construir, escrever código)
74
+ → Sustain (manter, revisar, liberar)
75
+ ```
76
+
77
+ ---
78
+
79
+ ## 3. Solução Proposta: Consolidação com Clareza de Fases
80
+
81
+ ### 3.1 Hierarquia de Artefatos (Nova Verdade Única)
82
+
83
+ ```
84
+ Nível Artefato Responsabilidade
85
+ ──────────────────────────────────────────────────────
86
+ Executivo STATE.md Milestone + status de releases
87
+ (sessão atual)
88
+
89
+ Tático RELEASE-PLAN.md Roadmap v1.17–v1.21 + histórico
90
+ (próximas 5
91
+ releases)
92
+
93
+ Operacional PLAN-v*.md Tarefas por release (archive pós-completion)
94
+ (per-release)
95
+
96
+ Referência README.md Instalar, ciclo BMAD, link a SKILL-INDEX
97
+ (documentação)
98
+
99
+ Consolidado SKILL-INDEX.md ← NOVO: tabela canônica de 38 skills
100
+ (skill catalog)
101
+
102
+ Convênios CONVENTIONS.md Código, testes, git, specs/
103
+ (toda sessão)
104
+ ```
105
+
106
+ ### 3.2 O que Deletar
107
+
108
+ | Arquivo | Ação | Razão |
109
+ |---|---|---|
110
+ | `PLAN.md` (raiz) | **Deletar** | Congelado em v1.0. RELEASE-PLAN.md é o vivo. |
111
+ | `specs/PLAN-v*.md` (×16) | **Arquivar** → `specs/archive/releases/` | Histórico; não crítico para o forward. |
112
+ | Skill index em 3 lugares | **Consolidar** → `SKILL-INDEX.md` | Uma tabela, referenciada em 3 docs. |
113
+
114
+ ### 3.3 O que Fica
115
+
116
+ ```
117
+ specs/
118
+ ├── STATE.md ← "Milestone v1.17, branch main, hash ba7d054"
119
+ ├── RELEASE-PLAN.md ← "Próximas 5 releases com WSJF, pré-requisitos"
120
+ ├── archive/releases/ ← Histórico de PLAN-v1.*.md
121
+ ├── CONTEXT.md, UBIQUITOUS_LANGUAGE.md, SCOPE.md, TASKS.md, PLAN.md
122
+ └── adr/, SPIKE-*, DIAGNOSIS.md, BUG-LOG.md
123
+
124
+ SKILL-INDEX.md ← NOVO: 38 skills × fase × status × fonte
125
+ README.md ← Referencia SKILL-INDEX.md (não copia)
126
+ CONVENTIONS.md ← Convênios, referencia SKILL-INDEX.md
127
+ ```
128
+
129
+ ---
130
+
131
+ ## 4. Consolidação de Skills (BMAD Phases)
132
+
133
+ ### Mapeamento de Nomes Simples → Fases BMAD
134
+
135
+ | Fase BMAD | Skills | Descrição | Status |
136
+ |---|---|---|---|
137
+ | **Discover** | survey-context, elaborate-spec | Questionamento & refino inicial | ✅ Claro |
138
+ | **Elaborate** | model-domain, define-language, challenge-design, grill-with-docs, deepen-architecture | Design & arquitetura | ✅ Claro |
139
+ | **Plan** | scope-work, slice-tasks, define-success, plan-work, plan-refactor | Planejamento detalhado | ✅ Claro |
140
+ | **Spike** | spike-prototype | Prototipagem exploratória | ✅ Claro |
141
+ | **Build** | kickoff-branch, guard-git, hook-commits, develop-tdd, delegate-task, dispatch-agents, execute-plan, wire-observability | Implementação + testes + observabilidade | ✅ Claro |
142
+ | **Bug** | investigate-bug, diagnose-root, validate-fix | Debugging & fix | ✅ Claro |
143
+ | **Review** | audit-code, request-review, respond-review | Revisão de qualidade | ✅ Claro |
144
+ | **Integrate** | commit-message, release-branch | Integração & release | ✅ Claro |
145
+ | **Sustain** | inspect-quality, organize-workspace | Manutenção & limpeza | ✅ Claro |
146
+ | **Utility** | terse-mode, craft-skill, edit-document | Transversais (qualquer fase) | ✅ Claro |
147
+ | **Bootstrap** | using-bigpowers, seed-conventions | One-time setup | ✅ Claro |
148
+
149
+ ---
150
+
151
+ ## 5. Plano de Ação (Ordem de Execução)
152
+
153
+ ### Fase 1: Preparação (30 min)
154
+ - [ ] ✅ Criar `SKILL-INDEX.md` (tabela canônica) — **DONE**
155
+ - [ ] Verificar que todos os 37-38 skills estão listados
156
+ - [ ] Revisar linhas 1 e 11-25 de README.md (índice antigo)
157
+
158
+ ### Fase 2: Consolidação (1h)
159
+ - [ ] Deletar `PLAN.md` (raiz)
160
+ - [ ] Criar `specs/archive/releases/` e mover `PLAN-v*.md` pra lá
161
+ - [ ] Atualizar README.md: referenciar SKILL-INDEX.md ao invés de copiar tabela
162
+
163
+ ### Fase 3: Revisão de Referências (30 min)
164
+ - [ ] Confirmar RELEASE-PLAN.md está correto e completo
165
+ - [ ] Confirmar STATE.md é apenas "estou aqui, próximo é isso"
166
+ - [ ] Encontrar todo `grill-me` em documentação, corrigir para `challenge-design`
167
+
168
+ ### Fase 4: Documentação (30 min)
169
+ - [ ] Adicionar comentário no topo de README, STATE, RELEASE-PLAN explicando hierarquia
170
+ - [ ] Seção "Single Source of Truth" em CONVENTIONS.md
171
+
172
+ ---
173
+
174
+ ## 6. Resumo de Benefícios
175
+
176
+ | Antes | Depois |
177
+ |---|---|
178
+ | Skill index em 3 lugares (README, RELEASE-PLAN, PLAN) | Skill index em 1 lugar; referenciado em 3 |
179
+ | PLAN.md stale coexiste com RELEASE-PLAN.md vivo | 1 canônico, histórico arquivado |
180
+ | 16 PLAN-v*.md dispersos em specs/ | Histórico limpo em archive/ |
181
+ | Hierarquia de artefatos implícita | Explícita: STATE → RELEASE-PLAN → SKILL-INDEX |
182
+ | Fases BMAD descritas em prosa em múltiplos lugares | Diagrama visual único em README + SKILL-INDEX |
183
+ | README 450 linhas; PLAN.md 450 linhas; redundância óbvia | README < 200 linhas; referencia SKILL-INDEX (11 KB) |
184
+
185
+ ---
186
+
187
+ ## 7. Próximos Passos Recomendados
188
+
189
+ 1. **Revisar ambos os arquivos** (este + SKILL-INDEX.md)
190
+ 2. **Executar Fase 1–4** acima
191
+ 3. **Git commit:** `feat(docs): consolidate skill index + BMAD lifecycle`
192
+ 4. **Validar:** rodar testes, compliance check, etc.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,11 @@
1
+ ## [2.87.2](https://github.com/danielvm-git/bigpowers/compare/v2.87.1...v2.87.2) (2026-08-05)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **scripts:** AGENTIC-STE word count must not glob markdown bold (**) ([4da5750](https://github.com/danielvm-git/bigpowers/commit/4da575016771fe534931e05680b6444a6127a52e))
7
+ * **scripts:** cycle-time toolchain — BSD awk FS + unbound agent token vars ([4819089](https://github.com/danielvm-git/bigpowers/commit/4819089956aae1b1239b74cfdce83be4fbedd111))
8
+
1
9
  ## [2.87.1](https://github.com/danielvm-git/bigpowers/compare/v2.87.0...v2.87.1) (2026-07-30)
2
10
 
3
11