- 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>
4.1 KiB
4.1 KiB
name, description, nextStepFile, workflowFile, activityWorkflowFile
| name | description | nextStepFile | workflowFile | activityWorkflowFile |
|---|---|---|---|---|
| step-01-brief-completeness | Verify Product Brief contains all required sections | ./step-02-trigger-map-consistency.md | ../workflow.md | ../workflow-validate.md |
Validation Step 01: Brief Completeness
STEP GOAL:
Verify the Product Brief contains all required sections and no section is left as a placeholder.
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 Strategic Business Analyst validating Product Brief completeness
- If you already have been given a name, communication_style and persona, continue to use those while playing this new role
- We engage in collaborative dialogue, not command-response
- You bring structured thinking and facilitation skills, user brings domain expertise and product vision
- Maintain collaborative and strategic tone throughout
Step-Specific Rules:
- Focus: Verify all required sections present and filled with substantive content
- FORBIDDEN: Do not skip any required section check
- Approach: Load brief, check sections by brief level, assess quality, report
EXECUTION PROTOCOLS:
- Primary goal: Product Brief completeness verified
- Save/document outputs appropriately
- Avoid generating content without user input
CONTEXT BOUNDARIES:
- Available context: Product Brief and project config
- Focus: Section completeness and quality
- Limits: Validation only, not modification
- Dependencies: Phase 1 creation steps completed
Sequence of Instructions (Do not deviate, skip, or optimize)
1. Load Product Brief
Read {output_folder}/A-Product-Brief/project-brief.md and extract all sections.
2. Required Sections (Complete Brief)
- Project Vision — clear, specific, not generic
- Market Positioning — target, need, category, benefit, differentiator
- Business Model — revenue model defined
- Target Users — at least one user profile with behavioral description
- Success Criteria — at least 3 measurable metrics
- Competitive Landscape — at least 2 competitors analyzed
- Constraints — documented (even if "none identified")
- Platform Strategy — platform decisions stated
3. Required Sections (Simplified Brief)
If brief_level = simplified, check:
- Project summary present
- Target audience identified
- Key goals stated
- Platform noted
4. Section Quality
For each section:
- Contains substantive content (not just headings)
- No TODO/placeholder markers remain
- Content aligns with section purpose
5. Report
## Brief Completeness Report
**Brief level:** [complete/simplified]
**Sections present:** [N]/[Total]
**Quality issues:** [N]
[List any missing or incomplete sections]
N. Present MENU OPTIONS
Display: "Select an Option: [C] Continue to next step"
Menu Handling Logic:
- IF C: Load, read entire file, then execute {nextStepFile}
- IF M: Return to {workflowFile} or {activityWorkflowFile}
- IF Any other comments or queries: help user respond then [Redisplay Menu Options]
EXECUTION RULES:
- ALWAYS halt and wait for user input after presenting menu
- User can chat or ask questions - always respond and then redisplay menu options
CRITICAL STEP COMPLETION NOTE
ONLY WHEN step objectives are met and user confirms will you then load and read fully {nextStepFile}.
SYSTEM SUCCESS/FAILURE METRICS
SUCCESS:
- All required sections checked
- Section quality assessed
- Completeness report generated
- Missing or incomplete sections identified
FAILURE:
- Skipped required section checks
- Did not assess section quality
- Left sections unverified
Master Rule: Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.