feat: Document new Stances feature, update project structure

[xangcastle]

This pull request updates the README.md to provide a more comprehensive and community-driven overview of Ronin, with a particular focus on the new "Stances" system and expanded roadmap. The changes clarify the architecture, introduce the concept of personas (Stances), and document future plans and community-driven development. The most important changes are grouped below.

Documentation of Architecture and Personas:

• Added a new section, "The Stances (Samurai & Sovereignty)," explaining the shift from simple model selection to customizable expert personas (Stances) that bundle prompt, model, scope, and credentials. This includes details on creating custom stances, default personas, enterprise integration, strict mode, and persona-based telemetry.
• Updated architecture descriptions to clarify the roles of RoninSettingsState (managing Stances) and RoninConfigService (managing environment context), reflecting the new persona-based approach.

Roadmap and Feature Expansion:

• Expanded the roadmap to include planned support for additional LLM providers (Anthropic, Google Gemini, DeepSeek, Kimi, Minimax, Ollama) and detailed upcoming UI/UX improvements (Markdown support, Stance Avatars, agentic timeline, interactive diffs, input enhancements).

Community and Development Process:

• Added a "Forged in Public" section, documenting major architectural decisions and their origins in community discussions, emphasizing transparency and collaborative problem-solving.
• Included visual diagrams (Blades.png, Stances.png) and references to relevant discussions to illustrate the architecture and persona system.

These updates make the README more informative for both new and existing users, highlighting Ronin's flexibility, team integration capabilities, and commitment to open development.

[github-actions]

Qodana Community for JVM

It seems all right 👌

No new problems were found according to the checks applied

💡 Qodana analysis was run in the pull request mode: only the changed files were checked

View the detailed Qodana report

To be able to view the detailed Qodana report, you can either:

• Register at Qodana Cloud and configure the action
• Use GitHub Code Scanning with Qodana
• Host Qodana report at GitHub Pages
• Inspect and use qodana.sarif.json (see the Qodana SARIF format for details)

To get *.log files or any other Qodana artifacts, run the action with upload-result option set to true,
so that the action will upload the files as the job artifacts:

      - name: 'Qodana Scan'
        uses: JetBrains/qodana-action@v2025.1.1
        with:
          upload-result: true

Contact Qodana team

Contact us at qodana-support@jetbrains.com

• Or via our issue tracker: https://jb.gg/qodana-issue
• Or share your feedback: https://jb.gg/qodana-discussions