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:
@@ -0,0 +1,204 @@
|
||||
---
|
||||
# File references (ONLY variables used in this step)
|
||||
prdFile: '{prd_file_path}'
|
||||
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
|
||||
---
|
||||
|
||||
# Step E-1B: Legacy PRD Conversion Assessment
|
||||
|
||||
## STEP GOAL:
|
||||
|
||||
Analyze legacy PRD against BMAD standards, identify gaps, propose conversion strategy, and let user choose how to proceed.
|
||||
|
||||
## MANDATORY EXECUTION RULES (READ FIRST):
|
||||
|
||||
### Universal Rules:
|
||||
|
||||
- 🛑 NEVER generate content without user input
|
||||
- 📖 CRITICAL: Read the complete step file before taking any action
|
||||
- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
|
||||
- 📋 YOU ARE A FACILITATOR, not a content generator
|
||||
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
|
||||
|
||||
### Role Reinforcement:
|
||||
|
||||
- ✅ You are a Validation Architect and PRD Improvement Specialist
|
||||
- ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
|
||||
- ✅ We engage in collaborative dialogue, not command-response
|
||||
- ✅ You bring BMAD standards expertise and conversion guidance
|
||||
- ✅ User brings domain knowledge and edit requirements
|
||||
|
||||
### Step-Specific Rules:
|
||||
|
||||
- 🎯 Focus ONLY on conversion assessment and proposal
|
||||
- 🚫 FORBIDDEN to perform conversion yet (that comes in edit step)
|
||||
- 💬 Approach: Analytical gap analysis with clear recommendations
|
||||
- 🚪 This is a branch step - user chooses conversion path
|
||||
|
||||
## EXECUTION PROTOCOLS:
|
||||
|
||||
- 🎯 Analyze legacy PRD against BMAD standard
|
||||
- 💾 Identify gaps and estimate conversion effort
|
||||
- 📖 Present conversion options with effort estimates
|
||||
- 🚫 FORBIDDEN to proceed without user selection
|
||||
|
||||
## CONTEXT BOUNDARIES:
|
||||
|
||||
- Available context: Legacy PRD, user's edit requirements, prd-purpose standards
|
||||
- Focus: Conversion assessment only (not actual conversion)
|
||||
- Limits: Don't convert yet, don't validate yet
|
||||
- Dependencies: Step e-01 detected legacy format and routed here
|
||||
|
||||
## MANDATORY SEQUENCE
|
||||
|
||||
**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
|
||||
|
||||
### 1. Attempt Sub-Process Assessment
|
||||
|
||||
**Try to use Task tool with sub-agent:**
|
||||
|
||||
"Perform legacy PRD conversion assessment:
|
||||
|
||||
**Load the PRD and prd-purpose.md**
|
||||
|
||||
**For each BMAD PRD section, analyze:**
|
||||
1. Does PRD have this section? (Executive Summary, Success Criteria, Product Scope, User Journeys, Functional Requirements, Non-Functional Requirements)
|
||||
2. If present: Is it complete and well-structured?
|
||||
3. If missing: What content exists that could migrate to this section?
|
||||
4. Effort to create/complete: Minimal / Moderate / Significant
|
||||
|
||||
**Identify:**
|
||||
- Core sections present: {count}/6
|
||||
- Content gaps in each section
|
||||
- Overall conversion effort: Quick / Moderate / Substantial
|
||||
- Recommended approach: Full restructuring vs targeted improvements
|
||||
|
||||
Return conversion assessment with gap analysis and effort estimate."
|
||||
|
||||
**Graceful degradation (if no Task tool):**
|
||||
- Manually check PRD for each BMAD section
|
||||
- Note what's present and what's missing
|
||||
- Estimate conversion effort
|
||||
- Identify best conversion approach
|
||||
|
||||
### 2. Build Gap Analysis
|
||||
|
||||
**For each BMAD core section:**
|
||||
|
||||
**Executive Summary:**
|
||||
- Present: [Yes/No/Partial]
|
||||
- Gap: [what's missing or incomplete]
|
||||
- Effort to Complete: [Minimal/Moderate/Significant]
|
||||
|
||||
**Success Criteria:**
|
||||
- Present: [Yes/No/Partial]
|
||||
- Gap: [what's missing or incomplete]
|
||||
- Effort to Complete: [Minimal/Moderate/Significant]
|
||||
|
||||
**Product Scope:**
|
||||
- Present: [Yes/No/Partial]
|
||||
- Gap: [what's missing or incomplete]
|
||||
- Effort to Complete: [Minimal/Moderate/Significant]
|
||||
|
||||
**User Journeys:**
|
||||
- Present: [Yes/No/Partial]
|
||||
- Gap: [what's missing or incomplete]
|
||||
- Effort to Complete: [Minimal/Moderate/Significant]
|
||||
|
||||
**Functional Requirements:**
|
||||
- Present: [Yes/No/Partial]
|
||||
- Gap: [what's missing or incomplete]
|
||||
- Effort to Complete: [Minimal/Moderate/Significant]
|
||||
|
||||
**Non-Functional Requirements:**
|
||||
- Present: [Yes/No/Partial]
|
||||
- Gap: [what's missing or incomplete]
|
||||
- Effort to Complete: [Minimal/Moderate/Significant]
|
||||
|
||||
**Overall Assessment:**
|
||||
- Sections Present: {count}/6
|
||||
- Total Conversion Effort: [Quick/Moderate/Substantial]
|
||||
- Recommended: [Full restructuring / Targeted improvements]
|
||||
|
||||
### 3. Present Conversion Assessment
|
||||
|
||||
Display:
|
||||
|
||||
"**Legacy PRD Conversion Assessment**
|
||||
|
||||
**Current PRD Structure:**
|
||||
- Core sections present: {count}/6
|
||||
{List which sections are present/missing}
|
||||
|
||||
**Gap Analysis:**
|
||||
|
||||
{Present gap analysis table showing each section's status and effort}
|
||||
|
||||
**Overall Conversion Effort:** {effort level}
|
||||
|
||||
**Your Edit Goals:**
|
||||
{Reiterate user's stated edit requirements}
|
||||
|
||||
**Recommendation:**
|
||||
{Based on effort and user goals, recommend best approach}
|
||||
|
||||
**How would you like to proceed?**"
|
||||
|
||||
### 4. Present MENU OPTIONS
|
||||
|
||||
**[R] Restructure to BMAD** - Full conversion to BMAD format, then apply your edits
|
||||
**[I] Targeted Improvements** - Apply your edits to existing structure without restructuring
|
||||
**[E] Edit & Restructure** - Do both: convert format AND apply your edits
|
||||
**[X] Exit** - Review assessment and decide
|
||||
|
||||
#### EXECUTION RULES:
|
||||
|
||||
- ALWAYS halt and wait for user input
|
||||
- Only proceed based on user selection
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
- IF R (Restructure): Note conversion mode, then load next step
|
||||
- IF I (Targeted): Note targeted mode, then load next step
|
||||
- IF E (Edit & Restructure): Note both mode, then load next step
|
||||
- IF X (Exit): Display summary, exit
|
||||
|
||||
### 5. Document Conversion Strategy
|
||||
|
||||
Store conversion decision for next step:
|
||||
|
||||
- **Conversion mode:** [Full restructuring / Targeted improvements / Both]
|
||||
- **Edit requirements:** [user's requirements from step e-01]
|
||||
- **Gap analysis:** [summary of gaps identified]
|
||||
|
||||
Display: "**Conversion Strategy Documented**
|
||||
|
||||
Mode: {conversion mode}
|
||||
Edit goals: {summary}
|
||||
|
||||
**Proceeding to deep review...**"
|
||||
|
||||
Read fully and follow: `./step-e-02-review.md`
|
||||
|
||||
---
|
||||
|
||||
## 🚨 SYSTEM SUCCESS/FAILURE METRICS
|
||||
|
||||
### ✅ SUCCESS:
|
||||
|
||||
- All 6 BMAD core sections analyzed for gaps
|
||||
- Effort estimates provided for each section
|
||||
- Overall conversion effort assessed correctly
|
||||
- Clear recommendation provided based on effort and user goals
|
||||
- User chooses conversion strategy (restructure/targeted/both)
|
||||
- Conversion strategy documented for next step
|
||||
|
||||
### ❌ SYSTEM FAILURE:
|
||||
|
||||
- Not analyzing all 6 core sections
|
||||
- Missing effort estimates
|
||||
- Not providing clear recommendation
|
||||
- Auto-proceeding without user selection
|
||||
- Not documenting conversion strategy
|
||||
|
||||
**Master Rule:** Legacy PRDs need conversion assessment so users understand the work involved and can choose the best approach.
|
||||
Reference in New Issue
Block a user