docs: rework structure

[ismaelfaro]

Which issue(s) does this pull-request address?

updating Docs to adding structure and architecture diagrams.

Closes: #

Description

Checklist

• I have read the contributor guide
• Linting passes: yarn lint or yarn lint:fix
• Formatting is applied: yarn format or yarn format:fix
• Unit tests pass: yarn test:unit
• E2E tests pass: yarn test:e2e
• Tests are included
• Documentation is changed or added
• Commit messages and PR title follow conventional commits

[matiasmolinas]

Here’s a revised draft of your comment incorporating the additional context:

Hi @ismaelfaro,

Thank you for updating the documentation with these structure and architecture diagrams! I reviewed the changes, and I find them incredibly useful, especially for developers new to this framework. Clear and detailed documentation like this not only improves onboarding but also aligns with modern development workflows.

For the issue I’m currently working on, my first step was to generate additional documentation—both for the framework as a whole and specifically for the issue I was addressing. This documentation served a dual purpose: helping me better understand the framework and providing structured context for an LLM to assist in drafting the initial implementation of the code.

From this perspective, I fully agree that improvements like the ones in this PR are not just enhancements but necessary steps for supporting new "developer workflows" that start by creating a solid understanding and leveraging LLMs as a tool to explore solutions.

Great work on this PR!