@the-bearded-bear/claude-craft 8.23.3 → 8.26.0-next.2a54921

package/Project/i18n/pt/commands/scan.md

@@ -1,271 +1,9 @@
 ---
-name: scan
-description: Analyze existing codebase and generate a structured inventory of modules, endpoints, models, and tests
-arguments:
-  - name: scope
-    description: Scope to scan (all, backend, frontend, api, tests)
-    required: false
-  - name: output
-    description: Output path (default project-management/scan-report.md)
-    required: false
+description: "Obsoleto (removido na 9.0): use /project:reverse scan"
+deprecated: true
+replaced-by: /project:reverse
 ---
 
-# /project:scan
+> ⚠️ `/project:scan` está obsoleto e será removido na 9.0. Use `/project:reverse scan`.
 
-## Mission
-
-Analyze an existing codebase to generate a comprehensive, structured inventory of all modules, endpoints, models, services, and tests. This command is the entry point for brownfield projects that need reverse-engineered specifications.
-
-## Prerequisites
-
-- Project directory exists with source code
-- Codebase is accessible (not encrypted or obfuscated)
-- Optional: `README.md` with project description
-- Optional: `docker-compose.yml` for infrastructure context
-
-## Modo Plano
-
-> **O modo plano é obrigatório.** Antes de executar, Claude ativa o modo plano para analisar o código impactado, propor um plano de implementação e aguardar sua validação antes de realizar qualquer alteração.
-
-## Workflow
-
-### Step 1: Stack Detection
-
-```
-+--------------------------------------------------------------+
-|                 CODEBASE SCAN - DETECTION                     |
-+--------------------------------------------------------------+
-| Detecting technology stack...                                  |
-+--------------------------------------------------------------+
-```
-
-**Automatic Detection Rules:**
-
-| File Pattern | Detected Stack |
-|-------------|----------------|
-| `*.php` + `symfony.lock` | Symfony |
-| `*.php` + `artisan` | Laravel |
-| `*.php` + `composer.json` | PHP (generic) |
-| `*.dart` + `pubspec.yaml` | Flutter |
-| `*.tsx` / `*.jsx` + `next.config.*` | React (Next.js) |
-| `*.tsx` / `*.jsx` + `package.json` | React |
-| `*.vue` + `package.json` | Vue.js |
-| `angular.json` | Angular |
-| `*.cs` + `*.csproj` | .NET / C# |
-| `*.py` + `pyproject.toml` | Python |
-| `Dockerfile` / `docker-compose.yml` | Docker (infra) |
-
-**Actions:**
-1. Scan root directory for framework markers
-2. Read `composer.json`, `package.json`, `pubspec.yaml`, `*.csproj`, or `pyproject.toml`
-3. Identify framework version and key dependencies
-4. Detect infrastructure (Docker, CI/CD, Redis, queues)
-5. Assign the appropriate tech-specific reviewer agent
-
-### Step 2: Structure Scan
-
-```
-+--------------------------------------------------------------+
-|                 CODEBASE SCAN - STRUCTURE                      |
-+--------------------------------------------------------------+
-| Scanning project structure...                                  |
-+--------------------------------------------------------------+
-```
-
-**Categorize all files into:**
-
-1. **Modules / Domains**: Group files by bounded context or feature
-   - Detect domain boundaries from directory structure
-   - Identify shared/common modules
-   - Map namespace structure
-
-2. **Endpoints**: List all API routes and controllers
-   - Parse route definitions (annotations, attributes, config files)
-   - Extract HTTP methods, paths, and handler references
-   - Identify middleware/guards applied
-
-3. **Models / Entities**: List all data models
-   - Parse entity/model classes
-   - Extract field names, types, and relationships
-   - Identify database migrations
-
-4. **Services**: List all services, use cases, and handlers
-   - Identify service classes and their dependencies
-   - Map command/query handlers (CQRS patterns)
-   - Detect event listeners and subscribers
-
-5. **Tests**: List test files and coverage scope
-   - Identify unit, integration, and E2E tests
-   - Map test files to source files
-   - Detect test frameworks in use
-
-6. **Infrastructure**: Configuration and deployment
-   - Docker configuration
-   - CI/CD pipelines
-   - Environment configuration
-   - Third-party service integrations
-
-### Step 3: Code Analysis
-
-```
-+--------------------------------------------------------------+
-|                 CODEBASE SCAN - ANALYSIS                       |
-+--------------------------------------------------------------+
-| Analyzing code patterns and complexity...                      |
-+--------------------------------------------------------------+
-```
-
-**Analysis Tasks:**
-1. Estimate lines of code (LOC) per module
-2. Identify architectural patterns in use (MVC, Clean Architecture, DDD, etc.)
-3. Detect code quality indicators (linting config, static analysis)
-4. Map dependency graph between modules
-5. Identify potential technical debt markers
-6. Use tech-specific reviewer (e.g., `@symfony-reviewer`, `@react-reviewer`) for stack-specific insights
-
-### Step 4: Report Generation
-
-Generate a structured Markdown report at the configured output path.
-
-### Step 5: Next Steps
-
-```
-+--------------------------------------------------------------+
-|                      NEXT STEPS                                |
-+--------------------------------------------------------------+
-| Scan complete! Recommended next actions:                       |
-|                                                                |
-| 1. /project:reverse-prd        -> Generate PRD from code      |
-| 2. /project:reverse-stories    -> Generate user stories        |
-| 3. /project:gap-analysis       -> Compare spec vs code         |
-+--------------------------------------------------------------+
-```
-
-## Output Format
-
-```
-project-management/
-+-- scan-report.md              # Full scan report
-```
-
-**Report Structure:**
-
-```
-+==============================================================+
-|                  CODEBASE SCAN REPORT                          |
-+==============================================================+
-| Project: {name}                                                |
-| Stack: Symfony 7.x / PHP 8.4                                   |
-| Size: ~15,000 LOC                                              |
-| Modules: 5 bounded contexts                                    |
-+==============================================================+
-
-## Technology Stack
-| Component       | Technology    | Version |
-|-----------------|---------------|---------|
-| Framework       | Symfony       | 7.2     |
-| Language        | PHP           | 8.4     |
-| Database        | PostgreSQL    | 16      |
-| Cache           | Redis         | 7.x     |
-| Containerization| Docker        | Yes     |
-
-## Modules / Bounded Contexts
-| Module          | Files | LOC   | Tests | Coverage |
-|-----------------|-------|-------|-------|----------|
-| User            | 24    | 1,800 | 12    | ~65%     |
-| Order           | 31    | 2,400 | 18    | ~72%     |
-| Payment         | 18    | 1,200 | 8     | ~55%     |
-| Notification    | 12    | 800   | 5     | ~40%     |
-| Shared/Common   | 15    | 600   | 3     | ~30%     |
-
-## Endpoints (API)
-| Method | Path                  | Controller         | Auth |
-|--------|-----------------------|--------------------|------|
-| GET    | /api/users            | UserController     | JWT  |
-| POST   | /api/users            | UserController     | JWT  |
-| GET    | /api/orders           | OrderController    | JWT  |
-| POST   | /api/orders           | OrderController    | JWT  |
-| ...    | ...                   | ...                | ...  |
-
-## Models / Entities
-| Entity      | Fields | Relationships       | Migrations |
-|-------------|--------|---------------------|------------|
-| User        | 12     | hasMany: Order      | 3          |
-| Order       | 15     | belongsTo: User     | 5          |
-| Product     | 10     | manyToMany: Order   | 2          |
-| ...         | ...    | ...                 | ...        |
-
-## Services
-| Service              | Dependencies | Type       |
-|----------------------|-------------|------------|
-| CreateOrderHandler   | 3           | Command    |
-| GetUserQuery         | 2           | Query      |
-| PaymentGateway       | 4           | Service    |
-| ...                  | ...         | ...        |
-
-## Tests
-| Type        | Count | Framework   |
-|-------------|-------|-------------|
-| Unit        | 42    | PHPUnit     |
-| Integration | 15    | PHPUnit     |
-| E2E         | 3     | Cypress     |
-| Total       | 60    |             |
-
-## Infrastructure
-| Component   | Config File        | Notes              |
-|-------------|--------------------|--------------------|
-| Docker      | docker-compose.yml | 4 services         |
-| CI/CD       | .github/workflows  | 2 pipelines        |
-| Env         | .env.example       | 15 variables       |
-
-## Complexity Summary
-| Metric                    | Value          |
-|---------------------------|----------------|
-| Total LOC                 | ~15,000        |
-| Total files               | 142            |
-| Bounded contexts          | 5              |
-| API endpoints             | 23             |
-| Database entities         | 8              |
-| Test files                | 60             |
-| Estimated test coverage   | ~55%           |
-| Architecture pattern      | Clean Arch     |
-```
-
-## Example Session
-
-```
-User: /project:scan
-
-Claude: Starting codebase scan...
-
-[Stack Detection]
-Detected: Symfony 7.2 / PHP 8.4
-Key dependencies: doctrine/orm, api-platform/core, lexik/jwt-auth
-
-[Structure Scan]
-Scanning directories...
-Found 5 bounded contexts: User, Order, Payment, Notification, Shared
-Found 23 API endpoints across 6 controllers
-Found 8 Doctrine entities with 12 migrations
-Found 60 test files (42 unit, 15 integration, 3 E2E)
-
-[Code Analysis]
-Architecture: Clean Architecture (Domain/Application/Infrastructure layers)
-Estimated LOC: ~15,000
-Code quality: PHPStan level 8, PHP-CS-Fixer configured
-
-Scan report generated: project-management/scan-report.md
-
-Would you like me to:
-1. Run /project:reverse-prd to generate a PRD from this scan?
-2. Run /project:reverse-stories to generate user stories?
-3. Focus the scan on a specific module?
-```
-
-## Related Commands
-
-- `/project:reverse-prd` - Generate a PRD from existing codebase
-- `/project:reverse-stories` - Generate user stories from codebase features
-- `/project:gap-analysis` - Compare specifications with actual codebase
-- `/project:generate-prd` - Generate a PRD interactively (greenfield)
-- `/project:generate-backlog` - Create SCRUM backlog from PRD
+Execute `/project:reverse scan $ARGUMENTS`: leia `.claude/commands/project/reverse.md` e siga-o com estes argumentos.

