docs: update all documentation and add AI tooling configs

- Rewrite README.md with current architecture, features and stack
- Update docs/API.md with all current endpoints (corporate, BI, client 360)
- Update docs/ARCHITECTURE.md with cache, modular queries, services, ETL
- Update docs/GUIA-USUARIO.md for all roles (admin, corporate, agente)
- Add docs/INDEX.md documentation index
- Add PROJETO.md comprehensive project reference
- Add BI-CCC-Implementation-Guide.md
- Include AI agent configs (.claude, .agents, .gemini, _bmad)
- Add netbird VPN configuration
- Add status report

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-03-19 13:29:03 -04:00
parent c5b377e788
commit 647cbec54f
3246 changed files with 479789 additions and 983 deletions

View File

@@ -0,0 +1,65 @@
---
name: reverse-engineering
description: Analyze any software or website to extract specifications and design patterns
---
# [R] Reverse Engineering — Any Software/Site → Specs & Extraction
**Goal:** Analyze existing software or public websites to extract page specifications, design systems, and architectural understanding.
**When to use:** Need to understand an existing product (yours or public). Want to create WDS specifications from existing software. Competitive analysis through design extraction. Migrating or rebuilding an existing product.
**Two modes:**
- **Internal:** Analyze your own codebase (source code access)
- **External:** Analyze any public website (browser-based, no source needed)
---
## CORE PRINCIPLES
- **Observe first, then extract** — Do not start generating specs from the first page you see. Explore the full scope of the target first, then systematically extract patterns. Premature extraction leads to incomplete and inconsistent results.
- **Respect intellectual property** — Reverse engineering is for learning and specification, not for copying proprietary code. Extract patterns, structures, and design tokens. Do not copy proprietary assets, fonts, or copyrighted content.
- **Focus on patterns, not pixel-perfect copy** — The goal is to understand the design system and page structures well enough to build something equivalent or better. Capture the rules and relationships, not individual pixel values.
---
## INITIALIZATION
### Design Log
Read `{output_folder}/_progress/00-design-log.md`. Check Current and Backlog for context.
### Essential Guides
- **[Execution Principles](data/guides/EXECUTION-PRINCIPLES.md)** — Document before acting, plan-then-execute
- **[Session Protocol](data/guides/SESSION-PROTOCOL.md)** — Read dialog, verify plan, present status
---
## STEPS
Execute steps in `./steps-r/`:
| Step | File | Purpose |
|------|------|---------|
| 01 | step-01-identify-target.md | Define target, access method, extraction goals |
| 02 | step-02-explore-and-capture.md | Explore structure, capture patterns and inventory |
| 03 | step-03-generate-specs.md | Generate WDS-format page specifications |
| 04 | step-04-extract-design-system.md | Extract design tokens and component catalog |
**Flow:** 01 → 02 → 03 → 04
### Critical Rules
- **ALWAYS** explore the full target before extracting — do not start with the first page
- **ALWAYS** document observations before generating specs
- **ALWAYS** generate output in `document_output_language`
- **ALWAYS** produce WDS-compatible artifacts that can feed into prototyping
- **NEVER** copy proprietary code, assets, or copyrighted content
---
## AFTER COMPLETION
1. Append a progress entry to `{output_folder}/_progress/00-design-log.md` under `## Progress`:
`### [date] — Reverse Engineering: [what was extracted]`
2. Suggest next action: feed specs into prototyping, analyze further, or start development