package/Project/i18n/pt/commands/sync-backlog.md

@@ -1,165 +1,9 @@
 ---
-description: "Sincronizar os arquivos do backlog com sprint-status.yaml"
-argument-hint: "[--direction source] [--dry-run]"
+description: "Obsoleto (removido na 9.0): use /project:migrate --resync"
+deprecated: true
+replaced-by: /project:migrate
 ---
 
-# Sync Backlog
+> ⚠️ `/project:sync-backlog` está obsoleto e será removido na 9.0. Use `/project:migrate --resync`.
 
-Sincronizacao bidirecional entre os arquivos markdown do backlog e sprint-status.yaml.
-
-## Argumentos
-
-$ARGUMENTS (formato: [--direction source] [--dry-run])
-- **--direction** (opcional): Direcao da sincronizacao
-  - `files-to-yaml`: Atualizar sprint-status.yaml a partir dos arquivos markdown
-  - `yaml-to-files`: Atualizar os arquivos markdown a partir de sprint-status.yaml
-  - `bidirectional`: Mesclar os dois (padrao, o mais recente prevalece)
-- **--dry-run** (opcional): Pre-visualizar as mudancas sem aplica-las
-
-## Processo
-
-### Etapa 1: Carregar as duas fontes
-
-1. Analisar `.bmad/sprint-status.yaml`
-2. Analisar todos os arquivos de story do diretorio de backlog
-3. Construir o mapa de comparacao por story ID
-
-### Etapa 2: Detectar os conflitos
-
-Para cada story, comparar:
-- Status
-- Contagem de tarefas concluidas
-- Validacao dos criterios de aceitacao
-- Fase TDD
-- Atribuicao
-
-Deteccao de conflitos:
-```yaml
-conflicts:
-  US-001:
-    field: status
-    yaml_value: "in-progress"
-    file_value: "🟢 Done"
-    yaml_timestamp: "2026-01-29T09:00:00Z"
-    file_timestamp: "2026-01-29T10:00:00Z"
-    resolution: "file"  # o mais recente prevalece
-```
-
-### Etapa 3: Resolver os conflitos
-
-Estrategias de resolucao:
-1. **newest-wins** (padrao): Usar o valor modificado mais recentemente
-2. **yaml-wins**: Sempre preferir sprint-status.yaml
-3. **files-win**: Sempre preferir os arquivos markdown
-4. **prompt**: Perguntar ao usuario para cada conflito
-
-### Etapa 4: Sync arquivos → YAML
-
-Atualizar sprint-status.yaml com:
-- Novas stories encontradas nos arquivos
-- Mudancas de status dos arquivos
-- Atualizacoes de tarefas dos arquivos
-- Validacao de AC dos arquivos
-
-### Etapa 5: Sync YAML → arquivos
-
-Atualizar os arquivos markdown com:
-- Fase TDD (adicionar ao comentario de metadados)
-- Historico (adicionar ao comentario de metadados)
-- Pontuacao INVEST (adicionar ao comentario de metadados)
-- Timestamp de sincronizacao
-
-### Etapa 6: Tratar os orfaos
-
-- **Stories no YAML mas nao nos arquivos**: Marcar como `archived` ou alertar
-- **Stories nos arquivos mas nao no YAML**: Adicionar a sprint-status.yaml
-
-### Etapa 7: Atualizar os timestamps
-
-Adicionar o timestamp de ultima sincronizacao em ambos:
-- `.bmad/sprint-status.yaml`: `last_sync: "2026-01-29T10:00:00Z"`
-- Arquivos de story: `<!-- last_sync: 2026-01-29T10:00:00Z -->`
-
-## Formato de Saida
-
-```
-🔄 Sincronizacao do Backlog
-==============================
-
-## Direcao: Bidirecional
-
-## Mudancas Detectadas
-
-### Arquivos → YAML (4 mudancas)
-| Story | Campo | Antigo | Novo |
-|-------|-------|--------|------|
-| US-001 | status | in-progress | done |
-| US-002 | tasks.completed | 2 | 3 |
-
-### YAML → Arquivos (2 mudancas)
-| Story | Campo | Antigo | Novo |
-|-------|-------|--------|------|
-| US-003 | tdd_phase | - | green |
-| US-004 | invest_score | - | 5/6 |
-
-## Conflitos Resolvidos
-
-| Story | Campo | Resolucao | Valor |
-|-------|-------|-----------|-------|
-| US-005 | status | newest-wins | done |
-
-## Orfaos
-
-### Apenas no YAML (arquivados):
-- US-010: "Funcionalidade antiga" (arquivado em 2026-01-15)
-
-### Apenas nos arquivos (adicionados ao YAML):
-- US-015: "Nova funcionalidade"
-
-## Sincronizacao Concluida
-
-✅ sprint-status.yaml atualizado
-✅ 12 arquivos de story atualizados
-⏰ Ultima sincronizacao: 2026-01-29T10:00:00Z
-
-## Proximas Etapas
-- Verificar as mudancas com git diff
-- Executar `/sprint:status` para verificar
-```
-
-## Saida Dry Run
-
-```
-🔄 Sincronizacao do Backlog (DRY RUN)
-========================================
-
-⚠️ Nenhuma modificacao sera realizada
-
-## Mudaria:
-
-### sprint-status.yaml
-- US-001.status: "in-progress" → "done"
-- US-002.tasks.completed: 2 → 3
-
-### Arquivos de Story
-- US-003: Adicionar metadado tdd_phase
-- US-004: Adicionar metadado invest_score
-
-Executar sem --dry-run para aplicar as mudancas.
-```
-
-## Exemplo
-
-```
-/project:sync-backlog
-/project:sync-backlog --direction files-to-yaml
-/project:sync-backlog --direction yaml-to-files --dry-run
-```
-
-## Automacao
-
-Adicionar ao hook pre-commit para sincronizacao automatica:
-```bash
-# .bmad/hooks/pre-commit.sh
-/project:sync-backlog --direction files-to-yaml
-```
+Execute `/project:migrate --resync $ARGUMENTS`: leia `.claude/commands/project/migrate.md` e siga-o com estes argumentos.